> ## 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.

# XML Map 配置

> XML Map 端口的所有可配置屬性。

## XML Map 索引標籤

使用此索引標籤上傳源和目標範本檔案，並構建對映。有關如何使用對映編輯器的詳細說明，請參閱[對映](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/mapping/mapping.md)文件中的[配置對映](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/mapping/mapping-config.md)。

## 設定索引標籤

### 端口配置

與端口核心操作相關的設定。

<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>

## 進階選項卡

### AI

<table><thead><tr><th>設定</th>
<th>描述</th></tr></thead>
<tbody><tr><td>**自訂 AI 提示詞**</td>
<td>選取此項可覆寫 AI 輔助對應在來源文件與目的文件之間建立對應時使用的預設系統提示詞和使用者提示詞內容。未選取時，端口使用預設提示詞產生對應。首次啟用該核取方塊時，預設提示詞會顯示在文字方塊中。</td></tr></tbody></table>
![自訂 AI 提示詞設定](https://docs.kasoftware.com/26.4/images/customize_ai_prompts.png)

### 進階設定

進階檔案處理設定。

| 設定 | 說明 |
| - | - |
| XML 宣告 | 指定是否在生成的 XML 檔案中包含 XML 宣告。 |
| 快取內容 | 指定剖析器是否快取每個 XML 元素的原始內容，以便對映期間透過 `xsubtree` 取得。該設定會增加記憶體使用，但允許原樣複製子樹。詳情請參閱[複製 XML 子樹](#複製-xml-子樹（xsubtree）)。 |
| 本地檔案方案 | 為連接器輸出訊息分配檔名的方案。可以使用宏在檔名中動態加入識別碼和時間戳。 |
| 處理延遲 | 連接器處理檔案前等待的時間（秒）。 |

### 訊息

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

**注意：**以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇**顯示成功路徑**，然後將成功路徑連線到 [File 端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/file.md)。

<table><thead><tr><th>設定</th><th>描述</th></tr></thead>
<tbody><tr><td>**儲存到已傳送資料夾**（已棄用）</td>
<td>將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受[靜態加密](https://docs.kasoftware.com/26.4/self-hosted/zh/getting-started/administration/settings/encryption-at-rest.md)保護。</td></tr>
<tr><td>**已傳送資料夾方案**（已棄用）</td>
<td>按所選時間間隔對 **Sent** 資料夾中的檔案進行分組。僅在啟用**儲存到已傳送資料夾**時適用。</td></tr></tbody></table>

### 日誌

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

<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-Hant/getting-started/administration/settings/settings-page.md#通知)索引標籤上的全域設定。若要對此端口使用其他設定，請開啟 **覆蓋全域設定**。

預設情況下，錯誤警示處於啟用狀態，這意味著每當發生錯誤時都會傳送電子郵件。若要關閉它們，請取消勾選 **啟用** 核取方塊。

輸入 **主題**（必填），然後可選擇輸入以逗號分隔的 **收件人** 郵箱清單。

## SLA 索引標籤

SLA 允許配置工作流程中端口預期傳送或接收的數量，並設定期望達到該數量的時間範圍。當 SLA 未滿足時，知行之橋會傳送電子郵件警告使用者，並將 SLA 標記為 *At Risk*，這意味著如果 SLA 很快仍未滿足，它將被標記為 *Violated*。

若要定義 SLA，請開啟 **預期數量**，然後點選 **設定** 索引標籤。

* 如果端口有單獨的傳送和接收操作，請使用選項按鈕指定 SLA 適用的方向。
* 在視窗的 **至少預期** 部分，設定期望處理的最小交易數，使用 **每** 欄位指定時間範圍，指明 SLA 應何時生效，並勾選一週中的相應日期。
* 在視窗的 **將狀態設定為 'At Risk'** 部分，指定 SLA 應何時標記為有風險。勾選 **傳送 'At Risk' 通知** 可在違約前接收通知。

> [!NOTE]
>
> 可以在維護視窗期間關閉 SLA 警示。點選導覽列上的 **設定**，然後導航到 **警示 > 常規警示**。點選平板和鉛筆圖示進行編輯，並取消勾選 **SLA 警示** 設定。

## 複製 XML 子樹（xsubtree）

[xsubtree](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/scripting/value-formatters/function-formatters.md#xsubtree-xpath) 格式化程式會將源元素的原始 XML 內容原樣複製到目標，保留完整子樹結構，不經過對映引擎重新序列化。需要讓源文件的一部分在不知道內部結構的情況下保持不變時，這十分有用。

首先在[進階選項卡](#進階選項卡)中啟用**快取內容**，使剖析器保留各元素的原始內容。該設定的記憶體用量會隨源文件大小增加。

隨後在目標節點的[自定義指令碼](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/xml-map/xml-map-advanced.md#自定義指令碼)中使用：

```text theme={null}
[xsubtree(ElementName)]
```

其中 `ElementName` 是要複製的源元素名稱或相對 XPath。

### 範例

源文件：

```xml theme={null}
<Items>
  <Item><Sub><X>1</X><Y>2</Y></Sub></Item>
  <Item><Sub><A>Hello</A><B>World</B></Sub></Item>
  <Item><Sub><Name>Test</Name></Sub></Item>
</Items>
```

對 `/Items/Item` 使用 Foreach，並在目標節點使用 `[xsubtree(Sub)]`，會生成：

```xml theme={null}
<Out xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Result><Sub><X>1</X><Y>2</Y></Sub></Result>
  <Result><Sub><A>Hello</A><B>World</B></Sub></Result>
  <Result><Sub><Name>Test</Name></Sub></Result>
</Out>
```

每個 `Sub` 元素及其全部子元素都會按源文件原樣複製。

> [!NOTE]
>
> 如果源中不存在指定元素，`xsubtree` 傳回空結果。

## 宏

| 宏 | 說明 |
| - | - |
| ConnectorID | 端口的 Connector ID。 |
| Ext | 副檔名（例如 `xml`、`csv`）。 |
| Filename | 訊息的原始檔名。 |
| FilenameNoExt | 不帶副檔名的訊息原始檔名。 |
| MessageId | 分配給訊息的唯一識別碼。 |
| RegexFilename | 根據原始檔名上的規則運算式派生出的檔名。 |
| Header | 按名稱引用的訊息頭值。 |
| LongDate | 長格式的當前日期/時間。 |
| ShortDate | 短格式的當前日期/時間。 |
| DateFormat | 自定義格式的當前日期/時間。 |
| Vault | 按名稱引用的保管庫項目值。 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.