Установить категории письма
Элемент задает письму список категорий — цветных меток Outlook. Для корректной работы следует поместить элемент в контейнер Microsoft 365.
Категории удобно использовать как статус обработки, видимый сотрудникам: «Робот: обработано», «Робот: ошибка», «Требует проверки».
Свойства
Описание общих свойств элемента см. в разделе Свойства элемента .
Символ * в названии свойства указывает на обязательность его заполнения.
| Свойство | Тип | Описание |
|---|---|---|
| Аккаунт: | ||
| Учетная запись | String | Ящик, в котором находится письмо. Должна совпадать с Учетной записью элемента, получившего письмо |
| Параметры: | ||
| Категории | List<String> | Имена категорий, например new List<string> { "Обработано" }. Пустой список снимает все категории |
| Сообщение* | Message | Обрабатываемое письмо, например msg |
Важно: Переданный список заменяет категории письма, а не дополняет их. Чтобы сохранить существующие категории, используйте выражение из примера 2.
Примечание: Категорию не обязательно заранее создавать в Outlook — без этого она отображается без цвета. Имена категорий чувствительны к регистру.
Практические примеры
Пример 1: отметка об обработке
- Учетная запись:
"robot@company.ru" - Категории:
new List<string> { "Робот: обработано" } - Сообщение:
msg
Пример 2: добавление категории с сохранением существующих
- Категории:
(msg.Categories ?? new List<string>()).Union(new[] { "Робот: обработано" }).ToList()
Пример 3: получение писем без отметки робота
В элементе Получить письма свойство Запрос:
"not(categories/any(c: c eq 'Робот: обработано'))"Возможные ошибки
| Ошибка | Причина и решение |
|---|---|
Не указано сообщение | Не заполнено свойство Сообщение |