El documento de entrada UMF_QUERY contiene la solicitud y los criterios de búsqueda para
una búsqueda de interconexión de servicios Web. Contiene la colección de segmentos UMF que estructuran
los datos de entrada para consultar la base de datos de entidades y, después, buscar y devolver
la información acerca de una entidad específica a la aplicación de llamada.
La información de un documento de entrada UMF_QUERY se basa en sentencias SQL.
Los resultados de esta búsqueda de interconexión de servicios Web se devuelven a la aplicación de
llamada en un documento de salida UMF_QUERY_RESULT.
Estos códigos UMF constan del segmento ROOT para el documento de entrada UMF_QUERY:
- DSRC_CODE
- Código UMF del código de fuente de datos que es necesario ya que hace referencia e identifica
la aplicación de llamada. Como parte del registro de interconexiones normal, este código de fuente de
datos se registra en la tabla UMF_LOG para cada UMF_QUERY procesado.
- El sistema ya está configurado con un código de fuente de datos, 1589, que se puede utilizar
para todas las búsquedas de interconexión de servicios Web. Este código de fuente de datos realiza
el proceso de resolución de entidades sin resolver los criterios de búsqueda de entrada con la
entidad en la base de datos de entidades que coincide con la búsqueda. Puede crear su propio código
de fuente de datos para una aplicación de llamada en particular, tan sólo debe asegurarse de que
el código de fuente de datos se establezca en no resolver las entidades.
- DSRC_REF
- Código UMF de referencia de fuente de datos que es necesario ya que hace referencia a la transacción
del mensaje de solicitud y se devuelve a la aplicación de llamada.
- FORMAT_CODE
- Código UMF que se correlaciona con un formato de documento de salida UMF que se especifica
en la tabla UMF_OUTPUT_FORMAT. 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
solicitado
- WS_RELATION, que devuelve una lista de todas las entidades relacionadas con la entidad
de entrada en el grado 1
- La consulta WS_ALERT, que devuelve todas las alertas del sistema que implican el ID de entidad
de entrada
- ENTITY_ID
- Este código UMF necesario especifica el ID de entidad para la entidad de la búsqueda.
El sistema devuelve una respuesta con detalles de los datos conocidos acerca de esta entidad
de la base de datos de entidades, basándose en los demás criterios de consulta.
Los segmentos UMF del documento de entrada UMF_QUERY opcionales son:
- <NAME>
- <ADDRESS>
- <EMAIL_ADDR>
- <NUMBER>
- <ATTRIBUTE>
Ejemplo de búsqueda UMF_QUERY
Este ejemplo de UMF_QUERY
utiliza el código de formato WS_DETAIL de ejemplo para consultar la base de datos de entidades y devolver
toda la información conocida 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>