Получить сообщение / Get message
Группа действий: Почта
Вычитывает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Идентификатор сеанса работы с почтовым сервером | 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 | Нет |
Результаты | ||||
Таблица результатов | Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов: - From - Отправитель; - Recipient - Получатель (список всех); - CC - Получатель копии письма; - Subject - Тема письма; - Body - Тело письма; - Attachments - Пути до файлов вложений (список всех); "DateTime – дата и время получения письма | Robin.DataTable |
Особые условия использования
Протокол POP3 не поддерживает считывание только прочитанных или не прочитанных писем. Для чтения только непрочитанных писем рекомендуется использовать протокол IMAP.
Робот вернет ошибку, если:
- папка для вложений не указана, "сохранить изображения" отмечено. Сначала выполнения действия проверить наличие картинок, потому что долгая обработка действия может быть.
Примечание: если просто есть вложения в письме и не указываем папку, то нет ошибки.
Пример использования
Задача:
Получить все письма от robinrobinoff@yandex.ru, с темой письма "Сотрудник" и PNG файлом во вложении.
Файлы из писем необходимо сохранить на рабочий стол в папку "Вложения".
Решение:
- Подключить почтовый ящик из которого требуется получить письма. Для любых действий с конкретным почтовым ящиком, необходимо сперва подключиться к нему, создать его уникальный идентификатор (Контекст).
- Определить почтовый сервис. (От почтового сервиса зависят параметры подключения к почтовому ящику).
- Получить письма соответствующие указанным фильтрам.
Реализация:
- Помещаем в рабочее пространство студии действие "Настройки подключения" и настраиваем его параметры. (см. описание действия "Настройки подключения").
- Помещаем в рабочее пространство студии действие "Получить сообщение".
Настройка действия:- Параметр "Контекст". Необходимо выбрать из выпадающего списка контекст соответствующий почтовому ящику с которого будут вычтены сообщения.
- Параметр "От". Указываем почтовый ящик отправителя сообщения.
- Параметр "Кому". Указываем почтовый ящик получателя сообщения.
- Параметр "Тема". Указываем значение "Сотрудник".
- Параметр "Название вложения". Указываем маску файлов. ".png"
- Параметр "Папка для сохранения вложений". Указываем путь до папки, в которую будут сохранены вложенияю
- Параметр "Результат". Указываем переменную "Таблица", в которую будет сохранена информация из писем.
- Нажимаем на кнопку "Старт" в верхней панели.
Результат:
Требуемые письма получены и сохранены в таблицу, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Вложения из писем сохранены в целевую папку.