É possível ativar o Construtor de Expressão XPath a partir da maioria dos campos de propriedade que suportam ou esperam expressões XPath como um valor que pode ser inserido dentro do campo.
A utilização do Construtor de Expressão XPath é opcional, pois é um auxílio no desenvolvimento de aplicativos de fluxo de mensagens. O Construtor de Expressão XPath ajuda a construir expressões de processamento de mensagens tantoXPath como ESQL. Você está livre para inserir expressões manualmente ou utilizar o Construtor de Expressões XPath para ajudar a construir tais expressões.
O XPath Expression Builder não suporta o uso da variável $Body. Você pode usar a variável $Body ao inserir uma expressão à mão, mas o XPath Expression Builder e a validação associada no WebSphere Message Broker Toolkit não a suportam. Use a variável $Root no lugar.
Você pode preencher os campos, independentemente do estado do nó, ou seja, se o nó estiver separado ou conectado ou totalmente, parcialmente ou completamente desconfigurado.
Variáveis (ou em terminologia ESQL, nomes de correlação) fornecem uma lista de todos os pontos de início da árvore de mensagens que se aplicam ao campo de propriedade a partir do qual o diálogo foi ativado.
Se um campo for um campo de caminho de leitura ou de leitura/gravação, as expressões devem ser iniciadas com essa variável para indicar para qual árvore em qual montagem de mensagem a expressão de caminho está mapeando.
Os nomes das variáveis XPath mapeiam para nomes de correlação existentes localizado nas expressões de referência de campo do ESQL, mas para estar em conformidade com a gramática do ESQL, são designados como referências de variável, através do prefixo do caractere dólar ($).
A caixa de diálogo do XPath Expression Builder suporta validação, que você pode desativar na página de preferências de XPath desmarcando a caixa de seleção Validar ao criar expressões XPath.
Se você selecionar as variáveis $Root ou $Body e criar uma expressão que faça referência ao corpo da mensagem, a expressão XPath conterá o elemento da mensagem. Esta expressão é correta para os corpos de mensagens pertencentes aos domínios XMLNSC, XMLNS, XML e DataObject.
Para corpos da mensagem que pertencem aos domínios MRM, MIME, SOAP e IDOC, é necessário remover o elemento de mensagem da expressão.
Por exemplo, a expressão XPath $Body/my_message/my_field é correta para XMLNSC, mas deve ser alterada para $Body/my_field para que seja correta para o MRM.
Existem três visualizações principais quando as funções são suportadas.
Se você expandir as Configurações de Espaço de Nomes no diálogo do Construtor de Expressão XPath, verá uma tabela das cadeias de pares do Prefixo e Espaço de Nome. Essa tabela é atualizada automaticamente quando as expressões XPath são criadas. Se o prefixo padrão gerado não é o que deseja,é possível alterá-lo, clicando em Alterar Prefixo.
Para incluir um prefixo e entrada de mapa de espaço de nomes, clique em Incluir e preencha os campos no diálogo.
Para editar ou excluir uma entrada na tabela, selecione o item e clique em Editar ou Excluir respectivamente.
Editar abre outro diálogo de campo, permitindo alterar o prefixo e o espaço de nomes.
Para obter informações sobre as preferências fornecidas com o editor XPath, consulte Preferências do Editor XPath.