Freigeben über


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 Ersetzungsparameter auch innerhalb der Abfragen bei einer Entitätssuche verwenden. FetchXML 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. Zum Definieren einer Entitätssuche müssen Sie drei Dinge angeben: einen Namen, die Entität, auf die sich die Suche bezieht, und die FetchXML Abfrage, die die Abfrage zum Abrufen der Daten vom Server darstellt.

Die folgende FetchXML Abfrage gibt den Namen und die Adressdaten eines Kontos auf Grundlage einer aus einem Fall verfügbaren Kunden-ID zurück:

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

Beispielentitätssuchen-Definition.

Wichtig

Beim Definieren von Abfragen in einer Entitätssuche sollten Sie nur die Felder zurückgeben, die für den Zweck erforderlich sind. FetchXML 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