Promoción de una propiedad

Puede promocionar una propiedad de nodo al nivel del flujo de mensajes para simplificar el mantenimiento del flujo de mensajes y sus nodos, y proporcionar valores comunes para varios nodos del flujo al hacer convergir propiedades promocionadas.

Antes de empezar

Para realizar esta tarea, debe haber completado la tarea siguiente:

Para promocionar propiedades de nodos de flujos de mensajes a nivel del flujo de mensajes:

  1. Conmute a la perspectiva Desarrollo de aplicaciones de intermediario.
  2. Abra el flujo de mensajes para el que desea promocionar propiedades efectuando una doble pulsación en el flujo de mensajes en la vista Navegador. También puede abrir el flujo de mensajes pulsando el botón derecho del ratón en la vista Navegador y, a continuación, pulsando en Abrir El contenido del flujo de mensajes se muestra en la vista del editor.

    Si es el primer flujo de mensajes que abre, a la izquierda de la vista del editor también se muestra la ventana de control de flujo de mensajes y la lista de nodos de flujos de mensajes incorporados disponibles.

  3. En la vista del editor, pulse el botón derecho del ratón en el símbolo del nodo de flujo de mensajes cuyas propiedades desea promocionar y, a continuación, pulse en Promocionar propiedad. Se muestra el diálogo Promoción de propiedad. En la parte izquierda del diálogo se listan todas las propiedades disponibles para todos los nodos del flujo de mensajes. Las propiedades del nodo que ha resaltado están ampliadas.

    Desde este diálogo, puede acceder a todas las propiedades de los nodos, sin tener en cuenta el nodo que se ha seleccionado al abrir el diálogo, al ampliar las propiedades de todos los demás nodos del flujo (inicialmente, están comprimidas).

    En la parte de la derecha se listan todas las propiedades que están promocionadas actualmente para el flujo de mensajes. Si aún no ha promocionado ninguna propiedad, a la derecha sólo se muestra el nombre del flujo de mensajes como directorio raíz del árbol de propiedades promocionadas.

    Casi todas las propiedades de los nodos de flujos de mensajes están disponibles para la promoción, pero no se pueden promocionar:

    • Las propiedades que denominan módulos ESQL y de correlación.
    • Un grupo de la propiedad, pero se puede promocionar una propiedad individual.
    • Una propiedad que no se puede editar (por ejemplo, la propiedad Arreglo del grupo de propiedades Validar del nodo MQInput).
    • Las propiedades de la descripción (Descripción corta y Descripción larga).
  4. Cree nuevos grupos de propiedades para su promoción. Encima de la lista de propiedades promocionadas, a la derecha se muestran tres iconos: el icono de nuevo grupo (situado a la izquierda), el icono de nueva propiedad (situado en el centro) y el icono de suprimir (situado a la derecha):

    Cuando crea una nueva propiedad promocionad, el nombre que especifica es el nombre por el que se conoce a la propiedad en el sistema y debe cumplir determinadas limitaciones de denominación Java y XML, que impone el diálogo y, si se indica un nombre que incluye un carácter no válido, se muestra un mensaje. Por ejemplo, no puede incluir un espacio o símbolo de comillas.

    Si desarrolla un flujo de mensajes en un proyecto definido por el usuario que se va a entregar como un plug-in de Eclipse, puede añadir conversión para las propiedades promocionadas que ha añadido. Los nombres convertidos pueden contener caracteres restringidos para nombres del sistema como, por ejemplo, espacios. La opción de proporcionar series de caracteres convertidos para propiedades promocionadas no está disponible si se trabaja con un flujo de mensajes de un proyecto de flujo de mensajes.

    1. Pulse el botón en el icono de nuevo grupo Icono de nuevo grupo (representación del diálogo de propiedades al que se ha impuesto un grupo de pequeños recuadros coloreados) para añadir un nuevo grupo de las propiedades promocionadas. El grupo se añade debajo del directorio raíz de flujos de mensajes y se le proporciona el nombre por omisión de Group1 (a menos que ya se hayan creado grupos que tengan nombres por omisión, en cuyo caso se proporciona al nombre del nuevo grupo el número más alto siguiente).

      El campo de nombre se muestra resaltado; sobreescríbalo para redenominar el grupo al crearlo. También puede redenominar el grupo más adelante, cuando lo desee, efectuando una doble pulsación en el nombre.

    2. Pulse el botón en el icono de nueva propiedad Icono de nueva propiedad (representación del diálogo de propiedades al que se ha impuesto un pequeño recuadro verde) para añadir una nueva propiedad promocionada en el grupo seleccionado actualmente (o a continuación de la propiedad seleccionada actualmente). La propiedad se añade debajo del grupo resaltado y se le proporciona el nombre por omisión de Property1 (a menos que ya se hayan creado propiedades que tengan nombres por omisión, en cuyo caso se proporciona al nombre de la nueva propiedad el número más alto siguiente).

      El campo de nombre se muestra resaltado; sobreescríbalo para redenominar la propiedad al crearla. También puede redenominar la propiedad en cualquier momento, efectuando una doble pulsación en el nombre.

    3. Pulse el botón en el icono de supresión Icono de supresión (una cruz roja) para suprimir la propiedad o el grupo seleccionado actualmente. Si suprime un grupo, todas las propiedades promocionadas del grupo se suprimen de la lista situada a la derecha. No existe ninguna confirmación de la acción de supresión. No obstante, las propiedades promocionadas suprimidas se devuelven a la lista situada a la izquierda, donde vuelven a estar disponibles para su promoción.
  5. Seleccione la propiedad que desea promocionar al nivel del flujo de mensajes de la lista de propiedades disponibles, situada a la izquierda del diálogo Promoción de propiedad. La lista situada a la izquierda muestra, inicialmente, la lista ampliada de todas las propiedades disponibles para el nodo seleccionado. Si ya ha promocionado propiedades de este nodo, éstas no aparecen a la izquierda, sino a la derecha.

    La lista situada a la izquierda también incluye los nodos restantes en este flujo de mensajes. Puede ampliar las propiedades que se listan en cada nodo y trabajar con todas las propiedades al mismo tiempo. Para continuar promocionando propiedades, no es necesario que cierre el diálogo y seleccione otro nodo de la vista del editor.

  6. para promocionar una propiedad de un nodo de flujo de mensajes para el flujo de mensajes, arrastre la entrada de la lista situada a la izquierda del diálogo Promoción de propiedad a la lista situada a la derecha:
    1. Puede soltar la propiedad en un espacio vacío. Automáticamente, se crea un nuevo grupo para el flujo de mensajes y se coloca la propiedad en el mismo, con el nombre original de la propiedad. El nombre del nodo de flujo de mensajes del que procede se muestra debajo de la entrada de la propiedad.

      Al nuevo grupo se le proporciona un nombre que toma el valor por omisión de Group1. Si el grupo Group1 ya existe, el nombre por omisión siguiente es Group2 y así sucesivamente. Redenomine el grupo efectuando una doble pulsación en el mismo y entrando nuevo texto.

    2. Puede soltarla en un grupo que ya existe, a fin de agrupar propiedades relacionadas del mismo o de nodos diferentes en el flujo de mensajes. Por ejemplo, es posible que desee agrupar todas las propiedades promocionadas que se relacionan con interacciones de base de datos.
    3. Puede soltarla en una propiedad que ya existe, a fin de hacer convergir propiedades relacionadas el mismo o de nodos diferentes en el flujo de mensajes (se describe con más detalle en el apartado Convergencia de varias propiedades) Por ejemplo, es posible que desee crear una única propiedad promocionada que altere temporalmente la propiedad de cada nodo que defina un origen de datos.
    Puede redenominar la propiedad promocionada (consulte el apartado Redenominación de una propiedad promocionada), pero no puede actualizar su identificación original. De este modo, se garantiza que siempre podrá determinar los nodos específicos que son el origen de cada propiedad promocionada, sin tener en cuenta el nombre de la propiedad promocionada.
  7. Después de seleccionar las propiedades que desea promocionar para el flujo de mensajes, pulse el botón en Aceptar Las actualizaciones se confirman y el diálogo se cierra. Si pulsa en Aplicar, se confirman los cambios, pero el diálogo Promoción de propiedad permanece abierto.

    Una vez que ha promocionado una propiedad, ya no puede realizar ningún cambio en la misma a través del diálogo de propiedades de nodo. Sólo puede actualizar su valor a nivel del flujo de mensajes.

