Suchen von Daten mithilfe von Entitätssuchen in Unified Service Desk

Entitätssuchen sind FetchXML-Definitionen, die Microsoft Dataverse-Webdienste abfragen, um Daten zurückzugeben. Sie können auch Ersetzungsparameter in den FetchXML-Abfragen in einer Entitätssuche verwenden. Entitätssuchen können in Regeln für die Fensternavigation sowohl als Quelle für den Zugriff auf Daten verwendet werden, die nicht auf dem Formular angezeigt werden, als auch als Ziel, um die Daten mit Hilfe eines Webdienstaufrufs an Dataverse nachzuschlagen und dann die Unified Service Desk-Kontextdaten aufzufüllen, damit sie in Ersatzparametern verwendet werden können. Sie können auch Entitätssuchen in der Aktion DoSearch für das gehostete Global Manager-Steuerelement verwenden, um nach Ihren Daten zu suchen.

Sie definieren eine Entitätssuche im Bereich Entitätssuchen (Einstellungen>Unified Service Desk>Entitätssuchen) in Dataverse. Um eine Entitätssuche zu definieren, müssen Sie drei Punkte angeben: einen Namen, die Entität, auf die sich die Suche bezieht, und die FetchXML-Abfrage, die die Abfrage repräsentiert, um Daten vom Server zu erhalten.

Die folgende FetchXML-Abfrage zeigt Namen- und Adressdetails einer Firma auf Basis einer Kunden-ID an, die von einer Anfrage aus verfügbar ist:

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

So sieht die Entitätssuchendefinition aus:

Wichtig

Bei der Definition von FetchXML-Abfragen in einer Entitätssuche sollten Sie nur die Felder zurückgeben, die für den Zweck erforderlich sind. Dieses minimiert die Auswirkungen im Netzwerk, indem die Größe der Anforderung und die angezeigten Daten begrenzt werden, so dass der Ressourcenverbrauch optimiert wird.

Entwickler können auch eine vorhandene Entitätssuchdefinition in ihrem Code wiederverwenden, um nach Datensätzen in Dataverse zu suchen. Weitere Informationen: Wiederverwendung der Definition der Entitätssuche in Ihrem angepassten Code

Siehe auch

Entitätssuchdefinition in Ihrem benutzerdefinierten Code wiederverwenden
Verwenden von Fensternavigationsregeln in Unified Service Desk
Handlungsaufforderungen
Erlernen der Konfiguration von Unified Service Desk
Exemplarische Vorgehensweise: Verwenden des allgemeinen Listeneradapters für CTI-Ereignisweiterleitung