Árvore de Propriedades

A árvore de propriedades é o primeiro elemento da árvore de mensagens e contém informações sobre as características da mensagem.

A raiz da árvore de propriedades é chamada de Propriedades. É o primeiro elemento sob Raiz. Todas as árvores de mensagens geradas pelos analisadores internos incluem uma árvore de propriedades para a mensagem. Se você criar seu próprio analisador definido pelo usuário, poderá escolher se o analisador criará uma árvore de propriedades. No entanto, para consistência, é recomendável incluir essa ação no analisador definido pelo usuário.

A árvore de propriedades é criada e inserida na árvore após todos os cabeçalhos, mas precedendo os dados da mensagem. Ela contém um conjunto de propriedades padrão que pode ser manipulado nos nós do fluxo de mensagens da mesma forma que qualquer outra propriedade. A maioria desses campos são mapeados para campos nos cabeçalhos suportados do , se presentes, e são transmitidos para o analisador apropriado quando uma mensagem é entregue de um nó para outro.

Por exemplo, o cabeçalho MQRFH2 contém informações sobre o conjunto de mensagens, o tipo e formato. Esses valores são armazenados na árvore de propriedades como MessageSet, MessageType e MessageFormat. Para acessar esses valores utilizando ESQL dentro dos nós de processamento de mensagens, consulte esses valores na árvore Properties; não consulte diretamente nos campos nos cabeçalhos dos quais eles são derivados.

Se a mensagem for convertida em um fluxo de bits, por exemplo, em um nó de saída, quaisquer propriedades restantes apenas na árvore de propriedades (ou seja, que não estão em nenhum cabeçalho nas mensagens de saída) não serão incluídas em nenhuma parte da mensagem de saída.

O analisador de Propriedades assegura que os valores nos campos do cabeçalho correspondam aos valores na árvore de propriedades na entrada para, e na saída de cada nó. Na saída de um nó, o analisador de Propriedades chama cada analisador de cabeçalho com os valores que ele contém atualmente. Ele então solicita os valores novamente do analisador do cabeçalho e atualiza seus próprios valores. Se você codificou ESQL no nó que atualiza valores na árvore de propriedades ou no cabeçalho ou em ambos, esses valores serão sempre correspondentes quando a árvore for transmitida a partir desse nó. No entanto, se você tiver atualizado um campo na árvore de propriedades e no cabeçalho com valores diferentes, o valor definido no cabeçalho será sobrescrito pelo valor definido na árvore de propriedades.

Quando o processamento do fluxo de mensagens estiver concluído, a árvore de propriedades será descartada.

Conceitos relacionados
Modelagem de Mensagens
Nomes de Correlação

Tarefas relacionadas
Desenvolvendo Aplicativos do Fluxo de Mensagens
Acessando a Árvore de Propriedades

Referências relacionadas
Nós Internos