IM Centre de documentation de Relationship Resolution, Version 4.2

Elaboration d'interrogations de services Web pour rechercher une entité précise

Suivez ces instructions pour élaborer un document d'entrée UMF_QUERY destiné à rechercher une entité spécifique dans la base de données d'entités. Ce document d'entrée UMF_QUERY doit être envoyé 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_QUERY_RESULT qui contient les détails de l'entité d'entrée demandée.

Avant de commencer :
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_QUERY.
A propos de 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.
Procédure :
  1. Créez un nouveau document d'entrée UMF_QUERY.
  2. Dans le segment ROOT, saisissez les balises et valeurs UMF nécessaires.
    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. IBM Relationship Resolution inclut trois codes de format intégrés pour les recherches de pipeline de services Web au moyen de UMF_QUERY :
      • WS_DETAIL, qui renvoie toutes les données d'entité disponibles pour l'ID d'entité d'entrée ;
      • WS_RELATION, qui renvoie la liste de toutes les entités apparentées à l'ID d'entité d'entrée par une relation à un degré ;
      • la requête WS_ALERT, qui renvoie toutes les alertes de rôle dans le système impliquant l'ID d'entité d'entrée.
      Si vous utilisez un autre code de format, il doit être configuré dans la table UMF_OUTPUT_FORMAT.
    4. Dans la balise ENTITY_ID, saisissez l'ID de l'entité sur laquelle vous souhaitez renvoyer des données.
  3. Indiquez tout autre critère de recherche à l'aide des autres segments UMF facultatifs <NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE> et <NUMBER>.
  4. Envoyez le document d'entrée UMF_QUERY à un pipeline de services Web.
Un pipeline de services Web traite le document UMF_QUERY à l'aide des critères définis pour rechercher dans la base de données les entités concordant avec l'interrogation. Le pipeline traite ensuite l'interrogation, crée des fichiers de journalisation standard, puis renvoie les résultats à l'application appelante, dans un document de sortie UMF_QUERY_RESULT via les services Web.

Exemple de recherche UMF_QUERY

Cet exemple d'interrogation UMF_QUERY recherche toutes les informations sur l'ID d'entité 1223 :
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_QUERY>
	<DSRC_CODE>1589</DSRC_CODE>
	<DSRC_REF>546</DSRC_REF>
	<FORMAT_CODE>WS_DETAIL</FORMAT_CODE>
	<ENTITY_ID>1223</ENTITY_ID>
</UMF_QUERY>
Tâches associées
Elaboration d'interrogations de services Web pour rechercher des entités avec des attributs similaires
Activation du moteur d'évaluation dynamique


Appréciations en retour

Dernière mise à jour : 2007