Получить сообщение Версия 6 (Java)
Группа действий: Почта
Описание
Действие читает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table.
Иконка действия
Параметры и их настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Идентификатор сеанса работы с почтовым сервером | Robin.JavaMail | Да | |
От | Будут выбраны письма, у которых почтовый адрес отправителя полностью соответствует или включает указанное значение | Robin.String | Нет | |
Кому | Будут выбраны письма, у которых почтовый адрес получателя полностью соответствует или включает указанное значение через знак «;» или «,» можно указать несколько адресов | Robin.String | Нет | |
Копия | Будут выбраны письма, у которых почтовый адрес получателя копии полностью соответствует или включает указанное значение. Через знак «;» или «,» можно указать несколько адресов | Robin.String | Нет | |
Тема | Будут выбраны письма, у которых тема полностью соответствует или включает указанное значение | Robin.String | Нет | |
Тело письма | Будут выбраны письма, у которых текст полностью соответствует или включает указанное значение | Robin.String | Нет | |
Название вложения | Будут выбраны письма, у которых название вложения полностью соответствует или включает указанное значение | Robin.String | Нет | |
Непрочитанные | Если значение «true», будут выбраны только непрочитанные письма. Если значение «false», будут выбраны прочитанные и непрочитанные письма» | Robin.Boolean | true | Нет |
Количество | Количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам | Robin.Numeric | Нет | |
Папка для вложений | Путь к папке, в которой будут созданы подпапки для сохранения вложений из писем | Robin.FolderPath | C:\doc\img | Нет |
Включить html текст | Если значение «true», действие вернет текст письма с полной информацией о стилях этого текста . Если значение «false», действие вернет обычный текст | Robin.Boolean | true | Нет |
Поиск по шаблону | Если значение «true», при выборе писем значения в параметрах фильтров поиска будут учитываться как регулярные выражения. Если значение «false», значения в параметрах фильтров поиска будут учитываться просто как текст, а при подключении с протоколом IMAP также увеличится скорость поиска | Robin.Boolean | true | Нет |
Начиная с даты | Будут выбраны сообщения, которые получены, начиная с указанных даты и времени | Дата-Время | Нет | |
Заканчивая датой | Будут выбраны сообщения, которые получены до указанных даты и времени включительно | Дата-Время | Нет | |
Результаты | ||||
Результат | Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Столбцы таблицы: Id - идентификатор сообщения; From - почтовый адрес отправителя; To - почтовые адреса всех получателей; CC - почтовые адреса всех получателей копии письма; Subject - тема письма; Body - текст тела письма; Path - путь до папки, в которую были сохранены файлы вложений | Robin.DataTable | ||
Количество сообщений | Количество найденных сообщений | Число |
Особые условия использования
Отсутствуют.
Пример использования
Задача
Получить все письма от test_robin_mail@mail.ru, с темой письма "Сотрудник" и PNG файлом во вложении. Файлы из писем необходимо сохранить на рабочий стол в папку "Вложения".
Решение
Подключить почтовый ящик с которого требуется взять письма. Для любых действий с конкретным почтовым ящиком, необходимо сперва подключиться к нему, создать его уникальный идентификатор (Контекст).
Определить почтовый сервис. (От почтового сервиса зависят параметры подключения к почтовому ящику).
Получить письма соответствующие указанным фильтрам
Реализация
- Собрать схему робота, состоящую из действий.
- Настроить параметры для действия "Настройки подключения". (см. описание действия Настройки подключения / Connection settings).
- Настроить параметры для действия "Получить сообщение".
Настройка действия:- Параметр "Контекст". Необходимо выбрать из выпадающего списка контекст соответствующий почтовому ящику с которого будут вычтены сообщения;
- Параметр "От". Указываем почтовый ящик отправителя сообщения;
- Параметр "Кому". Указываем почтовый ящик получателя сообщения;
- Параметр "Тема". Указываем значение "Сотрудник";
- Параметр "Название вложения". Указываем маску файлов. ".png";
- Параметр "Папка для сохранения вложений". Указываем путь до папки, в которую будут сохранены вложения;
- Параметр "Начиная с даты". Указываем дату, поиск с которой будет осуществлен с даты/времени указанных в "Начиная с даты" и до даты/времени указанных в "Заканчивая датой" включительно;
- Параметр "Заканчивая датой". Указываем дату, поиск до которой будет осуществлен с даты/времени указанных в "Начиная с даты" и до даты/времени указанных в "Заканчивая датой" включительно;
- Параметр "Результат". Указываем переменную "Таблица", в которую будет сохранена информация из писем.
- Нажать на кнопку "Старт" в верхней панели.
Результат
Требуемые письма получены и сохранены в таблицу, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Вложения из писем сохранены в целевую папку.