Отложенные запросы

Отложенные запросы предназначены для выполнения запросов по событиям, обработка которых занимает продолжительное время, а также для создания цепочек связанных запросов, выполняемых последовательно.

Если запрос не был выполнен в течение установленного времени ожидания, платформа предлагает отложить его выполнение. После этого пользователь может перейти в другой раздел и позднее посмотреть состояние и результат выполнения запроса.

Для работы с отложенными запросами перейдите в раздел События → Отложенные запросы (см. рисунок 1).

Рисунок 1 – Раздел "Отложенные запросы"

В таблице отображается следующая информация:

Идентификатор – уникальный идентификатор запроса;
Сущность – тип данных, по которым выполняется запрос;
Инициатор – пользователь, запустивший запрос;
Статус – текущее состояние выполнения запроса;
Время старта – дата и время начала выполнения запроса;
Время окончания – дата и время окончания выполнения запроса;
Порядок выполнения – порядковый номер запроса в последовательности запросов;
Таймаут запроса – максимальное время выполнения запроса;
Время хранения – срок хранения запроса и его результата;
Создано – дата и время создания запроса;
Обновлено – дата и время последнего изменения запроса.

Запрос может находиться в одном из следующих статусов:

Запланирован – запрос ожидает выполнения;
Выполняется – запрос выполняется;
Завершен – запрос успешно выполнен;
Завершен с ошибкой – при выполнении запроса произошла ошибка;
Отменен пользователем – выполнение запроса было остановлено пользователем.

В разделе доступны текстовый и строгий поиск, фильтрация, сортировка, обновление таблицы, настройка отображаемых полей, а также удаление выбранных или всех запросов.

Также доступны следующие действия:

просмотр информации о запросе;
редактирование запроса;
повторное выполнение запроса;
отмена выполнения запроса;
удаление запроса.

Набор доступных действий зависит от текущего статуса запроса.

Создание отложенного запроса

Отложенный запрос создаётся из раздела События при выполнении запроса по потоку событий.

Если выполнение запроса превышает установленное время ожидания, платформа отображает окно с предложением отложить его выполнение (см. рисунок 2).

Рисунок 2 – Предложение отложить выполнение запроса

Для создания отложенного запроса нажмите кнопку Отложить запрос. Откроется форма редактирования созданного запроса.

Чтобы закрыть окно без создания отложенного запроса, нажмите кнопку Закрыть.

Созданный запрос появится в разделе События → Отложенные запросы.

Просмотр и редактирование запроса

Для редактирования запроса нажмите кнопку редактирования. Откроется форма Редактирование отложенного запроса (см. рисунок 3).

Рисунок 3 – Редактирование отложенного запроса

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

В правой части формы отображается следующая информация:

Идентификатор – уникальный идентификатор запроса;
Сущность – тип данных, по которым выполняется запрос;
Статус – текущее состояние запроса;
Порядок выполнения – место запроса в последовательности;
Инициатор – пользователь, создавший запрос;
Время старта – дата и время начала выполнения;
Время окончания – дата и время завершения выполнения;
Создано – дата и время создания;
Обновлено – дата и время последнего изменения.

Для настройки запроса используются фильтры и агрегации, доступные в просмотрщике событий.

В блоке Фильтры отображаются условия, по которым выполняется запрос.

Для работы с условиями доступны следующие действия:

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

В блоке Агрегации можно добавить или удалить параметры агрегации данных.

Для сохранения внесённых изменений нажмите кнопку Сохранить.

Создание подзапроса

Подзапрос позволяет сформировать последовательность связанных запросов.

Для добавления подзапроса откройте форму редактирования запроса и нажмите кнопку Создать подзапрос. Новый запрос будет связан с исходным и отобразится на схеме.

После настройки подзапроса нажмите кнопку Сохранить.

Повторное выполнение запроса

Для повторного выполнения нажмите кнопку .

При повторном выполнении сохранённый результат предыдущего запуска удаляется и заменяется новым результатом.

Отмена выполнения запроса

Для остановки запроса нажмите кнопку отмены выполнения в соответствующей строке.

Отмена доступна для запросов, выполнение которых ещё не завершено. После отмены запросу присваивается статус Отменен пользователем.

Удаление запросов

Для удаления одного запроса нажмите кнопку удаления в соответствующей строке.

Для удаления нескольких запросов выполните следующие действия:

Установите флаги в строках необходимых запросов.
Нажмите кнопку Удалить.
В открывшемся окне подтвердите удаление, нажав кнопку Да.

Для отмены удаления нажмите кнопку Нет.

Чтобы удалить все запросы, нажмите кнопку Удалить все и подтвердите действие.

Настройка отображаемых полей

Для изменения состава и порядка колонок нажмите кнопку . Откроется окно Настройки отображения полей

В левой части окна отображаются доступные поля, а в правой – поля, добавленные в таблицу.

В окне доступны следующие действия:

добавление поля в таблицу;
удаление поля из таблицы;
изменение порядка отображения полей;
поиск поля по его наименованию;
восстановление набора полей по умолчанию.

Для сохранения настроек нажмите кнопку Применить.

Настройка времени ожидания запроса

Время, по истечении которого платформа предложит отложить выполнение запроса, задаётся в управлении конфигурацией.

Для изменения значения перейдите в раздел Управление конфигурацией → Общие и найдите блок Отложенные запросы (см. рисунок 4).

Рисунок 4 – Настройка времени ожидания запроса

В поле Время ожидания запроса (секунды) укажите количество секунд, в течение которых платформа должна ожидать результат выполнения запроса.

Если запрос не будет выполнен за указанное время, пользователю будет предложено отложить его выполнение.