Настроить отправку push-уведомлений пользователям мобильного приложения

Продукты
Все продукты

Мобильное приложение Creatio использует технологию push для отображения уведомлений в мобильных устройствах. Эти “push-уведомления” отправляются преднастроенным процессом “Отправить push-уведомление”. Используйте его как подпроцесс в ваших бизнес-процессах и кейсах.

Пример. Необходимо построить бизнес-процесс, который будет отправлять push-уведомление пользователям мобильного приложения, добавленным в список участников активности. Уведомление содержит название активности и текст “Вас добавили в список участников”. При нажатии на push-уведомление открывается страница активности.

Общая схема бизнес-процесса (Рис. 1):

  1. Начальное событие [ Сигнал ]: “Добавлен участник активности” — при добавлении в активность нового участника активируется сигнал и запускается бизнес-процесс;

  2. Действие [ Читать данные ]: “Читать данные участника активности” — процесс получает данные о контакте нового участника активности;

  3. Действие [ Читать данные ]: “Читать данные объекта администрирования” — процесс получает данные о пользователе, связанном с контактом участника активности.

  4. Действие [ Читать данные ]: “Читать данные активности” — процесс получает данные об активности, в которую был добавлен участник. Исходящий условный поток к завершающему элементу, который закончит процесс, если участник активности и автор активности является одним и тем же лицом (во избежание направления уведомлений автору активности). Исходящий поток по умолчанию к подпроцессу “Отправить push-уведомление”.

  5. [ Подпроцесс ]: “Отправить push-уведомление” — подпроцесс отправляет push-уведомление пользователю мобильного приложения.

    Рис. 1 — Бизнес-процесс “Отправка push-уведомления участнику активности”
    scr_process_creation_push_diagram.png

