Partager via


Rechercher des données à l’aide de recherches d’entité dans Unified Service Desk

Les recherches d’entités sont des définitions FetchXML qui interrogent les services web Microsoft Dataverse pour renvoyer des données. Vous pouvez également utiliser les paramètres de remplacement dans les requêtes FetchXML d’une recherche d’entités. Les recherches d’entités peuvent être utilisées dans les règles de navigation dans les fenêtres, à la fois comme source pour accéder à des données qui ne s’affichent pas dans le formulaire, et comme destination pour rechercher des données à l’aide d’un appel de service web vers la plateforme Dataverse, puis pour compléter les données de contexte du Unified Service Desk afin qu’elles puissent être utilisées dans les paramètres de remplacement. Vous pouvez également utiliser des recherches d’entité dans l’action DoSearch du contrôle hébergé Gestionnaire global pour rechercher vos données.

Vous définissez une recherche d’entités dans la zone Recherches d’entités (Paramètres>Unified Service Desk>Recherches d’entités) dans Dataverse. Pour définir une recherche d’entités, vous devez spécifier trois éléments : un nom, l’entité à laquelle la recherche s’applique, et la requête FetchXML qui représente la requête permettant de récupérer les données du serveur.

La requête FetchXML suivante renvoie les détails de nom et d’adresse d’un compte basé sur un ID client disponible depuis un incident :

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
  <entity name="account">  
    <attribute name="name" />  
    <attribute name="emailaddress1" />  
    <attribute name="telephone1" />     
    <attribute name="address1_line1" />  
    <attribute name="address1_city" />  
    <attribute name="address1_stateorprovince" />  
    <attribute name="address1_postalcode" />  
   <attribute name="address1_country" />  
   <attribute name="msdyusd_facebook"/>  
   <attribute name="msdyusd_twitter"/>  
    <order attribute="name" descending="false" />  
    <filter type="and">  
      <condition attribute="accountid" operator="eq" value="{[[incident.customerid.Id]x]}" />  
    </filter>  
  </entity>  
</fetch>  

Voici à quoi ressemble la définition de la recherche d’entités :

Exemple de définition de recherche d’entité.

Important

Lors de la définition des requêtes FetchXML dans une recherche d’entités, vous devez uniquement renvoyer les champs requis pour l’objectif. Cela permet de réduire l’impact sur le réseau en limitant la taille de la requête et des données retournées, ce qui optimise l’utilisation des ressources.

Les développeurs peuvent aussi réutiliser une définition de recherche d’entité existante dans leur code pour rechercher des enregistrements dans Dataverse. En savoir plus : Réutiliser la définition de recherche d’entité dans votre code personnalisé

Voir aussi

Réutiliser la définition de recherche d’entité dans votre code personnalisé
Utiliser les règles de navigation dans la fenêtre dans Unified Service Desk
Appels à l’action
Apprendre à configurer Unified Service Desk
Guide pas-à-pas : utiliser l’adaptateur d’écoute générique pour le routage des événements CTI