Beispiel: Synchronisieren von Daten mit externen Systemen mithilfe der Änderungsnachverfolgung

Dieser Beispielcode zeigt, wie mithilfe der Nachricht RetrieveEntityChanges mit den Klassen RetrieveEntityChangesRequest und RetrieveEntityChangesResponse Änderungen aus einer Tabelle abgerufen werden und Daten mit externen Systemen synchronisiert werden.

Weitere Informationen zur Funktion, die dieses Beispiel veranschaulicht, siehe Synchronisieren von Daten mit externen Systemen mithilfe der Änderungsnachverfolgung.

Wie man dieses Beispiel ausführt

1. Laden Sie das Repository "Microsoft/PowerApps-Samples " herunter, oder klonen Sie es, damit Sie über eine lokale Kopie verfügen.
2. (Optional) Bearbeiten Sie die Datei dataverse/App.config, um eine connection string zu definieren, die die Microsoft Dataverse Instanz angibt, mit der Sie eine Verbindung herstellen möchten.
3. Öffnen Sie die Beispiellösung in Visual Studio, und drücken Sie F5, um das Beispiel auszuführen. Nachdem Sie in dataverse/App.config eine connection string angegeben haben, werden diese Verbindungsinformationen von allen Beispielen verwendet, die Sie ausführen.

Wenn Sie in dataverse/App.configdatei keine connection string angeben, wird jedes Mal ein Dialogfeld geöffnet, wenn Sie das Beispiel ausführen, und Sie müssen Informationen dazu eingeben, mit welcher Dataverse-Instanz Sie eine Verbindung herstellen möchten und mit welchen Anmeldeinformationen Sie eine Verbindung herstellen möchten. Dieses Dialogfeld speichert frühere Verbindungen, so dass Sie eine bereits verwendete Verbindung auswählen können.

Diese Beispiele in diesem Repository, für die eine Verbindung mit einer Dataverse-Instanz erforderlich ist, enthalten einen verknüpften Verweis auf die dataverse/App.config Datei.

Was dieses Beispiel macht

Die RetrieveEntityChanges-Nachricht soll in einem Szenario verwendet werden, in dem Daten aus einem externen System synchronisiert werden, und die Funktion zur Änderungsnachverfolgung kann verwendet werden, um Datenänderungen zu ermitteln und auszugleichen.

Ohne dass ein separates System erforderlich ist, um dieses Szenario zu replizieren, simuliert dieses Beispiel das Szenario, indem zwei Anfragen ausgeführt werden. Zwischen den Anforderungen werden einige Daten geändert, sodass die zweite Anforderung Daten über die im Laufe der Zeit vorgenommenen Änderungen zurückgibt.

Wie dieses Beispiel funktioniert

Um das unter Was macht dieses Beispiel, beschriebene Szenario zu simulieren, geht das Beispiel wie folgt vor:

Einrichten

1. Importieren Sie eine verwaltete Lösung (ChangeTrackingSample_1_0_0_0_managed.zip), die eine Tabelle sample_book mit dem Alternativschlüssel sample_bookcode erstellt. Stellen Sie sicher, dass die Indizes zur Unterstützung des Alternativschlüssels aktiv sind
2. Es werden 10 anfängliche Tabellendatensätze Sample_book erstellt, damit Änderungen an diesen Tabellen nachverfolgt werden können.

Demonstrieren

1. Führen Sie die anfängliche Abfrage durch und zwischenspeichern Sie die Ergebnisse, einschließlich der DataToken
2. Aktualisieren Sie die Datensätze, die in Setup erstellt wurden
3. Führen Sie eine zweite Abfrage aus, diesmal durch den DataVersion mit dem DataToken-Wert, der aus der ursprünglichen Abfrage abgerufen wurde.
4. Zeigen Sie die Tabellenänderungen an, die von der zweiten Anfrage zurückgegeben wurden.

Bereinigung

Zeigen Sie eine Option zum Löschen der in Setup importierten verwalteten Lösung an, die die sample_book-Tabelle und alle im Beispiel erstellten Daten entfernt. Das Löschen ist optional, falls Sie die vom Beispiel erstellten Tabellen und Daten untersuchen möchten. Sie können ChangeTrackingSample manuell löschen, um das gleiche Ergebnis zu erzielen.