Для настройки процесса:

  1. Поместите на схему элемент [ Сигнал ] типа [ Начальные события ] — “Добавлен участник активности”. Элемент будет активироваться при добавлении контакта на деталь [ Участники ] активности.
  2. Настройте параметры сигнала:
    1. В поле [ Сигнал какого типа получен? ] выберите значение “Получен сигнал от объекта”.

    2. В поле [ Объект ] укажите “Участник активности”.

    3. Выберите тип события “Добавление записи”.

      Свойства элемента “Добавлен участник активности” (Рис. 2):

      Рис. 2 — Элемент “Добавлен участник активности”
      scr_process_creation_push_signal.png
  3. Настройте свойства элемента “Читать данные участника активности” (Рис. 3):
    Рис. 3 — Элемент “Читать данные участника активности”
    scr_process_creation_push_read_data.png
    1. В поле [ Какой режим чтения данных использовать? ] укажите “Читать первую запись из выборки”.

    2. В поле [ Из какого объекта читать данные? ] укажите “Участник активности”.

    3. В области [ Как отфильтровать записи? ] установите следующий фильтр: “Id = Добавленный участник активности.Уникальный идентификатор записи”.

      На заметку. Чтобы установить фильтр “Id=Добавлен участник активности.Уникальный идентификатор записи”: нажмите на ссылку [ Добавить условие ], выберите колонку [ Id ], в меню [ <?> ] выберите пункт [ Сравнить с параметром ], в открывшемся окне выберите элемент процесса “Добавлен участник активности” и его параметр “Уникальный идентификатор записи”.

    4. В поле [ Значение каких колонок вычитать? ] выберите “Только выбранных колонок”.

    5. Добавьте колонки “Активность” и “Участник” в список колонок, значения которых следует вычитать.

      На заметку. Рекомендуется ограничивать список колонок, значения которых вычитывают элементы [ Читать данные ] только теми колонками, значения которых фактически используются при выполнении процесса. Это значительно повысит производительность процессов и снизит аппаратную нагрузку в приложениях с большим количеством выполняемых процессов.

  4. Настройте свойства элемента “Читать данные объекта администрирования” (Рис. 4):
    Рис. 4 — Элемент “Читать данные объекта администрирования”
    scr_process_creation_push_read_data2.png
    1. В поле [ Какой режим чтения данных использовать? ] укажите “Читать первую запись из выборки”.

    2. В поле [ Из какого объекта читать данные? ] укажите “Объект администрирования”.

    3. В области [ Как отфильтровать записи? ] установите следующий фильтр: “Контакт=Читать данные участника активности.Первый элемент результирующей коллекции.Участник”.

      На заметку. Чтобы установить фильтр “Контакт=Читать данные участника активности.Первый элемент результирующей коллекции.Участник”: нажмите на ссылку [ Добавить условие ], выберите колонку [ Контакт ], в меню [ <?> ] выберите пункт [ Сравнить с параметром ], в открывшемся окне выберите элемент процесса “Читать данные участника активности” и его параметр “Участник”.

    4. В поле [ Значение каких колонок вычитать? ] выберите “Только выбранных колонок”.

    5. Добавьте колонку “Id” (подпроцессу “Отправить push-уведомление” требуется идентификатор пользователя, которому следует отправить уведомление).

  5. Настройте свойства элемента “Читать данные активности” (Рис. 5):

    Рис. 5 — Элемент “Читать данные активности”
    scr_process_creation_push_read_data3.png
    1. В поле [ Какой режим чтения данных использовать? ] укажите “Читать первую запись из выборки”.

    2. В поле [ Из какого объекта читать данные? ] укажите “Активность”.

    3. В области [ Как отфильтровать записи? ] установите следующий фильтр: “Контакт=Читать данные участника активности.Первый элемент результирующей коллекции.Активность”.

      На заметку. Чтобы установить фильтр “Контакт=Читать данные участника активности.Первый элемент результирующей коллекции.Активность”: нажмите на ссылку [ Добавить условие ], выберите колонку [ Контакт ], в меню [ <?> ] выберите пункт [ Сравнить с параметром ], в открывшемся окне выберите элемент процесса “Читать данные участника активности” и его параметр “Активность”.

    4. В поле [ Значение каких колонок вычитать? ] выберите “Только выбранных колонок”.

    5. Добавьте колонки “Заголовок” и “Автор” (процесс “Отправлять push-уведомления” будет использовать колонку “Заголовок” в качестве названия push-уведомления, а колонка “Автор” будет использоваться в условном потоке).

  6. Настройте свойства исходящего условного потока (Рис. 6)
    Рис. 6 — Условный поток
    scr_process_creation_push_flow.png
    1. В поле [ Условие перехода ] нажмите на кнопку btn_process_element_settings_lookup00015.png и выберите [ Элементы процесса ]. В окне [ Формула ] выберите “Читать данные участника активности” из списка слева и колонку [ Участник ] из списка справа.

    2. После выбранной формулы добавьте в строке значение “==”.

  7. Выберите “Читать данные активности” из списка слева и колонку [ Автор ] из списка справа.

    В результате получите следующий вид формулы: “[ #Читать данные участника активности.Первый элемент результирующей коллекции.Участник# ]==[ #Читать данные активности.Первый элемент результирующей коллекции.Автор# ]” (Рис. 7).

    Рис. 7 — Формула условного потока
    scr_process_creation_push_formula.png
  8. Настройте подпроцесс “Отправить push-уведомление”, который будет отправлять уведомление пользователю, выбранному элементом процесса “Читать данные объекта администрирования” .
    1. В параметре [ Связанный объект ] нажмите кнопку btn_process_element_settings_lookup00018.png и выберите пункт [ Значение справочника ]. В открывшемся окне выберите объект “Активность”.
    2. В параметре [ ID связанной записи ] нажмите кнопку btn_process_element_settings_lookup00019.png и выберите пункт [ Параметр процесса ]. В окне [ Выбор параметра ] выберите элемент процесса “Читать данные участника активности” и его параметр [ Активность ].

      На заметку. Параметры [ Связанный объект ] (EntityUID) и [ ID связанной записи ] (RecordId) подпроцесса “Отправить push-уведомление” определяют, какая страница записи откроется, когда пользователь нажмет на полученное push-уведомление в своем мобильном приложении. Например, чтобы открыть страницу активности, мы выбрали объект “Активность” и передали в параметр [ ID связанной записи ] идентификатор активности, страницу которой следует открыть.
      Параметры [ Связанный объект ] (EntityUID) и [ ID связанной записи ] (RecordId) не являются обязательными. Если эти параметры не заполнять, то при нажатии на полученное push-уведомление будет открываться мобильное приложение Creatio.

      В результате бизнес-процесс будет автоматически отправлять push-уведомление пользователю мобильного приложения, который был добавлен в активность (Рис. 8).

      Рис. 8 — Push-уведомление в мобильном приложении
      scr_chapter_process_creation_designer_push_notification_bpmonline.png