Propiedades definidas por el usuario

Una propiedad definida por el usuario (UDP) es una propiedad que se define cuando el usuario construye un flujo de mensajes utilizando el Editor de flujos de mensajes. Esta propiedad puede utilizarla el programa ESQL dentro de los nodos de flujos de mensajes, como por ejemplo un nodo Compute. También puede utilizarse como una propiedad Java dentro del código Java generado por un nodo JavaCompute.

La ventaja de las UDP es que el personal de operaciones puede cambiar los valores en el tiempo de despliegue. No es necesario que cambie los programas de aplicación. Por ejemplo, si utiliza las UDP para contener datos sobre su sistema informático, puede configurar un flujo de mensajes para una máquina, tarea o entorno específico en el momento de su despliegue, sin tener que cambiar el código en el nivel del nodo de mensaje.

Cuando inicia el Editor de flujos de mensajes para crear un flujo de mensajes o para modificar un flujo de mensajes existente, además de decidir qué nodos son necesarios en el flujo de mensajes, también tiene la opción (que proporciona el separador) de definir y asignar los valores iniciales a algunas propiedades definidas por el usuario. Utilice el separador Propiedades definidas por el usuario de la parte inferir de la ventana de edición. En el apartado Editor de flujos de mensajes encontrará más información para llevar a cabo esta tarea.

Además de definirse mediante el editor de flujos de mensajes, una UDP también debe definirse utilizando una sentencia DECLARE con la palabra clave EXTERNAL en cualquier programa ESQL que la utilice, o bien mediante el método getUserDefinedAttribute en cualquier nodo JavaCompute que la utilice.

Consulte el apartado Sentencia DECLARE para obtener detalles de la sentencia DECLARE y Acceso a propiedades definidas por el usuario desde un nodo JavaCompute para obtener más información acerca de cómo utilizar una UDP en un nodo JavaCompute.

Cualquier valor que especifique para una UDP al definirla en un flujo de mensajes prevalecerá sobre el valor de esa variable en el programa ESQL o Java.

El valor de una UDP también puede modificarse durante el despliegue utilizando el editor de archivador de intermediario para editar el archivo bar. Este valor prevalece sobre cualquier valor especificado al definir el flujo de mensajes.

Cada UDP de un flujo de mensajes debe tener un valor, proporcionado cuando se declara la UDP o por el editor de flujos de mensajes o el editor de archivador de intermediario; de lo contrario se produce un error de tiempo de despliegue. En la ejecución, después de que se haya declarado la UDP, su valor se puede consultar mediante sentencias de programa subsiguientes pero no se puede modificar.

El valor de la UDP se establece a nivel de flujo y es el mismo para todos los nodos elegibles contenidos en el flujo. Un "nodo elegible" es un nodo que soporta las UDP y está en el ámbito de la declaración que declara la UDP en la aplicación. Por ejemplo, si utiliza el editor de flujos de mensajes para cambiar el valor de una propiedad de usuario denominada "timezone", que se declara en un esquema denominado "mySchema", en un flujo de mensajes denominado "myFlow", la UDP está disponible en la ejecución para todos los nodos de myFlow que soportan las UDP y están en mySchema.

De forma similar, si utiliza el editor de flujos de mensajes para cambiar el valor de una propiedad definida por el usuario en un subflujo, la propiedad recién editada está disponible para todos los nodos del subflujo que soportan las UDP y están en el ámbito de la declaración. No está disponible, por ejemplo, para nodos del flujo padre.

Conceptos relacionados
Visión general de flujos de mensajes
Variables ESQL
Inicio del cambioPropiedades definidas por el usuario en ESQLFin del cambio
Tareas relacionadas
Desarrollo de flujos de mensajes
Configuración de un flujo de mensajes en el despliegue utilizando las UDP
Inicio del cambioAcceso a propiedades definidas por el usuario desde un nodo JavaComputeFin del cambio
Referencia relacionada
Variables ESQL
Sentencia DECLARE
Editor de flujos de mensajes
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
ac00643_