Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
— |
tags:mailcollector [29/10/2020 16:32] (текущий) |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
+ | ====== <mailcollector ... /> ====== | ||
+ | |||
+ | ''Компонент для работы с электронной почтой. '' | ||
+ | ---- | ||
+ | |||
+ | |||
+ | ===== Атрибуты ===== | ||
+ | |||
+ | ==== Основные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **id** | [[intro:types#id_name]] |Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор. \\ Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту.| | ||
+ | | **host** | [[intro:types#string]] |Адрес почтового сервера.| | ||
+ | | **login** | [[intro:types#string]] |Имя учетной записи на почтовом сервере.| | ||
+ | | **password** | [[intro:types#string]] |Пароль учетной записи.| | ||
+ | | **count** | [[intro:types#number]] |Количество циклов работы с почтовым ящиком. Если count="0", то цикл бесконечен.| | ||
+ | | **sleep** | [[intro:types#number]] |Временной промежуток в милисекундах между циклами работы с почтовым ящиком (если count!=1).| | ||
+ | | **amount** | [[intro:types#number]] |Количество сообщений, полученных с сервера.| | ||
+ | | **last-generated-id** | [[intro:types#number]] |ID последней сохраненной в системную таблицу (sys_desta_mail) записи.| | ||
+ | | **mail-id-list** | [[intro:types#number]] |Список ID, сохраненных в системную таблицу (sys_desta_mail) за последний сеанс загрузки сообщений.| | ||
+ | | **remove** | [[intro:types#boolean]] |Флаг удаления на сервере прочитанных сообщений.| | ||
+ | | **amount** | [[intro:types#number]] |Количество сообщений, полученных с сервера.| | ||
+ | | **last-generated-id** | [[intro:types#number]] |ID последнего сохраненного в базу сообщения.| | ||
+ | |||
+ | ==== Атрибуты для отправки сообщений (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **send-from** | [[intro:types#string]] |Адрес отправителя.| | ||
+ | | **send-from-name** | [[intro:types#string]] |Имя отправителя.| | ||
+ | | **send-to** | [[intro:types#string]] |Адрес получателя.| | ||
+ | | **send-to-name** | [[intro:types#string]] |Имя получателя.| | ||
+ | | **send-cc** | [[intro:types#string]] |Адрес для отправки копии письма.| | ||
+ | | **send-cc-name** | [[intro:types#string]] |Имя получателя копии письма.| | ||
+ | | **send-bcc** | [[intro:types#string]] |Адрес получателя скрытой копии.| | ||
+ | | **send-bcc-name** | [[intro:types#string]] |Имя получателя скрытой копии.| | ||
+ | | **send-subject** | [[intro:types#string]] |Тема письма.| | ||
+ | | **send-body** | [[intro:types#string]] |Тело письма.| | ||
+ | | **send-attach** | [[intro:types#string]] |Имена вложенных файлов. (Разделитель ";".)| | ||
+ | |||
+ | ==== Атрибуты только для чтения (R/O): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **mode** | ''receive | send'' |Указывает на текущее действие: прием или отправка сообщения.| | ||
+ | |||
+ | ==== Командные атрибуты(W/O): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **connect** | [[intro:types#boolean]] |@connect| | ||
+ | | **send-clear** | [[intro:types#boolean]] |Очистить все поля ввода.| | ||
+ | | **send** | [[intro:types#boolean]] |Отправить сообщение.| | ||
+ | |||
+ | ==== Событийные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **onCreated** | [[intro:types#code]] |Описание действий для события, возникающего единожды, после создания объекта. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onBeforeConnect** | [[intro:types#code]] |Событие, возникающее перед соединением с почтовым сервером. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onAfterConnect** | [[intro:types#code]] |Событие, возникающее после соединения с почтовым сервером. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onErrorConnect** | [[intro:types#code]] |Событие, возникающее, если при соединении с сервером произошла ошибка. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onAction** | [[intro:types#code]] |Событие, возникающее после успешного получения почты и сохранения в базу. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onDisconnect** | [[intro:types#code]] |Событие, возникающее после отключения от сервера. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onBeforeSend** | [[intro:types#code]] |Событие, возникающее перед отправкой письма на сервер. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onAfterSend** | [[intro:types#code]] |Событие, возникающее после отправки письма на сервер. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onErrorSend** | [[intro:types#code]] |Событие, возникающее при ошибке отправления письма на сервер. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | |||
+ | |||
+ | |||
+ | ===== Описание ===== | ||
+ | |||
+ | |||
+ | MailCollector описан в standartComponents. | ||
+ | |||
+ | Для того, чтоб подключить режим приема сообщений электронной почты нужно присоеденить файл mailcollector.appxml следующим образом: | ||
+ | <code> | ||
+ | <include file="biz.desta.jlib.standartComponents.mailcollector.appxml"/> | ||
+ | </code> | ||
+ | |||
+ | Для того, чтоб открыть окно с электронной почтой: | ||
+ | - Нужно указать host, login, password \\ <code> | ||
+ | destaMailCol.host = "host_name"; | ||
+ | destaMailCol.login = "login_name"; | ||
+ | destaMailCol.password = "pass"; | ||
+ | </code> | ||
+ | - После этого показать панель destaMailPanel разместить в нужном контейнере. | ||
+ | |||
+ | |||
+ | |||
+ | ===== Примеры ===== | ||
+ | |||
+ | примеры | ||