> ## 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 和目標 XML 結構的範本檔案。

任何 XML 對映的第一步都是選擇或上傳代表源和目標 XML 結構的範本檔案。

![](https://mintcdn.com/qiao/cAp6sdkg0SyWJqZM/26.4/images/xml-map-template-files.png?fit=max\&auto=format\&n=cAp6sdkg0SyWJqZM\&q=85\&s=5bf191b255dd4ec0bff4c3b02896998c)

* *來源檔案* 表示輸入文件的 XML 結構。任何由端口處理的檔案都應具有匹配的 XML 結構。只要巢狀元素的結構相同，輸入文件中的元素可以以不同於來源檔案的方式重複。
* *目的檔案* 表示輸出文件的結構。端口生成的檔案具有匹配的 XML 結構。根據對映，輸出文件中的元素可以以不同於目的檔案的方式重複或省略；但巢狀元素的結構保持不變。

這些範例可以透過多種方式在知行之橋中生成。

## 來自轉換端口的範本檔案

X12、EDIFACT 和 CSV 等轉換端口會自動將文件轉換為 XML。此外，EDI 端口會將完整的檔案架構提供給 XML Map 端口。這為將 EDI 檔案對映為所需格式提供了簡單的起點，尤其是在單個測試檔案可能無法涵蓋對映中可能需要的所有元素時。

### 上傳測試檔案

按照以下步驟生成輸入檔案的 XML 範本：

1. 在端口的 **交易** 索引標籤中，單擊 **更多** 下拉功能表，然後單擊 **上傳測試檔案**。

2. 導航到磁碟上要建模為 XML 的檔案，選擇它，然後單擊 **OK**。

3. 將 [EDI 端口](https://docs.kasoftware.com/26.4/self-hosted/zh/connectors/edi-connectors.md) 連線到流中的 XML Map 端口。此連線可以在任一方向進行——入站到 XML Map 端口，或從 XML Map 端口出站。

XML Map 端口會自動檢測測試檔案的結構。根據您放置 EDI 端口的位置，該檔案將出現在 XML Map 端口的 **來源檔案** 或 **目的檔案** 下拉功能表中。

> [!NOTE]
>
> 僅當相容端口連結到流中的 XML Map 端口時，測試檔案才在 XML Map 端口中可用。

### 手動建立測試檔案

你也可以手動建立測試檔案。只需透過轉換端口傳送範例檔案（EDI 端口應明確配置為“EDI-to-XML”模式）以生成 XML 輸出檔案。下載該輸出檔案，並將其作為來源檔案或目的檔案再次上傳到 XML Map 端口中。

## 選擇內建範本檔案

當你將包含內建架構檔案的 [EDI 端口](https://docs.kasoftware.com/26.4/self-hosted/zh-Hant/connectors/edi-connectors.md)連線到 XML Map 端口時，XML Map 端口可以自動讀取架構檔案，並將其作為 XML Map **設定**索引標籤上 **來源檔案** 或 **目的檔案** 欄位中的選項提供。這些範本檔案以 `connector://` 為字首。

## 來自資料庫端口的範本檔案

SQL Server、MySQL 和 CData 等資料庫端口會自動生成其輸入和輸出對映的 XML 表示。與 EDI 和 CSV 端口類似，在資料庫端口中儲存源或目標對映後，任何已連線的 XML Map 端口都可以自動檢測這些 XML 結構。

要將資料庫表結構用作來源檔案或目的檔案，請執行以下步驟：

1. 在資料庫端口中，建立到資料庫的可用連線。
2. 選擇一個操作（例如 Select 或 Upsert），並進行相應配置。也可以使用 **預覽** 按鈕儲存包含範例資料的對映範例。
3. 在工作流程中將 XML Map 端口連線到資料庫端口。
4. 在 XML Map 端口設定中找到作為來源檔案或目的檔案的表結構。

## 最佳實踐

XML Map 端口通常位於知行之橋工作流程中的其他兩個端口之間。通常最好使用 XML Map 端口兩側的兩個端口來生成範本檔案。例如，以下工作流程使用 XML Map 端口將 X12 檔案對映到資料庫插入：

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

在此範例中，應使用 X12 端口和 SQL Server 端口為它們之間的 XML Map 端口生成 XML 範本檔案。或者，也可以從內建範本檔案清單中選擇。


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