IM InfoSphere Identity Insight, Version 8.0

Document d'entrée UMF_QUERY

Le document d'entrée UMF_QUERY 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. Il contient les critères de recherche et de demande d'une recherche via le pipeline de services Web.

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 éléments et segments UMF requis comprennent le 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 InfoSphere Identity Insight contient trois codes de format intégrés pour les recherches via pipeline de services Web à l'aide d'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.
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 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 fiche 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>


Commentaires en retour

Dernière mise à jour : 2009