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

Элемент выполняет отправку электронного письма через 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] – название переменной с данными письма, на которое вы хотите ответить. Такую переменную можно получить, если предварительно использовать в сценарии элемент Чтение почты.

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

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)

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

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);

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)

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);