Отправить сообщение
Элемент предназначен для отправки писем через почту MS Exchange. С его помощью возможно:
- сформировать и отправить сообщение;
- ответить на какое-либо сообщение.
Данный элемент размещается внутри контейнера Сервер MS Exchange. Перед отправкой сообщения убедитесь, что в контейнере правильно указаны все необходимые свойства: email, логин, пароль и др.
Свойства
Символ *
в названии свойства указывает на обязательность заполнения. Описание общих свойств см. в разделе Свойства элемента.
Группа Exchange:
- Кому* [String] — электронный адрес адресата. Обязательный параметр. В случае, если указан только адресат, а все остальные параметры не заполнены, то будет отправлено пустое письмо.
- Кому (в копии) [String] — электронный адрес адресата копии. Если их несколько, используйте разделительный символ ”;”.
- Скрытая копия [String] — электронный адрес адресата скрытой копии. Если их несколько, используйте разделительный символ ”;”.
- Переменная [LTools.Office.Model.OMailMessage] — название переменной с моделью письма. В настоящее время не рекомендуется к использованию.
- Тема [String] — тема сообщения.
- Тело письма [String] — тело отправляемого сообщения. Пример:
"Message text"
. - Формат [LTools.Office.Model.OMailMessage.MailFormats] — формат сообщения. По умолчанию
PLAIN
- простой текст, не поддерживающий картинки, гиперссылки и другие подобные элементы. Чтобы изменить формат, нажмите на выпадающий список значений. Доступны варианты:RICHTEXT
,HTML
. - Вложения [System.Collections.Generic.List<String>] — список путей к вложениям письма. Указать пути можно несколькими способами:
- Использовать редактор коллекций (1). В поле редактора пропишите путь до файла вложения либо переменную, содержащую путь (2). Новая строка добавляется по нажатию
Enter
. - Заранее подготовить список путей до вложений. Его можно сформировать вручную или использовать элемент Поиск файлов, чтобы сохранить пути найденных вложений в переменную.
- Использовать редактор коллекций (1). В поле редактора пропишите путь до файла вложения либо переменную, содержащую путь (2). Новая строка добавляется по нажатию
- Копировать в папку [Boolean] — определяет, нужно ли сохранять копию письма в папке «Отправленные». По умолчанию чекбокс выключен — копия не сохраняется.
- Папка копирования [String] — позволяет переопределить папку для хранения копии письма. Работает только при установке чекбокса Копировать в папку.
- От имени [String] — изменяет адрес отправителя письма. В значении укажите электронный адрес и убедитесь, что у вас есть право на отправку писем с этого ящика — разрешение «Отправить как» (Send as). Получатель в данном случае не увидит, что письмо ему отправил другой пользователь. Если значение не задано, то отправителем будет владелец учетной записи, под которой вы подключились к серверу Exchange.
- Общий ящик [String] — позволяет сохранить копию отправленного письма в общем почтовом ящике. В значении нужно указать адрес общего ящика, участником которого вы являетесь. Одновременно с этим должны быть заполнены свойства:
- Копировать в папку — иначе копия не сохранится.
- От имени — если нужно не только сохранить копию в общем ящике, но и произвести саму отправку из общего ящика.
- Папка копирования — если письмо нужно сохранить в папке, отличной от «Отправленные».
Группа Re:
- Ответить [LTools.Office.Model.OMailMessage] — название переменной с данными письма, на которое вы хотите ответить. Такую переменную можно получить, если предварительно использовать в сценарии элемент Чтение почты.
- Ответить всем [Boolean] — если флаг установлен, ответ будет выслан всем адресатам.
Только код
Пример использования элемента в процессе с типом Только код (Pure code):
C#
var version = Microsoft.Exchange.WebServices.Data.ExchangeVersion.Exchange2010;
var url = "url";
var login = "login";
var password = "password";
var domain = "domain";
var russianTimeZone = false;
LTools.Office.MSExchangeApp app = LTools.Office.MSExchangeApp.InitSvc(wf, version, url, login, password, domain, russianTimeZone);
LTools.Office.Model.OMailMessage message = null;
var body = "body";
var toEmailAddress = "toEmailAddress";
var subject = "subject";
List<string> attachments = null;
var messageFormat = LTools.Office.Model.OMailMessage.MailFormats.PLAIN;
app.SendMessage(message);
app.SendMessage(body, toEmailAddress, subject, attachments, messageFormat);