Отправить сообщение

Send message

Элемент выполняет отправку электронного письма через Outlook. Размещается внутри контейнера Приложение Outlook.

Применение элемента позволяет достичь следующих целей:

• сформировать и отправить сообщение;

• ответить на сообщение.

Свойства

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

Группа Outlook:

1. Имя аккаунта [String] — имя учетной записи в профиле Outlook, c адреса которой необходимо отправить письмо. Если в профиле только одна учетная запись, то свойство можно не заполнять. Имя аккаунта можно узнать в меню Файл > Настройка учетных записей в Outlook. Пример:

   

   Если указанное имя не будет найдено среди аккаунтов запущенного профиля Outlook, то для отправки сообщения будет использован аккаунт по умолчанию.

2. Переменная [LTools.Office.Model.OMailMessage] — название переменной, хранящей данные письма. Использование переменной позволяет сразу отправить сообщение, которое вы сформировали в коде, и пропустить заполнение необязательных свойств элемента. Если одновременно указать и переменную, и свойства — что не рекомендуется — то приоритет будет у значений из свойств.

3. Тема [String] — тема сообщения.

4. Тело письма [String] — тело отправляемого сообщения.

5. Вложения [List<String>] — путь к файлу вложения письма. Используйте редактор коллекций, чтобы указать путь каждого вложения - список сформируется автоматически.

   
6. Кому [String] — адресат сообщения.

7. Копия [String] — адресат копии. Если их несколько, используйте разделительный символ ";".

8. Скрытая копия [String] — адресат скрытой копии. Если их несколько, используйте разделительный символ ";".

9. Формат [LTools.Office.Model.OMailMessage.MailFormats] — формат сообщения. По умолчанию PLAIN - простой текст, не поддерживающий картинки, гиперссылки и другие подобные элементы. Чтобы изменить формат, нажмите на выпадающий список значений. Доступны варианты: RICHTEXT(RTF), HTML.

10. От имени [String] — позволяет изменить электронный адрес отправителя. Например, в значении можно указать общий ящик, участником которого вы являетесь. При указании общего ящика убедитесь, что обладаете правами на отправку писем — разрешением «Отправить как» (Send as). Если свойство не заполнено, то по умолчанию письмо будет отправлено с основного адреса, привязанного к учетной записи.

Группа Re:

1. Ответить [LTools.Office.Model.OMailMessage] — название переменной с данными письма, на которое вы хотите ответить. Такую переменную можно получить, если предварительно использовать в сценарии элемент Чтение почты.

   🔸 Если одновременно заполнить свойства Переменная и Ответить, то приоритет будет у Ответить.

2. Ответить всем [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);

Python

app = LTools.Office.OutlookApp.Init(wf, "Outlook", "password");
msg = LTools.Office.Model.OMailMessage() 
msg.Subject = "subject"
msg.Body = "body"
app.SendMessage(msg, "My")
att = List[String]()
att.Add("file1")
app.SendMessage("body", "sendTo", "subject", "My", att, LTools.Office.Model.OMailMessage.MailFormats.HTML)

JavaScript

var host = new _lib.Microsoft.ClearScript.HostFunctions();
var app = _lib.LTools.Office.OutlookApp.Init(wf, "Outlook", "password");
var msg = host.newObj(_lib.LTools.Office.Model.OMailMessage); 
msg.Subject = "subject";
msg.Body = "body";
var att = host.newObj(_lib.System.Collections.Generic.List(_lib.System.String));
att.Add("file1");
app.SendMessage(msg, "My");
app.SendMessage("body", "sendTo", "subject", "My", att, _lib.LTools.Office.Model.OMailMessage.MailFormats.HTML);