Beispiel: Ausführen mehrerer Anforderungen

Dieses Beispiel zeigt, wie Sie mehrere Organisationsnachrichtenanforderungen mithilfe eines einzelnen Webdienst-Methodenaufrufs ausführen, indem Sie ExecuteMultipleRequest als Parameter übergeben. Das Reduzieren der Anzahl der Nachrichtenanforderungen, die über das Netzwerk gesendet werden müssen, führt zu einer höheren Nachrichtenverarbeitungsleistung.

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 ExecuteMultipleRequest Nachricht soll in einem Szenario verwendet werden, in dem sie Daten enthält, die erforderlich sind, um eine oder mehrere Nachrichtenanforderungen als eine einzelne Batch-Operation auszuführen und optional eine Sammlung von Ergebnissen zurückzugeben.

Wie dieses Beispiel funktioniert

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

Einrichten

Prüft auf aktuelle Version der Organisation.

Demonstrieren

1. Die ExecuteMultipleRequest Methode erstellt das ExecuteMultipleRequest-Objekt.
2. Die ExecutingMultipleSettings Methode weist Einstellungen zu, die das Ausführungsverhalten definieren: bei Fehlern fortfahren, Antworten zurückgeben.
3. Die OrganizationRequestCollection Methode erstellt eine leere Organisationsanforderungssammlung.
4. Die Methode CreateRequest wird für jede Tabelle zur Anforderungssammlung hinzugefügt.
5. Die Klasse GetCollectionOdEntitiesToUpdate aktualisiert die zuvor erstellten Tabellen.

Bereinigung

Zeigt eine Option an, um die Datensätze zu löschen, die in der Einrichtung erstellt 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.