A estrutura da árvore lógica é uma representação interna (broker) de uma mensagem. Também é conhecida como a montagem da mensagem.
Quando uma mensagem chega em um broker, ela é recebida por um nó input que foi configurado em um fluxo de mensagens. Antes de a mensagem ser processada pelo fluxo de mensagens, a mensagem deve ser interpretada por um ou mais analisadores que criam uma representação de árvore lógica a partir do fluxo de bits dos dados da mensagem.
O formato da árvore tem conteúdo idêntico ao fluxo de bits a partir do qual ele é criado, mas é mais fácil de manipular no fluxo de mensagens. Muitos dos nós do fluxo de mensagens integrado fornecem uma interface para você consultar e atualizar o conteúdo de mensagem da árvore e executar outras ações com relação a mensagens e bancos de dados para ajudá-lo a fornecer a função necessária em cada nó.
Várias interfaces são fornecidas:
A estrutura da árvore criada pelos analisadores é amplamente independente de qualquer formato de mensagem (por exemplo, XML). A exceção para isso é a subárvore que é criada como parte da árvore de mensagens para representar o corpo da mensagem. Essa subárvore é dependente da mensagem e seu conteúdo não é descrito com detalhes adicionais aqui.
O nó de entrada cria essa montagem de mensagem, que consiste em quatro árvores:
A primeira dessas árvores é preenchida com o conteúdo do fluxo de bits da mensagem de entrada, conforme descrito em Como a Árvore de Mensagem É Preenchida; as três árvores restantes estão inicialmente vazias.
Cada uma das quatro árvores criadas possui um elemento raiz (com um nome que é específico de cada árvore). Cada árvore é composta de várias partes distintas de informações chamadas elementos. O elemento raiz não possui pai e nem irmãos (irmãos são elementos que compartilham um único pai). A raiz é pai de vários elementos filhos. Cada filho deve ter um pai, pode ter zero ou mais irmãos e pode ter zero ou mais filhos.
As quatro árvores são criadas para nós de entrada internos e definidos pelo usuário e analisadores.
O nó de entrada transmite a montagem a mensagem que é criada para nós de processamento de mensagens subseqüentes no fluxo de mensagens:
Para determinar quais outras árvores estão incluídas, você deve especificar um valor para a propriedade modo Calcular do nó (exibida na guia Avançado). A ação padrão destina-se apenas à mensagem que será criada. É possível especificar qualquer combinação de árvores de mensagens, LocalEnvironment e ExceptionList a serem criadas na montagem da mensagem de saída.
Se quiser que a montagem da mensagem de saída contenha uma cópia completa da árvore de mensagens de entrada, é possível codificar uma única instrução ESQL SET para fazer a cópia. Se desejar que a mensagem de saída contenha um subconjunto da árvore de mensagens de entrada, você deve codificar o ESQL para copiar as partes desejadas. Em ambos os casos, sua opção de modo Calcular deve incluir Mensagem.
Se quiser que a montagem da mensagem de saída contenha todo ou parte do conteúdo de entrada da árvore LocalEnvironment ou ExceptionList, codifique o ESQL apropriado para copiar as informações que deseja reter nessa árvore. A opção de Modo Computar deve incluir LocalEnvironment, ou Exception, ou ambos.
Você também pode codificar o ESQL para ocupar a mensagem de saída, a árvore Ambiente, Ambiente Local ou Lista de Exceções com informações que não foram copiadas da árvore de entrada. Por exemplo, você pode recuperar dados de um banco de dados ou calcular o conteúdo dos dados da mensagem de entrada.