> ## 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.2/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 模板文件。或者，也可以从内置模板文件列表中选择。
