Utilice el primitivo de mediación Búsqueda de base de datos para modificar un mensaje, utilizando información de una base de datos.
El primitivo de mediación Búsqueda de base de datos puede añadir o modificar mensajes. Lo hace utilizando información de una base de datos especificada por el usuario.
Este primitivo de mediación busca valores de una base de datos y los almacena como elementos en el mensaje. Es posible que la información obtenida de la base de datos deba convertirse al tipo correcto para almacenarla en el mensaje. Se especifica utilizando la propiedad Tipo de valor de mensaje. Si la información obtenida de la base de datos no puede convertirse al tipo esperado por el mensaje, se produce una excepción.
Si ya existe un elemento de mensaje en el mensaje, el valor antiguo queda sobrescrito por el valor nuevo. Si el valor nuevo no es compatible con el tipo de elemento definido por la propiedad Tipo de valor de mensaje, se produce una excepción.
El primitivo de mediación Búsqueda de base de datos necesita distinta información de la base de datos, incluyendo una clave. La clave se encuentra utilizando una propiedad denominada Vía de acceso de claves. Si la clave Vía de acceso de claves no existe en el mensaje de entrada, se produce una excepción.
El primitivo de mediación Búsqueda de base de datos tiene un terminal de entrada y tres terminales de salida. El terminal de entrada está conectado para aceptar un mensaje y los terminales de salida están conectados para propagar un mensaje. Uno de los terminales de salida se utiliza si la clave Vía de acceso de claves se encuentra en el mensaje y en la base de datos. En este caso, la información obtenida de la base de datos se almacena en el mensaje y el mensaje actualizado se propaga. Otro terminal de salida se utiliza si la clave Vía de acceso de claves se encuentra en el mensaje, pero no en la base de datos. En este caso, el mensaje original se propaga sin cambios. El último terminal de salida se utiliza para la salida de error. Si se produce una excepción durante el proceso del mensaje de entrada, el terminal de error propaga el mensaje original, junto con información sobre la excepción.
Puede utilizar el primitivo de mediación Búsqueda de base de datos para garantizar que la información de un mensaje está actualizada.
Puede utilizar el primitivo de mediación Búsqueda de base de datos para añadir información a un mensaje, utilizando una clave contenida en un mensaje. Por ejemplo, la clave puede ser un número de cuenta.
A menudo es útil combinar el primitivo de mediación Búsqueda de base de datos con otros primitivos de mediación. Por ejemplo, puede utilizar un primitivo de mediación XSLT para manipular datos antes o después de invocar el primitivo de mediación Búsqueda de base de datos.
Propiedad | Valores válidos | Valor predeterminado | |
---|---|---|---|
Nombre del origen de datos | Serie | ||
Nombre de tabla | Serie: | ||
Nombre de columna de claves | Serie | ||
Vía de acceso de claves | Serie | ||
Elementos de datos | Nombre de columna de valores | Serie | |
Tipo de valor de mensaje | Serie: define el primitivo Java o la serie Java | ||
Elemento de mensaje | Serie: expresión XPath que describe la ubicación de la vía de acceso de un elemento del mensaje | ||
Validar entrada | Booleano: true o false | false |
Considere lo siguiente al utilizar el primitivo de mediación Búsqueda de base de datos: