Daten mithilfe von FetchXml abfragen

FetchXml ist eine proprietäre XML-basierte Abfragesprache, die zum Abrufen von Daten aus Dataverse verwendet wird. Unter FetchXml-Referenz finden Sie die Elemente, die zum Abrufen von Daten verwendet werden.

Erstellen einer Abfrage

Alle Abfragen basieren auf einer einzigen Tabelle. Das Stammelement ist Fetch. Verwenden Sie das Entitätselement, um die Tabelle auszuwählen, aus der die Abfrage Daten abruft. Das folgende Beispiel stellt eine einfache FetchXml-Abfrage dar:

<fetch top='5'>
  <entity name='account'>
      <attribute name='name' />
  </entity>
</fetch>

Diese Abfrage gibt die Namensspalte der ersten fünf Zeilen aus der Kontotabelle zurück, unter Verwendung von LogicalName der Tabelle, um das Attribut Entität name festzulegen.

Beschränken der Anzahl von Zeilen

Um die Anzahl der zurückgegebenen Zeilen zu begrenzen, verwenden Sie das top-Attribut des Fetch-Elements. Ohne das Attribut top gibt Dataverse bis zu 5.000 Zeilen zurück.

Alternativ können Sie mithilfe von Auslagerung eine Anzahl von Datensätzen angeben, die zurückgegeben werden sollen. Verwenden Sie das top-Attribut nicht, wenn Sie Seiten mit Daten anfordern. Erfahren Sie, wie Sie ausgelagerte Ergebnisse anfordern

Sie können top nicht verwenden, wenn Sie mithilfe des Attributs returntotalrecordcount eine Anzahl von Zeilen anfordern. Erfahren Sie, wie Sie Zeilen zählen

Bestimmte Ergebnisse zurückgeben

Verwenden Sie das distinct-Attribut des Fetch-Elements, um zu verlangen, dass die Abfrage alle doppelten Werte in den Ergebnissen ausschließt.

Wenn Sie das Attribut distinct verwenden, müssen Sie mindestens ein Ordnungselement hinzufügen, um eine konsistente Auslagerung zu gewährleisten.

Wenn Sie das distinct-Attribut verwenden, enthalten die zurückgegebenen Ergebnisse keine Primärschlüsselwerte für jeden Datensatz, da sie eine Aggregation aller unterschiedlichen Werte darstellen.

Daten abrufen

Um Ergebnisse aus Ihrer Abfrage zu erhalten, müssen Sie Ihre Anforderung an Dataverse senden. Erfahren Sie, wie Sie mithilfe von FetchXml Daten aus Dataverse abrufen

Abfrage verfeinern

Nachdem Sie die Tabelle ausgewählt haben, mit der Ihre Abfrage beginnen soll, verfeinern Sie die Abfrage, um die benötigten Daten zu erhalten. In den folgenden Artikeln wird erläutert, wie Sie Ihre Abfrage vervollständigen.

Community-Tools

Der XrmToolbox FetchXmlBuilder ist ein kostenloses Tool, um FetchXml-Anforderungen zu verfassen und zu testen.

FetchXml als Nachrichtenparameter verwenden

Sie verwenden FetchXml auch als Parameter für Dataverse-Vorgänge wie die folgenden Meldungen:

Nächste Schritte,

Lernen Sie, wie man Spalten auswählt.

Erfahren Sie, wie Sie Daten mit FetchXml abrufen.