Suivez ces instructions pour élaborer un document d'entrée UMF_SEARCH
afin de rechercher des entités dans la base de données d'entités qui concordent avec les valeurs de données des attributs
spécifiés dans les critères de recherche. Envoyez ce document d'entrée UMF_SEARCH dans
un pipeline de services Web pour traitement. Une fois l'interrogation
traitée par le pipeline, les services Web renvoient un document de sortie UMF_SEARCH_RESULTS
qui contient la liste des entités répondant aux critères de recherche.
Avant de commencer
Le serveur intégré WebSphere Application Server doit être en cours d'exécution
et au moins un pipeline de services Web doit être démarré et en cours d'exécution pour recevoir
et traiter le document d'entrée UMF_SEARCH.
Pourquoi et quand exécuter cette tâche
Etant donné que la demande de recherche est un document d'entrée UMF, les critères
doivent être formatés à l'aide de balises UMF valides. Vous pouvez employer n'importe quel éditeur de texte ou utilitaire
qui crée des données UMF.
- Créez un nouveau document d'entrée UMF_SEARCH.
- Dans le segment ROOT, saisissez les balises et les valeurs UMF requises ainsi
que toutes les balises et valeurs UMF facultatives que vous souhaitez utiliser pour définir les critères
de recherche. Saisissez au minimum des valeurs pour les balises UMF suivantes :
- Saisissez le code de source de données dans la balise DSRC_CODE. Le code de source
de données par défaut pour les recherches de pipeline de services Web est 1589. Si
vous utilisez un autre code de source de données que le code par défaut des recherches
de pipeline de services Web, assurez-vous qu'il soit configuré pour ne pas résoudre les entités.
- Entrez le code de référence de source de données qui référence la transaction
de message à l'origine de la demande dans la balise DSRC_REF. Le code de référence de source de données
doit être pertinent, car il est renvoyé à l'application appelante.
- Saisissez le code de format qui indique le format de sortie des résultats
à l'aide de la balise FORMAT_CODE. Les pipelines
contiennent trois codes de format intégrés pour les recherches via pipeline de services Web
à l'aide d'UMF_SEARCH :
- WS_SUMMARY_TOP10, qui renvoie les dix premières entités répondant aux critères
de recherche ;
- WS_SUMMARY_TOP100, qui renvoie les cent premières entités répondant aux critères
de recherche ;
- WS_SUMMARY, qui renvoie toutes les entités répondant aux critères de recherche.
Si vous utilisez un autre code de format, il doit être configuré
dans la table UMF_OUTPUT_FORMAT.
- Indiquez le score de résolution minimum dans la balise MIN_LIKE_SCORE
afin de définir le score numérique le plus bas pouvant être considéré comme une correspondance entre les valeurs d'attribut des critères de recherche et les entités de la base de données contenant les mêmes attributs. Plus le score est élevé, plus la concordance doit être exacte. Un score de 100 indique une concordance exacte.
- A l'aide des autres segments valides du document d'entrée UMF, indiquez les valeurs de données
pour les attributs qui composent les critères de recherche. Ces
valeurs correspondent aux attributs dont la recherche de pipeline de services Web a besoin
pour élaborer la liste des entités faisant apparaître des valeurs concordantes ou similaires. Le degré
de concordance dépend de la valeur de MIN_LIKE_SCORE.
- Envoyez le document d'entrée UMF_SEARCH via les services Web.
Résultats
Un pipeline de services Web traite le document UMF_SEARCH en appliquant
le processus de résolution d'entité pour rechercher des entités dans la base de données
à l'aide des critères définis. Le pipeline traite ensuite l'interrogation, crée des fichiers de journalisation standard,
puis renvoie les résultats à l'application appelante dans un document UMF_SEARCH_RESULTS via les services Web
et au format sélectionné.
Exemple de document d'interrogation UMF_SEARCH
Cet exemple de document d'entrée
UMF_SEARCH utilise le code de format WS_SUMMARY_TOP10 pour rechercher dans la base de données d'entités
les dix premières entités possédant des numéros de sécurité sociale
dont la valeur des données correspond exactement à la valeur 555-09-8761 :
Remarque : le format choisi pour cet exemple est utilisé dans un souci
de lisibilité et ne respecte pas le format obligatoire d'une ligne par fiche 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>