FetchXML zur Abfrage von Daten verwenden

  • 10 Minuten

FetchXML ist eine zuverlässige Abfragesprache, die von Microsoft entwickelt wurde, um die Ausführung komplexer Vorgänge mit Microsoft Dataverse-Daten zu ermöglichen. Sie bietet erheblich mehr Filteroptionen als OData-Konnektoren. Außerdem können Sie die Beschriftungen für Referenzdaten wie Optionssatzbeschriftungen oder Suchfelder anzeigen.

Sie können FetchXML-Abfragen mithilfe der folgenden Methoden ausführen:

  • Dataverse-Web-API

  • Organisationsdienst

Sie können in einer modellgesteuerten App auch einen benutzerdefinierten FetchXML-Filter für ein Suchfeld anwenden. Dieser Ansatz ermöglicht komplexere Suchszenarien, die standardmäßig nicht ohne Weiteres ausgeführt werden können. Weitere Informationen zu diesem Prozess finden Sie im Thema addCustomFilter (Client-API-Referenz).

Beispiel-FetchXML-Abfrage

Die folgende Beispielabfrage ruft die Felder accountid und name von der Kontotabelle ab:

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
   </entity>
</fetch>

Wenn Sie diese Daten z. B. nach Status filtern müssen, können Sie u. a. die folgende Beispielabfrage ausführen:

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
      <filter type='and'>
        <condition attribute='address1_stateorprovince' operator='eq' value='WA' />
      </filter>
   </entity>
</fetch>

Tools zum Erstellen Ihrer Abfragen

Wenn Sie Daten für eine modellgesteuerte App abfragen, die auf der Tabelle für die Anforderung basiert, können Sie FetchXML-Abfragen am einfachsten über die erweiterte Suche mit der Funktion FetchXML herunterladen erstellen. Sie können nur über die Benutzeroberfläche festlegen, welche Filter und zugehörigen Daten abgerufen werden können. Dies ist jedoch oft ein idealer Ausgangspunkt, da Sie kein neues XML erstellen müssen.

Screenshot zu „FetchXML herunterladen“ in der erweiterten Suche

Ein weiteres bemerkenswertes, von der Community erstelltes Tool ist FetchXML Builder. Mit diesem Tool können Sie FetchXML auf eine Art und Weise erstellen, die die erweiterte Suche nicht ermöglicht (Aggregate, äußere Verknüpfungen, „has no“-Abfragen und Attribute von mehrstufig verknüpften Entitäten). Es bietet außerdem eine Fülle von anderen Funktionen, die Sie auf der folgenden Website finden können: FetchXML Builder.

Weitere Ressourcen

Weitere umfassende Details zur FetchXML-Abfragesprache finden Sie im Abschnitt Daten mit FetchXML abfragen. In dem zahlreiche weiterführende Themen behandelt, z. B. das Verwenden von Paging, Abfragen hierarchischer Daten und vieles mehr.