Создать контекст для приема писем (CreateEmailReceiveContext)
Описание
Действие устанавливает соединение с сервером и возвращает объект контекста соединения для получения почты по протоколам IMAP или POP3.
Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|---|
Параметры | ||||||
POST_PROTOCOL | Протокол почтового сервера | Post protocol | Выбор протокола почтового сервера для получения почты: Выпадающий список:
| Robin.String | IMAP | Да |
SECURE_PROTOCOL | Защита соединения | Secure protocol | Протокол отправки сообщений. Возможные значения:
| Robin.String | SSL/TLS | Нет |
PORT | Порт | Port | Порт для соединения. | Robin.Numeric | 993 | Да |
SERVER | URL сервера | Server URL | Адрес почтового сервера. | Robin.String | imap.yandex.com | Да |
USERNAME | Логин | User | Логин от почты. | Robin.String | example@yandex.ru | Да |
PASSWORD | Пароль | Password | Пароль от почты. | Robin.Password | sdkhbvkjrn | Да |
Результаты | ||||||
RECEIVE_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым сервером для получения почты | Robin.Email.ReceiveContext | --- | --- |
Замечания
В перспективе можно добавить:
- к параметру "Защита соединения" протокол безопасности STARTTLS
- новый параметр действия - "Метод аутентификации" с значениями:
- автоопределение
- без аутентификации
- обычный пароль
- зашифрованный пароль
- Kerberos/GSSAPI
- NTLM
- OAuth2
Создать контекст для отправки писем (CreateEmailSendContext)
Описание
Действие устанавливает соединение с сервером и возвращает объект контекста соединения для отправки писем по протоколу SMTP.
Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|---|
Параметры | ||||||
SECURE_PROTOCOL | Защита соединения | Secure protocol | Протокол отправки сообщений. Возможные значения:
| Robin.String | SSL/TLS | Да |
PORT | Порт | Port | Порт для соединения. | Robin.Numeric | 465 | Да |
SERVER | URL сервера | Server URL | Адрес почтового сервера. | Robin.String | smtp.yandex.com | Да |
USERNAME | Логин | User | Логин от почты. | Robin.String | example@yandex.ru | Да |
PASSWORD | Пароль | Password | Пароль от почты. | Robin.Password | sdkhbvkjrn | Да |
Результаты | ||||||
SEND_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым сервером для отправки писем | Robin.Email.SendContext | --- | --- |
Особые условия использования
Протокол SMTP является встроенным параметром для действия., поэтому он исключен из пользовательских параметров действия.
Замечания
В перспективе можно добавить:
- к параметру "Защита соединения" протокол безопасности STARTTLS
- новый параметр действия - "Метод аутентификации" с значениями:
- автоопределение
- без аутентификации
- обычный пароль
- зашифрованный пароль
- Kerberos/GSSAPI
- NTLM
- OAuth2
Получить сообщение / Get message
Описание
Действие загружает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table.
Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|---|
Параметры | ||||||
RECEIVE_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым сервером ( eIMAP или ePOP3), возвращаемый действием CreateEmailReceiveContext. | Robin.Email.ReceiveContext | --- | Да |
UNREAD | Непрочитанные | Unread only | Выбрать только непрочитанные письма. | Robin.Boolean | true | Нет |
SIZE | Количество | Size | Количество писем, которое необходимо вычитать из почтового ящика по указанным фильтрам. | Robin.Numeric | 1 | Нет |
FROM | От | From | Выбираются письма, у которых почтовый адрес отправителя письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте ";" или "," | Robin.String | example@yandex.ru | Нет |
TO | Кому | To | Выбираются письма, у которых почтовый адрес получателя письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте ";" или "," | Robin.String | example@yandex.ru | Нет |
CC | Копия | CC | Выбираются письма, у которых копия письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте ";" или "," | Robin.String | example@yandex.ru | Нет |
SUBJECT | Тема | Subject | Выбираются письма, у которых тема письма соответствует указанному регулярному выражению. | Robin.String | Отчет | Нет |
BODY | Тело письма | Body | Выбираются письма, у которых текст письма соответствует указанному регулярному выражению. | Robin.String | Внимание! | Нет |
Результаты | ||||||
MESSAGES | Таблица результатов | Results table | Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов:
| Robin.DataTable |
Особые условия использования
Протокол POP3 не поддерживает считывание только прочитанных или не прочитанных писем. Для чтения только непрочитанных писем рекомендуется использовать протокол IMAP.
Отправить сообщение / Send message
Описание
Действие создает сообщение и отправляет сообщение на сервер.
Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|---|
Параметры | ||||||
SEND_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым сервером ( eSMTP), возвращаемый действием CreateEmailSendContext. | Robin.Email.SendContext | --- | Да |
FROM | От | From | Адрес почты отправителя сообщения. | Robin.String | example@yandex.ru | Да |
TO | Кому | To | Список адресов получателей письма. В качестве разделителя используйте ";". | Robin.Collection | Да | |
CC | Копия | CC | Список адресов получателей копии письма. В качестве разделителя используйте ";". | Robin.Collection | Нет | |
SUBJECT | Тема | Subject | Тема письма. | Robin.String | Отчет | Нет |
BODY | Тело письма | Body | Тело письма. | Robin.String | Добрый день! | Нет |
ATTACHMENTS | Вложения | Attachments | Робин-коллекция (Robin.Collection), содержащая пути к файлам (Robin.File), которые необходимо прикрепить. | Robin.Collection | Нет |
Ответить / Reply
Описание
Действие получает в виде входного параметра таблицу сообщений, выбирает сообщения из таблицы, возвращаемой действием Получить сообщение.
параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля | Значение по умолчанию |
---|---|---|---|---|---|---|---|
Параметры | |||||||
SEND_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым eSMTP-сервером, возвращаемый действием CreateEmailSendContext. | Robin.Email.SendContext | --- | Да | |
MESSAGES | Таблица с письмами | Messages Table | Таблица, в которой есть письма, на которые нужно ответить. | Robin.DataTable | Да | ||
REPLY_TO_ALL | Ответить всем | Reply to all | Логическая переменная. Если переменная равна True, то ответ будет направлен всем получателям, включая CC, письма с Message ID, указанным в параметре ID сообщения. Если переменная равна False, то ответ будет направлен только отправителю письма. | Robin.Boolean | True | False | Нет | False |
CITE | Цитировать | Cite | Логическая переменная. Если переменная равна True, то в тело ответа будет включен текст письма с Message ID, указанным в параметре ID сообщения. Если переменная равна False, то в тело ответа не будет включен текст письма с Message ID, указанным в параметре ID сообщения. | Robin.Boolean | True | False | Нет | False |
BODY | Тело | Body | Текст, который нужно добавить в тело письма. | Robin.String | Отвечаю вам. | Нет | |
ATTACHMENTS | Вложения | Attachments | Робин-коллекция (Robin.Collection), содержащая пути (Robin.File) к файлам, которые необходимо прикрепить. | Robin.Collection | Нет |
Комментарий для разработчика
Порядок работы действия:
- Действие из таблицы, указанной в параметре "Таблица с письмами", по Message ID извлекает сообщение, на которое нужно ответить.
- Из сообщения извлекаются параметры сообщения:
- От_получ,
- Кому_получ,
- Копия_получ,
- Тема_получ,
- Тело_получ.
- Формируются параметры нового сообщения, которое будет отправлено, в следующем порядке:
- Кому:
- Если значение параметра "Ответить всем" равно True, то в поле сообщения "Кому" вставляются все адресаты из поля "Кому_получ" + адрес отправителя "От_получ", а в поле "Копия" вставляются адресаты из поля "Копия_получ".
- Если значение параметра "Ответить всем" равно False, то в поле сообщения "Кому" вставляется только адрес отправителя "От_получ", а поле "Копия" остается пустым.
- Тема:
- Поле "Тема" получается путем добавления префикса "Re: " к теме сообщения, на которое следует ответить, - "Тема_получ"
- Тело:
- Если значение параметра "Цитировать" равно True, то в тело ответа следует включать текст со значением параметра "Тело" и текст письма с Message ID, указанным в параметре ID сообщения. Цитируемый текст должен быть выделен вертикальной линией слева.
- Если значение параметра "Цитировать" равно False, то в тело ответа следует включать только текст со значением параметра "Тело".
- Вложения:
- К ответу должны быть прикреплены все файлы, указанные в параметре действия "Вложения".
- Кому: