Получить письмо Версия 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 | Нет |
| Результаты | ||||
Полученные письма | Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов:
| Robin.DataTable | ||
Количество писем | Количество найденных писем. | |||
Особые условия использования
Выпадающий список в поле "Папка с письмами" состоит из системных папок:
- Все
- Входящие
- Черновики
- Спам
- Отмеченные
- Важные
- Отправленные
- Удаленные
- Пользовательская папка
Некоторых папок может не быть в почтовых сервисах. Если они выбраны, то действие завершится с ошибкой. Например, в Outlook – выбрать протокол Exchange – нет папок "Flagged" и "Important". В Яндекс Почте не возвращаются "Важные" и "Отмеченные", а в GMail– только "Важные"
Если выбрана "Пользовательская папка", необходимо заполнить соответствующий параметр, иначе действие завершится с ошибкой.
Чтобы параметр "Пользовательская папка" был учтен при поиске, в поле "Папка с письмами" должен быть выбран вариант "Пользовательская папка", иначе парамер будет проигнорирован.
Название папок не чувствительно к регистру.
Если есть необходимость указать несколько папок, и почтовый сервер это поддерживает, то в поле через разделитель «|» можно указать несколько папок. Системные папки, указанные в этом поле, найдены не будут.
Если в поле "Папка для вложений" указан путь, то вложения будут сохранены.
Изображения сохраняются в "Папку для вложений" в подпапку, созданную для каждого письма.
Если отмечен чекбокс "Сохранить изображения", но не заполнена "Папка для вложений", будет вызвана ошибка.
Если пользователь не заполнит параметры "Начиная с даты" и "Заканчивая датой", то поиск будет осуществлен по всем письмам, которые соответствуют указанным фильтрам.
Если пользователь заполнит эти параметры, то поиск будет осуществлен среди всех писем, которые были получены в диапазоне с даты/времени указанных в "Начиная с даты" и до даты/времени указанных в "Заканчивая датой" включительно.
Если заполнено только поле "Начиная с даты", то поиск будет осуществлен начиная с указанной даты/времени и до текущей даты/времени.
Если заполнено только поле "Заканчивая датой", то поиск будет осуществлен с начала списка писем и до указанной даты/времени.
Если по указанному промежутку времени не найдено писем, то возвращается пустая таблица. Действие ошибку не бросает.
Изображения сохраняются в "Папку для вложений" в подпапку, созданную для каждого письма.
Если отмечен чекбокс "Сохранить изображения", но не заполнена "Папка для вложений", будет вызвана ошибка.
Пример использования
Задача
Получить все письма с почты за заданный временной интервал и сохранить информацию из писем в таблицу (CSV), а также вывести диалоговое окно с количеством найденных сообщений.
Решение
Воспользоваться действиями: "Подключиться к почте", “Сообщение”, "Сохранить таблицу в CSV".
Реализация
- Собрать схему робота, состоящую из действий.
- Настроить параметры для действия "Подключиться к почте". (см. описание действия Подключиться к почте / Connection settings).
- Настроить параметры для действия "Получить письмо".
Настройка действия:- параметр "Контекст". Необходимо выбрать из выпадающего списка контекст соответствующий почтовому ящику с которого будут вычтены сообщения;
- параметр "Папка с письмами". Входящие.
- параметр "От". Указываем почтовый ящик отправителя сообщения;
- параметр “Начиная с даты”. Указываем дату начала интервала;
- параметр “Заканчивая датой”. Указываем дату конца интервала;
- параметр "Результат". Указываем переменную "Таблица", в которую будет сохранена информация из писем;
- параметр “Количество сообщений”. Указываем переменную “Счетчик”, в которую будет сохранена информация о количестве сообщений.
- Настроить параметры действия “Сообщение”.
- Настроить параметры действия “Сохранить таблицу в CSV”.
- Нажать на кнопку "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
Требуемые письма получены и сохранены в таблицу формата CSV, в которую сохраняется информация из писем, отобранных по выбранным фильтрам.
Также выведена форма с количеством найденных сообщений.
Обзор
Инструменты контента