Construindo Expressões XPath

A maioria das primitivas de mediação possui propriedades especificadas usando uma expressão XPath 1.0, por exemplo, a propriedade raiz leva uma expressão do XPath 1.0 que especifica a parte da mensagem que está disponível para a primitiva para ser processada. O XPath Expression Builder fornece uma visualização de árvore da mensagem e permite construir visualmente ou especificar manualmente uma expressão XPath 1.0.

É possível usar as expressões XPath 1.0 em seu fluxo para acessar partes específicas de uma mensagem. Em seguida, é possível processar a mensagem; por exemplo, é possível transformar, filtrar ou recuperar valores a partir de uma mensagem,

A mensagem de entrada é exibida no visualizador de esquema do XPath Expression Builder, de forma que o terminal de entrada da primitiva deve estar conectado para ativar o Expression Builder. Caso um terminal de entrada de primitiva não esteja conectado, o construtor não será ativado porque não conhece o tipo de mensagem a ser exibida.

O XPath Expression Builder é normalmente ativado clicando-se no botão Customizar XPath na visualização Propriedades de detalhes de um nó ou da primitiva de mediação. Para propriedades configuradas em uma tabela, clique no final de uma expressão para visualizar o botão XPath expression builder launch que ativa o XPath Expression Builder.

A seção Visualizador de Esquemas fornece uma visualização em árvore da mensagem de entrada. Para construir visualmente sua expressão XPath siga estas etapas:

  1. Expanda a árvore, navegue até o campo para o qual você deseja construir a expressão e clique nele para selecioná-lo. Um campo é um elemento ou um atributo mostrado com um caractere @ que precede seu nome. Os elementos de repetição são mostrados entre colchetes []. Para selecionar um elemento de repetição, clique sobre ele e insira um valor de índice quando solicitado. Ao clicar em um elemento, você verá o XPath Local sendo atualizado para mostrar o caminho do local do elemento selecionado
  2. Quando tiver selecionado um elemento, opcionalmente configure uma condição; clique em Condição para fazer uma seleção a partir de uma lista de campos disponíveis. Use esses campos se precisar filtrar ou selecionar através da especificação de um valor. Selecione um campo de condição e, em seguida, clique em Valor para configurar o valor com o qual fazer a comparação. Para os atributos ou os elementos simples (sem subelementos), você também pode selecionar self::node(), que significa utilizar o valor do atributo ou a parte do texto do elemento entre suas tags de início e fim. No tempo de execução, a condição será usada para selecionar os dados da instância.

A expressão do XPath completa é mostrada sob o título Expressão Completa do XPath:

Você pode inserir uma expressão XPath manualmente selecionando a caixa de opções Substituir e digitando sua expressão. Ou, se quiser construir expressões complexas, pode começar criando uma expressão com o construtor de expressões e selecionando Substituir para editá-la.

Nota: A sintaxe de sua expressão XPath 1.0 não será verificada.

Exemplo

O exemplo a seguir mostra o relacionamento entre um objeto de negócios na interface e uma condição XPath no XPath Expression Builder.

Um objeto de negócios Funcionário é criado contento quatro campos: id, isManager, name e department.
Figura do Objeto de Negócios Funcionário

O objeto de negócios Funcionário é usado como os tipos de mensagens de entrada e saída para EmployeeInterface.


Figura de EmployeeInterface
Aqui está a expressão XPath correspondente construída no XPath Expression Builder para filtrar os objetos de negócios para todos os funcionários que são gerentes: /body/getEmployeeInfo/Emp[isManager=true()].
  • /body A seção de corpo da mensagem
  • /getEmployeeInfo: O nome da operação na interface.
  • /Emp: O nome do tipo de mensagem de entrada.
  • [isManager=true()]: Verifica se o campo isManager está configurado como verdadeiro.
Nota: Nesse caso, a mesma expressão funcionará para fluxos de pedido e resposta, mas apenas porque as mensagens de entrada e saída para a operação são idênticas.

A figura a seguir mostra o exemplo da expressão XPath 1.0 no XPath Expression Builder:

Figura de Exemplo no XPath Expression Builder

Consulte http://www.w3.org/TR/xpath para obter informações adicionais sobre o XPath 1.0.

Feedback
(C) Direitos Autorais IBM Corporation 2005, 2006. Todos os Direitos Reservados.