FetchXMLBuilder

Die Klasse FetchXMLBuilder bietet eine flüssige API zum programmatischen Erstellen und Bearbeiten von FetchXML-Abfragen. Anstatt rohe XML-Strings zu erstellen, können Sie stark typisierte Methoden verwenden, um Entitäten, Spalten, Filter, Bedingungen, Sortierreihenfolgen und Link-Entitäten zu definieren.

React Note

FetchXMLBuilder ist ein serverseitiges Blazor-Utility – es gibt kein React-Äquivalent. React-Aufrufer komponieren FetchXML als String-Literale (Vorlagenstrings) und übergeben sie direkt an ppp.retrieveRecordsAsync(fetchXml). Der Server übernimmt weiterhin die schwere Arbeit (Filterzusammenführung, Paging, Sicherheitstrimming), sobald das FetchXML ankommt.

Erstellung einer Abfrage

Erstellen Sie eine neue FetchXMLBuilder mit einer leeren Abfrage oder parsen Sie eine bestehende FetchXML-Zeichenkette.

Auswahl von Spalten

Füge einzelne Spalten mit AddColumnhinzu oder setze AllColumns = true so, dass alle Spalten abgerufen werden. Die Einstellung AllColumns entfernt alle einzeln hinzugefügten Spalten.

Filter hinzufügen

Füge Filter zu einer Entität oder einer Verknüpfungs-Entität mit AddFilterhinzu, und füge dann Bedingungen zum Filter hinzu. Jede Bedingung spezifiziert eine Spalte, einen Operator und einen Wert.

Zusammenführung verwandter Tabellen

Nutze es AddLinkEntity , um einer verwandten Tabelle beizutreten. Setze die TableNameEigenschaften , From, To, Operator und zur Definition des Joins. Filter können zu Link-Entitäten hinzugefügt werden, genau wie die Hauptentität.

Sortierergebnisse

Verwenden AddSortOrder Sie, um die Sortierreihenfolge zu definieren. Du kannst den Spaltennamen und die Sortierung in absteigender Reihenfolge angeben.

Paging

Kontrolle das Paging-Verfahren mit den Count, , und PagingCookie Eigenschaften auf dem Fetch PageElement. Stellen Sie ein, ReturnRecordCount = true dass die Gesamtanzahl der Datensätze in den Ergebnissen enthalten ist.

Parsing bestehender FetchXML

Geben Sie eine bestehende FetchXML-Zeichenkette an den Konstruktor weiter, um sie zu parsen und zu bearbeiten. Dies ist nützlich, um Anfragen aus Ansichten oder anderen Quellen zu verändern.

Generierung des FetchXML-Strings

Aufruf ToString() zur Generierung der FetchXML-Zeichenkette. Die Ausgabe ist deterministisch geordnet: Attribute, dann Sortierreihenfolgen, dann Filter, schließlich Link-Entitäten. Innerhalb jeder Gruppe sind die Elemente alphabetisch sortiert.