IM Centre de documentation de Relationship Resolution, Version 4.2

Document d'entrée UMF_SEARCH

Le document d'entrée UMF_SEARCH contient les critères de recherche et de demande d'une recherche via le pipeline de services Web. Il contient la série de segments UMF qui structurent les données entrantes pour rechercher dans la base de données des entités contenant des valeurs d'attribut qui concordent avec les critères de recherche, puis renvoient la liste d'entités à l'application appelante. Les résultats de cette recherche via le pipeline de services Web sont renvoyés à l'application appelante dans un document de sortie UMF_SEARCH_RESULT.

Ces balises UMF comprennent le segment ROOT du document d'entrée UMF_SEARCH :
DSRC_CODE
Balise UMF de code de source de données qui est obligatoire car elle référence et identifie l'application appelante. Dans le cadre de la consignation de pipeline normale, ce code de source de données est consigné dans la table UMF_LOG pour chaque requête UMF_SEARCH traitée.
Le système est préconfiguré avec un code de source de données, 1589, qui peut s'utiliser pour toutes les recherches via pipeline de services Web. Ce code de source de données effectue le traitement de résolution d'entité sans résoudre les critères de recherche entrants avec l'entité de la base de données d'entités qui concorde avec la recherche. Vous pouvez créer votre propre code de source de données pour une application appelante particulière ; veillez simplement à ce qu'il soit configuré pour ne pas résoudre d'entités.
DSRC_REF
Balise UMF de référence de source de données qui est obligatoire car elle référence la transaction de message demandeuse et est renvoyée à l'application appelante.
SRC_CREATE_DT
Balise UMF de date de création de source qui est facultative. Si cette balise contient une valeur, elle sert à la consignation.
SRC_LSTUPD_DT
Balise UMF de date de dernière mise à jour de source, qui est facultative. Si cette balise contient une valeur, elle sert à la consignation.
SRC_LSTUP_US
Balise UMF d'utilisateur de dernière mise à jour de la source, qui est facultative. Si cette balise contient une valeur, elle sert à la consignation.
MIN_LIKE_SCORE
Balise UMF de score de résolution (ou ressemblance) minimum qui est obligatoire pour établir la plus faible valeur concordante des autres segments et balises UMF indiqués. Ce score numérique détermine ce qui est considéré comme une concordance entre les valeurs d'attribut demandées et les entités de la base de données dotées des mêmes attributs. Plus le score est élevé, plus la concordance doit être exacte. Un score de 100 indique une concordance exacte.
Par exemple, si la recherche vise à trouver toutes les entités possédant un numéro de sécurité sociale précis, la balise MIN_LIKE_SCORE détermine à quel degré un numéro de sécurité sociale doit concorder avec la valeur de sécurité sociale indiquée dans la requête avant qu'une entité de la base de données soit répertoriée comme composante de l'ensemble de résultats de cette requête.
FORMAT_CODE
Balise UMF qui corrèle avec un format de document de sortie UMF qui est indiqué dans la table UMF_FORMAT_CODE. IBM Relationship Resolution inclut trois codes de format intégrés pour les recherches de pipeline de services Web au moyen de 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 qui concordent avec les critères de recherche
La seule différence entre ces interrogations est le nombre d'enregistrements renvoyé, désigné dans le nom de la requête.
Après le segment ROOT, vous pouvez indiquer les critères de recherche au moyen des autres segments UMF disponibles et de leurs balises valides de noms, adresses, numéros, caractéristiques et adresses électroniques.

Exemple de requête UMF_SEARCH

Cet exemple de requête UMF_SEARCH renvoie les cinq premières entités de la base de données dont le numéro de sécurité sociale concorde exactement avec celui-ci : 555-09-8761. Même si le système trouve davantage d'entités, seules les cinq premières figurent dans la liste.
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 enregistrement UMF.
<UMF_SEARCH>
	<DSRC_CODE>1589</DSRC_CODE>
	<DSRC_REF>1223</DSRC_REF>
	<MIN_LIKE_SCORE>100</MIN_LIKE_SCORE>
	<MAX_RETURN_CNT>5</MAX_RETURN_CNT>
	<FORMAT_CODE>WS_SUMMARY</FORMAT_CODE>
	<NUMBER>
		<NUM_TYPE>SSN</NUM_TYPE>
		<NUM_VALUE>555-09-8761</NUM_VALUE>
	</NUMBER>
</UMF_SEARCH>
Référence associée
Codes de format WS_SUMMARY


Appréciations en retour

Dernière mise à jour : 2007