Beispiel: Einen Datensatz mit Upsert einfügen oder aktualisieren

Dieser Beispielcode zeigt, wie Datensätze mithilfe der UpsertRequest-Nachricht eingefügt oder aktualisiert werden.

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 UpsertRequest-Message ist dazu vorgesehen, in einem Szenario verwendet zu werden, in dem sie die Daten enthält, die zur Aktualisierung eines vorhandenen Datensatzes benötigt werden.

Wie dieses Beispiel funktioniert

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

Einrichten

1. Prüft die aktuelle Version der Organisation.
2. Importieren Sie eine verwaltete Lösung (UpsertSample_1_0_0_0_managed.zip), die eine Tabelle sample_product mit dem Alternativschlüssel sample_productcode erstellt. Stellen Sie sicher, dass die Indizes zur Unterstützung des Alternativschlüssels aktiv sind.

Demonstrieren

1. Die ProcessUpsert-Methode verarbeitet Daten in newsampleproduct.xml, um neue Produkte darzustellen, und erstellt 13 neue Datensätze.
2. Beim zweiten Aufrufen der ProcessUpsert-Methode erfolgt die Verarbeitung von Daten in der updatedsampleproduct.xml-Datei, um Aktualisierungen der zuvor erstellten Produkte darzustellen.
3. Die UpsertRequest-Methode erstellt 6 aktualisierte Datensätze.

Bereinigung

Zeigt eine Option an, um die verwaltete Lösung zu löschen, die in Einrichtung erstellt wurde. 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.