Класс BatchQuery

Сложный
PDF

Пространство имен Terrasoft.Nui.ServiceModel.DataContract библиотеки классов Terrasoft.Nui.ServiceModel.dll.

Назначение класса BatchQuery — выполнение пакетных запросов.

Пакетный запрос — коллекция произвольных запросов к сервису работы с данными DataService. Пакетные запросы используются для минимизации обращений к сервису работы с данными DataService, что позволяет повысить производительность приложения. Передача данных непосредственно в сервис работы с данными DataService осуществляется по HTTP протоколу при помощи POST-запроса по URL.

/* Формат URL для пакетного POST-запроса к DataService. */
http(s)://[Адрес приложения Creatio]/[Номер конфигурации]/dataservice/[Формат данных]/reply/BatchQuery
/* Пример URL для пакетного POST-запроса к DataService. */
http(s)://example.creatio.com/0/dataservice/json/reply/BatchQuery

Данные пакетного запроса могут передаваться в различных форматах. Одним из удобных для восприятия форматов является формат JSON.

Структура контракта данных BatchQuery
{
    "ContinueIfError":[Продолжить выполнение запроса в случае ошибки],
    "IncludeProcessExecutionData":[Данные о выполнении процесса],
    "Queries": [
        { 
            "__type": "[Полное квалифицированное имя типа запроса]", 
            /* Содержимое единичного запроса. */
            ... 
        }, 
        /* Другие единичные запросы. */
        ... 
    ] 
}

На заметку. Полный перечень свойств класса BatchQuery и его родительских классов можно найти в Библиотеке .NET классов.

Свойства 

ContinueIfError bool

Продолжить выполнение запроса в случае ошибки.

IncludeProcessExecutionData bool

Флаг, который включает данные о выполнении процесса.

Queries List<BaseQuery>

Коллекция единичных запросов. Для формирования содержимого единичных запросов, которые включены в пакетный запрос, можно воспользоваться контрактами данных InsertQuery, SelectQuery, UpdateQuery и DeleteQuery.