Работа с Хранилищем сообщений

В схемах обработки находятся шаги для доступа к Хранилищу сообщений аналогично шагам для работы с банком данных. Они доступны в общем списке шагов на вкладке Схема в разделе Хранилище сообщений.

Внимание

В версии 3.1 на вкладке Результат выполнения у шагов Поместить в MS и Получить из MS были переименованы переменные. Если в схемах процессов был настроен маппинг этих переменных с использованием настроек выражения, после обновления Платформы на версию 3.1 проверка и применение конфигурации будет прерываться ошибкой. Для исправления удалите маппинг вручную и настройте его заново, при этом в настройках выражения отобразится новое имя переменной.

Поместить в MS

Шаг помещает сообщение в Хранилище и аналогичен в настройке шагу Запись объекта, который работает с банком данных.

На вкладке Основные доступны следующие настройки шага:

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

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

  • В поле Время ожидания указывается время ожидания ответа в миллисекундах. Сообщение, которое помещается в Хранилище, будет ожидать в очереди для отправки в хранилище указанное время, по истечении которого попытки поместить сообщение в Хранилище прекратятся, и сообщение будет помещено в архив. Диапазон значений 0-1800000, где 0 - значение по умолчанию, соответствует максимальному времени 30 минут; 1 - минимальное время; 1800000 - максимальное время (30 минут).

  • В поле Сообщение указывается объект для записи в Хранилище. Можно выбрать системные переменные или переменные в контексте процесса; это может быть единичное сообщение или массив сообщений.

  • Флажок Игнорировать повторную отправку в Хранилище. Установлен по умолчанию. Если флажок установлен, сообщение, записанное этим шагом в Хранилище, при его переотправке из Хранилища (с помощью кнопки переотправки в ЦМ или шага Переотправить из MS) не будет помещено в Хранилище повторно. Если флажок не установлен, при переотправке сообщение будет повторно помещено в Хранилище.

Шаг возвращает результат в локальную переменную МассивИдентификаторовЗаписей - массив идентификаторов записей, сделанных в Хранилище (массив типа Guid). В случае записи единичного сообщения результатом будет массив c одним элементом.

Примечание

При использовании в маршруте из шага доступен только выход (параллельное выполнение).

Переотправить из MS

Шаг ищет записи в Хранилище по идентификатору записи в Хранилище. Из найденных записей шаг извлекает сообщения и отправляет их на повторную обработку.

Процесс для обработки сообщения при переотправке берется из значения свойства ProcessId переотправляемого сообщения (соответствует значению в колонке Процесс на вкладке Сообщения в ЦМ). Записи остаются в Хранилище после переотправки.

На вкладке Основные доступны следующие настройки шага:

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

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

  • В поле Идентификатор записи указывается переменная типа Guid или массив типа Guid.

  • Флажок После обработки относится к трансформациям. Если сообщение было помещено в Хранилище во время обработки в трансформации (входящей или исходящей) с переотправкой этого сообщения на шаге Переотправить из MS в настройках которого установлен флажок, эта трансформация не будет выполняться, а переотправляемое сообщение сразу перейдет в Платформе на этап обработки, следующий после трансформации. Если флажок не установлен (настройка по умолчанию), при переотправке сообщение попадет на обработку в Платформе в начало выполнения трансформации.

Существует в MS

Шаг проверяет наличие в Хранилище записи с указанными идентификаторами. Поиск идентификаторов производится по идентификаторам записей в Хранилище.

На вкладке Основные доступны следующие настройки шага:

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

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

  • В поле Идентификатор записи указывается переменная типа Guid или массив типа Guid. Также доступен выбор переменной типа данных, являющегося сохраняемым (объект банка данных) из выпадающего меню при нажатии на кнопку .

Шаг возвращает результат в локальную переменную IsExist (тип bool). Значение true, если записи существуют.

Удалить из MS

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

На вкладке Основные доступны следующие настройки шага:

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

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

  • В поле Идентификатор записи указывается переменная типа Guid или массив типа Guid. Также доступен выбор переменной типа данных, являющегося сохраняемым (объект банка данных) из выпадающего меню при нажатии на кнопку .

  • В поле Время ожидания указывается время ожидания ответа в миллисекундах.

Шаг возвращает результат в локальную переменную IsDeleted (тип bool). Значение true, если записи удалены.

Примечание

Выход (параллельное выполнение) отсутствует в шаге.

Получить из MS

Шаг получает записи из Хранилища в соответствии с идентификаторами и извлекает из них сообщения для дальнейшей обработки. Поиск идентификаторов производится по значениям идентификаторов записей Хранилища.

На вкладке Основные доступны следующие настройки шага:

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

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

  • В поле Идентификатор записи указывается переменная типа Guid или массив типа Guid.

Шаг возвращает результат в локальную переменную СписокСообщений (тип массив Сообщений).