IM Centre de documentation de Relationship Resolution, Version 4.2

Document d'entrée UMF_QUERY

Le document d'entrée UMF_QUERY 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 interroger la base de données d'entités, puis trouver et renvoyer les informations sur une entité particulière à l'application appelante. Les informations d'un document d'entrée UMF_QUERY reposent sur des instruction SQL. Les résultats de cette recherche via le pipeline de services Web sont renvoyés à l'application appelante dans un document de sortie UMF_QUERY_RESULT.

Ces balises UMF comprennent le segment ROOT du document d'entrée UMF_QUERY :
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_QUERY 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.
FORMAT_CODE
Balise UMF qui corrèle avec un format de document de sortie UMF qui est indiqué dans la table UMF_OUTPUT_FORMAT. 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é demandé ;
  • WS_RELATION, qui renvoie la liste de toutes les entités apparentées à l'entité d'entrée à un degré ;
  • WS_ALERT, qui renvoie toutes les alertes dans le système impliquant l'ID d'entité d'entrée.
ENTITY_ID
Cette balise UMF obligatoire désigne l'ID de l'entité dans la recherche. Le système renvoie une réponse qui renseigne en détail sur les données connues concernant cette entité de la base de données d'entités, selon les autres critères d'interrogation.

Les segments UMF facultatifs du documents d'entrée UMF_QUERY sont les suivants :

Exemple de recherche UMF_QUERY

Cet exemple de UMF_QUERY applique le code au format WS_DETAIL pour interroger la base de données d'entités et renvoyer toutes les informations recensées 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>
Référence associée
Code de format WS_DETAIL
Code de format WS_ALERT
Code de format WS_RELATION


Appréciations en retour

Dernière mise à jour : 2007