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

export const UploadTestFile = () => <>
    <p>按照以下步驟生成輸入檔案的 XML 範本：</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>1. 在端口的 <strong>交易</strong> 索引標籤中，單擊 <strong>更多</strong> 下拉功能表，然後單擊 <strong>上傳測試檔案</strong>。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>2. 導航到磁碟上要建模為 XML 的檔案，選擇它，然後單擊 <strong>OK</strong>。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>3. 將 <a href="/26.3/self-hosted/zh/connectors/edi-connectors">EDI 端口</a> 連線到流中的 XML Map 端口。此連線可以在任一方向進行——入站到 XML Map 端口，或從 XML Map 端口出站。</p>
    <p>XML Map 端口會自動檢測測試檔案的結構。根據您放置 EDI 端口的位置，該檔案將出現在 XML Map 端口的 <strong>來源檔案</strong> 或 <strong>目的檔案</strong> 下拉功能表中。</p>
    <Note>僅當相容端口連結到流中的 XML Map 端口時，測試檔案才在 XML Map 端口中可用。</Note>
  </>;

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

<img src="https://mintcdn.com/qiao/BoZrJ8_ctEN6h_9z/public/images/xml-map-template-files.png?fit=max&auto=format&n=BoZrJ8_ctEN6h_9z&q=85&s=48d2d1b3a0b31c0907b3c2d829b34f51" width="700" data-path="public/images/xml-map-template-files.png" />

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

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

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

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

### 上傳測試檔案

<UploadTestFile />

### 手動建立測試檔案

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

## 選擇內建範本檔案

當你將包含內建架構檔案的 [EDI 端口](../edi-connectors)連線到 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 檔案對映到資料庫插入：

<img src="https://mintcdn.com/qiao/BoZrJ8_ctEN6h_9z/public/images/xmlmap_example_flow.png?fit=max&auto=format&n=BoZrJ8_ctEN6h_9z&q=85&s=51724441c6952579304852cdd5aa0a8f" width="700" data-path="public/images/xmlmap_example_flow.png" />

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