Freigeben über

Xrm.WebApi.online.executeMultiple (Client API reference)

  • Artikel

Führen Sie eine Sammlung von Aktionen, Funktionen oder CRUD-Vorgängen aus.

Anmerkung

Diese Methode wird nur für den online-Modus unterstützt (Xrm.WebApi.online).

Wenn Sie mehrere Anforderungen in der Transaktion ausführen möchten, müssen Sie in ein Changeset als Parameter übergeben an diese Methode. Changesets sind eine Sammlung Vorgängen, die innerhalb derselben Transaktion ausgeführt werden. Sie können auch einzelne Anforderungen und Changesets zusammen als Parameter an diese Methode übergeben.

Anmerkung

  • Sie können keine Lesevorgänge einschließen (abrufen, mehrere Abrufen und Internet-API-Funktionen) als Bestandteil eines Changesets; dies ist gemäß den ODatas v4-Spezifikation.
  • Anforderungen können bis zu 1000 einzelne Anforderungen enthalten. Sie können keine anderen Batches enthalten. Weitere Informationen: Ausführen von Batchvorgängen.

Syntax

Ausführen mehrerer Anforderungen:

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Mehrere Anforderungen in einer Transaktion ausführen:

In diesem Fall werden req1, req2 und req3 in einer Transaktion ausgeführt.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Ausführen einer Mischung aus einzelnen Anforderungen und mehreren Anforderungen in der Transaktion:

In diesem Fall werden req1, req2 und req3 in der Transaktion ausgeführt, aber req4 und req5 werden individuell ausgeführt.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Parameter

Name typ Erforderlich Beschreibung
requests Array von Objekten Ja Ein Array einer der folgenden Typen:

Objekte, wobei jedes Objekt eine Aktion, Funktion oder CRUD-Anforderung ist, die Sie mit dem Web-API-Endpunkt ausführen möchten. Jedes Objekt exponiert eine getMetadata-Methode, mit der Sie Metadaten für die Aktion, Funktion oder CRUD-Anforderung definieren können, die Sie ausführen möchten. Die execute-Methode akzeptiert diesen Parametertyp.

Änderungssatz (ein Objektarray), wobei jedes Objekt im Änderungssatz wie oben definiert ist. In diesem Fall werden alle Anforderungsobjekte, die im Changeset angegeben wurden, in einer Transaktion ausgeführt.

Weitere Informationen finden Sie im Abschnitt Syntax.
successCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich ausgeführt wird. Der Funktion wird ein Array von Antwortobjekten übergeben. Siehe Rückgabewert
errorCallback Funktion Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Gibt bei Erfolg ein „Versprechen”-Objekt zurück, das ein Objektarray zu successCallback enthält. Die Objekte haben diese Eigenschaften:

Name Type Erforderlich Beschreibung
json Versprechen Nein Antwortkörper im JSON-Format.
text Versprechen Nein Antwortkörper im Klartextformat.
headers Object Ja Antwortheader.
ok Boolesch Ja Gibt an, dass die Anforderung erfolgreich war.
status Number Ja Numerischer Wert im Antwortstatuscode. Beispiel: 200
statusText Zeichenfolge Ja Beschreibung des Antwortstatuscodes. Beispiel: OK
type Zeichenfolge Ja Antworttyp. Werte sind: die leere Zeichenfolge (Standard), arraybuffer, blob, document, json und text.
url Zeichenfolge Ja Anforderungs-URL der Aktion, Funktion oder CRUD-Anfrage, die an den Internet API-Endpunkt gesendet wurde.

Xrm.WebApi