Xrm.WebApi.online.executeMultiple (klienta API atsauce)

Izpildīt darbību, funkciju vai CRUD operāciju kolekciju.

Note

Šī metode tiek atbalstīta tikai tiešsaistes režīmā (Xrm.WebApi.online).

Ja transakcijā vēlaties izpildīt vairākus pieprasījumus, jums ir jānodod izmaiņu kopa kā šīs metodes parametrs. Izmaiņu kopas ir operāciju kopums, kas tiek izpildīts transakcijā. Varat arī nodot atsevišķus pieprasījumus un mainīt kopas kopā kā parametrus šai metodei.

Note

• Lasīšanas operācijas (izgūšana, vairāku izgūšana un Web API funkcijas) nevar iekļaut kā daļu no izmaiņu kopas; tas ir saskaņā ar OData v4 specifikācijām.
• Pieprasījumi var saturēt līdz 1 000 atsevišķiem pieprasījumiem un nevar saturēt citas partijas. Papildinformācija Pakešu operāciju izpilde.

Sintakse

Izpildiet vairākus pieprasījumus:

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

Vairāku pieprasījumu izpilde transakcijā:

Šajā gadījumā req1, req2un req3 tiek izpildīti transakcijā.

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

Izpildiet atsevišķu pieprasījumu un vairāku pieprasījumu kombināciju transakcijā:

Šajā gadījumā req1, req2un req3 tiek izpildīti darījumā, bet req4 un req5 tiek izpildīti atsevišķi.

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

Parametrus

Nosaukums/vārds	Tips	Obligāti	Apraksts
requests	Objektu masīvs	Jā	Masīvs, kas sastāv no šiem tipiem: Objekti , kuros katrs objekts ir darbība, funkcija vai CRUD pieprasījums, ko vēlaties izpildīt pret Web API galapunktu. Katrs objekts atklāj getMetadata metodi , kas ļauj definēt metadatus darbībai, funkcijai vai CRUD pieprasījumam, kuru vēlaties izpildīt. Izpildes metode pieņem šāda veida parametrus. Izmaiņu kopa (objektu masīvs), kur katrs izmaiņu kopas objekts ir tāds, kā paskaidrots iepriekš. Šajā gadījumā visi izmaiņu kopā norādītie pieprasījuma objekti tiek izpildīti darījumā. Pieprasījumu piemērus skatiet sadaļā Sintakse.
successCallback	Funkcija	Nē	Funkcija, kas jāizsauc, kad operācija ir veiksmīgi izpildīta. Funkcijai tiek nodots atbildes objektu masīvs. Skatīt atgriezto vērtību
errorCallback	Funkcija	Nē	Funkcija, kas jāizsauc, ja operācija neizdodas. Tiek nodots objekts ar šādām īpašībām: - errorCode:Skaitlis. Kļūdas kods kā pozitīvs decimālskaitlis. Piemēram, kļūdas kods, kas dokumentēts kā 0x80040333 , tiks atgriezts kā 2147746611. - message:Virkne. Kļūdas ziņojums, kurā aprakstīta problēma.

Atgrieztā vērtība

Pēc panākumiem atgriež solījumu, kas satur objektu masīvu .successCallback Objektiem ir šādas īpašības:

Nosaukums/vārds	Tips	Obligāti	Apraksts
json	Solījums	Nē	Atbildes ķermenis JSON formātā.
text	Solījums	Nē	Atbildes pamatteksts vienkārša teksta formātā.
headers	Objektu	Jā	Atbilžu galvenes.
ok	Būla	Jā	Norāda, vai pieprasījums bija veiksmīgs.
status	Numurs	Jā	Skaitliskā vērtība atbildes statusa kodā. Piemērs: 200
statusText	String	Jā	Atbildes statusa koda apraksts. Piemērs: OK
type	String	Jā	Atbildes veids. Vērtības ir: tukša virkne (noklusējums), arraybuffer, blob, jsondocument, un text.
url	String	Jā	Uz Web API galapunktu nosūtītās darbības, funkcijas vai CRUD pieprasījuma pieprasījuma pieprasījuma URL.

Saistītie raksti

Xrm.WebApi