Guía de programación de la API › Ejemplos de CA Enterprise Log Manager API › GetObject › getQueryList

getQueryList

Utilice el comando getQueryList para crear una lista de todas las consultas disponibles en el entorno de CA Enterprise Log Manager. La respuesta XML contiene también los datos de formato y los criterios de filtrado que se hayan definido previamente para cada consulta.

Con el comando getQueryList pueden utilizarse los siguientes parámetros opcionales:

tag

Define una etiqueta existente en el sistema. Puede incluir una o más etiquetas para buscar con el comando getQueryList. Si especifica una etiqueta desconocida, el comando devuelve una lista vacía.

tagLogic

Especifica el modo de actuación del comando getQueryList ante la presencia de varias etiquetas. Los valores admitidos son AND (y) y OR (o). El valor predeterminado es OR. Sólo se puede utilizar un valor de tagLogic a la vez.

Ejemplo de etiqueta sin filtro

https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryList

Devuelve todas las consultas y los datos de formato relacionados con cada etiqueta.

Ejemplo de TagLogic con el valor OR

https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryList&tag=Unknown Category&tag=System

Devuelve todas las consultas relacionadas con las etiquetas “Unknown Category” (Categoría desconocida) OR (o) “System” (Sistema).

Ejemplo de TagLogic con el valor AND

https://ELMSERVER:5250/spin/calmapi/getObject.csp?type=getQueryList&tag=Unknown Category&tag=System&tagLogic=and

Devuelve todas las consultas relacionadas con las etiquetas “Unknown Category” (Categoría desconocida) AND (y) “System” (Sistema).

Ejemplo de resultado

El siguiente ejemplo abreviado muestra una única consulta, "System Event Count by Event Category" (Recuento de eventos del sistema por categoría de evento).

<?xml version="1.0" encoding="UTF-8" ?>
<Result>
	<Value>true</Value>
	<Description>Get Object Successful. Type [getQueryList]</Description>
	<Items>
	<Item edit="false">
		<Panel id="Subscription/panels/System_Event_Count_by_Event_Category" name="System Event Count by Event Category" subscription="true" version="12.0.46.8">
			<Description>Ranks system event count activity by event category</Description>
			<Tags>
				<Tag name="System" />
			</Tags>
			<Query id="">
				<Table>view_event</Table>
				<Args unique="false" />
				<Column columnname="event_datetime" datatype="T" displayname="Date" resultname="event_datetime" visible="true" />
				<Column columnname="event_category" datatype="S" displayname="Category" grouporder="1" notnull="true" resultname="event_category" sortdesc="" visible="true" />
				<Column columnname="event_count" datatype="I" displayname="Count" functionname="sum" resultname="event_count" sortdesc="true" sortorder="1" visible="true" />
			</Query>
			<Display>
				<X name="Category" resultname="event_category" />
				<Y name="Count" resultname="event_count" />
				<Visualization type="VizBarChart" />
				<Visualization type="VizPieChart" />
				<Visualization type="VizTable" />
			</Display>
		</Panel>
	</Item>
	<Item edit="false">

La etiqueta "Panel id=" indica que se trata de un informe de suscripción y muestra su nombre.

Nota: Si se trata de una consulta de solicitud, se mostrará la etiqueta "Prompt id=" en lugar de la etiqueta "Panel id=", por ejemplo, "Prompt id=HostPrompt".

"Tag Name=" denota la presencia de la etiqueta System (Sistema).

Los elementos de la etiqueta "Column columname=" especifican las columnas de eventos en las que se realizará la búsqueda relativa a la consulta. Asimismo, en esta etiqueta se indica el modo en que se agrupan y ordenan dichas columnas.

Los elementos de la etiqueta "Display" especifican el modo de visualización gráfica de los eventos.

Más información:

getQueryViewer

Consultas de solicitud

runQuery