Freigeben über

Xrm.WebApi.online.executeMultiple (Client-API-Referenz)

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 gemäß den v4-Spezifikationen von OData keine Lesevorgänge (abrufen, mehrere abrufen und Internet-API-Funktionen) als Bestandteil eines Changesets einschließen.
  • Anforderungen können bis zu 1.000 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.

Changeset (ein Array von Objekten), wobei jedes Objekt im Changeset wie oben erklärt ist. In diesem Fall werden alle Anforderungsobjekte, die im Changeset angegeben wurden, in einer Transaktion ausgeführt.

Anforderungsbeispiele finden Sie im Syntax-Abschnitt.
successCallback Function Nein Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich ausgeführt wird. Der Funktion wird ein Array von Antwortobjekten übergeben. Siehe Rückgabewert
errorCallback Function Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Es wird ein Objekt mit den folgenden Eigenschaften übergeben:
- errorCode: Zahl. Der Fehlercode als positive Dezimalzahl. Der als 0x80040333 dokumentierte Fehlercode wird zum Beispiel als 2147746611 zurückgegeben.
- message: Zeichenfolge Eine Fehlermeldung, die das Problem beschreibt.

Rückgabewert

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

Name typ 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

  • Last updated on