WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Configurando a pasta Variáveis da árvore do ambiente local, usando a função Cast

É 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.

Antes de Iniciar

Customize o mapa de mensagem para incluir a árvore de ambiente local. Para obter informações adicionais, consulte Customizando um mapa de mensagem para incluir na á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.

Esta figura mostra graficamente como a pasta de variáveis é definida com o tipo any.

É 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:

  1. 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.

    Esta figura 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.

  2. 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 Novo... > Modelo de Mensagem ... > Outro XML. 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.
      Esta figura mostra a janela que se abre ao escolher a opção Criar um arquivo de esquema XML vazio; irei modelar os dados usando o editor de esquema XML.
    • Crie o arquivo XSD LEVariablesFolderStructure.xsd no projeto AddressBookProvider. Em seguida clique em Concluir.
      Esta figura mostra graficamente a janela que você usa para selecionar o projeto e inserir o nome do arquivo xsd.
    • 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.
  3. 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.
      Esta figura mostra graficamente as opções de menu que você escolhe para converter um elemento. 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.
      Esta figura mostra a janela Seleção de Tipo com os elementos Country e CountryCode dentro de um quadrado vermelho.

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.

Esta figura mostra graficamente o elemento Country sob o elemento any da pasta Variáveis do ambiente local.

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.