Конвейер

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

Примечание

Конвейеры запускаются от имени системного пользователя Система со значением userId 44444444-2222-3333-0000-000000000000.

Значение userId пользователя отображается в ЦМ в подробностях событий и других записей.

Окно конвейера содержит следующие элементы:

  • Вкладка Основные

  • Вкладка Типы

  • Вкладка Переменные

  • Вкладка Схема

Вкладка Основные содержит:

  • Название: название конвейера, обязательно для заполнения.

  • Имя: имя конвейера, необязательно для заполнения. При присвоении имени необходимо учитывать перечень зарезервированных имен.

  • Комментарий: описание конвейера, необязательно для заполнения, поддерживается многострочный ввод.

  • Настройки хранилища: выбор типа хранилища:

    • В памяти

    • Очередь

  • Сохранять результаты конвейера в исходящей очереди: флаг устанавливается для сохранения результатов преобразования одного типа данных в другой будут сохраняться в исходящей очереди. Далее при установленном флаге Отправлять в Банк данных на вкладке Типы результаты работы конвейера могут быть обработаны алгоритмом сервиса Банк данных.

  • Запускать при получении сообщения установленного типа: флаг устанавливается для запуска конвейера при получении сообщения установленного типа.

  • Включен: флаг активирования / деактивирования алгоритма.

../../../_images/image181_conv.png

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

../../../_images/conv_typess.png

В разделе Входящие данные необходимо создать входящую переменную обрабатываемого типа.

Поддерживается возможность настроить автоматический запуск конвейера при появлении или удалении из банка данных объекта Типа обработки, если он имеет Сохраняемый тип данных. Эта функция включается установкой флага Забирать из Банка данных в разделе Входящие данные.

После установки флага необходимо выбрать, какое именно событие в банке данных должно вызывать срабатывание конвейера:

  • При создании: проверка соответствия условиям происходит в момент первой записи объекта в банк.

  • При изменении: проверка соответствия условиям происходит после обновления объекта.

  • При удалении: проверка соответствия условиям происходит перед выполнением удаления объекта из банка.

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

../../../_images/conv_in.png

В разделе Исходящие данные необходимо создать переменную с типом результата.

Поддерживается возможность настроить автоматическую запись в банк данных объекта Типа результата, если он имеет Сохраняемый тип данных. Эта функция включается установкой флага Отправлять в Банк данных в разделе Исходящие данные.

После установки флага в Условиях фильтрации необходимо настроить требования к объекту, при соблюдении которых будет выполняться запись в банк.

Для добавления типа входящих и / или исходящих данных:

  1. Нажмите на кнопку + в панели над соответствующей таблицей.

    Откроется всплывающее окно Параметр:

    ../../../_images/conv_type_select.png

  2. В окне произведите следующие настройки:

    • В поле Тип выберите тип данных.

    • В поле Наименование введите наименование типа (поле обязательно для заполнения).

    • При необходимости установите следующие флаги:

      • Массив: если предполагается использовать массив.

      • Разрешить NULL: если предполагается использование нулевых значений.

    • Укажите полный путь к типу данных.

    • Выберите значение переменной из списка.

    • Введите описание переменной.

    • В таблице Свойства добавьте строки свойств.

  3. Перейдите по ссылке Выбрать.

Вкладка Переменные содержит:

  • Панель кнопок управления.

  • Список переменных функции.

../../../_images/conv_var.png

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

Основной способ подбора (переменная обработки):

  • по типу данных переменная инициализирована этим типом данных.

  • по типу данных с признаком Использовать только для маршрутизации означает, что сама переменная не будет инициализирована этим типом данных. Переменная используется только для автоматического определения маршрута.

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

../../../_images/image183_conv.png

Подробное описание шагов находится в разделе Шаги процессов обработки.