Xrm.WebApi.online.executeMultiple (Referință API client)

Executați o colecție de operațiuni de acțiune, funcție sau CRUD.

Notă

Această metodă este acceptată doar pentru modul online (Xrm.WebApi.online).

Dacă doriți să executați mai multe solicitări într-o tranzacție, trebuie să treceți într-un set de modificări ca parametru pentru această metodă. Seturile de modificări reprezintă o colecție de operațiuni executate într-o tranzacție. De asemenea, puteți să transmiteți solicitări individuale și să modificați seturile împreună ca parametri la această metodă.

Notă

• Nu puteți include operațiuni de citire (regăsire, regăsire mai multe și funcții API Web) ca parte a unui set de modificări; acest lucru este conform specificațiilor OData v4.
• Solicitările pot conține până la 1.000 de solicitări individuale și nu pot conține alte grupuri. Mai multe informații: Executarea operațiunilor pe loturi.

Sintaxă

Se execută mai multe solicitări:

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

Executați mai multe solicitări într-o tranzacție:

În acest caz, req1, req2și req3 sunt executate într-o tranzacție.

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

Executați o combinație de solicitări individuale și solicitări multiple într-o tranzacție:

În acest caz, req1, req2și req3 sunt executate în tranzacție, dar req4 sunt req5 executate individual.

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

Parametrii

Nume	Tip	Obligatoriu	Descriere
requests	Matrice de obiecte	Da	Este o matrice cu unul dintre următoarele tipuri: Obiectele în care fiecare obiect este o acțiune, o funcție sau o solicitare CRUD pe care doriți să o executați în raport cu punctul final API Web. Fiecare obiect expune o metodă getMetadata care vă permite să definiți metadatele pentru acțiunea, funcția sau solicitarea CRUD pe care doriți să o executați. Metoda de executare acceptă acest tip de parametru. Modificați setul (o matrice de obiecte), unde fiecare obiect din setul de modificări este așa cum s-a explicat anterior. În acest caz, toate obiectele solicitate specificate în setul de modificări sunt executate într-o tranzacție. Găsiți exemple de solicitări în secțiunea Sintaxă.
successCallback	Funcţie	Nu	O funcție de apelat atunci când operațiunea este executată cu succes. O matrice de obiecte de răspuns este transmisă funcției. Consultați Valoarea returnată
errorCallback	Funcţie	Nu	O funcție de apelat atunci când operațiunea eșuează. Se transmite un obiect cu următoarele proprietăți: - errorCode:Număr. Codul de eroare ca număr zecimal pozitiv. De exemplu, codul de eroare documentat ca 0x80040333 va fi returnat ca 2147746611. - message:Șir. Un mesaj de eroare care descrie problema.

Valoare returnată

Pe succes, returnează o promisiune care conține o matrice de obiecte la successCallback. Obiectele au aceste proprietăți:

Nume	Tip	Obligatoriu	Descriere
json	Făgădui	Nu	Corpul răspunsului în format JSON.
text	Făgădui	Nu	Corp de răspuns în format text simplu.
headers	Obiect	Da	Anteturi de răspuns.
ok	Boolean	Da	Indică dacă solicitarea a reușit.
status	Număr	Da	Valoare numerică în codul de stare al răspunsului. De exemplu: 200
statusText	Șir	Da	Descrierea codului de stare al răspunsului. De exemplu: OK
type	Șir	Da	Tip de răspuns. Valorile sunt: șirul gol (implicit), arraybuffer, blob, document, json, și text.
url	Șir	Da	URL-ul solicitării acțiunii, funcției sau solicitării CRUD care a fost trimisă la punctul final API Web.

Articole asociate

Xrm.WebApi