XML 连接
组件介绍
组件作用
“XML 连接”组件用于将一个流中的 XML 标签添加到来自第二个流的 XML 结构中。
输入输出描述
- 输入：需要添加的 XML 标签，需要添加标签的 XML 数据
- 输出：连接的 XML 内容
组件图标
页面介绍
“XML 连接”组件的页面包含如下选项
目的流
| 选项 | 说明 | 样例值 |
|---|---|---|
| 目的 XML 通道 | 发送目标文档到连接的组件。 | |
| 目的 XML 字段 | 包含 XML 结构的字段。 |
源流
| 选项 | 说明 | 样例值 |
|---|---|---|
| 源 XML 通道 | 发送需要添加到目标的 XML 结构到连接的组件。 | |
| 源 XML 字段 | 包含要添加到目标的 XML 结构的字段。 |
连接条件
| 选项 | 说明 | 样例值 |
|---|---|---|
| XPath 语句 | 在目标文档中查找添加标签的节点的 XPath 语句。当启用复杂连接时，使用单个 ? 作为占位符。。 | |
| 复杂连接 | 启用复杂连接语法的标志，使用 XPath 语句中的占位符。 | |
| 连接比较字段 | 包含 XPath 语句中要替换的值的字段。 |
结果流
| 选项 | 说明 |
|---|---|
| 结果 XML 字段 | 将包含结果的字段。 |
| 编码 | 在 XML 头部和转换 XML 时使用的编码。 |
| 忽略 XML 头 | 是否省略 XML 头部。 |
| XPath 查询默认返回空值 | 不选择此选项时，空值将作为空元素添加到 XML 输出中。当选择此选项时，这些标签在输出中将被完全省略。 |
案例示例
该案例拼接用户定义的 xml 数据，总体流程如下图所示：
案例数据
该案例首先拼接 XML 根部
案例操作
使用自定义常量数据生成 XML 根数据
首先使用“自定义常量数据”组件自定义了一个字段，为 xml1。并填入了一行数据
输出结果如下图所示：
使用自定义常量数据生成包含学生姓名的 XML 数据
使用“自定义常量数据”组件自定义一个 xml2 字段表示包含学生姓名的 XML 数据。并填入数据
输出结果如下图所示：
使用 XML 连接组件连接 XML 根数据和包含学生姓名的 XML 数据
使用“XML 连接”组件设置
（1）拼接数据的组件（定义根 XML）以及包含 XML 数据的字段名（xml1）
（2）包含拼接数据的组件（定义源 XML）以及包含 XML 数据的字段名（xml2）
（3）连接条件（//students）
（4）设置输出拼接结果的字段名
输出结果如下图所示：
使用自定义常量数据生成包含学生姓名科目成绩的 XML 数据
使用“自定义常量数据”组件自定义了两个字段，分别为name（学生姓名）、subjectXML（包含科目以及成绩信息的 XML 数据），并填入了三行数据
输出结果如下图所示：
使用 XML 连接组件连接包含学生姓名的 XML 数据和包含学生姓名科目成绩的 XML 数据
使用“XML 连接”组件设置
（1）拼接数据的组件（XML 连接）以及包含 XML 数据的字段名（xml）
（2）包含拼接数据的组件（生成成绩 XML 数据）以及包含 XML 数据的字段名（subjectXML）
（3）连接条件（//student[@name='?']），勾选复杂连接，并设置连接比较字段为 name，意为使用 name 字段的数据与 ？ 处数据比较，若相同则进行拼接
（4）设置输出拼接结果的字段名
输出结果如下图所示：
