Nomes de Correlação

Um nome de correlação é uma referência de campo que identifica um ponto inicial bem definido na árvore de mensagem lógica e é utilizado nas referências de campo para descrever uma parte padrão do formato da árvore.

Ao acessar os dados de acesso em alguma das quatro árvores (mensagem, ambiente, ambiente local ou lista de exceção), os nomes de correlação que podem ser utilizados dependem do nó para o qual você cria ESQL ou mapeamentos e se o nó cria uma mensagem de saída. Por exemplo, um nó Trace não altera o conteúdo da mensagem à medida que passa pelo nó, mas um nó Compute pode construir uma nova mensagem de saída.

Você pode apresentar novos nomes de correlação com expressões SELECT, predicados quantificados e instruções FOR. Você pode criar nomes de não-correlação em um nó utilizando variáveis de referência.

Nomes de Correlação nos Nós que Não Criam uma Mensagem de Saída

A maioria dos nós de fluxo de mensagens não cria uma mensagem de saída; todas as expressões ESQL que você gravar em módulos ESQL ou em mapeamentos dentro desses nós farão referência apenas à mensagem de entrada. Utilize os seguintes nomes de correlação nos módulos ESQL que você grava para os nós Banco de Dados e Filtro:

Root
A raiz da mensagem que é transmitida pelo nó.
Body
O último filho da raiz da mensagem; isto é, o corpo da mensagem. Esse nome é um alias para Root.*[<].

Para obter uma descrição de como utilizar o asterisco (*) nas referências de campo, consulte Utilizando Referências de Campos Anônimos.

Properties
As propriedades padrão da mensagem de entrada.
Environment
A estrutura que contém as variáveis de ambiente globais atuais que estão disponíveis ao nó. O Ambiente pode ser lido e atualizado a partir de qualquer nó para o qual você possa criar código ou mapeamentos do ESQL.
LocalEnvironment
A estrutura que contém as variáveis de ambiente locais atuais que estão disponíveis ao nó. O LocalEnvironment pode ser lido e atualizado a partir de qualquer nó para o qual você possa criar código ou mapeamentos do ESQL.
DestinationList
A estrutura que contém as variáveis de ambiente local atuais disponíveis para o nó. Seu nome preferencial é LocalEnvironment, embora o nome de correlação DestinationList possa ser utilizado para compatibilidade com versões anteriores.
ExceptionList
A estrutura que contém a lista de exceções atuais à qual o nó tem acesso.

Não é possível utilizar esses nomes de correlação na expressão de qualquer mapeamento para um nó Mapping, Extract, Warehouse, DataInsert, DataUpdate ou DataDelete.

Nomes de Correlação nos Nós que Criam uma Mensagem de Saída

Se você estiver codificando ESQL para um nó Cálculo, os nomes de correlação deverão distinguir entre as duas árvores de mensagens envolvidas: a mensagem de entrada e a mensagem de saída. Os nomes de correlação em ESQL nesses nós são:

InputBody
O último filho da raiz da mensagem de entrada. Esse nome é um alias para InputRoot.*[<].

Para obter uma descrição de como utilizar *, consulte Utilizando Referências de Campos Anônimos.

InputRoot
A raiz da mensagem de entrada.
InputProperties
As propriedades padrão da mensagem de entrada.
Environment
A estrutura que contém as variáveis de ambiente globais atuais que estão disponíveis ao nó. O ambiente pode ser lido e atualizado.
InputLocalEnvironment
A estrutura que contém as variáveis de ambiente local para a mensagem que passa pelo nó.
InputDestinationList
A estrutura que contém as variáveis de ambiente local para a mensagem que passa pelo nó. Utilize o nome de correlação InputDestinationList para compatibilidade com versões anteriores; se a compatibilidade não for necessária, utilize o nome preferencial InputLocalEnvironment
InputExceptionList
A estrutura que contém a lista de exceções para a mensagem que passa pelo nó.
OutputRoot
A raiz da mensagem de saída.

Em um nó Cálculo, o nome de correlação OutputBody não é válido.

OutputLocalEnvironment
A estrutura que contém as variáveis de ambiente locais que são enviadas do nó.

Embora esse nome de correlação seja sempre válido, ele apenas tem significado quando a propriedade Modo Computar do nó Compute indica que o nó Compute está propagando o LocalEnvironment.

OutputDestinationList
A estrutura que contém as variáveis de ambiente locais que são enviadas do nó. Utilize o nome de correlação OutputDestinationList para compatibilidade com versões anteriores; se a compatibilidade não for necessária, utilize o nome preferencial OutputLocalEnvironment
OutputExceptionList
A estrutura que contém a lista de exceções que o nó está gerando.

Embora esse nome de correlação seja sempre válido, ele apenas tem significado quando a propriedade Modo Computar do nó Compute indica que o nó Compute está propagando a ExceptionList.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:36

ac00510_