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.
- Cree un nuevo documento de entrada UMF_SEARCH.
- 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:
- 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. 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.
- 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.
- 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.
- 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>