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 :
- Créez un nouveau document d'entrée UMF_QUERY.
- Dans le segment ROOT, saisissez les balises et valeurs UMF nécessaires.
- 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. 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.
- Dans la balise ENTITY_ID, saisissez l'ID de l'entité sur laquelle vous
souhaitez renvoyer des données.
- Indiquez tout autre critère de recherche à l'aide des autres segments UMF facultatifs
<NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE>
et <NUMBER>.
- 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>