Email Receive 端口（已弃用）

Email Receive 端口支持从 IMAP 邮件服务器检索邮件。

核心功能

基于 IMAP 的邮件轮询，支持现代服务商的 OAuth 2.0 认证
具备符合 IMAP RFC 标准的搜索过滤器，实现高级过滤
支持仅下载附件或下载完整邮件
可配置的邮件保留与删除策略

概览

Email Receive 端口提供了一种自动化接收电子邮件的简单方法。端口连接到指定的 IMAP 服务器，并轮询指定的邮箱以处理新消息。默认情况下，该端口仅接收尚未处理的消息，并支持其他 IMAP 过滤条件。端口支持接收 EML 格式的完整消息，或仅下载正在处理的电子邮件附件。

Outlook 和 Gmail 邮件服务器的 OAuth 2.0 配置是 Email Receive 端口中最常见的两种连接配置。

端口配置

本节包含所有可配置的端口属性。

设置

邮件接收配置

与建立连接相关的设置。

IMAP 连接

与建立到 IMAP 服务器的连接相关的设置。

设置	描述
Host	IMAP 服务器的主机名或 IP 地址。
Port	连接到 IMAP 服务器的端口。典型值包括 143 和 993。
Mailbox	用于轮询消息的 IMAP 邮箱。
TLS Type	连接到服务器时用于协商 SSL/TLS 的方法：STARTTLS：先建立明文连接，然后可以通过显式命令启动 SSL/TLS。SSL/TLS：无需先建立明文连接，立即进行协商。None (Plain Text)：建立明文连接，不使用 SSL/TLS。

认证

与连接身份验证相关的设置。

设置	描述
User	登录 IMAP 服务器的用户名。
Authentication Mechanism	用于登录服务器的身份验证类型。可用选项会根据你的选择而变化。
Password	（Basic 和 NTLM）IMAP 服务器的密码。
Auth URL	（OAuth 2.0）服务的授权 URL。点击 Connect 按钮登录并授予应用程序权限时，会定向到此 URL。
Access Token URL	（OAuth 2.0）访问令牌的 URL。
Client Id	（OAuth 2.0）注册 OAuth 时分配的客户端 Id。
Client Secret	（OAuth 2.0）注册 OAuth 时分配的密钥。
Scope	（OAuth 2.0）应用程序应有权访问的作用域列表。
Callback URL	（OAuth 2.0）所连接服务返回令牌以提供访问权限的 URL。服务通常要求你将允许的 URL 加入白名单，因此在服务中配置应用程序注册时应使用此值。

下载

与处理消息相关的设置。

设置	描述
New Messages	勾选此项以仅处理新消息。这通常通过跟踪已下载消息的 UID 来控制。如果 UID 值变为无效，端口会回退到使用上次处理消息的时间戳，或在尚未处理任何消息时使用 Days to Search 设置。
Days to Search	搜索消息的天数。如果勾选 Only process new messages，则仅当端口无法按 UID 或上次处理消息的时间戳搜索时，才会使用此值。
Additional Search Filters	提供符合 IMAP RFC 的搜索过滤器，以附加到基于 New Messages 和 Days to Search 设置自动构建的查询。
Download Type	选择下载 EML 格式的完整邮件消息或仅下载电子邮件附件。
Delete Emails	勾选此项以从邮箱中删除成功下载的消息。
Expunge After Delete	勾选此项以从邮箱中永久删除成功下载的电子邮件。警告：服务器可能会立即永久删除（清除）消息，使其无法恢复。

自动化

自动化设置

与端口自动处理文件相关的设置。

设置	描述
Receive	端口是否应自动轮询远程邮箱以下载消息。
Receive Interval	自动下载尝试之间的间隔。
Minutes Past the Hour	小时计划的分钟偏移量。仅当上面的间隔设置为 Hourly 时适用。例如，如果此值设置为 5，自动化服务会在 1:05、2:05、3:05 等时间下载。
Time	应执行尝试的当天时间。仅当上面的间隔设置为 Daily、Weekly 或 Monthly 时适用。
Day	应执行尝试的日期。仅当上面的间隔设置为 Weekly 或 Monthly 时适用。
Minutes	尝试下载前等待的分钟数。仅当上面的间隔设置为 Minute 时适用。
Cron Expression	表示 cron 表达式的五段字符串，用于确定何时执行尝试。仅当上面的间隔设置为 Advanced 时适用。

警报

SLA

高级页面

代理配置

高级设置

前面类别中未包含的设置。

设置	描述
IMAP Headers	IMAP 消息头中以逗号分隔的列表，这些消息头应提升为下载文件中的元数据。
Incoming Server Public Certificate	用于验证 TLS/SSL 服务器身份的公钥证书。如果目标服务器使用 TLS/SSL，请将此字段设置为标识服务器的证书。如果服务器证书不可用，可以将此设置留空以允许底层 OS/JVM 执行证书验证，或将其设置为 `Any Certificate` 以隐式信任服务器身份。
Command Timeout (seconds)	命令执行超时时间，以秒为单位。
本地文件方案	用于为端口输出的消息分配文件名的方案。可以在文件名中动态使用宏，以包含标识符和时间戳等信息。有关更多信息，请参阅宏。

消息

日志

设置	描述
Log Level	端口生成日志的详细程度。请求支持时，请将其设置为 Debug。
Log Subfolder Scheme	指示端口按所选时间间隔对 Logs 文件夹中的文件进行分组。Weekly 选项（默认值）会指示端口每周创建一个新子文件夹，并将当周所有日志存储在该文件夹中。将此设置留空表示端口将所有日志直接保存到 Logs 文件夹。对于处理大量交易的端口，使用子文件夹有助于保持日志井然有序并提升性能。
Log Messages	勾选此项可使已处理文件的日志条目包含文件本身的副本。如果禁用此选项，可能无法从 Input 或 Output 选项卡下载文件副本。

