Xrm.WebApi.online.executeMultiple (client-API-verwijzing)

Voer een verzameling actie-, functie- of CRUD-bewerkingen uit.

Opmerking

Deze methode wordt alleen ondersteund voor de onlinemodus (Xrm.WebApi.online).

Als u meerdere aanvragen in een transactie wilt uitvoeren, moet u een wijzigingsset als parameter doorgeven aan deze methode. Wijzigingensets vertegenwoordigen een verzameling bewerkingen die worden uitgevoerd in een transactie. U kunt ook afzonderlijke aanvragen doorgeven en sets wijzigen als parameters voor deze methode.

Opmerking

• U kunt geen leesbewerkingen (ophalen, meerdere functies en web-API-functies ophalen) opnemen als onderdeel van een wijzigingsset; dit is volgens de OData v4-specificaties.
• Aanvragen kunnen maximaal 1000 afzonderlijke aanvragen bevatten en kunnen geen andere batches bevatten. Meer informatie: Batchbewerkingen uitvoeren.

Syntaxis

Meerdere aanvragen uitvoeren:

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

Meerdere aanvragen uitvoeren in een transactie:

In dit geval req1worden , req2en req3 uitgevoerd in een transactie.

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

Voer een combinatie van afzonderlijke aanvragen en meerdere aanvragen in een transactie uit:

In dit geval req1worden , req2en req3 uitgevoerd in transactie, maar req4 en req5 worden ze afzonderlijk uitgevoerd.

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

Parameterwaarden

Naam	Typologie	Verplicht	Description
requests	Matrix van objecten	Yes	Een matrix van een van de volgende typen: Objecten waarbij elk object een actie, functie of CRUD-aanvraag is die u wilt uitvoeren op het web-API-eindpunt. Elk object maakt een getMetadata-methode beschikbaar waarmee u de metagegevens voor de actie, functie of CRUD-aanvraag kunt definiëren die u wilt uitvoeren. De methode execute accepteert dit type parameter. Wijzigingsset (een matrix met objecten), waarbij elk object in de wijzigingsset wordt uitgelegd zoals eerder is uitgelegd. In dit geval worden alle aanvraagobjecten die zijn opgegeven in de wijzigingenset, uitgevoerd in een transactie. Zoek aanvraagvoorbeelden in de sectie Syntaxis.
successCallback	Functie	Nee.	Een functie die moet worden aangeroepen wanneer de bewerking is uitgevoerd. Er wordt een matrix met antwoordobjecten doorgegeven aan de functie. Zie Retourwaarde
errorCallback	Functie	Nee.	Een functie om aan te roepen wanneer de bewerking mislukt. Er wordt een object met de volgende eigenschappen doorgegeven: - errorCode:Getal. De foutcode als een positief decimaal getal. De foutcode die wordt beschreven zoals 0x80040333 wordt geretourneerd als 2147746611. - message:Snaar. Een foutmelding die het probleem beschrijft.

Retourwaarde

Bij succes retourneert u een belofte met een matrix van objecten aan de successCallback. De objecten hebben de volgende eigenschappen:

Naam	Typologie	Verplicht	Description
json	Beloven	Nee.	Hoofdtekst van antwoord in JSON-indeling.
text	Beloven	Nee.	Hoofdtekst van antwoord in tekst zonder opmaak.
headers	Object	Yes	Antwoordheaders.
ok	Booleaan	Yes	Geeft aan of de aanvraag is geslaagd.
status	Number	Yes	Numerieke waarde in de antwoordstatuscode. Bijvoorbeeld: 200
statusText	Snaar / Touwtje	Yes	Beschrijving van de antwoordstatuscode. Bijvoorbeeld: OK
type	Snaar / Touwtje	Yes	Antwoordtype. Waarden zijn: de lege tekenreeks (standaard), arraybuffer, blob, document, jsonen text.
url	Snaar / Touwtje	Yes	Aanvraag-URL van de actie, functie of CRUD-aanvraag die is verzonden naar het web-API-eindpunt.

Verwante artikelen

Xrm.WebApi