Utilice estas instrucciones para crear un documento de entrada UMF_QUERY a fin de buscar una entidad
específica en la base de datos de entidades. El documento de entrada UMF_QUERY se envía mediante los
servicios Web a una interconexión de servicios Web para proceso. Después de que la interconexión procese
la consulta, los servicios Web devuelven un documento de salida UMF_QUERY_RESULT que contiene
los detalles acerca de la entidad de entrada solicitada.
Antes de empezar:
El servidor WebSphere Application Server
debe estar en ejecución y se debe haber iniciado al menos una
interconexión de servicios Web y estar en ejecución para recibir
y procesar el documento de entrada UMF_QUERY.
Acerca de esta tarea:
Puesto que la solicitud de búsqueda es un documento de entrada UMF, se deben
formatear los criterios utilizando códigos UMF válidos. Puede utilizar cualquier editor de texto o programa de utilidad
que cree UMF.
Procedimiento:
- Cree un nuevo documento de entrada UMF_QUERY.
- En el segmento ROOT, especifique los códigos y valores UMF necesarios:
- Especifique el código de fuente de datos en el código DSRC_CODE. El código de fuente de
datos por omisión para las búsquedas de interconexión de servicios Web es 1589. Si no utiliza el código de fuente de datos de búsqueda
de interconexión de servicios Web por omisión como código de fuente de datos, asegúrese de
que está configurado para no resolver entidades.
- Especifique el código de referencia de fuente de datos que hace referencia a la transacción de mensajes que realiza
la solicitud en el código DSRC_REF. El código de referencia de fuente de datos debe tener significado, porque se devuelve a la
aplicación de llamada.
- Especifique el código de formato para indicar el formato de salida de los resultados utilizando
el código FORMAT_CODE. IBM Relationship Resolution se suministra con tres códigos de formato
incorporados para una búsqueda de interconexión de servicios Web que utilizan UMF_QUERY:
- WS_DETAIL, que devuelve todos los datos de entidad disponibles para el ID de entidad de entrada
- WS_RELATION, que devuelve una lista de todas las entidades relacionadas con el ID de entidad de entrada
en una relación de 1 grado
- La consulta WS_ALERT, que devuelve todas las alertas de rol del sistema que implican el ID de entidad
de entrada
Si utiliza un código de formato diferente, debe configurarse en la tabla UMF_OUTPUT_FORMAT.
- En el código ENTITY_ID, especifique el ID para la entidad de la que desea devolver
información.
- Especifique cualquier otro criterio de búsqueda utilizando los demás segmentos UMF
opcionales <NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE>
y <NUMBER>.
- Envíe el documento de entrada UMF_QUERY a una interconexión de servicios Web.
Una interconexión de servicios Web toma el documento UMF_QUERY, utilizando los criterios
especificados para buscar entidades en la base de datos que coinciden con la consulta.
A continuación, la interconexión procesa la consulta, crea archivos de registro normales y devuelve
los resultados en un documento de salida UMF_QUERY_RESULT mediante los servicios Web a la aplicación
de llamada.
Ejemplo de búsqueda UMF_QUERY
En este ejemplo, UMF_QUERY busca toda la
información acerca del ID de entidad 1223:
Nota: Este ejemplo está formateado para
la lectura y no sigue el formato necesario de una línea por registro UMF.
<UMF_QUERY>
<DSRC_CODE>1589</DSRC_CODE>
<DSRC_REF>546</DSRC_REF>
<FORMAT_CODE>WS_DETAIL</FORMAT_CODE>
<ENTITY_ID>1223</ENTITY_ID>
</UMF_QUERY>