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.

Hinweis

FetchXml wird auch zum Definieren von Ansichten für modellgesteuerte Apps und einigen Berichtsfunktionen verwendet. Elemente und Attribute für diese Anwendungsfälle sind hier nicht enthalten. Erfahren Sie mehr über das Anpassen modellgesteuerter App-Ansichten mit Code.

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.

Artikel	Aufgabe
Spalten auswählen	Geben Sie an, welche Datenspalten zurückgegeben werden sollen.
Tabellen verbinden	Geben Sie an, welche zugehörigen Tabellen in den Ergebnissen zurückgegeben werden sollen.
Bestellzeilen	Geben Sie die Sortierreihenfolge der Zeilen an, die zurückgegeben werden sollen.
Filterzeilen	Geben Sie an, welche Datenzeilen zurückgegeben werden sollen.
Seitenergebnisse	Geben Sie an, wie viele Datenzeilen mit jeder Anforderung zurückgegeben werden sollen.
Aggregatdaten	So gruppieren und aggregieren Sie die zurückgegebenen Daten.
Anzahl der Zeilen	So ermitteln Sie die Anzahl der zurückgegebenen Zeilen.
Leistungsoptimierungen	So optimieren Sie die Leistung

Community-Tools

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

Hinweis

Von der Community erstellte Tools werden von Microsoft nicht unterstützt. Wenn Sie Fragen oder Probleme mit Community-Tools haben, wenden Sie sich an den Herausgeber des Tools.

FetchXml als Nachrichtenparameter verwenden

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

Name der Nachricht	SDK für die .NET-Anforderungsklasse	Web-API-Vorgang
BackgroundSendEmail	BackgroundSendEmailRequest	BackgroundSendEmail-Aktion
BulkDetectDuplicates	BulkDetectDuplicatesRequest	BulkDetectDuplicates-Aktion
FullTextSearchKnowledgeArticle	FullTextSearchKnowledgeArticleRequest	FullTextSearchKnowledgeArticle-Aktion
QueryExpressionToFetchXml	QueryExpressionToFetchXmlRequest	QueryExpressionToFetchXml-Aktion
SendBulkMail	SendBulkMailRequest	SendBulkMail-Aktion
Rollup	RollupRequest	Rollup-Funktion

Nächste Schritte,

Lernen Sie, wie man Spalten auswählt.

Spalten auswählen

Erfahren Sie, wie Sie Daten mit FetchXml abrufen.

Daten mit FetchXml abrufen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).