Email Send 端口

Email Send 端口透過 SMTP 郵件伺服器傳送郵件。

核心功能

基於 SMTP 的郵件投遞，支援使用者指定的伺服器或 SendGrid，並支援現代服務商的 OAuth 2.0 認證
支援範本模式，可根據 XML 資料或 ArcScript 生成動態內容
支援附件模式，可在傳送檔案的同時自定義郵件正文
支援多個收件人（To、CC 和 BCC）及動態欄位填充

概覽

Email Send 端口連線到 SMTP 伺服器（使用者指定或 SendGrid）投遞服務，將檔案作為傳出電子郵件訊息傳送。端口處理的輸入檔案可以作為電子郵件附件直接傳送，也可以從輸入檔案中解析資料，並透過指令碼範本包含在傳出訊息中。有關建立指令碼範本的更多資訊，請參閱範本模式部分。

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

端口配置

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

郵件配置

建立連線

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

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

完成以下屬性配置：

設定	描述
Email Protocol	選擇使用使用者指定的 SMTP 伺服器還是 SendGrid。如果選擇 SendGrid，則只保留 TLS Type。所有其他欄位均與 SMTP 相關。
API Key	你的 SendGrid API 金鑰。不適用於知行之橋 Cloud 實現。
Host	SMTP 伺服器的主機名或 IP 地址。
Port	連線到 SMTP 伺服器的端口。典型值包括 143 和 993。
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 加入白名單，因此在服務中配置應用程式註冊時應使用此值。
None	不需要身分驗證。
User	登入 SMTP 伺服器的使用者名稱。當 Authentication Mechanism 設定為 None 時不可見。
TLS Type	連線到伺服器時用於協商 TLS/SSL 的方法： STARTTLS：先建立明文連線，然後可以透過顯式命令啟動 TLS/SSL。 SSL/TLS：無需先建立明文連線，立即進行協商。 None (Plain Text)：建立明文連線，不使用 TLS/SSL。 Automatic：根據端口號檢測並應用合適的 TLS/SSL 協商方法。標準郵件端口（25、587）使用 STARTTLS，端口 465 使用 TLS/SSL。

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

Host
Port
TLS Type

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

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

SendGrid 唯一需要的設定是 TLS Type。使用 Add and Test 按鈕驗證端口是否可以連線到伺服器。

其他配置

與傳出電子郵件訊息相關的設定。大多數欄位可以包含來自傳出檔案的動態資料（有關更多資訊，請參閱動態欄位）。

設定	描述
Message Type	指定處理訊息的方法： Attachment：將到達端口的檔案作為附件傳送。有關更多資訊和範例，請參閱附件模式。 Template：將訊息正文解釋為從輸入檔案讀取值的 ArcScript 範本。有關建立指令碼範本的更多資訊，請參閱範本模式。
To	傳出電子郵件訊息收件人的電子郵件地址。使用逗號分隔的清單傳送給多個收件人。
Show From	展開一個欄位，用於輸入傳出電子郵件訊息發件人的電子郵件地址。端口會嘗試根據傳遞給 SMTP 伺服器的 User 憑據自動確定此欄位的值。
Show Cc / Show Bcc	展開欄位，用於輸入要抄送（CC）或密件抄送（BCC）的電子郵件地址。使用逗號分隔的清單傳送給多個收件人。
Subject	傳出電子郵件訊息的主題行。
Message Body	電子郵件正文。
Allow ArcScript in Email Body	當 Message Type 為 Attachment 時，勾選此項以允許在訊息正文中計算 ArcScript。

還可以點選 ArcScript 編輯器按鈕，在 To、From、CC、BCC 和 Subject 欄位中使用 ArcScript。

設定

郵件傳送配置

與端口名稱和描述相關的設定。

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

進階頁面

進階設定

與處理相關的額外設定。

