Получить письмо Версия 20 (Net)

Группа действий: Почта

Описание

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

Для получения данных, записанных в переменную типа "Таблица" необходимо использовать действие Сохранить таблицу в CSV.

Для корректной работы действия "Получить письмо" необходимо изначально настроить подключение к почте с помощью действия Подключиться к почте (Net).

Иконка действия

Параметры и их настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Контекст для работы с почтовым сервером.	Robin.Email	Контекст email	Да
Папка с письмами	Системная папка в почте, из которой нужно выбрать письма. Если выбрана «Пользовательская папка», необходимо заполнить соответствующее поле. Параметр не работает с протоколом POP3. Значение по умолчанию – Входящие.	Нет	Отправленные	Нет
Пользовательская папка	Пользовательская папка в почте, из которой нужно выбрать письма. Чтобы указать более одной папки, используйте «\|». Параметр не работает с протоколом POP3.	Нет	Договоры	Нет
От	Адрес отправителя письма. Может быть указан в виде регулярного выражения. Чтобы указать более одного отправителя, используйте «;» или «,».	Robin.String	test_robin_mail@mail.ru	Нет
Кому	Адрес получателя письма. Может быть указан в виде регулярного выражения. Чтобы указать более одного получателя, используйте «;» или «,».	Robin.String	test_robin_mail@mail.ru	Нет
Копия	Адрес получателя копии письма. Может быть указан в виде регулярного выражения. Чтобы указать более одного получателя копии, используйте «;» или «,».	Robin.String	test_robin_mail@mail.ru	Нет
Тема	Тема письма. Может быть указана в виде регулярного выражения.	Robin.String	Соглашение	Нет
Тело письма	Текст письма. Может быть указан в виде регулярного выражения.	Robin.String		Нет
Название вложения	Название вложения в письме. Может быть указано в виде регулярного выражения.	Robin.String	Договор	Нет
Непрочитанные	Если значение «true», то письма будут выбираться только среди непрочитанных, иначе – будут рассмотрены все полученные письма.	Robin.Boolean	true	Нет
Количество	Количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам.	Robin.Numeric	30	Нет
Папка для вложений	Путь к папке, в которой будут созданы подпапки для сохранения вложений из писем.	Robin.FolderPath	C:\doc\img	Нет
Включить html текст	Если значение «true», то в теле письма будет указана полная информация о стилях, иначе – будет получен только текст письма.	Robin.Boolean	true	Нет
Сохранить изображения	Если значение «true», то изображения из тела письма будут сохранены, иначе – сохранены не будут. Для сохранения также необходимо заполнить поле «Папка для вложений».	Robin.Boolean	true	Нет
Начиная с даты	Фильтр по дате получения письма. Будут выбраны только те письма, которые были получены, начиная с указанной даты.	Robin.DateTime		Нет
Заканчивая датой	Фильтр по дате получения письма. Будут выбраны только те письма, которые были получены до указанной даты включительно.	Robin.DateTime		Нет
Отметить как прочитанное	Если значение «true», то найденные письма будут отмечены прочитанными, иначе – письма останутся непрочитанными. Параметр не работает с протоколом POP3 – найденные письма будут отмечены как прочитанные.	Robin.Boolean	true	Нет
Результаты
Полученные письма	Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов: Id - идентификатор письма From - почтовый адрес отправителя To - почтовые адреса всех основных получателей CC - почтовые адреса всех получателей копии письма Subject - тема письма Body - тело письма Path - путь до сформированной подпапки, в которую были сохранены файлы вложений DateTime – дата и время получения письма	Robin.DataTable
Количество писем	Количество найденных писем.

Особые условия использования

Выпадающий список в поле "Папка с письмами" состоит из системных папок:

Все
Входящие
Черновики
Спам
Отмеченные
Важные
Отправленные
Удаленные
Пользовательская папка

Некоторых папок может не быть в почтовых сервисах. Если они выбраны, то действие завершится с ошибкой. Например, в Outlook – выбрать протокол Exchange – нет папок "Flagged" и "Important". В Яндекс Почте не возвращаются "Важные" и "Отмеченные", а в GMail– только "Важные"

Если выбрана "Пользовательская папка", необходимо заполнить соответствующий параметр, иначе действие завершится с ошибкой.

Чтобы параметр "Пользовательская папка" был учтен при поиске, в поле "Папка с письмами" должен быть выбран вариант "Пользовательская папка", иначе парамер будет проигнорирован.

Название папок не чувствительно к регистру.

Если есть необходимость указать несколько папок, и почтовый сервер это поддерживает, то в поле через разделитель «|» можно указать несколько папок. Системные папки, указанные в этом поле, найдены не будут.

Если в поле "Папка для вложений" указан путь, то вложения будут сохранены.

Изображения сохраняются в "Папку для вложений" в подпапку, созданную для каждого письма.

Если отмечен чекбокс "Сохранить изображения", но не заполнена "Папка для вложений", будет вызвана ошибка.

Если пользователь не заполнит параметры "Начиная с даты" и "Заканчивая датой", то поиск будет осуществлен по всем письмам, которые соответствуют указанным фильтрам.

Если пользователь заполнит эти параметры, то поиск будет осуществлен среди всех писем, которые были получены в диапазоне с даты/времени указанных в "Начиная с даты" и до даты/времени указанных в "Заканчивая датой" включительно.

Если заполнено только поле "Начиная с даты", то поиск будет осуществлен начиная с указанной даты/времени и до текущей даты/времени.

Если заполнено только поле "Заканчивая датой", то поиск будет осуществлен с начала списка писем и до указанной даты/времени.

Если по указанному промежутку времени не найдено писем, то возвращается пустая таблица. Действие ошибку не бросает.

Изображения сохраняются в "Папку для вложений" в подпапку, созданную для каждого письма.

Если отмечен чекбокс "Сохранить изображения", но не заполнена "Папка для вложений", будет вызвана ошибка.

Пример использования

Задача

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

Решение

Воспользоваться действиями: "Подключиться к почте", “Сообщение”, "Сохранить таблицу в CSV".

Реализация

Собрать схему робота, состоящую из действий.
Настроить параметры для действия "Подключиться к почте". (см. описание действия Подключиться к почте / Connection settings).
Настроить параметры для действия "Получить письмо".
Настройка действия:
1. параметр "Контекст". Необходимо выбрать из выпадающего списка контекст соответствующий почтовому ящику с которого будут вычтены сообщения;
2. параметр "Папка с письмами". Входящие.
3. параметр "От". Указываем почтовый ящик отправителя сообщения;
4. параметр “Начиная с даты”. Указываем дату начала интервала;
5. параметр “Заканчивая датой”. Указываем дату конца интервала;
6. параметр "Результат". Указываем переменную "Таблица", в которую будет сохранена информация из писем;
7. параметр “Количество сообщений”. Указываем переменную “Счетчик”, в которую будет сохранена информация о количестве сообщений.
Настроить параметры действия “Сообщение”.
Настроить параметры действия “Сохранить таблицу в CSV”.
Нажать на кнопку "Старт" в верхней панели.

Результат

Программный робот отработал успешно.

Документация ROBIN > Получить письмо (Net) > log_get_msg.png
Требуемые письма получены и сохранены в таблицу формата CSV, в которую сохраняется информация из писем, отобранных по выбранным фильтрам.
Также выведена форма с количеством найденных сообщений.

Документация ROBIN > Получить письмо (Net) > res_get_msg2.png

Документация ROBIN > Получить письмо (Net) > res_get_msg1.png