Campos específicos para atributos SOAP

Na janela Informações do Atributo, existem dois campos para os atributos SOAP que definem como os dados são coletados a partir da resposta SOAP.

O campo Tipo de Atributo pode ser qualquer valor a partir de uma lista que controla as informações sobre a resposta que é retornada. Alguns tipos de atributos requerem um valor no campo Valor de Tipo. O tipo de atributo padrão é XPath Query, que executa uma consulta XPath com relação ao conteúdo da resposta do servidor SOAP. O valor de tipo é a consulta XPath que é executada. A tabela a seguir descreve todos os tipos de atributos e o valor de tipo quando um for necessário:
Tabela 1. Informações sobre o Atributo SOAP
Tipo de Atributo Descrição Valor de tipo Tipo de dados retornado Diferenças com protocolos FTP e de arquivos
Consulta XPath Executa uma consulta XPath no conteúdo que é retornado de uma conexão de URL. A consulta deve ser gravada para retornar dados úteis para um atributo, não uma lista de nós. A consulta XPath para ser executada no conteúdo que é obtido de uma conexão de URL. Se uma consulta de seleção de linha foi definida, esta consulta XPath deve ser relativa à consulta de seleção de linha. Os dados retornados podem ser uma sequência, um valor numérico ou de registro de data e hora. O navegador Agent Builder para SOAP geralmente detecta o tipo de dados correto para o atributo dos dados que está sendo procurado. Se os dados estiverem no formato DateTime XML, você pode especificar o registro de data e hora como o tipo de atributo e o agente converterá o valor para um Registro de Data e Hora Candle. none
Tempo de Resposta A quantidade de tempo em milissegundos que demorou para fazer download do conteúdo a partir da URL solicitada. Nenhum Número inteiro (número em milissegundos) Nenhum
Mensagem de Resposta A mensagem de resposta de HTTP que é retornada pelo servidor. Nenhum Cadeia A mensagem de resposta somente será aplicada se a URL usar os protocolos HTTP ou HTTPS.
Código de Resposta O código de resposta de HTTP que é retornado pelo servidor. none Integer O código de resposta somente será aplicado se a URL usar os protocolos HTTP ou HTTPS. É sempre 0 para URLs de arquivos ou de FTP.
Comprimento da Resposta O tamanho do conteúdo em bytes, que foi transferido por download a partir da URL solicitada none Número inteiro (tamanho em bytes) Nenhum
Cabeçalho da Resposta O cabeçalho da resposta pode ser usado para recuperar um valor de um dos campos de cabeçalho de resposta da URL. O argumento especifica qual campo é solicitado. O campo de cabeçalho de resposta a ser coletado. Cadeia Geralmente, os protocolos de arquivos e FTP não possuem nenhum cabeçalho que possa ser coletado.
URL da Solicitação A conexão foi feita com essa URL. Todas as palavras-chave de resposta fornecem informações sobre a conexão com essa URL. A Consulta XPath pode ser usada para obter informações a partir do conteúdo retornado acessando esta URL. none Cadeia Nenhum

Opções de XPath

Usando o XML Path Language, é possível selecionar os nós de um documento XML. Alguns dos possíveis usos de XPaths para as origens de dados SOAP incluem:
  • O uso de predicados no XPath para identificar os elementos XML que correspondem às linhas de dados no grupo de atributos do IBM® Tivoli Monitoring. É possível usar predicados no XPath que mapeia elementos ou atributos XML para os atributos do Tivoli Monitoring, como no exemplo a seguir:
    Stat[@name="URLs"]/CountStatistic[@name="URIRequestCount"]/@count
    Em que há diversas etapas de local no XPath, cada etapa de local pode conter um ou mais predicados. Os predicados podem ser complexos e conter valores booleanos ou operadores de fórmulas. Exemplo:
    //PerformanceMonitor/Node/Server[@name="server1"]/Stat/Stat/Stat[@name="Servlets"]/Stat
  • Incluindo as funções de conjunto de nós no XPath, se uma linha contiver diversos elementos XML do mesmo tipo. E se a posição de um elemento XML na lista de nós determinar o atributo Tivoli Monitoring para o qual o elemento é mapeado. Os exemplos de funções do conjunto de nós são position(), first(), last() e count().
  • Fazer transformação de dados simples, como subsequência. Se você especificar a seguinte subsequência:
    substring(myXMLElement,1,3)
    o XPath retornará os três primeiros caracteres do elemento XML, myXMLElement.
É possível especificar elementos fora do contexto do XPath de seleção de linha usando dois pontos, (.., como no exemplo a seguir:
/../OrganizationDescription/OrganizationIdentifier