WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows

Primitivo de mediación Búsqueda de base de datos

Utilice el primitivo de mediación Búsqueda de base de datos para modificar un mensaje, utilizando información de una base de datos.

Introducción

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.

Uso

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.

Propiedades

Nombre del origen de datos
Nombre JNDI del origen de datos.
Nombre de tabla
Nombre de la tabla de bases de datos, incluido el nombre del esquema. Por ejemplo, myschema.mytable.
Nombre de columna de claves
Nombre de la columna de claves principal de la base de datos. La columna de claves especificada debe contener un valor exclusivo; no se admite el uso de claves de bases de datos de varias columnas. Además, el valor único debe ser del mismo tipo de elemento que el valor localizado en el mensaje mediante Vía de acceso de claves.
Vía de acceso de claves
Expresión XPath 1.0. El valor que devuelve la expresión XPath se utiliza como clave en la base de datos.
Elementos de datos
Tabla que contiene tres tipos de propiedades. Estas tres propiedades describen dónde encontrar la información de la base de datos, indican el tipo de información y los puntos del mensaje en los que se almacena información.
Nombre de columna de valores
Nombre de la columna de la base de datos de la que se obtiene el valor del elemento.
Tipo de valor de mensaje
Tipo de valor del elemento. Los únicos tipos soportados son los tipos de primitivos Java o el tipo de serie. Durante la ejecución, el valor obtenido de la base de datos se convierte en el tipo definido en Tipo de valor de mensaje. tipo de valor de mensaje se define mediante una serie.
Elemento de mensaje
Expresión XPath 1.0 que describe la ubicación de la vía de acceso de un elemento del mensaje. El elemento del mensaje es el punto en el que se almacena el valor de la base de datos. La expresión XPath debe evaluarse como un único elemento del mensaje.
Validar entrada
Si el valor es true, el mensaje de entrada se valida antes de realizar la mediación.
Tabla 1. Propiedades del 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

Consideraciones

Considere lo siguiente al utilizar el primitivo de mediación Búsqueda de base de datos:


Reference topic

Condiciones de uso | Evalúe esta página

Icono de fecha y horaÚltima actualización: 1 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.wbit.help.medprim.doc.nl1_6.0.1\ref\rwesb_DatabaseLookupmediationprimitive.html

(C) Copyright IBM Corporation 2005. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse. (http://www.eclipse.org)