Campos específicos para atributos SOAP
En la ventana Información de atributos, hay dos campos para los atributos de SOAP que definen cómo se recopilan los datos desde la respuesta de SOAP.
El campo Tipo de atributo puede ser cualquier valor de una lista que controle la información sobre la respuesta que se ha devuelto. Algunos tipos de atributos requieren un valor en el campo Valor de tipo. El tipo de atributo predeterminado es XPath Query, que ejecuta una consulta de XPath en el contenido de la respuesta del servidor de SOAP. El valor de tipo es la consulta XPath que se está ejecutando. La siguiente tabla describe todos los tipos de atributo y el valor de tipo cuando se necesita uno:
| Tipo de atributo | Descripción | Valor de tipo | Tipo de datos devueltos | Diferencias con los protocolos FTP y de archivos |
|---|---|---|---|---|
XPath Query |
Ejecuta una consulta XPath en el contenido que se devuelve desde una conexión URL. La consulta se debe grabar para que devuelva datos útiles para un atributo, no una lista de nodos. | La consulta XPath que se ejecutará en el contenido que se obtiene desde una conexión URL. Si se ha definido una consulta de selección de filas, esta consulta de XPath debe ser relativa a la consulta de selección de filas. | Los datos que se devuelven pueden ser un valor de serie, un valor numérico o un valor de indicación de fecha y hora. El navegador de Agent Builder para SOAP detecta generalmente el tipo de datos correcto para el atributo a partir de los datos que se examinan. Si los datos están en formato DateTime de XML, puede especificar una indicación de fecha y hora como tipo de atributo y el agente convertirá el valor a Timestamp de Candle. | Ninguna |
Tiempo de respuesta |
La cantidad de tiempo en milisegundos que se ha tardado en descargar el contenido del URL solicitado. | Ninguna | Entero (número de milisegundos) | Ninguna |
Mensaje de respuesta |
El mensaje de respuesta de HTTP que devuelve el servidor. | Ninguna | Serie | El mensaje de respuesta se aplica solo si el URL utiliza protocolos HTTP o HTTPS. |
Código de respuesta |
El código de respuesta de HTTP que devuelve el servidor. | Ninguna | Entero | El código de respuesta se aplica solo si el URL utiliza protocolos HTTP o HTTPS. Siempre es 0 para los URL de archivos o de FTP. |
Longitud de respuesta |
El tamaño del contenido en bytes que se ha descargado desde el URL solicitado | Ninguna | Entero (tamaño en bytes) | Ninguna |
Cabecera de respuesta |
La cabecera de respuesta se puede utilizar para recuperar un valor de uno de los campos de cabecera de respuesta de URL. El argumento especifica qué campo es solicitado. | El campo de la cabecera de respuesta que se va a recopilar. | Serie | Normalmente los protocolos de archivo y FTP no tienen cabeceras que se puedan recopilar. |
Solicitar URL |
La conexión se ha creado para este URL. Todas las palabras claves de respuesta proporcionan información sobre la conexión con este URL. La consulta XPath se puede utilizar para obtener información que se obtiene del contenido devuelto al acceder a este URL. | Ninguna | Serie | Ninguna |
Opciones de XPath
Si utiliza el lenguaje XML Path, puede seleccionar nodos desde un documento XML. Algunos de los posibles usos de XPaths para los orígenes de datos de SOAP incluyen:
- Utilización de predicados en XPath para identificar los elementos XML que se corresponden a las filas de datos en el grupo de atributos de IBM® Tivoli Monitoring.
Puede utilizar predicados en XPath que correlacionen elementos XML o atributos con atributos de Tivoli Monitoring, como en el siguiente ejemplo:
Donde hay varios pasos de ubicación en XPath, cada uno de ellos puede contener uno o más predicados. Los predicados pueden ser complejos y contener valores booleanos u operadores de fórmula. Por ejemplo:Stat[@name="URLs"]/CountStatistic[@name="URIRequestCount"]/@count//PerformanceMonitor/Node/Server[@name="server1"]/Stat/Stat/Stat[@name= "Servlets"]/Stat - Inclusión de funciones de conjunto de nodos en el XPath, si una fila contiene varios elementos
XML del mismo tipo. Y si la posición de un elemento XML en la lista de nodos determina el atributo
de Tivoli Monitoring con el que se correlaciona el elemento. Ejemplos de funciones de
conjunto de nodos son:
position(),first(),last()ycount(). - Transformación de datos simple, como la subcadena. Si especifica la siguiente subcadena:
el XPath devuelve los tres primeros caracteres del elemento XML, myXMLElement.substring(myXMLElement,1,3)
(.., como en el ejemplo
siguiente: /../OrganizationDescription/OrganizationIdentifier