Establecimiento de las propiedades definidas por el usuario en tiempo de ejecución utilizando una aplicación de integración personalizada

Utilice API de integración de IBM® para consultar, descubrir y establecer dinámicamente propiedades definidas por el usuario de flujo de mensajes en tiempo de ejecución. Puede utilizar API de integración de IBM para establecer propiedades con un tipo de datos de carácter.

Antes de empezar

Para que se puedan descubrir las propiedades definidas por el usuario en un flujo de mensajes, éste debe cumplir con las condiciones siguientes:
  • El flujo de mensajes debe contener al menos uno de los nodos siguientes:
    • JavaCompute
    • Calcular
    • Base de datos
    • Filter
  • El flujo de mensajes debe definir la propiedad definida por el usuario relevante y proporcionar un valor de alteración temporal.

Acerca de esta tarea

Consejo: Utilice nombres y valores significativos para las propiedades que defina, para que pueda comprender su propósito e intención rápidamente. Por ejemplo, una propiedad definida por el usuario con el nombre property01 cuyo valor inicial sea valueA no es tan práctica como una propiedad cuyo nombre sea RouteToAorB y su valor inicial RouteA.

Para consultar, descubrir y establecer propiedades definidas por el usuario en un flujo de mensajes, utilice API de integración de IBM para emitir las llamadas siguientes. Para obtener detalles sobre las llamadas, incluida la sintaxis y los parámetros que se deben utilizar, consulte la documentación de API de integración de IBM (API de integración de IBM).

Procedimiento

  1. Llame a MessageFlowProxy.getUserDefinedPropertyNames () para recuperar una lista de todas las propiedades definidas por el usuario definidas por el Editor de flujos de mensajes en el flujo de mensajes o subflujos.

    Se devuelve una matriz de serie que contiene los nombres de las propiedades.

  2. Llame a MessageFlowProxy.getUserDefinedProperty () para recuperar el valor de la propiedad definida por el usuario especificada.

    El valor de la propiedad se devuelve como un valor de Java™.lang.String.

  3. Llame a MessageFlowProxy.setUserDefinedProperty () para establecer un nuevo valor para la propiedad definida por el usuario especificada.

    La propiedad debe existir. No puede cambiar el tipo de datos de la propiedad definida por el usuario existente (java.lang.String); por lo tanto, debe asegurarse de que el nuevo valor cumple con el tipo de datos existente.

    El valor que establezca con la llamada MessageFlowProxy.setUserDefinedProperty() se rellena en todos los nodos relevantes del flujo de mensajes, incluidos los nodos contenidos en los subflujos.