IM InfoSphere Identity Insight, Versión 8.0


Creación de consultas de servicios Web para encontrar entidades con atributos similares

Utilice estas instrucciones para crear un documento de entrada UMF_SEARCH a fin de buscar entidades en la base de datos de entidades que coincidan con los valores de datos de los atributos especificados en los criterios de búsqueda. El documento de entrada UMF_SEARCH 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_SEARCH_RESULTS que contiene una lista de entidades que han coincidido con los criterios de búsqueda.

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_SEARCH.
Por qué y cuándo se efectúa esta tarea
Puesto que la petición de búsqueda es un documento de entrada UMF, los criterios se deben formatear 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_SEARCH.
  2. En el segmento ROOT, especifique los códigos y valores UMF necesarios, así como cualquier código y valores UMF opcionales que desee utilizar para especificar los criterios de búsqueda. Como mínimo, especifique valores para estos códigos UMF:
    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_SEARCH:
      • WS_SUMMARY_TOP10, que devuelve las 10 primeras entidades que coinciden con los criterios de búsqueda
      • WS_SUMMARY_TOP100, que devuelve las 100 primeras entidades que coinciden con los criterios de búsqueda
      • La consulta WS_SUMMARY, que devuelve todas las entidades que coinciden con los criterios de búsqueda
      Si utiliza un código de formato diferente, debe configurarse en la tabla UMF_OUTPUT_FORMAT.
    4. Especifique la puntuación de resolución mínima en el código MIN_LIKE_SCORE para establecer la puntuación numérica más baja que se considerará una coincidencia entre los valores de atributos de los criterios de búsqueda y las entidades de la base de datos de entidades que contengan los mismos atributos. Cuanto más alta es la puntuación, más exacta debe ser la coincidencia. Una puntuación de 100 indica una coincidencia exacta.
  3. Especifique los valores de datos para los atributos que componen los criterios de búsqueda utilizando los demás segmentos de documento de entrada UMF válidos. Estos valores son los atributos que la búsqueda de interconexión de servicios Web busca para crear la lista de entidades con valores coincidentes o similares. El grado de coincidencia dependerá del valor de MIN_LIKE_SCORE.
  4. Envíe el documento de entrada UMF_SEARCH mediante los servicios Web.
Resultados
Una interconexión de servicios Web toma el documento UMF_SEARCH, utilizando el proceso de resolución de entidades para buscar entidades en la base de datos con los criterios especificados. A continuación, la interconexión procesa la consulta, crea archivos de registro normales y devuelve los resultados en un documento UMF_SEARCH_RESULTS mediante los servicios Web a la aplicación de llamada utilizando el formato seleccionado.

Ejemplo de consulta de documento UMF_SEARCH

En este ejemplo, el documento de entrada UMF_SEARCH utiliza el código de formato WS_SUMMARY_TOP10 para consultar la base de datos de entidades a fin de buscar las 10 primeras entidades que contengan números de seguridad social en que el valor de datos del número de seguridad social coincida exactamente con el valor de datos 555-09-8761:
Nota: Este ejemplo está formateado para la lectura y no sigue el formato necesario de una línea por registro UMF.
<UMF_SEARCH>
	<DSRC_CODE>1589</DSRC_CODE>
	<DSRC_REF>1223</DSRC_REF>
	<MIN_LIKE_SCORE>100</MIN_LIKE_SCORE>
	<FORMAT_CODE>WS_SUMMARY_TOP10</FORMAT_CODE>
	<NUMBER>
		<NUM_TYPE>SSN</NUM_TYPE>
		<NUM_VALUE>555-09-8761</NUM_VALUE>
	</NUMBER>
</UMF_SEARCH>



Comentarios



Última actualización: 2009