Введение

Здесь представлены инструкции по настройке подключения и пути передачи данных из эл. писем в бизнес-процессе.

Кроме того, потребуется настроить начальное или промежуточное событие-получение сообщения на диаграмме процесса.

Подробный пример настройки приложения для обмена данными посредством эл. почты см. в статье «Пример: согласование заявлений по эл. почте. Настройка подключений, путей передачи данных и диаграммы процесса».

Порядок настройки получения эл. писем

1. Настройте подключение типа «Получение эл. почты в процессе».
2. Настройте путь передачи данных типа «Получение эл. почты в процессе».

3. Настройте начальное или промежуточное событие-получение сообщения на диаграмме процесса:

   • укажите настроенный путь передачи данных;
   • настройте сопоставление данных сообщения.

Настройка подключения

1. На странице Администрирование» выберите пункт «Инфраструктура» — «Подключения» ‌.
2. Откройте или создайте подключение к электронной почте типа «Получение эл. почты в процессе».

3. Настройте подключение:

   • Отключить — установите этот флажок, если требуется временно деактивировать данное подключение.
   • Название — укажите наименование подключения.
   • Протокол — выберите почтовый протокол:
     • IMAP
       • Порт — укажите порт для подключения к почтовому серверу.
       • Защита данных — выберите протокол шифрования:
         • Нет;
         • SSL;
         • TLS.
     • Microsoft Exchange
       • Домен — укажите домен для доступа к серверу Exchange.
       • Версия — выберите версию сервера Exchange.

   • Адрес почтового сервера — укажите URL почтового сервера.

     Примечание

     • Для SMTP не указывайте протокол (SMTP, HTTPS, HTTP).
     • Для Exchange укажите протокол (HTTPS, HTTP).

   • Имя пользователя — укажите учётную запись для подключения к почтовому серверу.

   • Пароль — введите пароль к учётной записи для подключения к почтовому серверу.
   • Интервал опроса — укажите интервал, с которым Comindware Platform будет проверять наличие новых писем.
   • Проверить соединение — нажмите эту кнопку, чтобы проверить соединение с почтовым сервером.

4. Нажмите кнопку «Создать».

Настройка пути передачи данных

Путь передачи данных типа «Получение эл. почты в процессе» служит для преобразования и передачи данных из эл. письма в Comindware Platform.

1. Откройте страницу «Администрирование» — «Архитектура» или страницу «Администрирование» приложения.
2. Выберите пункт «Пути передачи данных» ‌.
3. Откройте или создайте путь передачи данных типа «Подключения к электронной почте» – «Получение эл. почты в процессе».

4. Настройте свойства пути передачи данных на следующих вкладках:

   • Основные свойства
   • Атрибуты сообщения

5. Сохраните путь передачи данных.

Основные свойства

На вкладке «Основные свойства» настройте базовые параметры пути передачи данных:

• Отключить — установите этот флажок, чтобы временно деактивировать путь передачи данных.
• Название — введите наглядное наименование пути передачи данных.
• Подключение — выберите подключение типа «Получение эл. почты в процессе».
• Имя сообщения — введите уникальный идентификатор сообщения, проходящего по данному пути передачи данных.
• Приложение — выберите бизнес-приложение, в котором будет использоваться путь передачи данных.
• Процесс — выберите процесс из приложения, в котором будет использоваться путь передачи данных.
• Назначение:
  • Новый экземпляр процесса — полученное сообщение будет создавать новый экземпляр указанного процесса;
  • Существующий экземпляр процесса — полученное сообщение будет отправлено в определенный экземпляр указанного процесса.
• Ключевое поле — атрибут для поиска существующего экземпляра процесса. Доступно при указании «Существующий экземпляр процесса» в «Назначении».

Атрибуты сообщения

Чтобы извлечь данные из эл. письма и передать их в Comindware Platform, сопоставьте набор атрибутов сообщения с полями письма:

1. Добавьте атрибут сообщения, нажав кнопку «Создать».

2. Заполните свойства атрибута:

   • Название — наглядное название атрибута.
   • Системное имя — уникальное имя атрибута (для эл. писем может быть произвольным).
   • Тип данных:
     • Текст
     • Число
     • Длительность
     • Дата и время
     • Логический
     • Документ
     • Аккаунт
   • Поле сообщения — выберите поле письма, значение которого требуется присвоить атрибуту сообщения:
     • Адрес отправителя
     • Имя отправителя
     • Адрес получателя
     • Имя получателя
     • Тема
     • Сообщение
     • Адрес для отправки копии
     • Имя для отправки копии
     • Адрес для отправки скрытой копии
     • Имя для отправки скрытой копии
     • Прикреплённые файлы
     • ID сообщения
     • Дата получения сообщения

3. Настройте передачу значений атрибутов сообщения в атрибуты записи с помощью вкладки «Данные сообщения» в свойствах события-получения сообщения, использующего этот путь передачи данных.

Настройка события-получения сообщения

1. Поместите на диаграмму процесса начальное или промежуточное событие-получение сообщения.

   

2. В меню элемента события нажмите кнопку «Свойства» ‌.

3. На вкладке «Основные» настройте общие свойства элемента.
4. На вкладке «Дополнительные» выберите ранее созданный путь передачи данных.

5. На вкладке «Данные сообщения» сопоставьте атрибуты сообщения с атрибутами шаблона записи, связанного с шаблоном процесса:

   • Укажите название, системное имя и тип данных атрибутов сообщения так же, как они указаны в таблице «Атрибуты для передачи данных сообщения» в свойствах пути передачи данных.
   • В столбце «Значение» укажите атрибут шаблона записи такого же типа, как атрибут сообщения.
   • Значения указанных атрибутов сообщения будут присвоены атрибутам шаблона записи.

   

6. Опубликуйте процесс.