設定	描述
Attachment Filter	在傳送訊息之前應用的 glob 模式過濾器。模式可以是正向或負向的。例如，`.edi` 僅傳送副檔名為 `.edi` 的檔案，`-.tmp` 排除副檔名為 `.tmp` 的檔案。可以提供逗號分隔的過濾器清單。除非使用精確匹配，否則後面的過濾器優先順序更高。
Outgoing Server Public Certificate	用於驗證 TLS/SSL 伺服器身份的公開金鑰憑證。如果目標伺服器使用 TLS/SSL，請將此欄位設定為標識伺服器的憑證。如果伺服器憑證不可用，可以將此設定留空以允許底層 OS/JVM 執行憑證驗證，或將其設定為 `Any Certificate` 以隱式信任伺服器身份。
Extension Map	逗號分隔的名稱-值對清單，用於確定附件的 Content-Type 訊息頭值。例如，.txt=text/plain、.dat=application/edi-x12、.edi=application/edifact 注意：在輸入訊息中包含 Content-Type 訊息頭會覆蓋此設定確定的內容類型。
處理延遲	放置在交易索引標籤中的檔案在處理前延遲的時間（以秒為單位）。這是舊版設定。最佳做法是使用 File 端口來管理本地檔案系統，而不是使用此設定。

代理配置

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

