Xrm.WebApi.online.executeMultiple (Клиент API анықтамасы)

Іс-әрекеттер, функциялар немесе CRUD операцияларының жиынтығын орындаңыз.

Ескертпе

Бұл әдіс тек онлайн режимде (Xrm.WebApi.online) қолдау көрсетіледі.

Егер транзакцияда бірнеше сұрауларды орындағыңыз келсе, осы әдіске параметр ретінде өзгерту жиынтығын беру керек. Өзгерістер жиынтығы транзакцияда орындалатын операциялар жиынтығын білдіреді. Сондай-ақ, сіз жеке сұрауларды жібере аласыз және жиынтықтарды осы әдістің параметрлері ретінде бірге өзгерте аласыз.

Ескертпе

• Оқу операцияларын (алу, бірнеше алу және веб-API функцияларын) өзгерту жиынтығының бөлігі ретінде қоса алмайсыз; Бұл OData V4 спецификацияларына сәйкес келеді.
• Сұраулар 1000-ға дейін жеке сұрауды қамтуы мүмкін және басқа топтарды қамтымауы мүмкін. Қосымша ақпарат: Пакеттік операцияларды орындау.

Синтаксис

Бірнеше сұрауларды орындау:

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

Транзакцияда бірнеше сұрауларды орындау:

Бұл жағдайда, req1, req2және req3 олар мәміле бойынша орындалады.

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

Транзакцияда жеке сұраулар мен бірнеше сұраулар жиынтығын орындаңыз:

Бұл жағдайда, req1, req2және req3 мәміле бойынша орындалады, бірақ req4 жеке-жеке req5 орындалады.

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

Параметрлер

РаT�	Түр	Талап етіледі	Сипаттама
requests	Нысандар массиві	Иә	Келесі түрлердің біреуінің массиві: Әрбір нысан веб-API соңғы нүктесінде орындағыңыз келетін әрекет, функция немесе CRUD сұрауы болып табылатын нысандар. Әрбір нысан орындағыңыз келетін әрекет, функция немесе CRUD сұрауы үшін метадеректерді анықтауға мүмкіндік беретін getMetadata әдісін көрсетеді. Әдістемелік нұсқаулық осы параметрді қабылдайды. Өзгерту жиынтығы (объектілер массиві), онда өзгерістер жиынтығындағы әрбір нысан жоғарыда түсіндірілгендей болады. Бұл жағдайда, өзгерістер жиынтығында көрсетілген барлық сұрау объектілері транзакцияда орындалады. Синтаксис бөлімінен сұрау мысалдарын табыңыз.
successCallback	Function	Жоқ	Операция сәтті орындалған кезде шақырылатын функция. Тапсырманы орындау барысында объектілердің жиынтығы беріледі. Қайтаратын мәнді қараңыз
errorCallback	Function	Жоқ	Операция істен шыққанда қоңырау шалу функциясы. Келесі қасиеттері бар нысан беріледі: - errorCode: Сан. Қате коды оң ондық сан ретінде. Мысалы, құжатталған 0x80040333 қате коды ретінде 2147746611қайтарылады. - message: Жол. Ақауды сипаттайтын қате туралы хабар.

Қайтаратын мән

Сәттілік сәтті болған жағдайда, объектілер successCallbackжиынтығын қамтитын уәдені қайтарады. Объектілердің мына қасиеттері бар:

РаT�	Түр	Талап етіледі	Сипаттама
json	Уәде	Жоқ	JSON пішіміндегі жауап органы.
text	Уәде	Жоқ	Ашық мәтін пішіміндегі жауаптың денесі.
headers	Нысан	Иә	Жауап тақырыптары.
ok	Логикалық	Иә	Өтініштің сәтті орындалғанын көрсетіңіз.
status	Саны	Иә	Жауаптың күй кодындағы сандық мән. Мысалы: 200
statusText	Жол	Иә	Жауап беру жүйесінің сипаттамасы. Мысалы: OK
type	Жол	Иә	Жауап түрі. Мәндері: бос жол (әдепкі), , , , және textjson. documentblobarraybuffer
url	Жол	Иә	Веб-API соңғы нүктесіне жіберілген әрекеттің, функцияның немесе CRUD сұрауының URL мекенжайын сұраңыз.

Қатысты мақалалар

Xrm.WebAPI