A árvore Ambiente Local é uma parte da árvore de mensagem lógica na qual você pode armazenar informações enquanto o fluxo de mensagens processa a mensagem.
A raiz da árvore LocalEnvironment é chamada de LocalEnvironment. Essa árvore está sempre presente na mensagem de entrada: uma árvore Ambiente Local vazia é criada quando uma mensagem é recebida pelo nó de entrada.
Utilize a árvore LocalEnvironment para armazenar variáveis que podem ser referidas e atualizadas por nós de processamento de mensagens que ocorrem posteriormente no fluxo de mensagens. Você também pode utilizar a árvore Ambiente Local para definir destinos (que são internos e externos ao fluxo de mensagens), para os quais uma mensagem é enviada. também armazena informações no Ambiente Local em algumas circunstância e faz referências a ele para acessar valores que você pode ter definido para os destinos. (Compare isso com o Árvore de Ambiente, que o intermediário menciona em apenas uma situação)
A figura abaixo mostra a estrutura da árvore Ambiente Local em uma mensagem analisada por um analisador fornecido. Os filhos de Destino são dependentes de protocolo. O exemplo abaixo mostra a estrutura para uma mensagem do . Se a mensagem for analisada por outro analisador interno, ou por um analisador definido pelo usuário, a estrutura da árvore abaixo do elemento Destino terá conteúdo diferente do mostrado na figura.
Na estrutura em árvore mostrada acima, Ambiente Local possui três filhos:
As variáveis definidas podem ser alteradas por qualquer nó do processamento de mensagens que gera uma mensagem de saída e elas persistem no ambiente local a partir do ponto no fluxo de mensagens no qual elas são criadas até que a mensagem seja consolidada. Se o fluxo de mensagens for retornado (por exemplo, a um nó FlowOrder), essas variáveis serão perdidas.
As variáveis nessa subárvore são persistentes apenas em uma única instância de um fluxo de mensagens. Se você tiver várias instâncias de uma mensagem que passa pelo fluxo de mensagens e precisar transmitir informações entre elas, será necessário utilizar um banco de dados externo.
As informações de transporte são utilizadas por alguns nós de entrada e saída.
Se o fluxo de mensagens for iniciado com um nó HTTPInput, um único elemento de nome HTTP será incluído ao Destino. O elemento HTTP.RequestIdentifier é criado e inicializado para que possa ser utilizado por um nó HTTPReply. Você também pode criar outros campos na estrutura HTTP para uso pelo nó HTTPRequest, por exemplo, o URL do serviço ao qual o pedido é enviado. O tópico de cada nó contém informações adicionais sobre o conteúdo de Destino para o protocolo .
Se o fluxo de mensagens incluir um nó MQOutput, cada elemento será um elemento de nome exclusivo, que pode ser MQ ou MQDestinationList. Se existir mais de um elemento, cada um será será processado pelo nó de forma seqüencial. Os dois nomes não são aliases verdadeiros: qualquer um que você escolher para utilizar, cada referência ao elemento deverá ter o mesmo nome.
Se o fluxo de mensagens incluir um nó MQeOutput, cada elemento será um elemento de nome único que deve ser MQe. Se existir mais de um elemento, cada um será processado pelo nó de forma seqüencial.
O nó SCADAOutput não permite definir destinos de saída na árvore LocalEnvironment.
Se você incluiu um nó de saída definido pelo usuário no fluxo de mensagens, o conteúdo do Destino (se suportado) será definido por esse nó.
Você pode configurar os nós de saída para examinar a lista de destinos e enviar a mensagem para aqueles destinos, definindo as propriedades Modo de Destino como Lista de Destinos. Se fizer isso, deverá criar essa subárvore e seu conteúdo para definir esses destinos, fornecendo a ela o nome de Destino. Se isso não for feito, o nó de saída não poderá entregar as mensagens.
Se preferir, você poderá configurar o nó de saída para enviar mensagens para um único destino fixo, definindo a propriedade Modo de Destino como Nome da Fila ou como Responder à Fila. Se você selecionar qualquer uma dessas opções fixas, a lista de destinos não terá nenhum efeito nas operações do intermediário e não será necessário criar essa subárvore.
Você pode construir os elementos MQ ou MQe para conter um único elemento opcional Padrões. O elemento Padrões, se criado, deverá ser o primeiro filho e deverá conter um conjunto de elementos de nome/valor que fornecem os valores padrão para o destino da mensagem e suas opções PUT para esse pai.
Você também pode criar vários elementos chamados Dados de Destino no MQ e MQe. Cada um deles pode ser configurado com um conjunto de elementos de nome/valor que definem um destino de mensagem e suas opções PUT.
O conjunto de elementos que definem um destino é descrito em Tipos de Dados para Elementos na Subárvore Dados de Destino.
O conteúdo de cada instância de Dados de Destino é igual ao conteúdo de Padrões para cada protocolo e pode ser utilizado para substituir os valores padrão em Padrões. Você pode configurar Padrões para conter valores que são comuns a todos os destinos e definir apenas os valores exclusivos em cada subárvore DestinationData. Se um valor não estiver definido em DestinationData ou em Defaults, será utilizado o valor definido para a propriedade do nó correspondente.
As informações inseridas em Dados de Destino dependem da característica da propriedade do nó correspondente: isto é descrito em Acessando a Árvore Ambiente Local.
O filho de Destino é Lista de Roteadores. Ele possui um único elemento filho chamado Dados de Destino, que possui uma única entrada chamada Nome do Rótulo. Se estiver utilizando um cenário de roteamento dinâmico que envolve os nós RouteToLabel e Label, será necessário configurar a subárvore Destino com um Lista de Roteadores que contenha os rótulos de referência.
O tópico de cada nó de saída contém informações adicionais sobre o conteúdo de Destino da Escrita para e .
Quando o processamento do fluxo de mensagens estiver concluído, a árvore Ambiente Local será descartada.
Conceitos relacionados
Modelagem de Mensagens
Árvore de Ambiente
Tarefas relacionadas
Desenvolvendo Aplicativos do Fluxo de Mensagens
Criando Listas de Destino
Acessando a Árvore Ambiente Local
Utilizando Áreas do Bloco de Rascunho em Ambiente Local
Referências relacionadas
Nós Internos
Nó FlowOrder
Nó HTTPReply
Nó HTTPRequest
Nó MQeOutput
Nó MQOutput
Nó SCADAOutput
Tipos de Dados para Elementos na Subárvore Dados de Destino
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ac00520_ |