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 се изпълняват в транзакция, но req5req4 се изпълняват поотделно.

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

Параметри

Име	Type	Необходимо	Описание
requests	Масив от обекти	Да	Масив от един от следните типове: Обекти , където всеки обект е действие, функция или CRUD искане, което искате да изпълните спрямо крайната точка на уеб API. Всеки обект показва метод getMetadata , който ви позволява да дефинирате метаданните за действието, функцията или CRUD искането, което искате да изпълните. Методът за изпълнение приема този тип параметър. Промяна на набора (масив от обекти), където всеки обект в набора от промени е както е обяснено по-горе. В този случай всички обекти на искане, зададени в набора от промени, се изпълняват в транзакция. Намерете примери за искане в секцията "Синтаксис".
successCallback	Function	Не	Функция за извикване, когато операцията се изпълни успешно. На функцията се подава масив от обекти на отговор. Вижте върнатата стойност
errorCallback	Function	Не	Функция, която да се извика, когато операцията е неуспешна. Подаден е обект със следните свойства: - errorCode:Номер. Кодът на грешката като положително десетично число. Например кодът на грешката, документиран като 0x80040333 ще бъде върнат като 2147746611. - message:Низ. Съобщение за грешка, описващо проблема.

Връщана стойност

При успех връща обещание, съдържащо масив от обекти в successCallback. Обектите имат следните свойства:

Име	Type	Необходимо	Описание
json	Обещание	Не	Основен текст на отговора във формат JSON.
text	Обещание	Не	Основен текст на отговора във формат на обикновен текст.
headers	Обект	Да	Заглавки на отговор.
ok	булев	Да	Показва дали искането е успешно.
status	Номер	Да	Числова стойност в кода на състоянието на отговора. Например: 200
statusText	String	Да	Описание на кода на състоянието на отговора. Например: OK
type	String	Да	Тип отговор. Стойностите са: празен низ (по подразбиране), arraybuffer, , blobdocument, json, и text.
url	String	Да	Заявка за URL адрес на действието, функцията или CRUD заявката, която е изпратена до крайната точка на уеб API.

Свързани статии

Xrm.WebApi