Чтение почты (Outlook)

Eng: Read mail

Элемент для работы с электронной почтой в Microsoft Outlook, позволяющий:

Читать письма из указанных папок
Фильтровать сообщения по различным критериям
Сортировать результаты
Работать с вложениями

В свойствах указываем путь до папки Outlook, которую необходимо прочесть. Список полученных писем робот сохранит в переменную вывода.

Поддерживаемые типы сообщений

Обычные письма
Ответы и пересылаемые сообщения
Отчеты о доставке и прочтении

⚠️

Не поддерживается чтение контактов и календарныx событий.

Перед началом работы

Установленный Microsoft Outlook 2013 или новее
Настроенный почтовый профиль
Элемент должен находиться внутри Приложения Outlook

alt

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента.
Символ * в названии свойства указывает на обязательность заполнения.

Свойство	Тип	Описание
*Outlook:*
Путь к папке	String	Полный путь (например: `@"\\user@domain.com\Inbox\Важные"`). Регистр и язык должны соответствовать Outlook
Отчеты	Boolean	Включает обработку отчетов о доставке
Не читать тело	Boolean	Ускоряет обработку, исключая загрузку содержимого писем
Читать свойства	Boolean	Определяет, нужно ли читать свойства писем. Прочитанные свойства можно просмотреть в модели письма OMailMessage в поле `MessageProperties`. Пример обращения к свойствам письма: `<variable name>[0].MessageProperties`, где <variable name> - название переменной вывода, хранящей список прочитанных писем, а [0] - индекс письма
Только непрочитанные	Boolean	Определяет, следует ли читать только непрочитанные письма. По умолчанию чекбокс снят - читаются все письма
Запрос	String	Поле для указания поискового запроса писем. Внимание: избегайте лишних кавычек внутри SQL-выражения. Пример правильного формата: `"@SQL=urn:schemas:httpmail:subject like '%Office%'"`
Сортировать		Определяет, нужно ли сортировать письма по какому-либо полю. По умолчанию `None` (сортировка не задана). Выберите из выпадающего списока нужный параметр
Направление		Направление сортировки. Порядок сортировки: `Ascending` или `Descending`. По умолчанию - `Ascending` (по возрастанию).
*Вывод:*
Переменная*	List <LTools.Office.Model.OMailMessage>	Переменная для сохранения списка полученных писем. (индексируется с 0)

Примеры запросов


-- По теме
"@SQL=urn:schemas:httpmail:subject like '%вопрос%'"
"@SQL=urn:schemas:httpmail:subject like 'работа%'"
-- По дате получения
"@SQL=urn:schemas:htipmail:daterreceived >= '2025-04-25'"
"@SQL=urn:schemas:htipmail:daterreceived <= '2025-04-28'"
-- Комбинированные условия
"@SQL=urn:schemas:httpmail:subject like '%welcome%' AND urn:schemas:httpmail:hasattachment = true"

Доступные варианты сортировки

Свойства сортировки

Доступные поля для сортировки писем:

Поле	Описание	Пример SQL выражения
Bcc	Сортировка по скрытой копии	”`@SQL="urn:schemas:httpmail:bcc" ASC`”
Cc	Сортировка по копии	”`@SQL="urn:schemas:httpmail:cc" DESC`”
Receive Time	Сортировка по времени получения	”`@SQL="urn:schemas:httpmail:datereceived" DESC`”
From	Сортировка по отправителю	”`@SQL="urn:schemas:httpmail:from" ASC`”
To	Сортировка по получателю	”`@SQL="urn:schemas:httpmail:to" ASC`”
Subject	Сортировка по теме письма	”`@SQL="urn:schemas:httpmail:subject" DESC`”
Categories	Сортировка по категориям	”`@SQL="urn:schemas:httpmail:categories" ASC`”

Важно! При составлении запросов убедитесь, что:

Нет лишних кавычек вокруг имен полей
Весь SQL-запрос заключен в двойные кавычки
Поля urn:schemas не обернуты в дополнительные кавычки

Только код

Пример использования элемента в процессе с типом Только код (Pure code):

C#


LTools.Office.OutlookApp app = LTools.Office.OutlookApp.Init(wf, "Outlook", "password");
List<LTools.Office.Model.OMailMessage> ret = app.ReadMail("\\имя_профиля\Inbox", true);

Python


app = LTools.Office.OutlookApp.Init(wf, "Outlook", "password")
ret = app.ReadMail("\\имя_профиля\Inbox", True)

JavaScript


var app = _lib.LTools.Office.OutlookApp.Init(wf, "Outlook", "password");
var ret = app.ReadMail("\\имя_профиля\Inbox", true);