Формулировка проблемы: необходимо добавить возможность отправки уведомления с ссылками на скачивание мобильного приложения и файлом для авторизации в нем.
Используется:
Административное приложение -> Управление пользователями
Основное приложение -> Настройки -> Общие
Связанные задачи:
Решение: данная постановка содерджит в себе следующие логические части:
На указанный почтовый адрес пользователя будет отправляться
уведомление Мобильное приложение ARTA Synergy
со следующей структурой:
Текст уведомления
Ссылка на скачивание приложения для Android
Ссылка на скачивание приложения для iOS
Файл с параметрами для авторизации в мобильном приложении
Текст уведомления представлен в виде:
Для скачивания мобильного приложения ARTA Synergy пройдите по одной из следующих ссылок:
Google Play
App Store
Также Вы можете авторизоваться в ARTA Synergy, скачав и открыв файл synergy_auth.asmobile с Вашего устройства.
Данная функциональность доступна только для ОС Android.
Ссылка на скачивание приложения для Android состоит из:
Анкор (указатель ссылки) -
Google PlayURL -
https://play.google.com/store/apps/details?id=kz.arta.synergy.mobile.android&hl=ru
Ссылка на скачивание приложения для iOS состоит из:
Анкор (указатель ссылки) -
App StoreURL -
https://itunes.apple.com/ru/app/arta-synergy/id787781437?mt=8
Файл с параметрами для авторизации в мобильном
приложении имеет расширение asmobile
и маску названия synergy_auth. Файл содержит
следующий json:
{
"action_type": "auth_fill",
"value": {
"host":"http://synergy.company.com",
"login":"User"
}
}
где
login - логин пользователя, которому было
отправлено уведомление;
host - URL приложения из общих настроек
административного приложения.
Примечание: невалидный URL или его отсутствие может привести к тому, что ссылка в уведомлениях будет не рабочей, и это не будет являться ошибкой ARTA Synergy.
Примечание
Функционал, описанный ниже, доступен только для суперметодологов.
Во-первых, необходимо изменить
формат отображения настройки
"Генерирование логинов/паролей". Все
элементы данного блока должны отображаться в одну строку. При этом
функционал настройки остается неизменным.
Во-вторых, после настройки
"Генерирование логинов/паролей"
необходимо добавить новый блок
"Рассылка уведомлений для скачивания мобильного приложения",
причем в том же формате. Он содержит элементы:
радиокнопки "Всем выделенным" и "Всем из выборки"
кнопка "Отправить"
Радиокнопки "Всем выделенным" и "Всем из
выборки" имеют тот же функционал, что и у
аналогичных в блоке настроек
"Генерирование логинов/паролей":
"Всем выделенным" (включено по умолчанию) - уведомление будет отправлено тем пользователям, которые выбраны в таблице;
"Всем из выборки" - уведомление будет отправлено всем пользователям, которые отображаются на текущей странице таблице в данный момент.
По нажатию на кнопку "Отправить" будет проводиться валидация списка выбранных пользователей. Если выбран хотя бы один пользователь, Система отобразит сообщение с текстом:
Уведомление отправлено
На почту, указанную в карточке выбранных пользователей, будет отправлено уведомление с приглашением в мобильный клиент.
В случае, если ни один пользователь не был выбран, по нажатию на кнопку "Отправить" отобразится ошибка с текстом:
Ни один пользователь не выбран
Такое может произойти, если включена радиокнопка "Всем выделенным", но при этом ни один пользователь не выбран, либо включена радиокнопка "Всем из выборки", но таблица пуста.
Если в карточке пользователя не указан адрес электронной почты, либо он невалиден, то данный пользователь не получит уведомление. Это не будет являться ошибкой ARTA Synergy.
Во-первых, необходимо добавить
новую панель "Мобильное приложение" в
закладку "Общие" пользовательских настроек основного
приложения. Она будет всегда отображаться после панели
"Параметры авторизации" и содержать
элементы:
секция QR-кода
настройка "Уведомление для скачивания приложения"
Секция QR-кода отображает текущий QR-код с
лейблом QR-код для авторизации из панели
"Параметры авторизации".
Настройка "Уведомление для скачивания приложения" содержит в себе элементы:
поле "E-mail"
кнопка "Отправить"
Поле "E-mail" по умолчанию заполнено адресом, указанным в карточке авторизованного пользователя в административном приложении. При изменении адреса поле отображает последнее сохраненное значение.
Кнопка "Отправить" всегда отображается активной. По нажатию на кнопку в первую очередь должна проводиться валидация значения поля "E-mail". При ее неуспешном прохождении это поле подсвечивается красным цветом, отображается одна из возможных ошибок:
Альтернативный поток событий 1. Поле не заполнено:
E-mail не указанАльтернативный поток событий 2. Введен некорректный e-mail (отсутствие символа
@и/или имени домена):Введен некорректный e-mail
В случае успешного прохождения валидации Система отобразит сообщение с текстом:
Уведомление отправлено
Уведомление будет отправлено на адрес, указанный в поле "E-mail".
Во-вторых, дополнить валидацию кнопки "Сохранить" альтернативным потоком событий 2, описанным выше.
В-третьих, более не отображать
QR-код в панели
"Параметры авторизации".
В-четвертых, изменить расположение некоторых панелей во вкладке:
Безымянная панель общих настроек должна всегда отображаться после панели
"Делегирование".Если обе панели
"Электронная почта"и"Обмен сообщениями"отображаются в пользовательских настройках, то панель"Обмен сообщениями"будет располагаться после новой панели"Мобильное приложение".
При обновлении системы произойдет следующее:
Административное приложение, подраздел "Управление пользователями" - для всех суперметодологов будет изменено отображение настройки "Генерация логинов/паролей", а также добавится новая настройка "Рассылка уведомлений для скачивания мобильного приложения" со значениями по умолчанию.
Основное приложение, пользовательские настройки:
будет добавлена новая панель "Мобильное приложение" со значениями элементов по умолчанию;
в панели "Параметры авторизации" более не будет отображаться QR-код;
если для пользователя было настроено отображение панелей "Электронная почта" и "Обмен сообщениями", то панель "Обмен сообщениями" будет располагаться после панели "Мобильное приложение".
Других видимых изменений быть не должно.