IM InfoSphere Identity Insight, Versión 8.0


Creación de consultas de servicios Web para encontrar una entidad específica

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 incrustado 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.
Por qué y cuándo se efectúa 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.
  1. Cree un nuevo documento de entrada UMF_QUERY.
  2. En el segmento ROOT, especifique los códigos y valores UMF necesarios:
    1. 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.
    2. 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.
    3. Especifique el código de formato para indicar el formato de salida de los resultados utilizando el código FORMAT_CODE. Las interconexions se suministran 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.
    4. En el código ENTITY_ID, especifique el ID para la entidad de la que desea devolver información.
  3. Especifique cualquier otro criterio de búsqueda utilizando los demás segmentos UMF opcionales <NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE> y <NUMBER>.
  4. Envíe el documento de entrada UMF_QUERY a una interconexión de servicios Web.
Resultados
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>



Comentarios



Última actualización: 2009