Xrm.WebApi.online.executeMultiple (kliendi API viide)

Saate käivitada toimingu-, funktsiooni- või CRUD-toimingute kogumi.

Märkus.

Seda meetodit toetatakse ainult võrgurežiimis (Xrm.WebApi.online).

Kui soovite sooritada tehingus mitu päringut, peate selle meetodi parameetrina edastama muudatusekomplekti. Muudatuste komplektid tähistavad tehingus käivitatud toimingute kogumist. Saate ka edastada üksikuid taotlusi ja muuta kogumeid selle meetodi parameetritena.

Märkus.

• Te ei saa kaasata lugemistoiminguid (mitme funktsiooni toomine, toomine ja veebi-API funktsioonid) muutmiskomplekti osana; see vastab OData v4 tehnilistele andmetele.
• Taotlused võivad sisaldada kuni 1000 üksiktaotlust ja ei tohi sisaldada muid pakette. Lisateave: Pakett-toimingute käivitamine.

Süntaks

Mitme päringu täitmine:

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

Tehingus mitme päringu täitmine:

Sel juhul req1req2käivitatakse , ja req3 käivitatakse tehingus.

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

Käivitage tehingu üksikute taotluste ja mitme päringu kooslus:

Sel juhul req1käivitatakse , req2ja req3 käivitatakse tehingus, kuid req4 need req5 täidetakse ükshaaval.

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

Parameetrid

Nimi	Tüüp	Nõutav	Kirjeldus
requests	Objektide massiiv	Jah	Massiiv, mis sisaldab ühte järgmistest tüüpidest: Objektid , kus iga objekt on toiming, funktsioon või CRUD-taotlus, mida soovite veebi API lõpp-punkti suhtes täita. Iga objekt paljastab meetodi too metaandmed , mis võimaldab teil määratleda käivitatava toimingu, funktsiooni või CRUD-päringu metaandmed. Täitmismeetod aktsepteerib seda tüüpi parameetrit. Change set (an array of objects), where each object in the change set is as previously explained. Sel juhul käivitatakse tehingus kõik muutmiskomplektis määratud päringuobjektid. Taotluse näiteid leiate jaotisest Süntaks.
successCallback	Function	Ei	Funktsioon, mis helistab, kui toiming on edukalt käivitatud. Funktsioonile edastatakse vastuseobjektide massiiv. Kuva tagastusväärtus
errorCallback	Function	Ei	Funktsioon, mida kutsuda, kui toiming nurjub. Edastatakse järgmiste atribuutidega objekt: - errorCode:Arv. Tõrkekood positiivse kümnendarvuna. Näiteks tagastatakse kujul dokumenteeritud 0x80040333 tõrkekood.2147746611 - message:String. Probleemi kirjeldav tõrketeade.

Tagastatav väärtus

Edu korral tagastab lubaduse, mis sisaldab objektide massiivi.successCallback Objektidel on järgmised atribuudid.

Nimi	Tüüp	Nõutav	Kirjeldus
json	Lubadus	Ei	Vastuse keha JSON-vormingus.
text	Lubadus	Ei	Vastuse keha lihttekstivormingus.
headers	Ese	Jah	Vastuse päised.
ok	loogiline	Jah	Näitab, kas taotlus oli edukas.
status	Number	Jah	Arvväärtus vastuse olekukoodis. Näiteks: 200
statusText	String	Jah	Vastuse olekukoodi kirjeldus. Näiteks: OK
type	String	Jah	Vastuse tüüp. Väärtused on: tühi string (vaikeväärtus), arraybuffer, blob, document, jsonja text.
url	String	Jah	Veebi API lõpp-punkti saadetud toimingu, funktsiooni või CRUD-päringu URL-i taotlemine.

Seotud artiklid

Xrm.WebApi