Las propiedades del nodo de flujo de mensajes ya se han promocionado al flujo de mensajes. Si desea confirmarlo, pulse el botón derecho del ratón en el flujo de mensajes de la vista Navegador, o bien, pulse el botón derecho del ratón en la vista del editor y, a continuación, seleccione Propiedades.

Se visualiza el diálogo Propiedades del flujo de mensajes, en el que se muestran las propiedades del nodo de flujo de mensajes que se han promocionado, organizadas en los grupos que se han creado. Si, ahora, establece un valor para una de estas propiedades, el valor aparece como valor por omisión para la propiedad siempre que se incluya el flujo de mensajes en otros flujos de mensajes.

Cuando selecciona un flujo de mensajes intercalado de otro flujo de mensajes (un subflujo) y visualiza sus propiedades, se muestran los valores de las propiedades promocionadas. Si observa en el interior del flujo intercalado (es decir, si selecciona Abrir subflujo), se muestran los valores originales de las propiedades. El valor de una propiedad promocionada no sustituye la propiedad original, pero tiene prioridad al difundir el flujo de mensajes.

Promoción de propiedades obligatorias

Si promociona una propiedad que es obligatoria (es decir, aparece un asterisco junto al nombre en el diálogo de propiedades del nodo de flujo de mensajes), se conserva la característica obligatoria de la propiedad. Debe establecer siempre un valor para cada una de las propiedades obligatorias a nivel del nodo, aunque prevea promocionar la propiedad a nivel del flujo de mensajes y, así, alterarla temporalmente.

Promoción de propiedades a través de una jerarquía que flujos de mensajes

Puede repetir el proceso de promoción de propiedades de nodo de flujo de mensajes a través de varios niveles de flujo de mensajes. Puede promocionar propiedades de cualquier nivel de la jerarquía al nivel de arriba siguiente, y así sucesivamente a través de la jerarquía hasta el nivel superior. Cuando se difunde el flujo de mensajes a un intermediario, el valor de una propiedad se propaga desde el punto más alto de la jerarquía en el que se ha establecido hasta el nodo de flujo de mensajes original. El valor de la propiedad del nodo de flujo de mensajes original se altera temporalmente.

Conceptos relacionados
Propiedades promocionadas
Difusión de aplicaciones de flujos de mensajes

Tareas relacionadas
Definición de propiedades promocionadas
Redenominación de una propiedad promocionada
Convergencia de varias propiedades
Eliminación de una propiedad promocionada
Edición de propiedades configurables

Referencia relacionada
Nodos incorporados