Получить сообщение V16 (net) / Get message V16 (net)
Группа действий: Почта
Описание
Данное действие читает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table. Для получения данных, записанных в переменную типа "Таблица" необходимо использовать действие Сохранить таблицу в CSV / Table to CSV
Для корректной работы действия "Получить сообщение" необходимо изначально настроить подключение к почте с помощью действия Настройки подключения/ Сonnection Settings
Иконка действия
Параметры действия
Входные параметры:
Поле "Контекст" - идентификатор сеанса работы с почтовым сервером. В поле указывается контекст действия "Настройки подключения".
Поле "От" - почтовый адрес отправителя письма. Чтобы указать более одного элемента, используйте «;» или «,»
Поле "Кому" - почтовый адрес получателя письма. Чтобы указать более одного элемента, используйте «;» или «,»
Поле "Копия" - почтовый адрес получателя копии письма. Чтобы указать более одного элемента, используйте «;» или «,»
Поле "Тема" - тема письма.
Поле "Тело письма" - текст письма.
Поле "Название вложения" - названия вложения в письме.
Поле "Непрочитанные" - при указании чекбокса "Непрочитанные" = true , будут отобраны только непрочитанные письма.
Поле "Количество" - количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам.
Поле "Папка для сохранения вложений" - путь к папке, в которой будут созданы подпапки для сохранения вложений из писем.
Поле "Включить html текст" - данный чекбокс включает полную информацию о стилях. Иначе будет получен просто текст.
чекбокс "Включить html текст" проставлен
чекбокс "Включить html текст" не проставлен
Поле "Сохранить изображения" - если значение «true», то изображения из тела письма будут сохранены, иначе – сохранены не будут.
Поле “Начиная с даты” - Будут выбраны сообщения, которые получены, начиная с указанных даты и времени.
Поле “Заканчивая датой” - Будут выбраны сообщения, которые получены до указанных даты и времени включительно.
Выходные параметры:
Таблица результатов - таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов: - ID - идентификатор письма; - From - почтовый адрес отправителя; - To - почтовые адреса всех основных получателей; - CC - почтовые адреса всех получателей копии письма; - Subject - тема письма; - Body - тело письма; - Path - путь до сформированной подпапки, в которую были сохранены файлы вложений; - DateTime – дата и время получения письма.
Пример сохраненной таблицы в CSV (действие "Сохранить таблицу в CSV").
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Идентификатор сеанса работы с почтовым сервером | Robin.Email | Контекст email | Да |
От | Выбираются письма, у которых почтовый адрес отправителя письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте «;» или «,» | Robin.String | Нет | |
Кому | Выбираются письма, у которых почтовый адрес получателя письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте «;» или «,» | Robin.String | Нет | |
Копия | Выбираются письма, у которых адреса получателей копии письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте «;» или «,» | Robin.String | Нет | |
Тема | Выбираются письма, у которых тема письма соответствует указанному регулярному выражению. | Robin.String | Нет | |
Тело письма | Выбираются письма, у которых текст письма соответствует указанному регулярному выражению. | Robin.String | Нет | |
Название вложения | Выбираются письма, у которых названия вложений соответствуют указанному регулярному выражению. | Robin.String | Нет | |
Непрочитанные | Выбрать только непрочитанные письма | Robin.Boolean | true | Нет |
Количество | Количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам. | Robin.Numeric | Нет | |
Папка для сохранения вложений | Путь к папке, в которой будут созданы подпапки для сохранения вложений из писем. | Robin.FolderPath | C:\doc\img | Нет |
Включить html текст | Включить в тело письма полную информацию о стилях. Иначе будет получен просто текст. | Robin.Boolean | true | Нет |
Сохранить изображения | Если значение "true", то изображения из тела письма будут сохранены, иначе – сохранены не будут. | Robin.Boolean | true | Нет |
Начиная с даты | Будут выбраны сообщения, которые получены, начиная с указанных даты и времени. | Robin.DateTime | Нет | |
Заканчивая датой | Будут выбраны сообщения, которые получены до указанных даты и времени включительно. | Robin.DateTime | Нет | |
Результаты | ||||
Таблица результатов | Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов:
| Robin.DataTable |
Параметры действия предыдущих версий Получить сообщение_Net
Особые условия использования
Отсутствуют
Пример использования
Задача:
Получить все письма с почты за заданный временной интервал и сохранить информацию из писем в таблицу (CSV), а также вывести диалоговое окно с количеством найденных сообщений.
Решение:
Подключить почтовый ящик с которого требуется взять письма. Для любых действий с конкретным почтовым ящиком, необходимо сперва подключиться к нему, создать его уникальный идентификатор (Контекст).
Определить почтовый сервис. (От почтового сервиса зависят параметры подключения к почтовому ящику).
Получить письма соответствующие указанным фильтрам.
Реализация:
Воспользуемся действиями: "Настройки подключения", “Сообщение”, "Сохранить таблицу в CSV".
Собрать схему робота, состоящую из действий:
Настроить параметры для действия "Настройки подключения". (см. описание действия Настройки подключения / Connection settings).
Настроить параметры для действия "Получить сообщение".
Настройка действия:
Параметр "Контекст". Необходимо выбрать из выпадающего списка контекст соответствующий почтовому ящику с которого будут вычтены сообщения.
Параметр "От". Указываем почтовый ящик отправителя сообщения.
Параметр “Начиная с даты”. Указываем дату начала интервала.
Параметр “Заканчивая датой”. Указываем дату конца интервала.
Параметр "Результат". Указываем переменную "Таблица", в которую будет сохранена информация из писем.
Параметр “Количество сообщений”. Указываем переменную “Счетчик”, в которую будет сохранена информация о количестве сообщений.
Настроить параметры действия “Сообщение”
Настроить параметры действия “Сохранить таблицу в CSV”
Нажать на кнопку "Старт" в верхней панели.
Результат:
Требуемые письма получены и сохранены в таблицу формата CSV, в которую сохраняется информация из писем, отобранных по выбранным фильтрам.
Также выведена форма с количеством найденных сообщений.