Specifiche del fuso orario

Guida alla programmazione API › Esempi di API di CA User Activity Reporting Module › Chiamate al visualizzatore di query e rapporti › Specifiche della query › Specifiche del fuso orario

Specifiche del fuso orario

È possibile aggiungere la specifica del fuso orario a una chiamata getQuery o runQuery. getTimeZones consente di recuperare un elenco dei fusi orari disponibili.

Esempio di specifica del fuso orario

https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryViewer&objectId=Subscription/panels/System_Event_Count_By_Event_Action&timezone=NOMEFUSOORARIO

In questo caso, "&timezone=" specifica il nome del fuso orario desiderato. Il nome del fuso orario scelto andrà a sostituire "NOMEFUSOORARIO", come visualizzato nell'elenco restituito dalla chiamata gtTimeZones.

Nota: la risposta ad un fuso orario non valido varia a seconda della chiamata che lo specifica:

Se nella chiamata runQuery viene utilizzato un fuso orario non valido, verranno restituiti i timestamp GMT. Se non si specifica alcun fuso orario, il fuso orario predefinito sarà quello impostato sul server.
Se non si specifica alcun fuso orario o si utilizza un fuso orario non valido nella chiamata getQueryViewer o getReportViewer, il fuso orario predefinito sarà quello del server di destinazione.

Ulteriori informazioni:

getTimeZones

runQuery

Ulteriori informazioni:

Specifiche IncidentFilter in formato XML

Specifiche del filtro XML

È possibile preimpostare filtri CA User Activity Reporting Module per il rapporto in formato XML e aggiungerli a un URL di getQueryViewer, getReportViewer, oppure runQuery, utilizzando il termine filterXML. È possibile applicare più filtri nidificati, utilizzando le parentesi e i termini AND e OR. Sostanzialmente, si creeranno filtri di CA User Activity Reporting Module avanzati in formato XML.

Importante: I termini FilterXml sono complessi e l'API non esegue alcuna convalida. I termini del filtro non validi daranno origine a un errore della query. Per tale motivo, si consiglia di prestare particolare attenzione nella creazione dei termini del filtro.

Gli elementi del filtro disponibili, elencati nell'ordine di utilizzo, sono i seguenti:

lparens

Indica il numero di parentesi aperte. Sono consentiti valori uguali o superiori a 0.

logico

Imposta il termine logico che collega i filtri, AND oppure OR. Lasciare sempre vuoto il valore logico del primo termine del filtro.

col

Definisce le colonne evento interrogate. È possibile ottenere l'elenco delle colonne disponibili utilizzando getDataModel.

oper

Definisce un operatore per il filtro. Sono consentiti i seguenti valori, che applicano la distinzione tra maiuscole e minuscole:

EQUAL, uguale a
NEQ, diverso da
LESS, minore di
GREATER, maggiore di
LEQ, minore o uguale a
GREATEQ, maggiore o uguale a
LIKE, simile a
NOTLIKE, non simile a
INSET, nel set
NOTINSET, non nel set
MATCH, corrisponde
KEYED, con chiave
NOTKEYED, senza chiave

val

Definisce il valore ricercato dal filtro.

rparens

Indica il numero di parentesi chiuse. Sono consentiti valori uguali o superiori a 0. Il numero totale di parentesi chiuse corrisponde sempre al numero totale di parentesi aperte.

Quando si visualizza un rapporto o una query grafica, è possibile visualizzare o regolare i termini FilterXML impostati dalla sezione del filtro avanzato, accessibile dall'interfaccia del visualizzatore nella finestra di dialogo Filtro locale.

Esempio di specifica del filtro XML.

Questo esempio mostra una chiamata getQueryViewer con un'istruzione di filtro. Per chiarezza, i termini del filtro sono visualizzati per esteso.

https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryViewer&objectId=Subscription/panels/System_Event_Count_By_Event_Action&server=ELMSERVER&filterXml=
  <Filter logic="" lparens="1" col="source_username" oper="LIKE" val="su" rparens="0"/>
  <Filter logic="AND" lparens="0" col="event_logname" oper="LIKE" val="CALM" rparens="1"/>
</Scope>

"&filterxml=" indica che di seguito è presente un'istruzione per il filtro.

L'istruzione di filtro imposta la query in modo da eseguire la ricerca nella colonna source_username per il criterio "su" e nella colonna event_logname per il criterio "CALM". Dal momento che i due termini sono uniti dall'istruzione AND (Filter logic="AND"), verranno restituiti solo gli eventi in cui entrambi i valori sono rilevati nelle rispettive colonne.

Specifiche del filtro di accesso XML

È possibile preimpostare i filtri CA User Activity Reporting Module per la query o il rapporto in formato XML al momento dell'autenticazione mediante il meccanismo del nome certificato e della password di certificato. Un filtro di accesso XML utilizzato in una chiamata di accesso viene applicato a tutte le query e a tutti i rapporti eseguiti nella sessione. Se si utilizza un filtro XML nella query o nel rapporto dopo aver eseguito l'accesso con un filtro di accesso XML, CA User Activity Reporting Module applica entrambi i filtri per recuperare i risultati.

Gli elementi del filtro di accesso XML sono simili agli elementi del filtro XML.

Esempio di specifica di un filtro di accesso XML senza un filtro XML

Questo esempio mostra una chiamata getQueryViewer con un'istruzione per il filtro di accesso XML. Per chiarezza, i termini del filtro sono visualizzati per esteso.

https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryViewer&objectId=Subscription/panels/System_Event_Count_by_Event_Source&certname=test&password=test&accessFilterXml=<AccessScope><Filter logic="" lparens="0" col="event_logname"oper="LIKE" val="CALM" rparens="0"/></AccessScope>

"&accessFilterXml=" indica che di seguito è presente un'istruzione di filtro.

Esempio di specifica di un filtro di accesso XML con un filtro XML

Questo esempio mostra una chiamata objectId con istruzioni per il filtro XML e il filtro di accesso XML.

https://ELMSERVER:5250/spin/calmapi/runQuery.csp?objectId=Subscription/panels/System_Event_Count_by_Event_Source&filterXml=<Scope><Filter logic="" lparens="1"  col="event_logname" oper="INSET" val="'CALM','Unix'" rparens="1"/></Scope>&certname=test&password=test&accessFilterXml=<AccessScope><Filter logic="" lparens="1" col="event_logname" oper="LIKE" val="CALM" rparens="1"/></AccessScope>

"&filterxml=" indica che di seguito è presente un'istruzione per il filtro.

"&accessFilterXml=" indica che di seguito è presente un'istruzione di filtro.

Contatta CA Technologies