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 éléments et segments UMF requis comprennent le 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 InfoSphere Identity Insight
contient 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 qui concordent avec les critères de recherche
- La seule différence entre ces interrogations est le nombre de fiches renvoyées, désigné dans le nom de la requête.
Vous indiquez ensuite les critères de recherche optionnels au moyen des autres segments UMF disponibles et de leurs balises valides de noms, adresses, numéros, caractéristiques et adresses électroniques.
- NAME
- Recherchez les attributs de nom qui définissent le nom de la personne, l'organisation, le lieu ou l'élément, tels que définis par le modèle d'entité et l'identité entrante.
- NUMBER
- Recherchez les attributs de numéro qui se composent de données généralement décrites sous forme de numéro, telles que le numéro de carte de crédit, numéro de téléphone et numéro de passeport.
- ADDRESS
- Recherchez les attributs d'adresse qui définissent une localisation de l'identité et contiennent généralement les informations d'adresse standard : numéro et nom de rue, numéro du bâtiment,
code postal, localité, état et pays.
- ATTRIBUTE
- Recherchez les attributs de caractéristique qui définissent d'autres spécificités ou informations identitaires qui ne sont pas exprimées par les autres types d'attributs.
- EMAIL
- Recherchez les attributs d'adresse électronique qui définissent les adresses de messagerie Internet.
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 fiche 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>