IM InfoSphere Identity Insight, Version 8.0

Elaboration d'interrogations de services Web pour rechercher des entités avec des attributs similaires

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.
  1. Créez un nouveau document d'entrée UMF_SEARCH.
  2. 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 :
    1. 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.
    2. 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.
    3. 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.
    4. 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.
  3. 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.
  4. 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>


Commentaires en retour

Dernière mise à jour : 2009