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

Les recherches d’entités sont des FetchXML définitions qui interrogent Microsoft Dataverse des services Web pour renvoyer des données. Vous pouvez également utiliser des paramètres de remplacement dans les FetchXML requêtes d’une recherche d’entité. 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é, vous devez spécifier trois éléments : un nom, l’entité à laquelle la recherche s’applique et la FetchXML requête qui représente la requête permettant de récupérer les données du serveur.

La FetchXML requête suivante renvoie les détails du nom et de l’adresse d’un compte en fonction d’un identifiant client disponible à partir d’un dossier :

<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 :

Important

Lors de la définition FetchXML de requêtes dans une recherche d’entité, vous ne devez renvoyer que les champs requis à cet effet. 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