Отправить сообщение
Элемент выполняет отправку электронного письма через Outlook. Размещается внутри контейнера Приложение Outlook.
Применение элемента позволяет достичь следующих целей:
- сформировать и отправить сообщение;
- ответить на сообщение.
Свойства
Символ *
в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.
Группа Outlook:
-
Имя аккаунта [String] — имя учетной записи в профиле Outlook, c адреса которой необходимо отправить письмо. Если в профиле только одна учетная запись, то свойство можно не заполнять. Имя аккаунта можно узнать в меню Файл > Настройка учетных записей в Outlook. Пример:
Если указанное имя не будет найдено среди аккаунтов запущенного профиля Outlook, то для отправки сообщения будет использован аккаунт по умолчанию.
-
Переменная [LTools.Office.Model.OMailMessage] — название переменной, хранящей данные письма. Использование переменной позволяет сразу отправить сообщение, которое вы сформировали в коде, и пропустить заполнение необязательных свойств элемента. Если одновременно указать и переменную, и свойства — что не рекомендуется — то приоритет будет у значений из свойств.
-
Тема [String] — тема сообщения.
-
Тело письма [String] — тело отправляемого сообщения.
-
Вложения [List<String>] — путь к файлу вложения письма. Используйте редактор коллекций, чтобы указать путь каждого вложения - список сформируется автоматически.
-
Кому [String] — адресат сообщения.
-
Копия [String] — адресат копии. Если их несколько, используйте разделительный символ ”;”.
-
Скрытая копия [String] — адресат скрытой копии. Если их несколько, используйте разделительный символ ”;”.
-
Формат [LTools.Office.Model.OMailMessage.MailFormats] — формат сообщения. По умолчанию
PLAIN
- простой текст, не поддерживающий картинки, гиперссылки и другие подобные элементы. Чтобы изменить формат, нажмите на выпадающий список значений. Доступны варианты:RICHTEXT
(RTF),HTML
. -
От имени [String] — позволяет изменить электронный адрес отправителя. Например, в значении можно указать общий ящик , участником которого вы являетесь. При указании общего ящика убедитесь, что обладаете правами на отправку писем — разрешением «Отправить как» (Send as). Если свойство не заполнено, то по умолчанию письмо будет отправлено с основного адреса, привязанного к учетной записи.
Группа Re:
-
Ответить [LTools.Office.Model.OMailMessage] — название переменной с данными письма, на которое вы хотите ответить. Такую переменную можно получить, если предварительно использовать в сценарии элемент Чтение почты.
:small*orange_diamond: *Если одновременно заполнить свойства Переменная и Ответить, то приоритет будет у Ответить._
-
Ответить всем [Boolean] — если чекбокс установлен, то ответ отправится всем адресатам.
Группа Параметры
Уведомить о доставке [Boolean] — Запрос уведомления об успешной доставке сообщения. По умолчанию свойство выключено. Функция доступна с версии 1.24.10. Уведомить о прочтении [Boolean] — Запрос уведомления о прочтении сообщения. По умолчанию свойство выключено. Функция доступна с версии 1.24.10.
Решение проблем
Выполнение/отладка элемента, в котором заполнено свойство От имени, может завершиться ошибкой:
"Error: Отправить сообщение/cf63d3fd-495d-4cc7-b82b-acaea13d362c/1.1/LTools.Office.Elements.Outlook.WFSendMessage = Не удалось выполнить операцию. Интерфейс передачи сообщений возвратил неизвестную ошибку. Если это повторится, перезагрузите Outlook. Невозможно определить получателя".
Это означает, что у пользователя недостаточно прав на использование функциональности и необходимо связаться с администратором почты.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
LTools.Office.OutlookApp app = LTools.Office.OutlookApp.Init(wf, "Outlook", "password");
LTools.Office.Model.OMailMessage msg = new LTools.Office.Model.OMailMessage() { Subject = "subject", Body = "body" };
app.SendMessage(msg, "My");
app.SendMessage("body", "sendTo", "subject", "My", new List<string>() { "file1" }, LTools.Office.Model.OMailMessage.MailFormats.HTML);