Перейти к основному содержимому

Настройка BPMN-элемента Platform Message Connector

Параметры BPMN-элемента Platform Message Connector используют параметры сущности канал сообщений электронной почты, которые настраиваются в интерфейсе AdminTools.

Прежде, чем вы приступите к настройке параметров BPMN-элемента Platform Message Connector в DevTools, вам необходимо создать канал сообщений электронной почты в AdminTools. Вы можете настроить канал сообщений электронной почты после того, как вы настроите параметры BPMN-элемента Platform Message Connector в DevTools. В таком случае в AdminTools убедитесь, что вы указываете имя канала, соответствующее указанному в параметре Message settings → Channel Name BPMN-элемента Platform Message Connector.

Сообщения электронной почты могут быть созданы на основе шаблонов. Шаблон записывается в формате JSON и содержит следующие поля:

  • Body: содержимое сообщения электронной почты с HTML-разметкой и замещающий текст, например, %name%.
  • From: имя отправителя.
  • Description: описание шаблона.
  • Type: тип содержимого сообщения. Например, укажите Html для поддержки HTML-разметки в содержимом сообщения.
  • Name: имя шаблона.

Например, в качестве шаблона сообщения электронной почты могут использоваться следующие:

{
  "Body": "Уважаемый(-ая) %name%, напоминаем о важных датах.",
  "From": "info@platform-md.ru",
  "Description": "Reminder Template",
  "Type": "Html",
  "Name": "Reminder_Template"
}
{
  "Body":"Уважаемый(-ая),

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

   С уважением,
   Администрация",
  "From":"Администрация",
  "Description":"template",
  "Type":"Html",
  "Name":"Scenario_4_sendtask_00_whithout_email"
}

Создайте шаблон сообщения с помощью любого редактора и сохраните шаблон в файле формата JSON.

Чтобы загрузить созданный шаблон сообщения в список шаблонов:

  1. В главном меню AdminTools выберите Messages.
  2. В разделе Message Manager, который отображается, выберите вкладку Templates.
  3. Нажмите Import, и в окне, которое отображается, выберите файл шаблона сообщения и нажмите Import.

Шаблон сообщения импортируется и отображается в списке шаблонов на вкладке Templates.

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

Чтобы создать канал сообщений электронной почты:

  1. В главном меню AdminTools выберите Messages.

  2. В разделе Message Manager, который отображается, выберите вкладку Channels.

  3. Нажмите + и в окне Channel, которое открывается, укажите следующие параметры для создания канала на основе импортированного шаблона:

    • Name (обязательный параметр): введите имя канала, например, MyNewChannel. Используйте латинские буквы и цифры.
    • Description (необязательный параметр): введите описание канала. Вы можете использовать любые символы.
    • Provider (обязательный параметр): из раскрывающегося списка выберите email.
    • Template (обязательный параметр): из раскрывающегося списка выберите шаблон, ранее загруженный в Платформу.

  4. В окне Channel нажмите Create.

Канал сообщений электронной почты создается и отображается в списке каналов на вкладке Channels.

Теперь вы можете использовать созданный канал сообщений электронной почты при настройке BPMN-элемента Platform Message Connector на схеме бизнес-процесса в DevTools.

Чтобы настроить параметры BPMN-элемента Platform Message Connector:

  1. На BPMN-схеме выберите элемент Platform Message Connector.

  2. На панели справа укажите следующие параметры BPMN-элемента:

    • Type → Type (обязательный параметр): значение ru.platform:EmailTask:1 установлено по умолчанию и не может быть изменено.
    • Message settings → Channel Name (обязательный параметр): из раскрывающегося списка выберите канал сообщений электронной почты, созданный в AdminTools, или введите имя нового канала, который вы создадите в AdminTools в дальнейшем. Вы можете использовать выражение на языке FEEL.
    • Message settings → Recipients input type (обязательный параметр): из раскрывающегося списка выберите Email для отправки сообщения электронной почты.
    • Message settings → Email recipient addresses (обязательный параметр): введите адреса электронной почты получателей сообщения через запятую. Вы можете использовать выражение на языке FEEL для динамического формирования списка получателей.
    • Message settings → Subject (обязательный параметр): введите тему сообщения. Например, вы можете ввести строку Изменение правил внутреннего распорядка.
    • Message settings → Template data input type (обязательный параметр): из раскрывающегося списка выберите Email для отправки сообщения электронной почты.
    • Message settings → Email templates (обязательный параметр): укажите значения для подстановки данных в шаблон сообщения электронной почты. Вы можете использовать выражение на языке FEEL для формирования текста сообщения электронной почты. Например, если в шаблоне используется %name% (см. пример шабона выше), в Message settings → Email templates вы можете указать следующее значение: {"name": "Иван Васильевич"}.
    • Message settings → Files (необязательный параметр): если к сообщению электронной почты вы хотите приложить файлы, введите BPMN-переменную, которая содержит ссылки на эти файлы. Вы можете использовать выражение на языке FEEL для формирования списка файлов.

  3. Вверху справа нажмите Сохранить.