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

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

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

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

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

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

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

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

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

   

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

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

   1. В поле [ Сигнал какого типа получен? ] выберите значение “Получен сигнал от объекта”.

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

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

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

      Рис. 2 — Элемент “Добавлен участник активности”

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

   

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

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

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

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

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

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

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

4. Настройте свойства элемента “Читать данные объекта администрирования” (Рис. 4):
   Рис. 4 — Элемент “Читать данные объекта администрирования”

   

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

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

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

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

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

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

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

   Рис. 5 — Элемент “Читать данные активности”

   

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

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

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

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

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

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

6. Настройте свойства исходящего условного потока (Рис. 6)
   Рис. 6 — Условный поток

   

   1. В поле [ Условие перехода ] нажмите на кнопку и выберите [ Элементы процесса ]. В окне [ Формула ] выберите “Читать данные участника активности” из списка слева и колонку [ Участник ] из списка справа.

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

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

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

   Рис. 7 — Формула условного потока

   
8. Настройте подпроцесс “Отправить push-уведомление”, который будет отправлять уведомление пользователю, выбранному элементом процесса “Читать данные объекта администрирования” .
   1. В параметре [ Связанный объект ] нажмите кнопку и выберите пункт [ Значение справочника ]. В открывшемся окне выберите объект “Активность”.

   2. В параметре [ ID связанной записи ] нажмите кнопку и выберите пункт [ Параметр процесса ]. В окне [ Выбор параметра ] выберите элемент процесса “Читать данные участника активности” и его параметр [ Активность ].

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

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

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