История страницы
...
Get message Version 6 (Java)
Группа действийAction group: Почта Email
Описание
Действие читает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table
Иконка действия
Параметры действия
Входные параметры
Поле "Контекст" - Идентификатор сеанса работы с почтовым сервером
Поле "От" - Будут выбраны письма, у которых почтовый адрес отправителя полностью соответствует или включает указанное значение
Поле "Кому" - Будут выбраны письма, у которых почтовый адрес получателя полностью соответствует или включает указанное значение через знак «;» или «,» можно указать несколько адресов
Поле "Копия" - Будут выбраны письма, у которых почтовый адрес получателя копии полностью соответствует или включает указанное значение. Через знак «;» или «,» можно указать несколько адресов
Поле "Тема" - Будут выбраны письма, у которых тема полностью соответствует или включает указанное значение
Поле "Тело письма" - Будут выбраны письма, у которых текст полностью соответствует или включает указанное значение
Поле "Название вложения" - Будут выбраны письма, у которых название вложения полностью соответствует или включает указанное значение
Поле "Непрочитанные" - Если значение «true», будут выбраны только непрочитанные письма. Если значение «false», будут выбраны прочитанные и непрочитанные письм.»
Поле "Количество" - Количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам
Поле "Папка для вложений" - Путь к папке, в которой будут созданы подпапки для сохранения вложений из писем
Поле "Включить html текст" - Если значение «true», действие вернет текст письма с полной информацией о стилях этого текста . Если значение «false», действие вернет обычный текст
Поле "Поиск по шаблону" - Если значение «true», при выборе писем значения в параметрах фильтров поиска будут учитываться как регулярные выражения. Если значение «false», значения в параметрах фильтров поиска будут учитываться просто как текст, а при подключении с протоколом IMAP также увеличится скорость поиска
...
Description
The action reads emails that match the specified filters from the mailbox and saves them to the Table type variable.
Action icon
Action parameters
Input parameters
Parameter | Description |
---|---|
Context | Email connection context identifier. |
From | Selects emails whose sender email address fully matches or contains the provided value. |
To | Selects emails whose recipient’s email address fully matches or contains the provided value. To specify more than one item, use ";" or ",". |
CC | Selects emails whose addresses of the recipients of the email copy fully match or contains the provided value. To specify more than one item, use ";" or ",". |
Subject | Selects messages whose subject line fully matches or contains the provided value. |
Body | Selects emails for which the text of the email body fully matches or contains the provided value. |
Attachment name | Selects messages with attachment names fully match or contains the provided value. |
Unread only | If "true", only unread emails will be selected. If the value is "false", both read and unread emails will be selected. |
Count | The number of emails that must be read from the mailbox using the specified filters. |
Folder For Attachment | The path to the folder in which subfolders will be created to save attachments from letters. |
Include html text | If the value is "true", the action will return an email text with full information about the styles of that text . If the value is "false", the action will return plain text. |
Search by template | If the value is "true", the values in the search filters will be treated as regular expressions when selecting emails. If the value is "false", the values in the search filters will be considered as plain text, and the search speed will also increase when connecting with IMAP protocol. |
Starting date | The |
...
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 |
...
. |
...
Output parameters
Result - A table into which information is saved from letters selected by the selected filters. The table has the following set of columns: ID - message identifier; From - sender; To - recipient (list of all); CC - recipient of a copy of the letter; Subject - subject of the letter; Body - the body of the letter; Path - path to the folder with the attachment files. DateTime - received date and time.
"Number of messages" field - the number of messages found.
Settings
Property | Description | Type | Filling example | Mandatory field |
---|---|---|---|---|
Parameters | ||||
Context | Email connection context identifier | Robin.JavaMail | Yes | |
From | Selects emails whose sender email address fully matches or contains the provided value | Robin.String | No | |
To | Selects emails whose recipient’s email address fully matches or contains the provided value. To specify more than one item, use ";" or "," | Robin.String | No | |
CC | Selects emails whose addresses of the recipients of the email copy fully match or contains the provided value. To specify more than one item, use ";" or "," | Robin.String | No | |
Subject | Selects messages whose subject line fully matches or contains the provided value. | Robin.String | No | |
Body | Selects emails for which the text of the email body fully matches or contains the provided value. | Robin.String | No | |
Attachment name | Selects messages with attachment names fully match or contains the provided value | Robin.String | No | |
Unread only | Selects unread emails only | Robin.Boolean | true | No |
Count | The number of emails that must be read from the mailbox using the specified filters. | Robin.Numeric | No | |
Folder For Attachment | The path to the folder in which subfolders will be created to save attachments from letters |
Выходные параметры
Результат - Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Столбцы таблицы: 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 |
No |
Include html |
text | Include full body with html tags if applicable | Robin.Boolean | true |
Нет
Поиск по шаблону
No | |||
Search by template | If "true" search by provided template, if "false" search as substring | Robin.Boolean | true |
Нет
Результат
Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Столбцы таблицы: Id - идентификатор сообщения; From - почтовый адрес отправителя; To - почтовые адреса всех получателей; CC - почтовые адреса всех получателей копии письма; Subject - тема письма; Body - текст тела письма; Path - путь до папки, в которую были сохранены файлы вложений.
Robin.DataTable
Особые условия использования
Отсутствуют
Пример использования
Задача
Получить все письма от testsforrobin@mail.ru, с темой письма "Employee" и PNG файлом во вложении. Файлы из писем необходимо сохранить в папку.
Решение
Подключить почтовый ящик с которого требуется взять письма. Для любых действий с конкретным почтовым ящиком, необходимо сперва подключиться к нему, создать его уникальный идентификатор (Контекст).
Определить почтовый сервис. (От почтового сервиса зависят параметры подключения к почтовому ящику).
Получить письма соответствующие указанным фильтрам
Реализация
...
No | ||||
Starting date | The messages that are received starting from the specified date and time will be selected. | Robin.DateTime | No | |
Ending date | Messages received before the specified date and time inclusive will be selected. | Robin.DateTime | No | |
Results | ||||
---|---|---|---|---|
Result | A table into which information is saved from letters selected by the selected filters. The table has the following set of columns: - ID - Message identifier; - From - Sender; - To - Recipient (list of all); - CC - Recipient of a copy of the letter; - Subject - Subject of the letter; - Body - The body of the letter; - Path - Path to the folder with the attachment files. - DateTime - received date and time | Robin.DataTable | ||
Number of messages | The number of messages found. | Robin.Numeric |
Special conditions of use
None.
Example of use
Task
Get all messages from testsforrobin@mail.ru with subject "Employee" and PNG-files in the attachments. Files from the messages to save to the folder.
Solution
Connect the mailbox from which you want to receive emails. For any actions with a particular mailbox, connect to it first, create its unique identifier (Context).
Define the mail service. (Connection parameters to the mailbox depend on the mail service).
Get emails matching the specified filters.
Implementation
- Assemble a robot scheme withe the actions:
- Set the "Open email" action parameters. (for action description go to Connection settings).
Set the "Get message" action parameters.
Action setting:a. "Context" parameter. Select from the drop-down list the context corresponding to the mailbox from which the messages will be deducted;
b. "From" parameter. Specify the mailbox of the message sender;
c. "To" parameter. Specify the mailbox of the message recipient;
d. "Subject" parameter. Specify the value "Employee";
e. "Attachment name" parameter. Specify the file mask. ".png";
f. "Folder For Attachment" parameter. Specify the path to the folder where the attachments will be saved;
g. "Starting date" parameter. Specify the date to be searched from the date/time specified in "Starting date" up to and including the date/time specified in "Ending date";
h. "Ending Date" parameter. Specify the date to be searched from the date/time specified in "Starting date" up to and including the date/time specified in "Ending date";
i. "Result" parameter. Specify the "Table" variable where the information from emails will be saved;
- Click "Start" in the top panel.
Result
The required emails are received and saved to a table that stores information from emails selected by the specified filters. Attachments from emails are saved to the target folder
...
Результат
Требуемые письма получены и сохранены в таблицу, в которую сохраняется информация из писем, отобранных по выбранным фильтрам.
Вложения из писем сохранены в целевую папку.