Email Receive端口

Email Receive 端口支援從 IMAP 郵件伺服器檢索郵件。

核心功能

基於 IMAP 的郵件輪詢，支援現代服務商的 OAuth 2.0 認證
具備符合 IMAP RFC 標準的搜尋過濾器，實現進階過濾
支援僅下載附件或下載完整郵件
可配置的郵件保留與刪除策略

概覽

Email Receive 端口提供了一種自動化接收電子郵件的簡單方法。端口連線到指定的 IMAP 伺服器，並輪詢指定的郵箱以處理新訊息。預設情況下，該端口僅接收尚未處理的訊息，並支援其他 IMAP 過濾條件。端口支援接收 EML 格式的完整訊息，或僅下載正在處理的電子郵件附件。

Outlook 和 Gmail 郵件伺服器的 OAuth 2.0 配置是 Email Receive 端口中最常見的兩種連線配置。

端口配置

本節包含所有可配置的端口屬性。

設定

郵件接收配置

與建立連線相關的設定。

設定	描述
端口 Id	端口的靜態、唯一識別碼。
端口型別	顯示端口型別及其用途的描述。
端口描述	一個可選欄位，用於提供端口及其在流中的角色的自由格式描述。

建立連線

要允許知行之橋接收電子郵件，必須先建立 Email Receive 連線。建立後，該連線可以在多個 Email Receive 端口之間共享。建立此連線有以下幾種方式：

在流程中新增一個 Email Receive 端口。然後使用 Connection 下拉功能表選擇現有連線，或點選 Create 新增新連線。
開啟知行之橋 系統設定 頁面，然後開啟 Connections 索引標籤。點選 Add，選擇 Email Receive，然後點選 Next。
如果透過此方式建立連線，仍需在端口的 Connection 下拉功能表中選擇該連線。

完成以下屬性配置：

設定	描述
Host	IMAP 伺服器的主機名或 IP 地址。
Port	連線到 IMAP 伺服器的端口。典型值包括 143 和 993。
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 加入白名單，因此在服務中配置應用程式註冊時應使用此值。

建立與 IMAP 伺服器的網路級連線需要以下設定：

Host
Port
TLS Type

建立網路級連線後，需要以下設定才能存取 IMAP 伺服器上儲存的訊息：

User
Password 或 OAuth 2.0 身分驗證憑據
Mailbox

使用 Add and Test 按鈕驗證端口是否可以連線到伺服器。

下載

與處理訊息相關的設定。

設定	描述
Mailbox	用於輪詢訊息的 IMAP 郵箱。
Only process 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	勾選此項以從郵箱中刪除成功下載的訊息。
Move to Folder	成功下載訊息後將其移動到的郵箱資料夾。如果指定的資料夾不存在，系統會自動建立。如果設定此項，Delete Emails 將不起作用。資料夾路徑中可以使用宏。
Expunge After Delete	勾選此項以從郵箱中永久刪除成功下載的電子郵件。警告：伺服器可能會立即永久刪除（清除）訊息，使其無法恢復。

進階頁面

進階設定

前面類別中未包含的設定。

設定	描述
IMAP Headers	IMAP 訊息頭中以逗號分隔的清單，這些訊息頭應提升為下載檔案中的中繼資料。
Incoming Server Public Certificate	用於驗證 TLS/SSL 伺服器身份的公開金鑰憑證。如果目標伺服器使用 TLS/SSL，請將此欄位設定為標識伺服器的憑證。如果伺服器憑證不可用，可以將此設定留空以允許底層 OS/JVM 執行憑證驗證，或將其設定為 `Any Certificate` 以隱式信任伺服器身份。
Command Timeout (seconds)	命令執行逾時時間，以秒為單位。
TLS Enabled Protocols	建立出站連線時支援的 TLS/SSL 協議清單。最佳做法是僅使用 TLS 協議。SSL v2 和 SSL v3 被認為存在漏洞，只有在合作伙伴不支援更高版本時才應使用。請注意，TLS v1.3 尚未被普遍採用，如果目標伺服器不支援它，可能會被拒絕。
本地檔案方案	用於為端口輸出的訊息分配檔名的方案。可以在檔名中動態使用宏，以包含識別碼和時間戳等資訊。有關更多資訊，請參閱宏。

代理配置

這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下，本節使用安全設定頁面的代理設定部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。

設定	描述
代理型別	基於代理的防火牆使用的協議。
代理主機	基於代理的防火牆的名稱或 IP 地址。
代理端口	基於代理的防火牆的 TCP 端口。
代理使用者	用於透過基於代理的防火牆進行身分驗證的使用者名稱。
代理密碼	用於對基於代理的防火牆進行身分驗證的密碼。
身分驗證方案	保留預設值 None 或選擇以下身分驗證方案之一：Basic、Digest、Proprietary 或 NTLM。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。

設定	描述
儲存到已傳送資料夾（已棄用）	將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案（已棄用）	按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定	描述
日誌級別	指定要記錄在端口日誌目錄中的資訊型別： None - 不建立任何日誌。 Error - 僅當端口遇到錯誤時才建立日誌。 Warning - 僅當端口發出警告時才建立日誌。 Info - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。 Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。 Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。請注意：Debug 和 Trace 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構	指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本	指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。

其他設定

特殊設定適用於特定用例。

設定	描述
其他設定	允許在以分號分隔的清單中配置隱藏的端口設定，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用這些設定。

自動化

自動化設定

與端口自動處理檔案相關的設定。

設定	描述
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

交易

此索引標籤列出與該端口關聯的所有訊息。使用搜尋欄查詢特定訊息，或點選漏斗圖示應用過濾器。可以按跟蹤訊息頭、時間和/或狀態進行過濾。

接收郵件

如果啟用了 Receive Automation，Email Receive 端口會自動輪詢配置的 IMAP 郵箱以下載訊息。預設情況下，端口只接收尚未下載的訊息。端口第一次接收訊息時，請使用下載配置部分中的 Days to Search 設定來指定要下載的訊息範圍。也可以點選端口 Transactions 索引標籤上的 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

操作指南

腳本編寫

軟體許可和第三方版權

核心功能

概覽

端口配置

設定

郵件接收配置

建立連線

下載

進階頁面

進階設定

代理配置

訊息

日誌

其他設定

自動化

自動化設定

自動化狀態

警示

SLA

交易

接收郵件

搜尋過濾器

宏

範例

​核心功能

​概覽

​端口配置

​設定

​郵件接收配置

​建立連線

​下載

​進階頁面

​進階設定

​代理配置

​訊息

​日誌

​其他設定

​自動化

​自動化設定

​自動化狀態

​警示

​SLA

​交易

​接收郵件

​搜尋過濾器

​宏

​範例

核心功能

概覽

端口配置

設定

郵件接收配置

建立連線

下載

進階頁面

進階設定

代理配置

訊息

日誌

其他設定

自動化

自動化設定

自動化狀態

警示

SLA

交易

接收郵件

搜尋過濾器

宏

範例