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);

Параметри

Ім'я	Ввести	Обов'язковий	Опис
requests	Масив об'єктів	Так	Масив одного з таких типів: Об'єкти , для яких кожен об'єкт є дією, функцією або запитом CRUD, який потрібно виконати з кінцевою точкою API Веб. Кожен об'єкт надає метод getMetadata , який дає змогу визначити метадані для дії, функції або запиту CRUD, який потрібно виконати. Метод execute приймає цей тип параметра. Набір змін (масив об'єктів), де кожен об'єкт у наборі змін пояснюється раніше. У цьому випадку всі об'єкти запиту, указані в наборі змін, виконуються в транзакції. Знайдіть приклади запитів у розділі Синтаксис.
successCallback	Function	Ні	Функція, яка викликається під час успішної операції. До функції передається масив об'єктів відповіді. Див . повернуте значення
errorCallback	Function	Ні	Функція для виклику, коли операція не вдається. Передано об'єкт із такими властивостями: - errorCode:Число. Код помилки як додатне десяткове число. Наприклад, код помилки, задокументований як 0x80040333 , буде повернуто як 2147746611. - message:Рядок. Повідомлення про помилку з описом проблеми.

Повернуте значення

Після успішного виконання повертається обіцянка, яка містить масив об'єктів для successCallback. Об'єкти мають такі властивості:

Ім'я	Ввести	Обов'язковий	Опис
json	Обіцяти	Ні	Текст відповіді у форматі JSON.
text	Обіцяти	Ні	Текст відповіді у форматі звичайного тексту.
headers	Об'єкт	Так	Заголовки відповідей.
ok	логічний	Так	Указує, чи успішно виконано запит.
status	Номер	Так	Числове значення в коді стану відповіді. Наприклад: 200
statusText	String	Так	Опис коду стану відповіді. Наприклад: OK
type	String	Так	Тип відповіді. Значення: пустий рядок (за замовчуванням), arraybuffer, blob, document, jsonі text.
url	String	Так	URL-адреса запиту на дію, функцію або запит CRUD, надісланий до кінцевої точки API веб-сайту.

Пов’язані статті

Xrm.WebApi