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:
| 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:
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:Stat[@name="URLs"]/CountStatistic[@name="URIRequestCount"]/@count//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()ecount(). - Fazer transformação de dados simples, como subsequência. Se você especificar a seguinte subsequência:
o XPath retornará os três primeiros caracteres do elemento XML, myXMLElement.substring(myXMLElement,1,3)
(..,
como no exemplo a seguir: /../OrganizationDescription/OrganizationIdentifier