> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Form 端口

> Form 端口暴露出一個公共介面，用戶端在此填寫表單並將資料提交到工作流程，具備拖拽式設計器和使用者身分驗證支援。

Form 端口暴露出一個公共介面，可以將 WebForm 的資料提交到 知行之橋 工作流程中。

## 核心功能

* 基於 Web 的表單建立，配備拖拽式設計器
* 支援分節（Section）、明細表（Detail Table）及多種欄位型別
* 為表單提交提供使用者身分驗證和存取控制
* 動態表單生成，並支援自定義品牌標識和成功提示訊息

## 概覽

表單是從 Form 端口**表單設計器**索引標籤建立的。表單分為段和明細，每個段都可以有可變數量的表單欄位。更多詳情請查閱[建立表單](#建立表單)部分。

當你使用 Form 端口提交新資料時，你應該將端口放在連線流的開頭。用戶端可以連線到 Web 介面，檢視和填寫表單，並將此資料提交到配置的 知行之橋 工作流程中。有關更多詳細資訊，請參閱[提交表單資料](#提交新的表單資料)。

以下部分說明如何配置 Form 端口、建立表單和提交新表單資料。

## 端口配置

此部分包含所有可配置的端口屬性。

### 表單設計器索引標籤

*與構建一組按部分和詳細資訊表組織的表單欄位相關的設定。*

![](https://mintcdn.com/qiao/Aa29RQkYomm0Fubg/26.4/images/Form_connector_form_designer.png?fit=max\&auto=format\&n=Aa29RQkYomm0Fubg\&q=85\&s=9ab0d96a4b9488eb956f6a69acbbbe0a)

當用戶端連線到已配置的端點並提交表單時，他們會看到與上方面板中配置完全相同的欄位佈局。

設計器包含以下設定（有關更多詳細資訊，請參閱[建立表單](#建立表單)）。

| 設定 | 描述 |
| - | - |
| **表單 URL** | 已釋出表單的連結。 |
| **表單** | 表單的標題（例如，您的公司名稱）。 |
| **新增** | 下拉功能表，用於新增部分或詳細資訊表。**新增部分** 允許向表單新增特定部分，**新增詳細資訊** 允許向表單新增詳細資訊表。詳細資訊表就像一個預配置的表，表單使用者可以根據需要為資料集新增任意數量的記錄。 |
| **表單欄位** | 將欄位拖放到表單的明細表和分割區區域中。根據需要重複此操作多次。欄位型別包括： **文字欄位** — 包含名稱和描述的輸入文字方塊。 **下拉式清單** — 包含名稱和下拉選項的下拉式清單。 **選項按鈕** — 一組包含名稱和選項按鈕選項的選項按鈕。 **核取方塊** — 一組包含名稱和核取方塊選項的核取方塊。 **檔案上傳** — 允許表單使用者將特定型別的檔案直接上傳到表單。 |
| **徽標** | 上傳公司徽標，該徽標顯示在表單頂部。預設情況下，它使用 知行之橋 徽標。還可以更改橫幅的顏色。 |
| **成功訊息** | 使用者成功提交表單資料後看到的確認訊息。可以更改預設訊息或新增其他文字。 |

### 設定頁

#### 端口配置

*與端口核心配置相關的設定。*

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

#### 進階設定

| 設定 | 描述 |
| - | - |
| **本地檔案命名規則** | 用於為端口輸出訊息分配檔名的規則。可以在檔名中使用宏動態包含識別碼和時間戳等資訊。更多資訊，請參見[宏](#宏)。 |

### 表單使用者

**表單使用者**索引標籤使你能夠為用戶端建立使用者憑據，以便他們可以存取公共介面。如果用戶端尚未登入到應用程式管理控制檯，則在瀏覽介面時會提示該用戶端輸入**使用者名稱**和**密碼**組合。

你可以在此索引標籤上新增、編輯和刪除憑據。

#### 新增使用者

新增使用者憑據：

1. 單擊**新增使用者**開啟**新增使用者**對話方塊。

2. 輸入使用者名稱和密碼。（單擊眼睛圖示可檢視密碼欄位的內容。）

3. 單擊**儲存更改**，新使用者將新增到表單使用者清單中。

#### 編輯使用者

要編輯現有使用者：

1. 單擊要編輯的使用者旁邊的省略號，然後單擊**編輯**。

2. 編輯憑據並單擊**儲存更改**。如果你決定不進行更改，請單擊**取消**退出對話方塊。

#### 刪除單個使用者

要刪除單個使用者：

1. 點選要刪除的使用者旁邊的省略號，然後點選**刪除**。

2. 點選**刪除**以刪除使用者，或點選**取消**以取消刪除請求。

#### 刪除多個使用者

要刪除多個使用者，請選中要刪除的使用者對應的核取方塊，然後點選**刪除**。確認刪除或取消刪除請求。

### 伺服器索引標籤

#### 受信任的 IP 地址

**可信 IP 地址** 部分提供以下功能：

<table><thead><tr><th>功能</th><th>描述</th></tr></thead>
<tbody><tr><td>**新增**</td><td>輸入新的 IP 地址範圍。</td></tr>
<tr><td>**編輯**</td><td>修改選定的 IP 地址範圍。</td></tr>
<tr><td>**刪除**</td><td>從清單中刪除選定的 IP 地址範圍。</td></tr></tbody></table>

以下限制適用於此功能：

<ul><li>`localhost` 不能被修改或從清單中刪除。</li>
<li>任何超出定義範圍的 IP 地址都將被拒絕。</li>
<li>支援 IP 範圍。例如，項目 `100.10.100.1-15` 表示允許 `100.10.100.1` 和 `100.10.100.15` 之間的 IP 地址。</li>
<li>支援無類別域間路由 (CIDR) 表示法。例如，項目 `100.10.100.0/24` 表示允許 `100.10.100.0` 和 `100.10.100.255` 之間的 IP 地址。</li>
<li>支援萬用字元模式。例如，項目 `100.10.100.*` 表示允許以 `100.10.100` 開頭的 IP 地址。</li></ul>

> [!NOTE]
>
> 為了讓用戶端能夠存取伺服器，需要有清晰的網路路徑。在雲環境中，可能需要在三個地方進行更改：
>
> • 雲控制檯中的網路規則。
>
> • 託管應用程式的機器上的防火牆規則。例如，在使用 Amazon AMI 時，可以使用 *簡單防火牆*（UFW）來允許所需端口上的流量。Linux 環境中的常見策略是將流量從低於 1024 的端口轉寄到高於 1024 的非標準端口，同時將應用程式配置為使用非標準端口。這可以避免與非 root 使用者繫結到低於 1024 的端口相關的權限問題。
>
> • [安全](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/security.md) 索引標籤的 [網路存取](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/network-access.md) 部分。

### 進階頁面

#### 日誌

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

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

#### 其他設定

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

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

### 告警索引標籤

*與配置通知相關的設定。*

在執行服務級別協議 (SLA) 之前，需要設定電子郵件通知以接收通知。預設情況下，知行之桥 使用 [通知](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/alerts.md) 索引標籤上的全域設定。要為此端口使用其他設定，請啟用 **覆蓋全域設定**。

預設情況下，錯誤通知處於啟用狀態，這意味著每當出現錯誤時都會傳送電子郵件。要關閉錯誤通知，請取消選中 **啟用** 核取方塊。

輸入 **主題**（必填）。勾選**允許在主題中使用 ArcScript**，即可在**主題**欄位中使用 ArcScript。選中後會顯示 **ArcScript 編輯器**按鈕（![ArcScript 編輯器按鈕](https://docs.kasoftware.com/26.4/images/rest_arcscript_editor.png)）。

（可選）輸入以逗號分隔的**收件人**電子郵件地址清單。

### SLA 索引標籤

*與配置服務級別協議 (SLA) 相關的設定。*

SLA 允許配置預期流程中端口傳送或接收的資料量，並設定預期達到該資料量的時間範圍。當 SLA 未達到時，知行之桥 會傳送電子郵件警告使用者，並將 SLA 標記為 *存在風險*，這意味著如果 SLA 未能儘快達到，則會被標記為 *已違反*。這讓使用者有機會介入並確定 SLA 未達到的原因，並採取適當的措施。如果在風險時間段結束時仍未達到 SLA，則會將 SLA 標記為已違反，並再次通知使用者。

SLA 轉換為 *存在風險* 或 *已違反* 狀態時，也會寫入[應用程式日誌](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/activity.md#应用程序日志)，這意味著應用程式效能監控 (APM) 和日誌擷取工具也可以針對這些狀態發出警示。

要定義 SLA，請啟用 **預期資料量**，然後點選 **設定** 索引標籤。

![SLA Empty](https://docs.kasoftware.com/26.4/images/sla_empty.png)
<ul><li>如果端口具有單獨的傳送和接收操作，請使用選項按鈕指定 SLA 適用的方向。</li>
<li>在視窗的 **預計至少** 部分中：
<ul><li>設定預計處理的最小交易數量（交易量）</li>
<li>使用 **每個** 欄位指定時間範圍</li>
<li>指示 SLA 生效的時間。如果選擇 **開始於**，請填寫日期和時間欄位。</li>
<li>勾選希望 SLA 生效的星期幾對應的核取方塊。如有必要，請使用下拉功能表選擇 **每天**。</li></ul></li>
<li>在視窗的 **將狀態設定為“有風險”** 部分中，指定應將 SLA 標記為有風險的時間。
<ul><li>預設情況下，只有在違反 SLA 的情況下才會傳送通知。要更改此設定，請勾選 **傳送“有風險”通知**。</li></ul></li></ul>

以下範例顯示了為端口配置的 SLA，該端口預計在週一至週五每天接收 1000 個檔案。如果尚未收到 1000 個檔案，則會在時間段結束前 1 小時傳送風險通知。

![SLA Configuration Example](https://docs.kasoftware.com/26.4/images/sla_defined.png)

> [!NOTE]
>
> 如果有必要，可以關閉 SLA 通知。這在維護視窗期間非常有用。點選導覽列上的 **設定**，然後跳轉到 **通知 > 通用通知**。點選平板和鉛筆圖示進行編輯，並取消勾選 **SLA 通知** 設定。

### 交易索引標籤

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

收到的表單回覆會顯示在此索引標籤上。

## 配置 IIS 伺服器

如果你的 知行之橋 例項託管在 IIS 伺服器上，並且你使用 Microsoft Windows 身分驗證登入到應用程式，則必須為你的使用者停用 Windows 身分驗證。否則，Form 端口無法正確驗證使用者，端口將無法正常工作。

要停用 Windows 身分驗證：

1. 在你的 IIS 管理器中，在基本應用程式路徑中建立一個名為 `connector` 的新資料夾。

2. 在 **IIS**（右窗格中）下為 `connector` 資料夾選擇 **Authentication**。

   ![](https://mintcdn.com/qiao/kYLwR1iZrGqYINH1/26.4/images/form_iis_1.png?fit=max\&auto=format\&n=kYLwR1iZrGqYINH1\&q=85\&s=022c64886ffe12ca4ccbf389135f7237)

3. 將此資料夾的 **Windows 身分驗證** 設定為 **停用**。

   ![](https://mintcdn.com/qiao/kYLwR1iZrGqYINH1/26.4/images/form_iis_2.png?fit=max\&auto=format\&n=kYLwR1iZrGqYINH1\&q=85\&s=0b50ff70ae24ea8174815fbdc88d9944)

## 建立表單

表單包含欄位、部分和詳細資訊：

* **部分**：將欄位分組的標題
* **詳細資訊**：類似於預配置表的物件，表單使用者可以在其中根據需要為資料集新增任意數量的記錄
* **欄位**：帶有標籤的輸入框，使用者可在此輸入表單資料

首先，點選表單標題旁邊的**新增**按鈕，然後選擇**新增部分**或**新增詳細資訊**。

### 新增部分

"部分"透過將表單中的欄位按標題分類來劃分欄位。例如，"收貨人"部分可能包含"地址"、"城市"和"郵政編碼"等欄位。

向表單新增欄位並非必須使用"部分"。但是，"部分"提供了專案的邏輯分組，有助於使用者快速理解表單。

要新增部分：

1. 從下拉功能表中選擇**新增部分**。輸入部分名稱。

2. 現在您可以開始向該部分[新增欄位](#新增欄位)。

   ![](https://mintcdn.com/qiao/Aa29RQkYomm0Fubg/26.4/images/Form_connector_form_designer_add_section_results.png?fit=max\&auto=format\&n=Aa29RQkYomm0Fubg\&q=85\&s=c956ce53e66ca47e6c4dfff5f463b93c)

### 新增詳細資訊表

詳細資訊表允許表單建立者在 Web 表單中嵌入表格，以實現結構化的、基於行的資料輸入。它們包含可配置的列數，可以在表單建立期間定義這些列數。它們非常適合在單次表單提交中捕獲可重複的資料集。終端使用者可以根據需要動態新增任意數量的行，併為這些行中的每一列輸入值。有關範例，請參閱[存取你的表單](#存取你的表單)。

要將詳細資訊表新增到表單：

1. 從下拉功能表中點選**新增詳細資訊**。輸入名稱。

2. 現在可以向表中新增列了。選擇任意[表單欄位型別](#表單欄位型別)。

   ![](https://mintcdn.com/qiao/Aa29RQkYomm0Fubg/26.4/images/Form_connector_form_designer_add_detail_result.png?fit=max\&auto=format\&n=Aa29RQkYomm0Fubg\&q=85\&s=08c89419647b8339052ff61963f0a5ca)

### 新增欄位

*欄位*是表單的基本輸入單位。

新增欄位：

1. 將物件從**表單欄位**部分拖放到您的部分或詳細資訊表中。

2. 輸入**顯示名稱**（例如，訂單項 ID）。預設情況下，系統會填充 **XML 名稱**，但可以使用**覆蓋**核取方塊提供其他名稱。

3. 使用**必填**核取方塊指定該欄位是否為必填欄位。

4. 其他選項因[表單欄位型別](#表單欄位型別)而異。以下範例顯示了正在定義的文字欄位。完成欄位定義後，點選**新增**。

   ![](https://mintcdn.com/qiao/Aa29RQkYomm0Fubg/26.4/images/Form_connector_form_designer_form_field.png?fit=max\&auto=format\&n=Aa29RQkYomm0Fubg\&q=85\&s=fbb590971e5d479975911d7170584771)

> [!TIP]
>
> 要編輯欄位，請點選其名稱的連結或名稱右側的省略號。要移除欄位，請點選省略號並選擇**移除例項**。將欄位拖放到部分或詳細資訊表中，即可重新排列它們在表單中的位置。

### 表單欄位型別

#### 文字欄位選項

* 顯示名稱：表單中欄位的名稱。
* XML 名稱：顯示名稱的淨化版本。它必須是有效的 XML 元素名稱。
* 覆蓋：核取方塊，用於更改預設的 XML 名稱。
* 必填：核取方塊，用於指示該欄位是否為必填項。
* 預設值：使用此處提供的文字填充表單。
* 描述：幫助文字，用於描述欄位的用途。

#### 下拉欄位選項

* 顯示名稱：表單中欄位的名稱。
* XML 名稱：顯示名稱的淨化版本。它必須是有效的 XML 元素名稱。
* 覆蓋：核取方塊，用於更改預設的 XML 名稱。
* 下拉選項：表單下拉欄位中顯示的選項清單。點選**新增選項**即可新增所需的選項。
* 必填：核取方塊，用於指示該欄位是否為必填項。
* 預設值：使用此處提供的文字填充表單。
* 描述：輔助文字，用於描述該欄位的用途。

#### 選項按鈕欄位選項

* 顯示名稱：表單中欄位的名稱。
* XML 名稱：顯示名稱的淨化版本。它必須是有效的 XML 元素名稱。
* 覆蓋：核取方塊，用於更改預設的 XML 名稱。
* 選項按鈕選項：表單選項按鈕欄位中顯示的選項清單。點選**新增選項**即可新增所需的選項。
* 必填：核取方塊，用於指示該欄位是否為必填項。
* 預設值：使用此處提供的文字填充表單。
* 描述：輔助文字，用於描述該欄位的用途。

#### 核取方塊欄位選項

* 顯示名稱：表單中欄位的名稱。
* XML 名稱：顯示名稱的淨化版本。它必須是有效的 XML 元素名稱。
* 覆蓋：核取方塊，允許您更改預設的 XML 名稱。
* 核取方塊選項：表單核取方塊欄位中顯示的選項清單。點選**新增選項**新增所需的選項。
* 必填：核取方塊，指示該欄位是否為必填項。
* 預設值：使用此處提供的文字填充表單。
* 描述：描述欄位用途的幫助文字。

#### 檔案上傳欄位選項

* 顯示名稱：表單中欄位的名稱。
* XML 名稱：顯示名稱的淨化版本。它必須是有效的 XML 元素名稱。
* 覆蓋：核取方塊，允許您更改預設的 XML 名稱。
* 接受的檔案型別副檔名：允許上傳的檔案型別清單。例如，`.xml` 僅接受 XML 檔案。要允許所有檔案型別，請使用 `*`。點選**新增選項**新增需要的選項。
* 必填：核取方塊，指示該欄位是否為必填項。
* 預設值：使用此處提供的文字填充表單。
* 描述：輔助文字，描述該欄位的用途。

### 存取你的表單

表單設計完成後，點選設計器頂部的**表單 URL** 連結即可存取。以下表單是一個簡單的範例：

![](https://mintcdn.com/qiao/Aa29RQkYomm0Fubg/26.4/images/Form_connector_final_form.png?fit=max\&auto=format\&n=Aa29RQkYomm0Fubg\&q=85\&s=5d271c0ee8d93f21e4eb3737f0871e0d)

## 提交新的表單資料

在表單編輯器中建立表單後，使用者可以存取 Form 端口的 Web 介面並透過表單提交資料。

對於主表單中的欄位，使用者只需輸入與表單標籤相對應的值（取自你拖入表單設計器的欄位名稱）。

使用者可以透過點選**新增行**向詳細資訊表新增行。使用者輸入所有資料後，點選**提交**即可提交資料。如果提交成功，系統會顯示類似以下內容的訊息。

![](https://mintcdn.com/qiao/Aa29RQkYomm0Fubg/26.4/images/Form_connector_form_designer_success_message.png?fit=max\&auto=format\&n=Aa29RQkYomm0Fubg\&q=85\&s=0f62a53d04eadb9d8cc4964e5e8cfe28)

當使用者提交表單時，表單資料會被推送到**交易**索引標籤。輸出是一個包含以下結構的 XML 檔案：

```xml theme={null}
<Items>
  <FormTitle>
    <FieldA>data</FieldA>
    <FieldB>more data</FieldB>
    <FieldC>even more data</FieldC>
    <DetailTitle>
      <SubFieldA>123</SubFieldA>
      <SubFieldB>456</SubFieldB>
    </DetailTitle>
    <DetailTitle>
      <SubFieldA>135</SubFieldA>
      <SubFieldB>246</SubFieldB>
    </DetailTitle>
  </FormTitle>
</Items>
```

此輸出非常適合由 [XMLMap 端口](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/xml-map/xml-map.md) 處理，以便可以將其對映為可供另一個端口使用的 XML 格式。

## 宏

在檔案命名策略中使用宏可以提高組織效率和對資料的上下文理解。透過將宏合併到檔名中，可以動態地包含相關資訊，例如識別碼、時間戳和訊息頭資訊，從而為每個檔案提供有價值的上下文。這有助於確保檔名反映對組織重要的詳細資訊。

知行之桥 支援這些宏，它們都使用以下語法：`%Macro%`。

<table><thead><tr><th>宏</th><th>描述</th></tr></thead>
<tbody><tr><td>ConnectorID</td><td>替換為端口的 ConnectorID。</td></tr>
<tr><td>ConnectorName</td><td>替換為端口名稱。可用於在檔名或路徑中包含連線名稱，例如按生成備份檔案的資料庫連線標記檔案。</td></tr>
<tr><td>Ext</td><td>替換為端口當前正在處理的檔案的副檔名。</td></tr>
<tr><td>Filename</td><td>替換為端口當前正在處理的檔案的檔名（包括副檔名）。</td></tr>
<tr><td>FilenameNoExt</td><td>替換為端口當前正在處理的檔案的檔名（不帶副檔名）。</td></tr>
<tr><td>MessageId</td><td>計算端口輸出的訊息的 MessageId。</td></tr>
<tr><td>RegexFilename:*pattern*</td><td>將規則運算式模式應用於端口當前正在處理的檔案的檔名。</td></tr>
<tr><td>Header:*headername*</td><td>替換為端口正在處理的當前訊息的目標訊息頭（`headername`）的值。</td></tr>
<tr><td>LongDate</td><td>以常規格式計算系統的當前日期時間（例如，2024 年 1 月 24 日星期三）。</td></tr>
<tr><td>ShortDate</td><td>以 yyyy-MM-dd 格式計算系統的當前日期時間（例如 2024-01-24）。</td></tr>
<tr><td>DateFormat:*format*</td><td>以指定格式（`format`）計算系統的當前日期時間。有關可用的日期時間格式，請參閱 [範例日期格式](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/date-formatters.md#date-formats-with-literal-characters)。</td></tr>
<tr><td>Vault:*vaultitem*</td><td>計算指定保管庫專案的值。</td></tr></tbody></table>

### 範例

某些宏（例如 %Ext% 和 %ShortDate%）不需要參數，但其他宏則需要。所有帶有參數的宏都使用以下語法：`%Macro:argument%`

以下是帶有參數的宏的一些範例：

<ul><li>%Header:headername%：其中 `headername` 是訊息上訊息頭的名稱。</li>
<li>%Header:mycustomheader% 解析為輸入訊息上設定的 `mycustomheader` 訊息頭的值。</li>
<li>%Header:ponum% 解析為輸入訊息上設定的 `ponum` 訊息頭的值。</li>
<li>%RegexFilename:pattern%：其中 `pattern` 是規則運算式模式。例如，`%RegexFilename:^([\w][A-Za-z]+)%` 匹配並解析為檔名中的第一個單詞，並且不區分大小寫（`test_file.xml` 解析為 `test`）。</li>
<li>%Vault:vaultitem%：其中 `vaultitem` 是 [vault](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/global-settings-vault.md) 中專案的名稱。例如，`%Vault:companyname%` 解析為儲存在保管庫中的 `companyname` 項的值。</li>
<li>%DateFormat:format%：其中 `format` 是可接受的日期格式（有關詳細資訊，請參閱 [範例日期格式](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/date-formatters.md#sample-date-formats)）。例如，`%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%` 解析為檔案上的日期和時間戳。</li></ul>

還可以建立更復雜的宏，如以下範例所示：

<ul><li>將多個宏組合在一個檔名中：`%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%`</li>
<li>包括宏之外的文字：`MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%`</li>
<li>在宏中包含文字：`%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%`</li></ul>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.
設定	描述
端口 Id	端口的靜態、唯一識別碼。
端口型別	顯示端口型別及其用途的描述。
端口描述	一個可選欄位，用於提供端口及其在流中的角色的自由格式描述。
功能	描述
新增	輸入新的 IP 地址範圍。
編輯	修改選定的 IP 地址範圍。
刪除	從清單中刪除選定的 IP 地址範圍。
設定	描述
日誌級別	指定要記錄在端口日誌目錄中的資訊型別： None - 不建立任何日誌。 Error - 僅當端口遇到錯誤時才建立日誌。 Warning - 僅當端口發出警告時才建立日誌。 Info - 記錄工作流程的一般資訊，包括任何錯誤和警告（如果適用）。 Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。 Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。 \\請注意：\\Debug 和 Trace 級別的日誌可能會記錄敏感資訊，包括訊息內容和 SSL 憑證。儘管連線屬性（例如密碼）被遮蔽了，但在與您的組織外部共享它們之前，請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構	指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本	指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。
宏	描述
ConnectorID	替換為端口的 ConnectorID。
ConnectorName	替換為端口名稱。可用於在檔名或路徑中包含連線名稱，例如按生成備份檔案的資料庫連線標記檔案。
Ext	替換為端口當前正在處理的檔案的副檔名。
Filename	替換為端口當前正在處理的檔案的檔名（包括副檔名）。
FilenameNoExt	替換為端口當前正在處理的檔案的檔名（不帶副檔名）。
MessageId	計算端口輸出的訊息的 MessageId。
RegexFilename:pattern	將規則運算式模式應用於端口當前正在處理的檔案的檔名。
Header:headername	替換為端口正在處理的當前訊息的目標訊息頭（`headername`）的值。
LongDate	以常規格式計算系統的當前日期時間（例如，2024 年 1 月 24 日星期三）。
ShortDate	以 yyyy-MM-dd 格式計算系統的當前日期時間（例如 2024-01-24）。
DateFormat:format	以指定格式（`format`）計算系統的當前日期時間。有關可用的日期時間格式，請參閱 [範例日期格式](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/date-formatters.md#date-formats-with-literal-characters)。
Vault:vaultitem	計算指定保管庫專案的值。