Freigeben über

Abfragen von Daten mithilfe von FetchXML in Dataverse

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.

Anmerkung

Sie können FetchXML auch verwenden, um Ansichten für modellgesteuerte Apps und einige Berichterstellungsfunktionen zu definieren. Dieser Artikel enthält keine Elemente und Attribute für diese Anwendungsfälle. Erfahren Sie mehr über das Anpassen modellgesteuerter App-Ansichten mit Code.

Verfassen einer FetchXML-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, indem der LogicalName der Tabelle verwendet wird, um das Attribut Entitätname festzulegen.

Anzahl an Zeilen begrenzen

Um die Anzahl der zurückgegebenen Zeilen zu begrenzen, verwenden Sie das Fetch-Elementtop-Attribut. Ohne das top Attribut gibt Dataverse bis zu 5.000 Standardtabellenzeilen und 500 elastische Tabellenzeilen zurück.

Alternativ können Sie mithilfe von Paginierung 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 paginierte 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 Fetch-Elementdistinct-Attribut, 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 Bestellelement hinzufügen, um eine konsistente Seiteneinteilung 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.

Abrufen von Daten mit FetchXML

Um Ergebnisse aus Ihrer Abfrage zu erhalten, senden Sie Ihre Anforderung an Dataverse. Informationen zum Abrufen von Daten aus Dataverse mithilfe von FetchXml.

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

Es gibt kostenlose Tools zum Verfassen und Testen von FetchXML-Anforderungen:

Anmerkung

Microsoft unterstützt keine Tools, die von der Community erstellt wurden. Wenn Sie Fragen oder Probleme mit Communitytools haben, wenden Sie sich an den Herausgeber des Tools.

Verwenden von FetchXML als Nachrichtenparameter

Sie können FetchXML auch als Parameter für Dataverse-Vorgänge wie die folgenden Nachrichten verwenden:

Name der Nachricht SDK für die .NET-Anforderungsklasse Web-API-Vorgang
BackgroundSendEmail BackgroundSendEmailRequest BackgroundSendEmail-Aktion
BulkDetectDuplicates BulkDetectDuplicatesRequest BulkDetectDuplicates-Aktion
FullTextSearchKnowledgeArticle FullTextSearchKnowledgeArticleRequest FullTextSearchKnowledgeArticle-Aktion
FetchXmlToQueryExpression FetchXmlToQueryExpressionRequest FetchXmlToQueryExpression-Funktion
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 mithilfe von FetchXML abrufen.

Abrufen von Daten mit FetchXml.

  • Last updated on