ИсходящееПисьмо

Стд::ЭлектроннаяПочта::ИсходящееПисьмо
Базовые типы: Объект

Исходящее сообщение электронной почты.

Сравнение ссылочное

Примеры

знч Сообщение = новый ИсходящееПисьмо("sender@1c.ru")    
Сообщение.ДобавитьПолучателей("recipient@1c.ru")    
Сообщение.ДобавитьПолучателейКопии("ivanov@1c.ru")
Сообщение.Важность = ВажностьСообщенияЭлектроннойПочты.Высокая
Сообщение.Текст = "Текст исходящего сообщения электронной почты."
Сообщение.Тема = "Тема сообщения"

Конструкторы

ИсходящееПисьмо

ИсходящееПисьмо(Отправитель: АдресПочты|Строка, Получатели: АдресПочты|Строка|ЧитаемыйМассив<АдресПочты>, Тема: Строка? = Неопределено)

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

Свойства

Важность

Важность: ВажностьПисьма

Важность почтового сообщения. Значение данного свойства определяется значением заголовка “X-Priority”.

Вложения

ТолькоЧтение Вложения: ЧитаемыйМассив<ВложениеПисьма>

Массив вложений.

ДатаОтправления

ТолькоЧтение ДатаОтправления: Момент?

Значение заголовка “Date”. Undefined, если заголовок не установлен.

ИдСообщения

ИдСообщения: Строка?

Значение заголовка “Message-ID”. Undefined, если заголовок не установлен.

ОбратныеАдреса

ТолькоЧтение ОбратныеАдреса: ЧитаемыйМассив<АдресПочты>

Массив адресов из заголовков “Reply-To”.

Отправитель

ТолькоЧтение Отправитель: АдресПочты?

Отправитель электронного сообщения.

Получатели

ТолькоЧтение Получатели: ЧитаемыйМассив<АдресПочты>

Получатели сообщения электронной почты.

ПолучателиКопии

ТолькоЧтение ПолучателиКопии: ЧитаемыйМассив<АдресПочты>

Получатели копии сообщения.

ПолучателиСкрытойКопии

ТолькоЧтение ПолучателиСкрытойКопии: ЧитаемыйМассив<АдресПочты>

Получатели скрытой копии сообщения.

Текст

Текст: Строка

Текст сообщения.

Тема

Тема: Строка?

Значение заголовка “Subject”. Undefined, если заголовок не установлен.

Методы

ВСтроку

ВСтроку(): Строка

Переопределение: ВСтроку

Возвращает строковое представление сообщения.

ДобавитьЗаголовок

ДобавитьЗаголовок(Имя: Строка, Значение: Число|Строка|ЧитаемыйМассив<Число|Строка>): ИсходящееПисьмо

Добавляет значение Значение заголовка с именем Имя. При попытке добавить значение заголовков: “Subject”, “Message-id”, “From”, “Sender”, “Reply-To”, “To”, “Cc”, “Bcc”, “in-reply-to”, “references”, “date”, которое приведет к тому, что таких полей станет больше одного, будет выброшено исключение. Возвращает текущий экземпляр.

ДобавитьОбратныеАдреса

ДобавитьОбратныеАдреса(ОбратныеАдреса: АдресПочты|Строка|ЧитаемыйМассив<АдресПочты>): ИсходящееПисьмо

Добавляет обратный адрес ОбратныеАдреса для сообщения. Возвращает текущий экземпляр.

ДобавитьПолучателей

ДобавитьПолучателей(Получатели: АдресПочты|Строка|ЧитаемыйМассив<АдресПочты>): ИсходящееПисьмо

Добавляет получателя или получателей Получатели. Возвращает текущий экземпляр.

ДобавитьПолучателейКопии

ДобавитьПолучателейКопии(Получатели: АдресПочты|Строка|ЧитаемыйМассив<АдресПочты>): ИсходящееПисьмо

Добавляет получателя или получателей Получатели копии сообщения. Возвращает текущий экземпляр.

ДобавитьПолучателейСкрытойКопии

ДобавитьПолучателейСкрытойКопии(Получатели: АдресПочты|Строка|ЧитаемыйМассив<АдресПочты>): ИсходящееПисьмо

Добавляет получателя или получателей Получатели скрытой копии сообщения. Возвращает текущий экземпляр.

ОчиститьЗаголовки

ОчиститьЗаголовки(): ИсходящееПисьмо

Удаляет все заголовки сообщения. Возвращает текущий экземпляр.

ПолучитьВсеЗаголовки

ПолучитьВсеЗаголовки(Имя: Строка): ЧитаемыйМассив<Строка>

Возвращает массив со всеми значениями заголовка Имя. Если заголовка нет - пустой массив.

ПолучитьПервыйЗаголовок

ПолучитьПервыйЗаголовок(Имя: Строка): Строка?

Возвращает значение заголовка по его имени Имя или Undefined, если значения нет или заголовок отсутствует. Если есть несколько значений заголовка, то вернется первое по порядку.

ПриложитьДанные

ПриложитьДанные(Данные: Байты|ПотокЧтения|Строка, Название: Строка = “”, ТипСодержимого: Строка = “”): ВложениеПисьма

Добавляет и возвращает вложение сообщения на основе указанных данных Данные и параметров Название и ТипСодержимого.

Примеры

метод ДобавитьФайлВоВложение(Письмо: ИсходящееПисьмо)
    пер ФайлЛогов1 = новый Файл("C:/logs/1.log")
    исп ПотокФайла1 = ФайлЛогов1.ОткрытьПотокЧтения()
    Письмо.ПриложитьДанные(ПотокФайла1, "SystemInitializationLogs.txt")

    пер ФайлЛогов2 = новый Файл("C:\\logs\\2.log")
    исп ПотокФайла2 = ФайлЛогов2.ОткрытьПотокЧтения()
    Письмо.ПриложитьДанные(ПотокФайла2, "2.log")
;

ПриложитьФайл

ПриложитьФайл(Файл: Файл|Строка, Название: Строка = “”, ТипСодержимого: Строка = “”): ВложениеПисьма

Добавляет и возвращает вложение сообщения на основе файла Файл и параметров Название и ТипСодержимого. Если Название не заполнен, то названием будет имя приложенного файла.

Примеры

метод ПриложитьФайлКПисьму(Письмо: ИсходящееПисьмо)
    Письмо.ПриложитьФайл("C:/logs/1.log", "SystemInitializationLogs.txt")
    Письмо.ПриложитьФайл("C:\\logs\\2.log")
;

УдалитьВложение

УдалитьВложение(Ид: Ууид)

Удаляет вложение с идентификатором Ид из сообщения.

УдалитьЗаголовок

УдалитьЗаголовок(Имя: Строка): ИсходящееПисьмо

Удаляет все заголовки с именем Имя. Возвращает текущий экземпляр.

УстановитьЗаголовок

УстановитьЗаголовок(Имя: Строка, Значение: Число|Строка|ЧитаемыйМассив<Число|Строка>): ИсходящееПисьмо

Устанавливает заголовок с именем Имя и значениями Значение. Если заголовок с таким именем уже существует, то перед установкой все существующие значения заголовка будут удалены.