Xrm.WebApi.online.executeMultiple (справочник по API клиента)

Выполнение коллекции операций действия, функции или CRUD.

Замечание

Этот метод поддерживается только в интерактивном режиме (Xrm.WebApi.online).

Если вы хотите выполнить несколько запросов в транзакции, необходимо передать в этот метод набор изменений в качестве параметра. Наборы изменений представляют коллекцию операций, выполняемых в транзакции. Вы также можете передавать отдельные запросы и изменять наборы вместе в качестве параметров для этого метода.

Замечание

• Нельзя включать операции чтения (извлечение, извлечение нескольких и функций веб-API) в составе набора изменений; это соответствует спецификациям OData версии 4.
• Запросы могут содержать до 1000 отдельных запросов и не могут содержать другие пакеты. Дополнительные сведения: выполнение пакетных операций.

Синтаксис

Выполнение нескольких запросов:

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

Выполнение нескольких запросов в транзакции:

В этом случае req1req2, и 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);

Параметры

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

Возвращаемое значение

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

Имя	Тип	Обязательно	Description
json	Обещать	нет	Текст ответа в формате JSON.
text	Обещать	нет	Текст ответа в формате обычного текста.
headers	Object	Да	Заголовки ответа.
ok	Boolean	Да	Указывает, выполнен ли запрос успешно.
status	Number	Да	Числовое значение в коде состояния ответа. Например: 200
statusText	String	Да	Описание кода состояния ответа. Например: OK
type	String	Да	Тип ответа. Значения: пустая строка (по умолчанию), arraybuffer, blob, document, jsonи text.
url	String	Да	URL-адрес запроса действия, функции или CRUD, отправленного в конечную точку веб-API.

Связанные статьи

Xrm.WebApi