Nombres de correlación

Un nombre de correlación es una referencia de campo que identifica un punto de inicio bien definido en el árbol lógico de mensajes y que se utiliza en las referencias de campo para describir un componente estándar del formato del árbol.

Cuando accede a los datos de cualquiera de los cuatro árboles (mensajes, entorno, entorno local o lista de excepciones), los nombres de correlación que puede utilizar dependen del nodo para el que crea ESQL o correlaciones y de si el nodo crea un mensaje de salida. Por ejemplo, el nodo Trace no modifica el contenido del mensaje a medida que lo pasa a través del nodo, pero el nodo Compute puede crear un nuevo mensaje de salida.

Puede entrar nuevos nombres de correlación con expresiones SELECT, predicados cuantificados y sentencias FOR. Puede crear nombres que no sean de correlación en un nodo utilizando variables de referencia.

Nombres de correlación en nodos que no crean un mensaje de salida

Inicio del cambioLa mayor parte de los nodos de flujos de mensajes no crean ningún mensaje de salida; todas las expresiones ESQL que se escriben en módulos ESQL o en correlaciones dentro de dichos nodos sólo hacen referencia al mensaje de entrada. Puede utilizar los nombres de correlación siguientes en nodos Database y Filter (módulos ESQL). Estos nombres de correlación no se pueden utilizar en expresiones de correlación para los nodos Mapping, Extract, Warehouse, DataInsert, DataUpdate o DataDelete.Fin del cambio

Root
Directorio raíz del mensaje que pasa a través del nodo.
Body
Último elemento dependiente del directorio raíz del mensaje, que es el cuerpo del mensaje. Es un alias para Root.*[<].

En el apartado Utilización de referencias de campo anónimas obtendrá una descripción completa sobre cómo utilizar *.

DestinationList
Estructura que contiene las variables de entorno local disponibles para el nodo. El nombre preferido es LocalEnvironment, aunque se puede utilizar el nombre de correlación DestinationList para la compatibilidad con versiones anteriores.
Properties
Propiedades estándar del mensaje de entrada.
ExceptionList
Estructura que contiene la lista de excepciones actual a la que el nodo tiene acceso.
Environment
Estructura que contiene las variables de entorno globales disponibles para el nodo. El entorno se puede leer y actualizar desde cualquier nodo para el que pueda crear código ESQL o correlaciones.
LocalEnvironment
Estructura que contiene las variables de entorno local disponibles para el nodo. El entorno local se puede leer y actualizar desde cualquier nodo para el que pueda crear código ESQL o correlaciones.

Nombres de correlación en nodos que crean un mensaje de salida

Si codifica ESQL para un nodo Compute, los nombres de correlación son diferentes, puesto que hay dos árboles de mensajes implicados: el mensaje de entrada y el mensaje de salida. Los nombres de correlación de ESQL dentro de estos nodos son los siguientes:

Environment
Estructura que contiene las variables de entorno globales disponibles para el nodo. El entorno se puede leer y actualizar.
InputRoot
Directorio raíz del mensaje de entrada.
InputBody
Último elemento dependiente del directorio raíz del mensaje de entrada. Es un alias para InputRoot.*[<].

En el apartado Utilización de referencias de campo anónimas obtendrá una descripción completa sobre cómo utilizar *.

InputProperties
Propiedades estándar del mensaje de entrada.
InputDestinationList
Estructura que contiene las variables de entorno local para el mensaje que pasa a través del nodo. Utilice el nombre de correlación InputDestinationList para la compatibilidad con versiones anteriores; si no se requiere compatibilidad, utilice el nombre preferido InputLocalEnvironment
InputExceptionList
Estructura que contiene la lista de excepciones para el mensaje que pasa a través del nodo.
InputLocalEnvironment
Estructura que contiene las variables de entorno local para el mensaje que pasa a través del nodo.
OutputRoot
Directorio raíz del mensaje de salida.

En un nodo Compute, no existe el nombre de correlación OutputBody.

OutputDestinationList
Estructura que contiene las variables de entorno local que se envían desde el nodo. Utilice el nombre de correlación OutputDestinationList para la compatibilidad con versiones anteriores; si no se requiere compatibilidad, utilice el nombre preferido OutputLocalEnvironment
OutputExceptionList
Estructura que contiene la lista de excepciones que genera el nodo.

Mientras que este nombre de correlación siempre es válido, sólo tiene significado cuando la propiedad Modalidad de cálculo del nodo Compute indica que el nodo Compute está propagando ExceptionList.

OutputLocalEnvironment
Estructura que contiene las variables de entorno local que se envían desde el nodo.

Mientras que este nombre de correlación siempre es válido, sólo tiene significado cuando la propiedad Modalidad de cálculo del nodo Compute indica que el nodo Compute está propagando el LocalEnvironment.

Conceptos relacionados
Árbol Environment
Árbol LocalEnvironment
Árbol ExceptionList
Referencias de campo ESQL
Diseño de mensajes

Tareas relacionadas
Desarrollo de aplicaciones de flujos de mensajes
Manipular el contenido del cuerpo del mensaje
Manipulación de otras partes del árbol de mensajes
Utilización de referencias de campo anónimas

Referencia relacionada
Nodos incorporados
Nodo Compute
Nodo Database
Nodo Filter