📧 Настройка e-mail уведомлений для сетевой версии

[Runa]

⚠ Предупреждение! Данный функционал работает только в многопользовательском режиме. При индивидуальной работе с программой отправка уведомлений по e-mail не осуществляется.

1. Настройка аккаунтов в менеджере сетевых проектов
В меню "Инструменты" команда "Email аккаунты" - список аккаунтов, через которые будет осуществляться рассылка уведомлений:

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

В окне списка аккаунтов, по кнопке "Создать", открывается окно для ввода информации по аккаунту:


Примечание: для Gmail необходимо дать разрешение для рассылки уведомлений через сторонние сервисы (https://myaccount.google.com/lesssecureapps):


2. Создание структуры данных в проекте
Для работы функционала требуется наличие двух объектов с данными: получателей и уведомлений.
В объекте получателя обязательно наличие поля с e-mail адресом (строка с подтипом Email):

В объекте уведомлений обязательно наличие полей:
- получатель (поле ссылки на объект получателей);
- тема сообщения (поле строка или составное);
- содержание сообщения (текст);
- признак отправки (переключатель);
- планируемая дата отправки (дата);
- планируемое время отправки (время);
- результат отправки (строка):

Наличие других полей в указанных объектах не влияет на работу функционала.

3. Создание формы рассылки
В структуре проекта создать форму Email уведомлений:

После выбора объекта уведомлений в свойстве "Объект", в имя формы подставляется имя объекта с префиксом (которые можно изменить по своему усмотрению), а на вкладке "Поля в списке" отображаются все поля данного объекта для выбора тех, которые требуется отобразить в списке в нужном порядке или назначить фильтры:

На вкладке "Служебные поля" устанавливаются соответствия для служебных полей:

Для свойства "Значение выполнения" задаётся значение переключателя "Отправлено", которое должно быть ему присвоено при успешной отправке письма.

4. Работа с формой отправления уведомлений
Создаётся запись, в которой указывается тема и содержание письма, выбирается получатель и устанавливается планируемое время отправки сообщения:

После сохранения записи, её данные в форме выглядят так:

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

После обновления данных при успешной отправке письма поле "Отправлено" поменяет своё значение на установленное. Поле результата в любом случае изменит своё значение, в котором будет информация о дате/времени попытки отправления и ответ от сервера:


При необходимости любое уведомление можно отправить немедленно в ручном режиме. Для этого служит кнопка "Отправить" в верхней части детализации записи. При ручной отправке уведомления не производится проверка на признак отправленности и менеджеру даётся команда для принудительной отсылки. Пользователю выводится сообщение о выполнении данной операции. После выполнения менеджером полученной команды, на компьютер пользователя придёт информация об изменениях в объекте.

Дополнительная информация
- Если в структуре объектов будут удалены поля, используемые в форме рассылки, то при открытии формы уведомлений пользователю будет выводится сообщение о нарушении структуры данных, а подробная информация будет попадать в список ошибок структуры проекта (кнопка открытия окна со списком ошибок активируется в правой верхней части главного меню программы).
- Отправка уведомлений производится на компьютере с менеджером. Отправка производится один раз в минуту.
Если в объекте уведомлений существует несколько записей с одним назначенным днём и временем, то отправка производится только первой обнаруженной записи, а остальные при этом игнорируются. Это сделано с целью предотвращения попадания email-адреса в спам-список сервера.
- При изменении данных в объекте уведомлений в результате выполнения рассылки или при изменении записей другими пользователями, у всех пользователей, у которых открыта данная форма, в нижней левой части формы активируются: кнопка обновления списка записей и кнопка последних изменений в объекте.
- Отправка письма производится только при условии несовпадения установленного значения выполнения со значением в записи.
- Принудительная отправка выполняется независимо от всех условий.

Будьте внимательны при настройке и работе с формой e-mail уведомлений: чтобы Ваш почтовый ящик не попал в спам-лист почтового сервера.

Пример проекта в приложении.