385 lines
23 KiB
Markdown
385 lines
23 KiB
Markdown
# МОДУЛИ «ПОЧТОВЫЕ АГЕНТЫ»
|
||
|
||
## Модуль «Отправить письмо»
|
||
|
||
Модуль «Отправить письмо» предназначен для отправки письма одному или
|
||
нескольким получателям.
|
||
|
||
### Интерфейс модуля
|
||
|
||
Окно модуля состоит из нескольких вкладок: «Настройки», «Получатель»,
|
||
«Письмо». Рассмотрим по порядку все вкладки. Начнем знакомство с
|
||
рассмотрения вкладки «Настройки».
|
||
|
||
#### Вкладка «Настройки»
|
||
|
||
<center><img src="\media\image247.png" style="width:3.41519in;height:3.50183in" /></center>
|
||
|
||
<center>Рис. 1. Окно модуля</center>
|
||
|
||
**Поле «Настройки»** – выпадающий список, в котором предложены несколько
|
||
почтовых служб. При выборе почтовой службы будут заполнены поля «Хост»,
|
||
«Порт», «Безопасность» согласно её настройкам. Пункт "Пользовательские"
|
||
предоставляет возможность самостоятельной настройки параметров доступа к
|
||
почтовой службе.
|
||
|
||
<center><img src="\media\image248.png" style="width:3.58031in;height:1.50057in" /></center>
|
||
|
||
<center>Рис. 2. Пример настройки почтовый службы «Mail»</center>
|
||
|
||
**Поля «Хост», «Порт, «Безопасность»** необходимы к заполнению только
|
||
при выборе пользовательских настроек. Представляют собой набор
|
||
обязательных полей для подключения к почтовым сервисам.
|
||
|
||
**Поле «Доменное имя»** необходимо для некоторых почтовых служб (в
|
||
основном, корпоративных) для указания доменного имени, необходимого для
|
||
авторизации.
|
||
|
||
**Поле «E-mail»** предназначено для указания адреса электронной почты, с
|
||
которой будут отправлены сообщения, в формате <name@mail.ru>.
|
||
|
||
**Поле «Пароль»** предназначено для ввода пароля от почты для
|
||
авторизации.
|
||
|
||
**Флажок «Показывать пароль»** предоставляет возможность показать пароль
|
||
для проверки его правильности.
|
||
|
||
<center><img src="\media\image249.png" style="width:3.53827in;height:3.61276in" /></center>
|
||
|
||
<center>Рис. 3. Пример заполненной вкладки «Настройки»</center>
|
||
|
||
#### Вкладка «Получатель»
|
||
|
||
На данной вкладке заполняется информация о лицах, которым будет
|
||
отправлено письмо.
|
||
|
||
Модуль предоставляет различные способы указания получателей, а именно:
|
||
|
||
- ручной ввод списка получателей (имена и e-mail’ы);
|
||
|
||
- из переменной-элемента, в виде одного e-mail’а;
|
||
|
||
- из переменной-списка, в виде нескольких e-mail’ов.
|
||
|
||
<center><img src="\media\image250.png" style="width:3.1044in;height:3.56189in" /></center>
|
||
|
||
<center>Рис. 4. Вкладка «Получатель»</center>
|
||
|
||
Если выбран переключатель «Список», то поле «Переменная» недоступно для
|
||
ввода, иначе – наоборот, доступно поле «Переменная», но недоступны
|
||
другие поля.
|
||
|
||
Для ввода получателей методом «Список» необходимо заполнить поля «Имя
|
||
получателя» и «E-mail получателя», затем нажать на кнопку под полями
|
||
«Добавить». После этого введенные значения появятся в таблице в центре
|
||
окна. Если необходимо удалить какого-либо получателя из таблицы,
|
||
необходимо выбрать строку с ним и нажать на кнопку «Удалить».
|
||
|
||
<center><img src="\media\image251.png" style="width:3.11688in;height:3.68064in" /></center>
|
||
|
||
<center>Рис. 5. Пример заполнения таблицы получателей</center>
|
||
|
||
Если используется метод выбора получателей через переменную, то поля
|
||
«Имя получателя», «E-mail получателя» и таблица становятся недоступными.
|
||
В поле «Переменная» необходимо ввести название переменной, начиная с
|
||
символов «v.», из которой будут взяты email’ы получателей. Переменная
|
||
может быть списком из email’ов, либо строкой с перечислением их через
|
||
запятую.
|
||
|
||
<center><img src="\media\image252.png" style="width:3.09091in;height:3.52781in" /></center>
|
||
|
||
<center>Рис. 6. Вкладка «Получатель»</center>
|
||
|
||
#### Вкладка «Письмо»
|
||
|
||
На данной вкладке настраивается письмо, которое будет отправлено
|
||
получателям, указанным на вкладке «Получатель». Все поля необязательны
|
||
для заполнения, если не заполнить ни одного из них будет отправлено
|
||
пустое письмо с темой «<Без темы>».
|
||
|
||
<center><img src="\media\image253.png" style="width:3.17498in;height:3.62001in" /></center>
|
||
|
||
<center>Рис. 7. Вкладка «Письмо»</center>
|
||
|
||
Для прикрепления одного файла во вложение следует нажать на кнопку
|
||
«Выбрать файл» и в открывшемся диалоговом окне выбрать требуемый файл.
|
||
|
||
Для прикрепления сразу нескольких файлов необходимо нажать на кнопку
|
||
«Выбрать папку» и в открывшемся диалоговом окне выбрать папку со всеми
|
||
требуемыми файлами.
|
||
|
||
Каждое из полей формы может быть заполнено переменной.
|
||
|
||
## Модуль «Считать письма»
|
||
|
||
Модуль «Считать письма» предназначен для получения списка писем с почты
|
||
для дальнейшей их обработки или просто для скачивания вложений. Для
|
||
работы модуля обязательно разрешение подключения по IMAP или POP3
|
||
протоколу на используемой почте (подробнее про включение протоколов
|
||
описано этой главе, пункте «Включение IMAP и POP3 протоколов»).
|
||
|
||
### Интерфейс модуля
|
||
|
||
Модуль состоит из трех вкладок: «Настройки», «Настройки чтения» и
|
||
«Параметры загрузки».
|
||
|
||
Вкладка «Настройки» аналогична одноименной вкладке в модуле «Отправить
|
||
письмо», с одним существенным отличием - в данном модуле предоставляется
|
||
выбор протокола отправки: IMAP или POP3. Так же отсутствует поле «Доменное имя»,
|
||
так как для считывания почты оно не требуется.
|
||
|
||
При выборе соответствующего протокола и его настроек, поля «Хост»,
|
||
«Порт» и «Безопасность» заполняются автоматически (кроме режима
|
||
«Пользовательские настройки»).
|
||
|
||
<center><img src="\media\image254.png" style="width:3.50034in;height:4.99627in" /></center>
|
||
|
||
<center>Рис. 8. Окно модуля с примером авто-заполнения полей</center>
|
||
|
||
#### Вкладка «Настройки чтения»
|
||
|
||
Вкладка «Настройки чтения» представляет собой набор полей, которые
|
||
заполняются в зависимости от того, какие письма следует считать.
|
||
|
||
<center><img src="\media\image255.png" style="width:3.60271in;height:5.15757in" /></center>
|
||
|
||
<center>Рис. 9. Вкладка «Настройка чтения»</center>
|
||
|
||
**Поле «Переменная».** В поле ожидается ввод названия переменной, в
|
||
которую будет внесена информация о считанных письмах. В программе это
|
||
поле будет представлено списком объектов, имеющих шесть полей:
|
||
|
||
1. Subject – тема письма;
|
||
|
||
2. Body – тело письма, его основной текст;
|
||
|
||
3. Sender – отправитель;
|
||
|
||
4. Receivers – получатели, перечисленные через запятую;
|
||
|
||
5. Attachments – список путей до скачанных вложений;
|
||
|
||
6. Date – дата получения письма;
|
||
|
||
7. Id – уникальный идентификатор письма.
|
||
|
||
Примеры работы с переменными
|
||
|
||
- v.mails\[2\].Attachments\[0\] – получение пути первого вложения
|
||
третьего считанного письма:
|
||
|
||
<center><img src="\media\image256.png" style="width:5.58442in;height:1.55168in" /></center>
|
||
|
||
<center>Рис. 10. Пример получения пути до первого вложения второго письма</center>
|
||
|
||
- v.mails\[3\].Subject – получение темы четвертого скачанного
|
||
сообщения:
|
||
|
||
<center><img src="\media\image257.png" style="width:3.98701in;height:1.86121in" /></center>
|
||
|
||
<center>Рис. 11. Пример получения темы первого письма</center>
|
||
|
||
**Поле «Скачивать вложения в папку»** предназначено для ввода пути до
|
||
папки, в которую загрузятся все вложения считанных писем. Если оставить
|
||
поле пустым, то файлы будут загружаться во временную директорию
|
||
компьютера.
|
||
|
||
**Поле «Новая папка для каждого письма»** позволяет сохранять вложения
|
||
из каждого письма в свою отдельную папку для того, чтобы файлы, имеющие
|
||
одинаковые названия, но содержащиеся в разных письмах, не перетирали
|
||
друг друга. При скачивании вложений во временную системную папку
|
||
компьютера галочка является обязательной.
|
||
|
||
**Флажок «Только непрочитанные»** позволяет настроить считывание только
|
||
новых писем. *Доступно только для протокола IMAP.*
|
||
|
||
**Флажок «Отмечать как прочитанные»** позволяет после считывания
|
||
устанавливать пометку о прочтении письма. *Доступно только для протокола
|
||
IMAP*.
|
||
|
||
**Поле «Читать из папки»** предназначено для настройки конкретной папки
|
||
в почтовом ящике, из которой следует считывать письма. По умолчанию,
|
||
письма считываются из папки «Входящие». *Доступно только для протокола
|
||
IMAP.*
|
||
|
||
**Поле «Фильтр по отправителям»** позволяет искать сообщения,
|
||
отправленные от одного из указанных отправителей. Перечислить всех можно
|
||
через запятую, либо подав в это поле переменную-список, содержащую
|
||
отправителей.
|
||
|
||
**Поле «Фильтр по получателям»** позволяет искать сообщения, в которых
|
||
присутствуют указанные получатели. Перечислить всех можно через запятую,
|
||
либо подав в это поле переменную-список, содержащую получателей.
|
||
*Доступно только для протокола IMAP.*
|
||
|
||
**Поле «Фильтр по теме сообщений»** предназначено для настройки фильтра
|
||
по теме сообщений. Если необходимо скачать письма с темой, содержащей
|
||
или не содержащей определенную строку, то следует выбрать одноименную
|
||
операцию в выпадающем списке и вписать нужную строку в появившемся поле
|
||
(рисунок 12). *Доступно только для протокола
|
||
IMAP.*
|
||
|
||
<center><img src="\media\image258.png" style="width:4.20909in;height:0.85417in" /></center>
|
||
|
||
<center>Рис. 12. Фильтр по теме сообщений</center>
|
||
|
||
**Поле «Фильтр по дате»** предназначено для настройки фильтрации
|
||
считывания писем по дате. При указании значения в данном поле, робот
|
||
будет считывать только те сообщения, которые удовлетворяют заданному
|
||
условию.
|
||
|
||
Доступны следующие методы фильтрации:
|
||
|
||
- за определенную дату – «На дату»;
|
||
|
||
- начиная с какой-либо даты, включая её – «С даты»;
|
||
|
||
- все письма, до какой-либо даты, включая её – «До даты»;
|
||
|
||
- «Между датами».
|
||
|
||
После выбора метода фильтрации под полем «Фильтр по дате» появится одно
|
||
или два поля для внесения в них нужных значений в формате ДД.ММ.ГГГГ.
|
||
*Доступно только для протокола IMAP.*
|
||
|
||
#### Вкладка «Параметры загрузки»
|
||
|
||
С помощью данной вкладки можно ограничить информацию, скачиваемую с
|
||
почтового сервера, для уменьшения затрачиваемых ресурсов. По умолчанию
|
||
скачивается вся доступная информация.
|
||
|
||
Доступно следующее разграничение для скачивания:
|
||
|
||
- Загрузка информации об отправителе, получателях, теме и дате
|
||
сообщения (шапка письма);
|
||
|
||
- Загрузка только текста сообщения;
|
||
|
||
- Загрузка вложений (по умолчанию так же скачивается текст сообщения);
|
||
|
||
- Загрузка только даты сообщения.
|
||
|
||
<center><img src="\media\image259.png" style="width:2.90833in;height:4.16351in" /></center>
|
||
|
||
<center>Рис. 13. Вкладка «Параметры загрузки»</center>
|
||
|
||
С помощью данной функции можно загрузить только, например, «шапки»
|
||
писем, отобрать из них необходимые, и догрузить по ним всю информацию с
|
||
помощью модуля «Действия над письмами», который будет описан в следующей
|
||
главе.
|
||
|
||
### Включение IMAP и POP3 протоколов
|
||
|
||
1. Яндекс
|
||
|
||
1. IMAP
|
||
|
||
> Для использования протокола IMAP в почтовой службе Яндекс необходимо
|
||
> перейти в настройки почты (1), затем «Почтовые программы» (2) и
|
||
> разрешить доступ к почтовому ящику с помощью почтовых клиентов с
|
||
> сервера imap.yandex.ru (3), способы авторизации – по портальному
|
||
> паролю (4).
|
||
|
||
<center><img src="\media\image260.png" style="width:6.43284in;height:2.81862in" /></center>
|
||
|
||
<center>Рис. 14. Включение IMAP протокола в Яндекс</center>
|
||
|
||
Если настройки «Портальный пароль» нет, значит в вашем аккаунте
|
||
предусмотрено использование паролей приложений, которые для работы
|
||
Lexema-RPA Studio необходимо выключить. Для этого перейдите в управление
|
||
аккаунтом - «Пароли и авторизация» - «Пароли приложений» - «Выключить
|
||
пароли приложений».
|
||
|
||
<center><img src="\media\image261.png" style="width:6.69306in;height:1.91319in" /></center>
|
||
|
||
<center>Рис. 15. Пароли приложений в настройках аккаунта</center>
|
||
|
||
<center><img src="\media\image262.png" style="width:5.30208in;height:2.04448in" /></center>
|
||
|
||
<center>Рис. 16. Выключение паролей приложения</center>
|
||
|
||
Затем вернитесь на страницу с включением настроек почтовых программ и
|
||
установите галочку напротив «Портального пароля», как это изображено на
|
||
рисунке 14.
|
||
|
||
2. POP3
|
||
|
||
Для включения протокола POP3 необходимо войти в те же настройки, что и
|
||
при включении протокола IMAP: «Настройки» (1) – «Почтовые программы» (2)
|
||
- разрешить доступ к почтовому ящику с помощью почтовых клиентов с
|
||
свервера pop.yandex.ru (3).
|
||
|
||
<center><img src="\media\image263.png" style="width:6.34328in;height:2.78926in" /></center>
|
||
|
||
<center>Рис. 17. Включение протокола POP3 в Яндекс</center>
|
||
|
||
2. GMail
|
||
|
||
1. IMAP
|
||
|
||
Для включения IMAP протокола в почтовой службе GMail необходимо перейти
|
||
в настройки почты (1), затем выбрать пункт «Пересылка и POP/IMAP» (2) -
|
||
«Доступ по IMAP» и затем в «Состоянии» включить IMAP (3):
|
||
|
||
<center><img src="\media\image264.png" style="width:6.80756in;height:3.38542in" /></center>
|
||
|
||
<center>Рис. 18. Включение протокола IMAP в Gmail</center>
|
||
|
||
2. POP3
|
||
|
||
Аналогично проводится включение протокола POP3: настройки (1) –
|
||
«Пересылка и POP/IMAP» (2) - «Доступ по протоколу POP» - «Включить POP
|
||
для всех писем» (3):
|
||
|
||
<center><img src="\media\image265.png" style="width:6.69306in;height:1.90556in" /></center>
|
||
|
||
<center>Рис. 19. Включение POP3 протокола в Gmail</center>
|
||
|
||
## Модуль «Действия над письмами»
|
||
|
||
С помощью данного модуля можно переносить уже считанные письма в другие
|
||
папки в почте, удалять письма с сервера и догружать информацию. Для
|
||
использования модуля предварительно необходимо получить письма с помощью
|
||
модуля «Считать письма».
|
||
|
||
### Интерфейс модуля
|
||
|
||
Интерфейс модуля состоит из двух вкладок – «Настройки» и «Действие».
|
||
|
||
#### Вкладка «Настройки»
|
||
|
||
Вкладка настроек не отличается от аналогичной вкладки в модуле «Считать
|
||
письма», но доступен только один протокол – IMAP. При выборе в поле
|
||
«Настройки» необходимой почтовой службы, поля «Хост», «Порт» и «SSL»
|
||
заполнятся автоматически, при пользовательских настройках их необходимо
|
||
заполнять вручную.
|
||
|
||
<center><img src="\media\image266.png" style="width:4.0816in;height:3.86678in" /></center>
|
||
|
||
<center>Рис. 20. Вкладка «Настройки» модуля «Переместить письмо»</center>
|
||
|
||
#### Вкладка «Действие»
|
||
|
||
На данной вкладке производится настройка действия, совершаемого над
|
||
сообщением.
|
||
|
||
<center><img src="\media\image267.png" style="width:3.9563in;height:3.74807in" /></center>
|
||
|
||
<center>Рис. 21. Вкладка «Параметры перемещения»</center>
|
||
|
||
**Поле «Действие»** позволяет выбрать одно из трёх доступных действий –
|
||
«Переместить письмо», «Удалить письмо» и «Загрузить всю информацию из
|
||
письма».
|
||
|
||
В **поле «Id письма»** вносится id письма, над которым производится
|
||
действие, который может быть получен с помощью модуля «Считать письма».
|
||
Может быть передано несколько идентификаторов через запятую, либо
|
||
переменная-список, содержащая их.
|
||
|
||
**Поле «Папка»** доступно только для действия «Переместить письмо». В
|
||
него указывается название папки на почте, в которую должно быть
|
||
перемещено письмо.
|
||
|
||
**Поле «Переменная»** доступно только для действия «Загрузить всю
|
||
информацию из письма», в которое вводится название переменной, которая
|
||
будет являться результирующей для выполнения действия. |