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 交易夥伴管理控制台

端口

對映

系統 API

操作指南

腳本編寫

軟體許可和第三方版權

Email Receive 端口（已棄用）

核心功能

概覽

端口配置

設定

郵件接收配置

IMAP 連線

認證

下載

自動化

自動化設定

警示

SLA

高階頁面

代理配置

進階設定

訊息

日誌

其他設定

建立連線

接收郵件

搜尋過濾器

宏

範例

​核心功能

​概覽

​端口配置

​設定

​郵件接收配置

​IMAP 連線

​認證

​下載

​自動化

​自動化設定

​警示

​SLA

​高階頁面

​代理配置

​進階設定

​訊息

​日誌

​其他設定

​建立連線

​接收郵件

​搜尋過濾器

​宏

​範例

核心功能

概覽

端口配置

設定

郵件接收配置

IMAP 連線

認證

下載

自動化

自動化設定

警示

SLA

高階頁面

代理配置

進階設定

訊息

日誌

其他設定

建立連線

接收郵件

搜尋過濾器

宏

範例