Xrm.WebApi.online.executeMultiple (kliento API nuoroda)

Vykdyti veiksmų, funkcijų arba CRUD operacijų rinkinį.

Pastaba.

Šis metodas palaikomas tik prisijungus (Xrm.WebApi.online).

Jei norite vykdyti kelias užklausas operacijoje, turite pereiti į keitimą, nustatytą kaip parametrą šiam metodui. Pakeitimų rinkiniai nurodo operacijų, kurios vykdomos operacijoje, rinkinį. Taip pat galite perduoti atskiras užklausas ir pakeisti rinkinius kaip šio metodo parametrus.

Pastaba.

• Negalite įtraukti skaitymo operacijų (nuskaityti, nuskaityti kelias ir žiniatinklio API funkcijas) kaip pakeitimų rinkinio dalies; tai atitinka "OData v4" specifikacijas.
• Užklausose gali būti iki 1 000 atskirų užklausų ir negali būti kitų paketų. Daugiau informacijos: Vykdykite paketines operacijas.

Sintaksė

Vykdyti kelias užklausas:

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

Vykdyti kelias užklausas operacijoje:

Šiuo atveju , req1req2ir req3 yra vykdomi operacijoje.

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

Vykdyti atskirų užklausų ir kelių užklausų derinį operacijoje:

Šiuo atveju , req1ir req2req3 yra vykdomi kaip operacija, bet req4 ir req5 vykdomi atskirai.

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

Parametrus

Pavadinimą	Rūšis	Privalomas	Aprašą
requests	Objektų masyvas	Taip	Vieno iš šių tipų masyvas: Objektai , kuriuose kiekvienas objektas yra veiksmas, funkcija arba CRUD užklausa, kurią norite vykdyti žiniatinklio API galiniame punkte. Kiekvienas objektas atskleidžia getMetadata metodą , kuris leidžia apibrėžti metaduomenis veiksmui, funkcijai arba CRUD užklausai, kurią norite vykdyti. Vykdymo metodas priima šio tipo parametrą. Keisti rinkinį (objektų masyvą), kur kiekvienas keitimų rinkinio objektas yra, kaip paaiškinta anksčiau. Šiuo atveju visi keitimo rinkinyje nurodyti užklausos objektai vykdomi operacijoje. Raskite užklausos pavyzdžių sekcijoje Sintaksė.
successCallback	Funkcija	Ne	Funkcija, iškviečiama sėkmingai įvykdžius operaciją. Funkcijai perduodamas atsako objektų masyvas. Žr. grąžinamą reikšmę
errorCallback	Funkcija	Ne	Funkcija, kurią reikia iškviesti, kai operacija nepavyksta. Perduotas objektas su šiomis ypatybėmis: - errorCode:Numeris. Klaidos kodas kaip teigiamas dešimtainis skaičius. Pavyzdžiui, klaidos kodas, dokumentuotas kaip 0x80040333 bus grąžintas kaip 2147746611. - message:Eilutės. Klaidos pranešimas, apibūdinantis problemą.

Grąžinimo reikšmė

Sėkmingai grąžins pažadą, kuriame yra objektų masyvas.successCallback Objektai turi šias ypatybes:

Pavadinimą	Rūšis	Privalomas	Aprašą
json	Žadėti	Ne	Atsakymo tekstas JSON formatu.
text	Žadėti	Ne	Atsakymo tekstas paprastojo teksto formatu.
headers	Daiktas	Taip	Atsakymo antraštės.
ok	Bulio logikos	Taip	Nurodo, ar užklausa buvo sėkminga.
status	Skaičius	Taip	Skaitinė reikšmė atsakymo būsenos kode. Pavyzdžiui: 200.
statusText	String	Taip	Atsakymo būsenos kodo aprašas. Pavyzdžiui: OK.
type	String	Taip	Atsakymo tipas. Reikšmės yra: tuščia eilutė (numatytoji), arraybuffer, blob, document, ir jsontext.
url	String	Taip	Veiksmo, funkcijos arba CRUD užklausos, išsiųstos į žiniatinklio API galinį punktą, užklausos URL.

Susiję straipsniai

Xrm.WebApi