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.

SDK für .NET: Beispielcode für das Synchronisieren von Daten mit externen Systemen mithilfe der Änderungsnachverfolgung

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. 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 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 zurückgibt, zu den Änderungen im Laufe der Zeit.

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, um den Alternativschlüssels zu unterstützen, 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.

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).