Свойства и методы объекта V7Mail

[СветланаТ]

ДобавитьАдрес
Добавляет адрес рассылки письма

Синтаксис:

ДобавитьАдрес(<Адрес>)

Англоязычный синоним:

AddAddress

Параметры:

<Адрес> (строковое выражение) - почтовый адрес

Возвращаемое значение:

Нет

Описание:

Метод ДобавитьАдрес добавляет адрес в список адресов получателей данного сообщения, созданного методом НовоеСообщение. Адрес формируется в соответствии с выбранным типом ЭП.

[СветланаТ]

ДобавитьФайл
Добавляет файл к письму

Синтаксис:

ДобавитьФайл(<ИмяФайла>)

Англоязычный синоним:

AddFile

Параметры:

<ИмяФайла> (строковое выражение) - значение полного пути к добавляемому файлу

Возвращаемое значение:

Нет

Описание:

Метод ДобавитьФайл позволяет добавить имя нового файла в  список присоединенных файлов сообщения, созданного методом   НовоеСообщение.  Файл должен существовать. В случае "1C:Электронная Почта"  диск, на котором находится файл (диск должен быть обязательно подключен).

[СветланаТ]

Послать
Послать сообщение

Синтаксис:

Послать(<Просмотр>)

Англоязычный синоним:

Send

Параметры:

<Просмотр> числовое значение

0 - не отображать окно редактирования сообщения перед отправкой (значение по умолчанию)

1 - отображает окно редактирования и позволяет просмотреть и отредактировать сообщение перед отправкой (только в случае работы с клиентом MAPI)

Возвращаемое значение:

Нет

Описание:

Метод Послать позволяет отправить сообщение, созданного  методом НовоеСообщение. У посылаемого сообщения  обязательно должен быть задан хотя бы один адресат.

[СветланаТ]

ВыбратьСообщения
Инициализирует процесс получения сообщений

Синтаксис:

ВыбратьСообщения()

Англоязычный синоним:

SelectMеssages

Параметры:

Нет

Возвращаемое значение:

Числовое значение:

0 - сообщений нет;

1 - выбрано хотя бы одно сообщение.

Описание:

Метод ВыбратьСообщения инициализирует процесс получения сообщений с помощью метода ПолучитьСообщение.

[СветланаТ]

ПолучитьСообщение
ПолучитьСообщение

Синтаксис:

ПолучитьСообщение()

Англоязычный синоним:

ReceiveMessage

Параметры:

Нет

Возвращаемое значение:

Числовое значение:

1 - сообщение получено успешно;

0 - сообщений больше нет.

Описание:

Метод ПолучитьСообщение выбирает следующее сообщение из  выборки, открытой с помощью метода ВыбратьСообщения.  Данный метод используется для организации цикла по  сообщениям. После получения сообщения доступны для чтения  адрес отправителя и заголовок сообщения. Содержимое  сообщения (текст и присоединенные файлы) будет доступно  после выполнения метода ПрочитатьСообщение.

[СветланаТ]

ПрочитатьСообщение
Получить содержимое сообщения

Синтаксис:

ПрочитатьСообщение(<Флаг>)

Англоязычный синоним:

ReadMessage

Параметры:

<Флаг> Числовое значение

0 - не помечать как прочитанное

1 - помечать как прочитанное  (значение по умолчанию)

Возвращаемое значение:

Нет

Описание:

Метод ПрочитатьСообщение позволяет получить содержимое  сообщения (текст и присоединенные файлы), полученного с помощью метода ПолучитьСообщение. Текст сообщения хранится в атрибуте Текст, а полные пути к присоединенным файлам можно получить с помощью  метода ПолучитьФайл. Файлы копируются во временную директорию и удаляются при переходе на следующее сообщение (метод ПолучитьСообщение)

Параметр <Флаг> определяет состояние сообщения после  прочтения:

0 - сообщение не помечается как прочитанное и может быть повторно получено и прочитано;

1 - сообщение помечается как прочитанное и не попадает в последующие выборки.

[СветланаТ]

АдресОтправителя
Получить адрес отправителя полученного сообщения

Синтаксис:

АдресОтправителя()

Англоязычный синоним:

SenderAddress

Параметры:

Нет

Возвращаемое значение:

<Адрес> (строковое выражение) - значение адреса отправителя сообщения

Описание:

Метод АдресОтправителя позволяет получить адрес, с которого было отправлено сообщение. Для того, чтобы получить адреса отправителя надо сначала получить сообщение с помощью метода ПолучитьСообщение.

[СветланаТ]

ПолучитьФайл
Получить имя и полный путь к следующему присоединенному файлу полученного сообщения

Синтаксис:

ПолучитьФайл(<ИмяФайла>,<Каталог>)

Англоязычный синоним:

GetFile

Параметры (возвращаемые):

<ИмяФайла> (строковое выражение) - имя файла

<Каталог> (строковое выражение) - каталог   (Disk:\Path\)

Возвращаемое значение:

Числовое значение:

1 - получено успешно;

0 - файлов больше нет

Описание:

Метод ПолучитьФайл получить имя и каталог следующего  присоединенного файла сообщения, прочитанного с помощью  метода  ПрочитатьСообщение. Данный метод используется для  организации цикла по присоединенным файлам сообщения. Если  файл в дальнейшем планируется использовать, то его  необходимо переименовать или скопировать в другое место.  При получении следующего сообщения все присоединенные файлы данного сообщения будут удалены.

[СветланаТ]

УдалитьСообщение
Удалить сообщение

Синтаксис:

УдалитьСообщение()

Англоязычный синоним:

DeleteMessage

Параметры:

Нет

Возвращаемое значение:

Нет

Описание:

Метод УдалитьСообщение удаляет текущее сообщение,  полученное с помощью метода ПолучитьСообщение. (и,  возможно, прочитанное с помощью метода ПрочитатьСообщение).

[СветланаТ]

Примеры
Перем Почта Экспорт;

ЗагрузитьВнешнююКомпоненту("V7Plus.dll");

Почта = СоздатьОбъект("AddIn.V7Mail");

Процедура ПослатьСообщение()

Почта.Подключиться("MAPI","МояКонфигурацияПодключения, "");

Почта.НовоеСообщение();

Почта.ДобавитьАдрес("xxx@yyy.zzz");

Почта.ДобавитьФайл("invoice.txt");

Почта.Заголовок="Прайс-лист фирмы ТоргТехника";

Почта.Текст="В прилагаемом файле помещен прайс лист нашей

фирмы";

Почта.Послать();

Почта.Отключиться();

КонецПроцедуры

Процедура ПринятьСообщения()

Перем ПутьКФайлу, ИмяФайла;

ТекстДок=СоздатьОбъект("Текст");

Почта.Подключиться();

Почта.ВыбратьСообщения();

Пока Почта.ПолучитьСообщение() = 1 Цикл

АдресОтправителя=Почта.АдресОтправителя();

Заголовок=Почта.Заголовок;

Почта.ПрочитатьСообщение(0);

Текст=Почта.Текст;

Пока Почта.ПолучитьФайл(ПутьКФайлу, ИмяФайла) = 1 Цикл

ТекстДок.Открыть(ПутьКФайлу+ИмяФайла);

ТекстДок.ТолькоПросмотр(1);

ТекстДок.Показать(Заголовок);

КонецЦикла;

КонецЦикла;

Почта.Отключиться();

КонецПроцедуры