...

Get message Version 16 (Net)

Группа действийAction group: ПочтаMail

Описание

Данное действие читает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table. Для получения данных, записанных в переменную типа "Таблица" необходимо использовать действие Eng_Сохранить таблицу в CSV

Для корректной работы действия "Получить сообщение" необходимо изначально настроить подключение к почте с помощью действия Eng_Настройки подключения (Net)

Иконка действия

Image Removed

Параметры действия

Входные параметры

1. Поле "Контекст" - идентификатор сеанса работы с почтовым сервером. В поле указывается контекст действия "Настройки подключения". 
2. Поле "От" - почтовый адрес отправителя письма. Чтобы указать более одного элемента, используйте «;» или «,»
3. Поле "Кому" - почтовый адрес получателя письма. Чтобы указать более одного элемента, используйте «;» или «,»
4. Поле "Копия" - почтовый адрес получателя копии письма. Чтобы указать более одного элемента, используйте «;» или «,»
5. Поле "Тема" - тема письма. 
6. Поле "Тело письма" - текст письма. 
7. Поле "Название вложения" - названия вложения в письме. 
8. Поле "Непрочитанные" - при указании чекбокса "Непрочитанные" = true , будут отобраны только непрочитанные письма. 
9. Поле "Количество" - количество писем, которое необходимо прочитать из почтового ящика по указанным фильтрам.
10. Поле "Папка для сохранения вложений" - путь к папке, в которой будут созданы подпапки для сохранения вложений из писем.
11. Поле "Включить html текст" - данный чекбокс включает полную информацию о стилях. Иначе будет получен просто текст.
    чекбокс "Включить html текст" проставлен
    Image Removed
    чекбокс "Включить html текст" не проставлен
     Image Removed
12. Поле "Сохранить изображения" - если значение «true», то изображения из тела письма будут сохранены, иначе – сохранены не будут.
13. Поле “Начиная с даты” - Будут выбраны сообщения, которые получены, начиная с указанных даты и времени.
14. Поле “Заканчивая датой” - Будут выбраны сообщения, которые получены до указанных даты и времени включительно.

Выходные параметры

Таблица результатов - таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов:

1. ID - идентификатор письма.
2. From - почтовый адрес отправителя.
3. To - почтовые адреса всех основных получателей.
4. CC - почтовые адреса всех получателей копии письма.
5. Subject - тема письма; - Body - тело письма.
6. Path - путь до сформированной подпапки, в которую были сохранены файлы вложений.
7. DateTime – дата и время получения письма.

...

Description

This action reads emails from the mailbox that match the specified filters and saves them to a variable of type Table. To retrieve the data written to the variable of the Table type, use the action Table to CSV Tables

In order for the "Get message" action to work correctly, it is necessary to initially set up a connection to the email using the action Open email (Net) Mail

Action icon

Image Added

Action parameters

Input parameters

1. "Context" field - identifier of the session of work with the email server. The field specifies the context of the "Connection settings" action. 
2. "From" field - the mail address of the email sender. To specify more than one item, use ";" or ","
3. "To" field - the email address of the recipient of the message. To specify more than one element, use ";" or ",".
4. "CC" field - the email address of the recipient of the copy of the letter. To specify more than one element, use ";" or ",".
5. "Subject" field - the subject of the email. 
6. "Body" field - the text of the email. 
7. "Attachment name" field - the name of the attachment in the email. 
8. "Unread only" field - if the checkbox = true, only unread emails will be selected. 
9. "Count" field - the number of emails that should be read from the mailbox according to the specified filters.
10. "Folder For Attachment" field - the path to the folder where subfolders for saving attachments from emails will be created.
11. "Include html text" field - this checkbox includes full information about styles. Otherwise, just text will be received.
    The "Include html text" checkbox is checkedImage Added
    the "Include html text" checkbox is unchecked
     Image Added
12. "Save images" field - if the value is "true", the images from the message body will be saved, otherwise they will not be saved.
13. "Starting date" field - The messages that are received starting from the specified date and time will be selected.
14. "Ending date" field - Messages received up to and including the specified date and time will be selected.

Output parameters

