El documento de entrada UMF QUERY 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.
Contiene la solicitud de los criterios de búsqueda para una consulta de interconexión de servicios web.
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 elementos y segmentos UMF necesarios forman 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 InfoSphere Identity Insight 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.
Después se especifican los criterios de búsqueda opcionales utilizando los otros segmentos UMF disponibles y sus códigos validos para nombres, direcciones, números, caracteristicas y direcciones de correo electrónico.
- NAME
- Consulta los atributos de nombre que definen el nombre de una persona, organización, lugar o elemento, tal como se define en el model de identidad y la identidad entrante.
- NUMBER
- Consulta atributos de nombre que constan de datos normalmente descritos como un número, por ejemplo números de tarjetas de crédito, números de telefono y números de pasaporte.
- ADDRESS
- Consulta atributos de direcciones que definen una ubicación de la identidad y que normalmente contienen información de una dirección estándard: nombre de la calle y número; número de edificio, ciudad, estado, país y código postal.
- ATTRIBUTE
- Consulta características de atributos que definen otros rasgo de identidad o otro tipo de información que no está expresada con otros tipos de atributos.
- EMAIL
- Consulta atributos de correo electrónico que definen direcciones de correo electrónico de internet.
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>