É possível usar a função Cast para definir variáveis em um mapa de mensagem que são definidas na pasta Variáveis da árvore do ambiente local.
Sobre Esta Tarefa
A árvore do ambiente local é uma parte da
árvore de mensagem lógica na qual é possível armazenar informações enquanto o
fluxo de mensagens processa a mensagem. Você usa a árvore do ambiente local para armazenar variáveis que podem ser referidas e atualizadas por nós de processamento de mensagens que ocorram posteriormente no fluxo de mensagens. Você pode usar também a árvore do ambiente local para definir destinos (que são internos ou externos para o fluxo de mensagens) aos quais uma mensagem é enviada.
Ao incluir a árvore do ambiente local em um mapa de mensagem, você deve fornecer as transformações para todos os seus elementos para que os valores de entrada de cada elemento não sejam perdidos. É possível copiar o campo de entrada inalterado ou modificado por uma transformação.
Muitos nós do WebSphere Message
Broker dependem das informações na árvore do ambiente local que está sendo copiado junto com o fluxo de mensagens.
A pasta Variáveis na árvore do ambiente local é definida como xsd:any. Ao incluir a árvore do ambiente local, é possível ver a estrutura das pastas de destino com todos os seus elementos e uma pasta Variáveis com um único elemento definido com um tipo genérico.
É possível definir manualmente os elementos que são incluídos na pasta Variáveis. Não há uma estrutura predefinida para a pasta Variáveis. Cada fluxo de mensagens possui seu própria pasta Variáveis da árvore do ambiente local. Por essa razão, se você deseja acessar algum desses elementos em seu mapa de mensagem, deverá definir cada elemento que deseja usar no mapa de mensagem usando a função Cast.
Nota:
- É possível usar a função Cast para definir explicitamente outros elementos no conjunto da mensagem do mapa de mensagem.
- No WebSphere Message
Broker, a árvore do ambiente local predefine outras pastas para refletir os dados criadas e usados pelos nós WebSphere Message
Broker.
Neste cenário, você cria um elemento denominado Country na pasta Variáveis do ambiente local a ser usada por outros nós posteriormente no fluxo de mensagens para roteamento.
Procedimento
Para incluir o elemento Country na pasta Variáveis da árvore do ambiente local, conclua as etapas a seguir:
- Defina uma transformação Mover entre a árvore do ambiente local de entrada e a árvore do ambiente local de saída. Crie uma conexão entre a árvore do ambiente local de entrada e a árvore do ambiente local de saída. É possível fazer isto de quaisquer
das maneiras a seguir:
- No mapa de mensagem, clique com o botão direito na árvore do ambiente local de entrada e selecione Criar Conexão. Mova o mouse para a árvore do ambiente local de saída e clique no ambiente local para definir a transformação Mover.
- No mapa de mensagem, clique com o botão direito na árvore do ambiente local de entrada e selecione Link Rápido. Uma nova janela aparece, em que é possível selecionar o ambiente local do elemento de saída. Use essa opção quando tiver uma longa lista de elementos de saída. Também é possível filtrar a lista em Link Rápido.
Se você precisar modificar apenas alguns campos na árvore de ambiente local, poderá usar uma transformação Mover para copiar a árvore do ambiente local inalterada e, em seguida, usar a função Substituir para modificar os elementos que devem ser atualizados.
A figura a seguir mostra graficamente como a transformação Mover é definida entre a árvore do ambiente local de entrada e a árvore do ambiente local de saída.
Todos os valores de entrada são copiados para os valores de saída.
- Crie um arquivo de esquema em seu aplicativo, serviço, ou biblioteca para definir os elementos da pasta Variáveis da árvore do ambiente local e seu tipo:
- No visualização Desenvolvimento de Aplicativos , selecione . Clique em Avançar.
- Selecione Criar um arquivo de esquema XML vazio; irei modelar meus dados usando o editor de esquema XML e, em seguida, clique em Avançar.
- Crie o arquivo XSD LEVariablesFolderStructure.xsd no projeto AddressBookProvider. Em seguida clique em Concluir.
- O arquivo LEVariablesFolderStructure.xsd é aberto em uma nova guia na qual você usa o editor de Esquema XML para definir suas variáveis e seus tipos.
Em nosso exemplo, definimos o esquema a seguir:
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="Country" type="xsd:string"/>
<xsd:element name="CountryCode" type="xsd:integer"/>
</xsd:schema>
Nota: Em nosso exemplo, os nós que leem esses elementos requerem que eles não sejam namespaced. Por esse motivo, o esquema também é definido sem uma declaração de namespace.
- Use a função Cast para definir as variáveis de ambiente local no mapa de mensagem, de modo que eles sejam visíveis na pasta Variáveis no mapa. Conclua as etapas a seguir para converter o elemento any em uma variável e seu tipo na árvore do ambiente local de saída:
- Clique com o botão direito no elemento any e, em seguida, selecione Cast.
- Na janela Seleção de Tipo, selecione Country e, em seguida, clique em OK.
Resultados
Agora, você definiu uma variável do ambiente local que pode ser usada por outros nós em seu fluxo de mensagens para roteamento ou filtragem.
Você pode ver o elemento Country no ambiente local na pasta Variáveis no mapa de mensagem.
O que Fazer Depois
Configure o mapa de mensagem para incluir a mensagem SOAP.
Para obter informações adicionais, consulte Configurando o mapa de mensagem para incluir a mensagem SOAP.