Email Send 端口（已棄用）

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

核心功能

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

概覽

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

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

端口配置

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

設定

郵件傳送配置

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

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

連線

與連線到 SMTP 伺服器相關的設定。

設定	描述
Host	SMTP 伺服器的主機名或 IP 地址。
Port	連線到 SMTP 伺服器的端口。
User	登入 SMTP 伺服器的使用者名稱。
Authentication Mechanism	用於登入伺服器的身分驗證型別。可用選項會根據你的選擇而變化。
Password	（Basic 和 NTLM）SMTP 伺服器的密碼。
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	不需要身分驗證。
TLS Type	連線到伺服器時用於協商 SSL/TLS 的方法：STARTTLS：先建立明文連線，然後可以透過顯式命令啟動 SSL/TLS。SSL/TLS：無需先建立明文連線，立即進行協商。None (Plain Text)：建立明文連線，不使用 SSL/TLS。Automatic：端口根據配置的端口號確定 TLS 型別。

訊息

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

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

自動化

自動化設定

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

效能

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

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

警示

SLA

進階頁面

代理配置

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

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

進階設定

與處理相關的額外設定。

設定	描述
Allow ArcScript in Attachment mode	當 Message Type 為 Attachment 時，勾選此項以允許在訊息正文中計算 ArcScript。
Excluded Extensions	不應由端口處理的副檔名清單，以逗號分隔。
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 端口來管理本地檔案系統，而不是使用此設定。

訊息

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

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

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

日誌

與日誌建立和儲存相關的設定。

設定	描述
Log Level	端口生成日誌的詳細程度。請求支援時，請將其設定為 Debug。
Log Subfolder Scheme	指示端口按所選時間間隔對 Logs 資料夾中的檔案進行分組。Weekly 選項（預設值）會指示端口每週建立一個新子資料夾，並將當週所有日誌儲存在該資料夾中。將此設定留空表示端口將所有日誌直接儲存到 Logs 資料夾。對於處理大量交易的端口，使用子資料夾有助於保持日誌井然有序並提升效能。
Log Messages	勾選此項可使已處理檔案的日誌項目包含檔案本身的副本。如果停用此選項，可能無法從 Input 或 Output 索引標籤下載檔案副本。

其他設定

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

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

建立連線

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

Host
Port
TLS Type

點選 Test Connection 按鈕驗證端口是否可以連線到伺服器。建立網路級連線後，需要以下設定才能登入伺服器並開始傳送電子郵件：

User
Password

傳送郵件

端口 系統設定 頁面上的訊息部分決定要傳送的電子郵件訊息：

如果 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.?

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

附件模式

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

This relies on a previous step in the flow to promote the necessary values as headers onto the message. Depending on the content of the file, you can do this with various Operations and connector settings.

考慮以下 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

操作指南

腳本編寫

軟體許可和第三方版權

Email Send 端口（已棄用）

核心功能

概覽

端口配置

設定

郵件傳送配置

連線

訊息

自動化

自動化設定

效能

警示

SLA

進階頁面

代理配置

進階設定

訊息

日誌

其他設定

建立連線

傳送郵件

動態欄位

範本模式

基本範本

XPath 格式化

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

程式碼檢視編輯器

附件模式

​核心功能

​概覽

​端口配置

​設定

​郵件傳送配置

​連線

​訊息

​自動化

​自動化設定

​效能

​警示

​SLA

​進階頁面

​代理配置

​進階設定

​訊息

​日誌

​其他設定

​建立連線

​傳送郵件

​動態欄位

​範本模式

​基本範本

​XPath 格式化

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

​程式碼檢視編輯器

​附件模式

核心功能

概覽

端口配置

設定

郵件傳送配置

連線

訊息

自動化

自動化設定

效能

警示

SLA

進階頁面

代理配置

進階設定

訊息

日誌

其他設定

建立連線

傳送郵件

動態欄位

範本模式

基本範本

XPath 格式化

程式碼檢視編輯器

附件模式