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

Статус
В этой теме нельзя размещать новые ответы.

Runa

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

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

В окне списка аккаунтов, по кнопке "Создать", открывается окно для ввода информации по аккаунту:
Окно списка почтовых аккаунтов.png Настройка e-mail аккаунта.png

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

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

3. Создание формы рассылки
В структуре проекта создать форму Email уведомлений:
Создание формы email уведомлений.png
После выбора объекта уведомлений в свойстве "Объект", в имя формы подставляется имя объекта с префиксом (которые можно изменить по своему усмотрению), а на вкладке "Поля в списке" отображаются все поля данного объекта для выбора тех, которые требуется отобразить в списке в нужном порядке или назначить фильтры:
Настройка формы уведомлений.png
На вкладке "Служебные поля" устанавливаются соответствия для служебных полей:
Настройка служебных полей в форме email уведомлений.png
Для свойства "Значение выполнения" задаётся значение переключателя "Отправлено", которое должно быть ему присвоено при успешной отправке письма.

4. Работа с формой отправления уведомлений
Создаётся запись, в которой указывается тема и содержание письма, выбирается получатель и устанавливается планируемое время отправки сообщения:
Заполнение данных уведомления.png
После сохранения записи, её данные в форме выглядят так:
Форма с данными записи до отправки.png
После того, как менеджер выполнит отправку уведомления, в левой нижней части списка записей будет активированы кнопки обновления списка и просмотра изменений в объекте:
Форма с данными после отправки.png
После обновления данных при успешной отправке письма поле "Отправлено" поменяет своё значение на установленное. Поле результата в любом случае изменит своё значение, в котором будет информация о дате/времени попытки отправления и ответ от сервера:
Форма с данными после обновления списка.png

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

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

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

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

Вложения

Статус
В этой теме нельзя размещать новые ответы.
Сверху Снизу