Xrm.WebApi.online.executeMultiple (referenca klijentskog API-ja)

Izvršavanje zbirke akcija, funkcija ili crud operacija.

Napomena

Ta je metoda podržana samo za mrežni način rada (Xrm.WebApi.online).

Ako želite izvršiti više zahtjeva u transakciji, morate proslijediti promjenu postavljenu kao parametar za ovu metodu. Skupovi promjena predstavljaju zbirku operacija izvršenih u transakciji. Na tu metodu možete proslijediti i pojedinačne zahtjeve te zajedno mijenjati skupove kao parametre.

Napomena

• U skup promjena ne možete uvrstiti operacije čitanja (dohvaćanje, dohvaćanje više funkcija i web-API funkcija) to je kao u specifikacijama OData v4.
• Zahtjevi mogu sadržavati do 1000 pojedinačnih zahtjeva i ne mogu sadržavati druge serije. Dodatne informacije: Izvršavanje operacija grupe.

Sintaksa

Izvršavanje više zahtjeva:

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

Izvršavanje više zahtjeva u transakciji:

U ovom slučaju req1, , req2i req3 izvršavaju se u transakciji.

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

Izvršite kombinaciju pojedinačnih zahtjeva i više zahtjeva u transakciji:

U ovom slučaju , req1, req2i izvršavaju req3 se u transakciji, ali req4 i req5 izvršavaju se pojedinačno.

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

Parametara

Ime	Tip	Obvezno	Opis
requests	Niz objekata	Da	Polje jedne od sljedećih vrsta: Objekti za koje je svaki objekt akcija, funkcija ili CRUD zahtjev koji želite izvršiti na krajnjoj točki API-ja za web. Svaki objekt prikazuje metodu getMetadata koja vam omogućuje definiranje metapodataka za akciju, funkciju ili zahtjev za CRUD koji želite izvršiti. Metoda izvršenja prihvaća ovu vrstu parametra. Promijenite skup (polje objekata) gdje je svaki objekt u skupu promjena kao što je prethodno objašnjeno. U tom se slučaju svi objekti zahtjeva navedeni u skupu promjena izvršavaju u transakciji. Primjere zahtjeva potražite u odjeljku Sintaksa.
successCallback	Function	Ne	Funkcija koja se poziva kada se operacija uspješno izvrši. Funkciji se prosljeđuje polje objekata odgovora. Pogledajte povratnu vrijednost
errorCallback	Function	Ne	Funkcija za pozivanje kada operacija ne uspije. Prosljeđuje se objekt sa sljedećim svojstvima: - errorCode:Broj. Kôd pogreške kao pozitivan decimalni broj. Primjerice, kôd pogreške dokumentiran kao 0x80040333 će se vratiti kao 2147746611. - message:Gudački. Poruka o pogrešci koja opisuje problem.

Povratna vrijednost

Nakon uspjeha vraća obećanje koje sadrži polje objekata u successCallback. Objekti imaju sljedeća svojstva:

Ime	Tip	Obvezno	Opis
json	Obećanje	Ne	Tijelo odgovora u JSON obliku.
text	Obećanje	Ne	Tijelo odgovora u obliku običnog teksta.
headers	Objekt	Da	Zaglavlja odgovora.
ok	Booleov	Da	Označava je li zahtjev uspio.
status	Broj	Da	Brojčana vrijednost u kodu stanja odgovora. Npr: 200
statusText	String	Da	Opis koda statusa odgovora. Npr: OK
type	String	Da	Vrsta odgovora. Vrijednosti su: prazan niz (zadano), arraybuffer, blob, document, jsoni text.
url	String	Da	Zatražite URL akcije, funkcije ili CRUD zahtjeva koji je poslan na krajnju točku API-ja za web.

Povezani članci

Xrm.WebApi