Создать контекст для приема писем (CreateEmailReceiveContext)
Описание
Действие устанавливает соединение с сервером и возвращает объект контекста соединения для получения почты по протоколам IMAP или POP3.
| Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|---|
| Параметры | ||||||
| Протокол почтового сервера | Post protocol | Выбор протокола почтового сервера для получения почты: Выпадающий список:
| Robin.String | IMAP | Да | |
| Защита соединения | Secure protocol | Протокол отправки сообщений. Возможные значения:
| Robin.String | SSL/TLS | Нет | |
| Порт | Port | Порт для соединения. | Robin.Numeric | 993 | Да | |
| URL сервера | Server URL | Адрес почтового сервера. | Robin.String | imap.yandex.com | Да | |
| Логин | User | Логин от почты. | Robin.String | example@yandex.ru | Да | |
| Пароль | Password | Пароль от почты. | Robin.Password | sdkhbvkjrn | Да | |
| Результаты | ||||||
| RECEIVE_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым сервером для получения почты | Robin.Email.ReceiveContext | --- | --- |
Замечания
В перспективе можно добавить:
- к параметру "Защита соединения" протокол безопасности STARTTLS
- новый параметр действия - "Метод аутентификации" с значениями:
- автоопределение
- без аутентификации
- обычный пароль
- зашифрованный пароль
- Kerberos/GSSAPI
- NTLM
- OAuth2
Создать контекст для отправки писем (CreateEmailSendContext)
Описание
Действие устанавливает соединение с сервером и возвращает объект контекста соединения для отправки писем по протоколу SMTP.
| Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|---|
| Параметры | ||||||
| Защита соединения | Secure protocol | Протокол отправки сообщений. Возможные значения:
| Robin.String | SSL/TLS | Да | |
| Порт | Port | Порт для соединения. | Robin.Numeric | 465 | Да | |
| URL сервера | Server URL | Адрес почтового сервера. | Robin.String | smtp.yandex.com | Да | |
| Логин | User | Логин от почты. | Robin.String | example@yandex.ru | Да | |
| Пароль | Password | Пароль от почты. | Robin.Password | sdkhbvkjrn | Да | |
| Результаты | ||||||
| SEND_POST_CONTEXT | Контекст | Context | Контекст действия для работы с почтовым сервером для отправки писем | Robin.Email.SendContext | --- | --- |
Особые условия использования
Протокол SMTP является встроенным параметром для действия., поэтому он исключен из пользовательских параметров действия.
Замечания
В перспективе можно добавить:
- к параметру "Защита соединения" протокол безопасности STARTTLS
- новый параметр действия - "Метод аутентификации" с значениями:
- автоопределение
- без аутентификации
- обычный пароль
- зашифрованный пароль
- Kerberos/GSSAPI
- NTLM
- OAuth2
Получить сообщение / Get message
Описание
Действие загружает из почтового ящика письма, которые соответствуют указанным фильтрам, и сохраняет их в переменную типа Table.
| Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|---|
| Параметры | ||||||
| Контекст | Context | Контекст действия для работы с почтовым сервером ( eIMAP или ePOP3), возвращаемый действием OpenEmail. | Robin.Email.ReceiveContext | --- | Да | |
| Непрочитанные | Unread only | Выбрать только непрочитанные письма. | Robin.Boolean | true | Нет | |
| Количество | Count | Количество писем, которое необходимо вычитать из почтового ящика по указанным фильтрам. | Robin.Numeric | 1 | Нет | |
| От | From | Выбираются письма, у которых почтовый адрес отправителя письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте ";" или "," | Robin.String | example@yandex.ru | Нет | |
| Кому | To | Выбираются письма, у которых почтовый адрес получателя письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте ";" или "," | Robin.String | example@yandex.ru | Нет | |
| Копия | CC | Выбираются письма, у которых копия письма соответствует указанному регулярному выражению. Чтобы указать более одного элемента, используйте ";" или "," | Robin.String | example@yandex.ru | Нет | |
| Тема | Subject | Выбираются письма, у которых тема письма соответствует указанному регулярному выражению. | Robin.String | Отчет | Нет | |
| Тело письма | Body | Выбираются письма, у которых текст письма соответствует указанному регулярному выражению. | Robin.String | Внимание! | Нет | |
| Включить html текст | Include html text | Включить в тело письма полную информацию о стилях. Иначе будет получен просто текст. По умолчанию false. | Robin.Boolean | true | Нет | |
| Название вложения | Attachment name | Выбираются письма, у которых названия вложений соответствуют указанному регулярному выражению. | Robin.String | Отчет | Нет | |
| Папка для сохранения вложений | Folder For Attachment | Путь до папки, в которой будут созданы подпапки для сохранения вложений из писем. Для каждого вычитанного письма с вложением в указанной папке создается подпапка. Все вложения из письма сохраняются в данную подпапку. Имя подпапки формируется по следующему правилу: <ДДММГГГГ-ЧЧММСС>_<Тема письма>, где ДДММГГГГ-ЧЧММСС - дата и время получения письма. Имя подпапки обрезается до 255 символов. Специальные символы \ / : * ? " < > | в названии заменяются на пробелы. | Robin.FilePath | D:\Вложение1.jpg | Нет | |
| Результаты | ||||||
| Таблица результатов | Results table | Таблица, в которую сохраняется информация из писем, отобранных по выбранным фильтрам. Таблица имеет следующий набор столбцов:
| Robin.Table | |||
Особые условия использования
Протокол POP3 не поддерживает считывание только прочитанных или не прочитанных писем. Для чтения только непрочитанных писем рекомендуется использовать протокол IMAP.
Отправить сообщение / Send message
Описание
Действие создает сообщение и отправляет сообщение на сервер.
| Имя параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|---|
| Параметры | ||||||
| Контекст | Context | Контекст действия для работы с почтовым сервером ( eSMTP), возвращаемый действием OpenEmail. | Robin.Email.SendContext | --- | Да | |
| От | From | Адрес почты отправителя сообщения. | Robin.String | example@yandex.ru | Да | |
| Кому | To | Список адресов получателей письма. В качестве разделителя используйте ";" | Robin.String | example@yandex.ru | Да | |
| Копия | CC | Список адресов получателей копии письма. В качестве разделителя используйте ";" | Robin.String | example@yandex.ru | Нет | |
| Тема | Subject | Тема письма. | Robin.String | Отчет | Нет | |
| Тело письма | Body | Тело письма. | Robin.String | Добрый день! | Нет | |
| Вложения | Attachments | Путь к файлу, который необходимо прикрепить. Если необходимо прикрепить несколько вложений, пути к файлам указываются через ";" | Robin.String | D:\Вложение1.jpg;D:\Вложение2.jpg | Нет | |
Ответить / Reply
Описание
Действие получает в виде входного параметра таблицу сообщений, выбирает сообщение с указанным Message ID, формирует сообщения получателям с ответом и отправляет сообщения.
| параметра\результата (eng) | Свойство (title) | Англ. наименование (title) | Описание (description) | Тип | Пример заполнения | Обязательность заполнения поля | Значение по умолчанию |
|---|---|---|---|---|---|---|---|
| Параметры | |||||||
| Контекст | Context | Контекст действия для работы с почтовым eSMTP-сервером, возвращаемый действием OpenEmail. | Robin.Email.SendContext | --- | Да | ||
| Таблица с письмами | Messages Table | Таблица, в которой есть письмо, на которое нужно ответить | Robin.Table | Да | |||
| ID сообщения | Message ID | Идентификатор письма, на которое необходимо ответить. | Robin.String | Да | |||
| Ответить всем | Reply to all | Логическая переменная. Если переменная равна True, то ответ будет направлен всем получателям, включая CC, письма с Message ID, указанным в параметре ID сообщения. Если переменная равна False, то ответ будет направлен только отправителю письма. | Robin.Boolean | True | False | Нет | False | |
| Цитировать | Cite | Логическая переменная. Если переменная равна True, то в тело ответа будет включен текст письма с Message ID, указанным в параметре ID сообщения. Если переменная равна False, то в тело ответа не будет включен текст письма с Message ID, указанным в параметре ID сообщения. | Robin.Boolean | True | False | Нет | False | |
| Тело | Body | Текст, который нужно добавить в тело письма. | Robin.String | Отвечаю вам. | Нет | ||
| Вложения | Attachments | Путь к файлу, который необходимо прикрепить к письму. Чтобы указать более одного элемента, используйте ';' знак. | Robin.String | D:\Вложение1.jpg;D:\Вложение2.jpg | Нет | ||
Комментарий для разработчика
Порядок работы действия:
- Действие из таблицы, указанной в параметре "Таблица с письмами", по Message ID извлекает сообщение, на которое нужно ответить.
- Из сообщения извлекаются параметры сообщения:
- От_получ,
- Кому_получ,
- Копия_получ,
- Тема_получ,
- Тело_получ.
- Формируются параметры нового сообщения, которое будет отправлено, в следующем порядке:
- Кому:
- Если значение параметра "Ответить всем" равно True, то в поле сообщения "Кому" вставляются все адресаты из поля "Кому_получ" + адрес отправителя "От_получ", а в поле "Копия" вставляются адресаты из поля "Копия_получ".
- Если значение параметра "Ответить всем" равно False, то в поле сообщения "Кому" вставляется только адрес отправителя "От_получ", а поле "Копия" остается пустым.
- Тема:
- Поле "Тема" получается путем добавления префикса "Re: " к теме сообщения, на которое следует ответить, - "Тема_получ"
- Тело:
- Если значение параметра "Цитировать" равно True, то в тело ответа следует включать текст со значением параметра "Тело" и текст письма с Message ID, указанным в параметре ID сообщения. Цитируемый текст должен быть выделен вертикальной линией слева.
- Если значение параметра "Цитировать" равно False, то в тело ответа следует включать только текст со значением параметра "Тело".
- Вложения:
- К ответу должны быть прикреплены все файлы, указанные в параметре действия "Вложения".
- Кому:
Обзор
Инструменты контента