È 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:
È 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:
Indica il numero di parentesi aperte. Sono consentiti valori uguali o superiori a 0.
Imposta il termine logico che collega i filtri, AND oppure OR. Lasciare sempre vuoto il valore logico del primo termine del filtro.
Definisce le colonne evento interrogate. È possibile ottenere l'elenco delle colonne disponibili utilizzando getDataModel.
Definisce un operatore per il filtro. Sono consentiti i seguenti valori, che applicano la distinzione tra maiuscole e minuscole:
Definisce il valore ricercato dal filtro.
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.
È 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.
Copyright © 2011 CA. Tutti i diritti riservati. | Contatta CA Technologies |