Получить сообщение Версия 4 (Java)
Группа действий: Почта
Описание
Действие читает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table
Иконка действия
Параметры действия
Входные параметры
Поле "Контекст" - Идентификатор сеанса работы с почтовым сервером
Поле "От" - Будут выбраны письма, у которых почтовый адрес отправителя полностью соответствует или включает указанное значение
Поле "Кому" - Будут выбраны письма, у которых почтовый адрес получателя полностью соответствует или включает указанное значение через знак «;» или «,» можно указать несколько адресов
Поле "Копия" - Будут выбраны письма, у которых почтовый адрес получателя копии полностью соответствует или включает указанное значение. Через знак «;» или «,» можно указать несколько адресов
Поле "Тема" - Будут выбраны письма, у которых тема полностью соответствует или включает указанное значение
Поле "Тело письма" - Будут выбраны письма, у которых текст полностью соответствует или включает указанное значение
Поле "Название вложения" - Будут выбраны письма, у которых название вложения полностью соответствует или включает указанное значение
Поле "Непрочитанные" - Если значение «true», будут выбраны только непрочитанные письма. Если значение «false», будут выбраны прочитанные и непрочитанные письм.»
Поле "Количество" - Количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам
Поле "Папка для вложений" - Путь к папке, в которой будут созданы подпапки для сохранения вложений из писем
Поле "Включить html текст" - Если значение «true», действие вернет текст письма с полной информацией о стилях этого текста . Если значение «false», действие вернет обычный текст
Поле "Поиск по шаблону" - Если значение «true», при выборе писем значения в параметрах фильтров поиска будут учитываться как регулярные выражения. Если значение «false», значения в параметрах фильтров поиска будут учитываться просто как текст, а при подключении с протоколом IMAP также увеличится скорость поиска
Поле "Starting date". Необязательное. Описание: "he messages that are received starting from the specified date and time will be selected". Тип данных: Дата-Время
Поле "Ending date". Необязательное. Описание: "Messages received before the specified date and time inclusive will be selected". Тип данных: Дата-Время
Выходные параметры
Результат - Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Столбцы таблицы: Id - идентификатор сообщения; From - почтовый адрес отправителя; To - почтовые адреса всех получателей; CC - почтовые адреса всех получателей копии письма; Subject - тема письма; Body - текст тела письма; Path - путь до папки, в которую были сохранены файлы вложений
Поле "Number of messages" - The number of messages found
Настройки
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Идентификатор сеанса работы с почтовым сервером | 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 | ||
Количество сообщений | Количество найденных сообщений | Число |
Особые условия использования
Отсутствуют
Пример использования
Задача
Получить все письма от testsforrobin@mail.ru, с темой письма "Employee" и PNG файлом во вложении. Файлы из писем необходимо сохранить в папку.
Решение
Подключить почтовый ящик с которого требуется взять письма. Для любых действий с конкретным почтовым ящиком, необходимо сперва подключиться к нему, создать его уникальный идентификатор (Контекст).
Определить почтовый сервис. (От почтового сервиса зависят параметры подключения к почтовому ящику).
Получить письма соответствующие указанным фильтрам
Реализация
- Собрать схему робота, состоящую из действий:
- Настроить параметры для действия "Open email". (см. описание действия Настройки подключения / Connection settings).
- Настроить параметры для действия "Get message".
- Нажать на кнопку "Старт" в верхней панели.
Результат
Требуемые письма получены и сохранены в таблицу, в которую сохраняется информация из писем, отобранных по выбранным фильтрам.
Вложения из писем сохранены в целевую папку.