Results table - a table where information from emails selected by selected filters is saved. The table has the following set of columns:

1. ID - email identifier.
2. From - email address of the sender.
3. To - email addresses of all primary recipients.
4. CC - email addresses of all recipients of the email copy.
5. Subject - subject of the email; 
6. Body - body of the email.
7. Path - path to the generated subfolder where attachment files were saved.
8. DateTime - date and time when the email was received.

Example of a saved table in CSV (action "Save table to Пример сохраненной таблицы в CSV (действие "Сохранить таблицу в CSV"). 

...

Settings

...

Action parameters of previous versions

Eng_Получить сообщение Версии1-15

...

Special conditions of use 

ОтсутствуютNone.

Пример использования

Задача

Получить все  письма с почты за заданный временной интервал и сохранить информацию из писем в таблицу (CSV), а также вывести диалоговое окно с количеством найденных сообщений.

Решение

Подключить почтовый ящик, с которого требуется взять письма. Для любых действий с конкретным почтовым ящиком, необходимо сперва подключиться к нему, создать его уникальный идентификатор (Контекст).

Определить почтовый сервис. (От почтового сервиса зависят параметры подключения к почтовому ящику).

Получить письма соответствующие указанным фильтрам.

Реализация

Example of use

Task

Get all emails from the mail for a given time interval and save the information from the emails to a table (CSV) and display a dialog box with the number of found messages.

Solution

Connect the mailbox from which you want to receive emails. For any actions with a particular mailbox, you should first connect to it, create its unique identifier (Context).

Define a postal service. (The parameters of connection to the mailbox depend on the postal service).

Receive emails corresponding to the specified filters.

Implementation

Use the actions: "Open email", "Get message", "Show message"Воспользуемся действиями: "Open email", “Get message”, “Show message”, "Table to CSV".

1. Собрать схему робота, состоящую из действийAssemble a robot scheme consisting of actions:
   
2. Настроить параметры для действия "Настройки подключения". (см. описание действия Configure the settings for the "Connection settings" action. (see the description of the action Настройки подключения / Connection settings). 
   
3. Настроить параметры для действия "Получить сообщение".
   

   Настройка действия:

   1. параметр "Контекст". Необходимо выбрать из выпадающего списка контекст соответствующий почтовому ящику с которого будут вычтены сообщения;
   2. параметр "От". Указываем почтовый ящик отправителя сообщения;
   3. параметр “Начиная с даты”. Указываем дату начала интервала;
   4. параметр “Заканчивая датой”. Указываем дату конца интервала;
   5. параметр "Результат". Указываем переменную "Таблица", в которую будет сохранена информация из писем;
   6. параметр “Количество сообщений”. Указываем переменную “Счетчик”, в которую будет сохранена информация о количестве сообщений.

   Image Removed

4. Настроить параметры действия “Сообщение”.
   Image Removed
5. Настроить параметры действия “Сохранить таблицу в CSV”.
   Image Removed
6. Нажать на кнопку "Старт" в верхней панели. 

Результат

Image Removed

Требуемые письма получены и сохранены в таблицу формата CSV, в которую сохраняется информация из писем, отобранных по выбранным фильтрам.

1. Set the parameters for the "Get message" action.
   

   Set the action parameters:

   1. "Context" parameter. It is necessary to select from the dropdown list the context corresponding to the mailbox from which the messages will be deducted;
   2. "From" parameter. Specify the mailbox of the message sender;
   3. "Starting date" parameter. Specify the starting date of the interval;
   4. "Ending date" parameter. Specify the end date of the interval;
   5. "Results table" parameter. Specify the "Table" variable where the information from the emails will be saved;
   6. "Number of messages" parameter. Specify the "Count" variable, into which the information about the number of messages will be saved.

   Image Added

2. Set the parameters of the "Message" action.
   Image Added
3. Set the parameters of the "Table to CSV" action.
   Image Added
4. Click on the "Start" button in the top panel. 

Result

Image Added

The required emails are retrieved and saved in a CSV format table, which saves information from the emails selected by the selected filters.

A form with the number of found messages is also displayedТакже выведена форма с количеством найденных сообщений.