Gegevens zoeken met entiteitzoekacties in Volledige servicedesk

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Entiteitzoekacties zijn FetchXML-definities die de Microsoft Dynamics 365 webservices vragen om gegevens terug te sturen. U kunt ook vervangingsparameters gebruiken in de FetchXML-query's in een entiteitzoekactie. Entiteitzoekacties kunnen in de regels van de vensternavigatie zowel worden gebruikt als bron om toegang te krijgen tot gegevens die niet op het formulier worden weergegeven, en als doel voor het opzoeken van de gegevens met een webserviceoproep voor Dynamics 365, en kunnen daarna de contextgegevens van Unified Service Desk vullen zodat deze kunnen worden gebruikt in vervangingsparameters. U kunt entiteitzoekacties ook in de DoSearch-actie voor het gehoste besturingselement Algemene beheerder gebruiken om uw gegevens te zoeken.

U definieert een entiteitzoekactie in het gebied Entiteitszoekopdrachten (Instellingen > Volledige servicedesk > Entiteitszoekopdrachten) in Dynamics 365. Als u een entiteitzoekactie wilt definiëren, moet u drie dingen opgeven: een naam, de entiteit waarop de zoekactie betrekking heeft en de FetchXML-query die de query vertegenwoordigt die gegevens van de server ophaalt.

Met de volgende FetchXML-query worden de naam en het adres van een account opgehaald op basis van de klant-id uit een aanvraag:

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

Zo ziet de definitie van de entiteitzoekactie eruit:

Voorbeeld van zoekdefinitie van entiteit

Belangrijk

Bij het definiëren van FetchXML-query's in een entiteitzoekactie moet u alleen de velden als resultaat gegeven die voor het doel vereist zijn. Hierdoor blijven de gevolgen voor het netwerk klein doordat de omvang van de aanvraag en de geretourneerde gegevens wordt beperkt, wat het resourcegebruik optimaliseert.

Ontwikkelaars kunnen een bestaande definitie van een entiteitzoekactie in hun code hergebruiken, om records te zoeken in Dynamics 365.Meer informatie:Entiteit Zoekdefinitie opnieuw gebruiken in uw aangepaste code

Zie ook

Entiteit Zoekdefinitie opnieuw gebruiken in uw aangepaste code
Vensternavigatieregels gebruiken in Volledige servicedesk
Actieoproepen
Leren werken met Volledige servicedesk
Overzicht: De algemene listener-adapter gebruiken voor CTI-gebeurtenisroutering

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht

  • Last updated on