Beispiel: Konvertieren von Abfragen zwischen FetchXML und QueryExpression

Dieses Beispiel zeigt, wie Abfragen zwischen FetchXML und QueryExpression konvertiert werden.

Wie man dieses Beispiel ausführt

1. Um eine lokale Kopie zu erhalten, laden Sie den Beispielbericht herunter, oder klonen Sie ihn.
2. (Optional) Bearbeiten Sie die dataverse/App.config-Datei so, dass sie eine Verbindungszeichenfolge festlegt, aus der die Microsoft Dataverse-Instanz hervorgeht, zu der Sie eine Verbindung herstellen möchten.
3. Um das Beispiel auszuführen, öffnen Sie die Beispiellösung in Visual Studio, und drücken Sie F5. Nachdem Sie in der dataverse/App.config-Datei eine Verbindungszeichenfolge angegeben haben, nutzen alle Beispiele, die Sie ausführen, diese Verbindungsdaten.

Wenn Sie in der dataverse/App.config-Datei keine Verbindungszeichenfolge angeben, wird bei jeder Ausführung eines Beispiels ein Dialogfeld geöffnet, in dem Sie eingeben müssen, zu welcher Dataverse-Instanz Sie eine Verbindung herstellen und welche Anmeldeinformationen Sie verwenden möchten. Vorherige Verbindungen werden im Dialogfeld zwischengespeichert, sodass Sie aus zuvor verwendeten Verbindungen auswählen können.

Diejenigen Beispiele aus dem Bericht, die zu ihrer Ausführung eine Verbindung zu einer Instanz von Dataverse benötigen, enthalten eine verknüpfte Referenz zur dataverse/App.config-Datei.

Funktionsweise

Die QueryExpression und fetchExpression-Nachrichten sind für die Verwendung in einem Szenario vorgesehen, das Abfragen in einer Hierarchie von Ausdrücken bzw. FetchXML enthält.

Wie dieses Beispiel funktioniert

Um das unter Was das Beispiel macht beschriebene Szenario zu simulieren, führt das Beispiel folgende Vorgänge aus:

Einrichtung

1. Prüft auf die aktuelle Version der Organisation.
2. Die CreateRequireRecords-Methode erstellt ein Konto und zwei Kontaktdatensätze, die vom Beispiel verwendet werden.
3. Der QueryExpression erstellt eine QueryExpression, um sie in FetchXML umzuwandeln.
4. Die DoFetchXmlToQueryExpressionConversion-Klasse erstellt eine Fetch-Abfrage, die Sie in einen QueryExpression konvertieren.
5. Die conversionRequest-Methode konvertiert den generierten QueryExpression in FetchXML und umgekehrt.
6. Verwenden Sie die konvertierte Abfrage mit einer RetrieveMultiple-Anforderung.

Bereinigung

Zeigt eine Option an, um die Datensätze zu löschen, die in der Einrichtungerstellt wurden. Das Löschen ist optional, falls Sie die vom Beispiel erstellten Tabellen und Daten untersuchen möchten. Sie können die Datensätze manuell löschen, um das gleiche Ergebnis zu erzielen.