其他设置

建立连接

建立与 IMAP 服务器的网络级连接需要以下设置：

Host
Port
TLS Type

使用 Test Connection 按钮验证端口是否可以连接到服务器。建立网络级连接后，需要以下设置才能访问 IMAP 服务器上存储的消息：

User
Password 或 OAuth 2.0 身份验证凭据
Mailbox

接收邮件

如果启用了 Receive Automation，Email Receive 端口会自动轮询配置的 IMAP 邮箱以下载消息。默认情况下，端口只接收尚未下载的消息。端口第一次接收消息时，请使用下载配置部分中的 Days to Search 设置来指定要下载的消息范围。也可以点击端口 Output 选项卡上的 Receive 按钮手动检索消息。 Download Type 设置决定下载完整邮件还是仅下载邮件附件。下载的文件会放置在 Output Folder 中，或传递到流程中的下一个端口。当 Download Type 设置为 Attachments 时，端口会向每条消息添加两个消息头：

EmailReceive-Attachment-Index：每个附件的附件编号
EmailReceive-Attachment-Count：电子邮件中的附件总数

搜索过滤器

IMAP Search Filter 设置允许进一步自定义要检索的消息范围。此字段接受标准 IMAP 协议过滤器，并且仅下载与配置的过滤器匹配的消息。支持以下过滤器：

过滤器	描述
`<message set>`	消息序列号对应于指定消息序列号集的消息。
ALL	邮箱中的所有消息：这是用于 AND 组合的默认初始关键字。
ANSWERED	设置了 `\Answered` 标志的消息。
BCC `<string>`	信封结构的 BCC 字段中包含指定字符串的消息。
BEFORE `<date>`	内部日期早于指定日期的消息。
BODY `<string>`	消息正文中包含指定字符串的消息。
CC `<string>`	信封结构的 CC 字段中包含指定字符串的消息。
DELETED	设置了 `\Deleted` 标志的消息。
DRAFT	设置了 `\Draft` 标志的消息。
FLAGGED	设置了 `\Flagged` 标志的消息。
FROM `<string>`	信封结构的 FROM 字段中包含指定字符串的消息。
HEADER `<field-name> <string>`	具有指定字段名（如 [RFC-822] 中定义）的消息头，并且 [RFC-822] 字段正文中包含指定字符串的消息。
KEYWORD `<flag>`	设置了指定关键字的消息。
LARGER `<n>`	RFC822.SIZE 大于指定八位字节数的消息。
NEW	设置了 `\Recent` 标志但未设置 `\Seen` 标志的消息。此功能等同于 “(RECENT UNSEEN)“。
NOT `<search-key>`	与指定搜索键不匹配的消息。
OLD	未设置 `\Recent` 标志的消息。此功能等同于 “NOT RECENT”（与 “NOT NEW” 相对）。
ON `<date>`	内部日期在指定日期内的消息。
OR `<search-key1> <search-key2>`	与任一搜索键匹配的消息。
RECENT	设置了 `\Recent` 标志的消息。
SEEN	设置了 `\Seen` 标志的消息。
SENTBEFORE `<date>`	[RFC-822] Date: 消息头早于指定日期的消息。
SENTON `<date>`	[RFC-822] Date: 消息头在指定日期内的消息。
SENTSINCE `<date>`	[RFC-822] Date: 消息头在指定日期之内或之后的消息。
SINCE `<date>`	内部日期在指定日期之内或之后的消息。
SMALLER `<n>`	RFC822.SIZE 小于指定八位字节数的消息。
SUBJECT `<string>`	信封结构的 SUBJECT 字段中包含指定字符串的消息。
TEXT `<string>`	消息头或消息正文中包含指定字符串的消息。
TO `<string>`	信封结构的 TO 字段中包含指定字符串的消息。
UID `<message set>`	唯一标识符对应于指定唯一标识符集的消息。
UNANSWERED	未设置 `\Answered` 标志的消息。
UNDELETED	未设置 `\Deleted` 标志的消息。
UNDRAFT	未设置 `\Draft` 标志的消息。
UNFLAGGED	未设置 `\Flagged` 标志的消息。
UNKEYWORD `<flag>`	未设置指定关键字的消息。
UNSEEN	未设置 `\Seen` 标志的消息。

入门指南

工作流

EDI 交易伙伴管理控制台

端口

映射

操作指南

脚本编写

软件许可和第三方版权

Email Receive 端口（已弃用）

核心功能

概览

端口配置

设置

邮件接收配置

IMAP 连接

认证

下载

自动化

自动化设置

警报

SLA

高级页面

代理配置

高级设置

消息

日志

其他设置

建立连接

接收邮件

搜索过滤器

宏

示例

​核心功能

​概览

​端口配置

​设置

​邮件接收配置

​IMAP 连接

​认证

​下载

​自动化

​自动化设置

​警报

​SLA

​高级页面

​代理配置

​高级设置

​消息

​日志

​其他设置

​建立连接

​接收邮件

​搜索过滤器

​宏

​示例

核心功能

概览

端口配置

设置

邮件接收配置

IMAP 连接

认证

下载

自动化

自动化设置

警报

SLA

高级页面

代理配置

高级设置

消息

日志

其他设置

建立连接

接收邮件

搜索过滤器

宏

示例