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:
Tabla 1. Información de atributos de SOAP
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:
    Stat[@name="URLs"]/CountStatistic[@name="URIRequestCount"]/@count
    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:
    //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() y count().
  • Transformación de datos simple, como la subcadena. Si especifica la siguiente subcadena:
    substring(myXMLElement,1,3)
    el XPath devuelve los tres primeros caracteres del elemento XML, myXMLElement.
Puede especificar elementos fuera del contexto del XPath de selección de filas utilizando dos puntos seguidos, (.., como en el ejemplo siguiente:
/../OrganizationDescription/OrganizationIdentifier