設定	描述
代理型別	基於代理的防火牆使用的協議。
代理主機	基於代理的防火牆的名稱或 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`。正常的端口用例和功能不需要使用這些設定。

自動化

自動化設定

設定	描述
傳送	指示端口在檔案準備就緒時自動傳送檔案的開關。
Retry Interval	端口在重試失敗傳送之前等待的間隔。
Max Attempts	端口嘗試傳送訊息的次數。將此值設定為 1 會指示端口僅進行初始傳送嘗試而不重試。每次嘗試之間，端口會等待 Retry Interval 指定的時長。

效能

與端口資源分配相關的設定。

設定	描述
最大工作執行緒數	此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋進階設定頁面的效能設定部分的預設設定。
最大檔案數	分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋進階設定頁面的效能設定部分的預設設定。

警示

SLA

交易

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

傳送郵件

郵件配置索引標籤決定要傳送的電子郵件訊息：

如果 Message Type 設定為 Attachment，端口處理的檔案將作為電子郵件附件傳送，並且應在訊息文字編輯器中指定訊息正文。有關更多資訊，請參閱附件模式。
如果 Message Type 設定為 Template，訊息文字編輯器將被視為 ArcScript 範本。在指令碼範本中，可以從端口處理的檔案中解析值，並將其包含在電子郵件正文中。有關更多資訊，請參閱範本模式。

要在一封電子郵件中傳送多個附件，需要構建一個包含所有要包含附件的批次處理組，然後將該批次處理組傳送到 Email Send 端口進行處理。

動態欄位

To、From、CC、BCC 和 Subject 欄位支援來自傳出檔案的動態資訊（例如檔名和已處理該檔案的端口）。檔案資訊可透過 _message 項獲得。_message 項具有一組帶有 header: 字首的屬性，對應於傳出檔案中可用的每個訊息頭。這些訊息頭包括檔名、與在知行之橋流程中處理檔案相關的任何中繼資料，以及透過指令碼提升到檔案的任何自定義訊息頭。與任何其他 ArcScript 項一樣，_message 項和訊息頭屬性在方括號中引用： [_message.header:headerName] 例如，可以將 Subject 設定為以下值，以包含傳出檔案的檔名： [_message.header:filename]

範本模式

將 Message Type 設定為 Template 會指示端口將訊息正文解釋為 ArcScript 範本。範本使用簡單的語法與輸入檔案互動，並檢索要在電子郵件正文中使用的值。這些值可以與靜態文字組合，生成根據端口處理的檔案動態填充的標準正文格式。要使用 Template 模式，端口必須接收 XML 檔案作為輸入。範本只能解析 XML 檔案中的資訊。

基本範本

有關範本訊息的範例，請考慮以下輸入 XML 文件：

<Lead>
  <Company>ABC, Inc.</Company>
  <Email>john@abcinc.com</Email>
  <FirstName>John</FirstName>
  <Description>Blue Widget</Description>
</Lead>

此檔案在 Lead 標籤內包含一組屬性：Company、Email、FirstName、Description。將 Email 欄位傳入訊息的 ArcScript 運算式如下所示： [document.lead_email] 此運算式包含三個元件：

document 項，指向當前開啟的檔案。
lead_email 屬性，指向 john@abcinc.com。
方括號（[]），表示使用格式化器而不是文字字元。

上述 XML 輸入檔案的電子郵件正文範本可能如下所示：

Hi [document.lead_firstname],
<br>
We saw that you might be interested in the following product:
<br>
[document.lead_description]
<br>
Would you like to set up a demo to learn more about how we can help you with your work at [document.lead_company]?

此訊息將生成以下電子郵件：

Hi John,

We saw that you might be interested in the following product:

Blue Widget

Would you like to set up a demo to learn more about how we can help you with your work at ABC, Inc.?

有關 ArcScript 的更多資訊，請參閱指令碼部分。

XPath 格式化

XPath 格式化器（在運算式中寫為 xpath）提供了從檔案中檢索動態值的替代方法。對於已經在知行之橋其他位置使用 ArcScript 的使用者來說，這種方法可能更熟悉。XPath 要求輸入檔案是 XML 檔案。使用與上面相同的輸入檔案範例：

<Lead>
  <Company>ABC, Inc.</Company>
  <Email>john@abcinc.com</Email>
  <FirstName>John</FirstName>
  <Description>Blue Widget</Description>
</Lead>

傳回電子郵件地址的 XPath 運算式如下： [xpath(/Lead/Email)] 此運算式包含三個元件：

xpath 後跟括號，表示該運算式為 XPath 運算式。
資料路徑，每個級別用斜槓分隔。
方括號（[]），表示使用格式化器而不是文字字元。

在範本模式下使用 XPath 格式化器

考慮以下 XML：

<Items>
    <projectName>myProject</projectName>
    <assignee>Bob Ross</assignee>
    <dueDate>02/27/2024</dueDate>
    <resources>
        <description>http://mydomain.com/desc</description>
        <images>http://mydomain.com/images</images>
        <colors>http://mydomain.com/colors</colors>
    </resources>
</Items>

對上面的 XML 輸入檔案使用 xpath 運算式的電子郵件正文範本可能如下所示：

Hi [xpath(/Items/assignee)],
<br>
You have a new project to start working on. The name of the project is [xpath(/Items/projectName)].
<br>
All the resources you need can be found at the following links:
<br>
<ul>
  <li>Description: [xpath(/Items/resources/description)]</li>
  <li>Images: [xpath(/Items/resources/images)]</li>
  <li>Colors: [xpath(/Items/resources/colors)]</li>
</ul>
<br>
The due date for this project is [xpath(/Items/dueDate)].

此訊息將生成以下電子郵件：

Hi Bob Ross,

You have a new project to start working on. The name of the project is myProject.

All the resources you need can be found at the following links:

  - Description: http://mydomain.com/desc
  - Images: http://mydomain.com/images
  - Colors: http://mydomain.com/colors

The due date for this project is 02/27/2024.

程式碼檢視編輯器

程式碼檢視編輯器支援建立自定義 ArcScript，以對來自 XML 檔案的資訊進行進階處理。要開啟程式碼檢視編輯器，請點選訊息編輯器中的 Code View 按鈕。

在此模式下，ArcScript 運算式可用於一次處理多個資料項目。以下輸入檔案範例包含名稱清單：

<record>
  <to>Dave</to>
  <items>
    <item>
      <first_name>James</first_name>
      <last_name>Satchel</last_name>
    </item>
    <item>
      <first_name>John</first_name>
      <last_name>Smith</last_name>
    </item>
    <item>
      <first_name>Gina</first_name>
      <last_name>Newberry</last_name>
    </item>
  </items>
</record>

在程式碼檢視編輯器中編寫的以下訊息使用 ArcScript 合併了來自該輸入檔案的資料：

Hi [document.record_to],
<br>
Here are the people you were asking about:
<br>
<arc:set attr="xml.xpath" value="/record/items/item" />
<arc:call op="xmlDOMSearch" in="xml">
  <arc:set attr="first.names" value="[xpath(first_name)]" />
  <arc:set attr="last.names" value="[xpath(last_name)]" />
  <arc:enum attr="first.names">
    [_value]
  </arc:enum>
  <arc:enum attr="last.names">
    [_value]
  </arc:enum>
  <br>
</arc:call>

此程式碼會迴圈輸入 XML 檔案中的所有名字和姓氏值，並將它們列印在訊息正文中。使用上面的輸入檔案執行時，最終電子郵件如下所示：

Hi Dave,

Here are the people you were asking about:

James Satchel
John Smith
Gina Newberry

有關 ArcScript 和自定義運算式的更多資訊，請參閱指令碼部分。

附件模式

如果將 Message Type 設定為 Attachment，請在編輯器中輸入電子郵件正文。如有必要，可以引用輸入訊息上的訊息頭來豐富電子郵件正文。然後，Email Send 端口會計算這些訊息頭，並將輸入檔案附加到傳出電子郵件。

這依賴於流程中的前一步將必要的值作為訊息頭提升到訊息上。根據檔案內容，可以使用各種操作和端口設定來執行此操作。

考慮以下 XML：

<Items>
    <projectName>myProject</projectName>
    <assignee>Bob Ross</assignee>
    <dueDate>02/27/2024</dueDate>
    <resources>
        <description>http://mydomain.com/desc</description>
        <images>http://mydomain.com/images</images>
        <colors>http://mydomain.com/colors</colors>
    </resources>
</Items>

電子郵件正文可能如下所示：

Hi [_message.header:assignee],
<br>
You have a new project to start working on. The name of the project is [_message.header:projectname].
<br>
All the resources you need can be found at the following links:
<br>
<ul>
  <li>Description: [_message.header:description]</li>
  <li>Images: [_message.header:images]</li>
  <li>Colors: [_message.header:colors]</li>
</ul>
<br>
The due date for this project is [_message.header:duedate].

此訊息將生成以下電子郵件，幷包含輸入檔案作為附件：

Hi Bob Ross,

You have a new project to start working on. The name of the project is myProject.

All the resources you need can be found at the following links:

  - Description: http://mydomain.com/desc
  - Images: http://mydomain.com/images
  - Colors: http://mydomain.com/colors

The due date for this project is 02/27/2024.

入門指南

工作流

EDI 交易夥伴管理控制台

端口

對映

系統 API

操作指南

腳本編寫

軟體許可和第三方版權

核心功能

概覽

端口配置

郵件配置

建立連線

其他配置

設定

郵件傳送配置

進階頁面

進階設定

代理配置

訊息

日誌

其他設定

自動化

自動化設定

效能

警示

SLA

交易

傳送郵件

動態欄位

範本模式

基本範本

XPath 格式化

在範本模式下使用 XPath 格式化器

程式碼檢視編輯器

附件模式

​核心功能

​概覽

​端口配置

​郵件配置

​建立連線

​其他配置

​設定

​郵件傳送配置

​進階頁面

​進階設定

​代理配置

​訊息

​日誌

​其他設定

​自動化

​自動化設定

​效能

​警示

​SLA

​交易

​傳送郵件

​動態欄位

​範本模式

​基本範本

​XPath 格式化

在範本模式下使用 XPath 格式化器

​程式碼檢視編輯器

​附件模式

核心功能

概覽

端口配置

郵件配置

建立連線

其他配置

設定

郵件傳送配置

進階頁面

進階設定

代理配置

訊息

日誌

其他設定

自動化

自動化設定

效能

警示

SLA

交易

傳送郵件

動態欄位

範本模式

基本範本

XPath 格式化

程式碼檢視編輯器

附件模式