tXMLMap 的核心定位是 XML-aware 的 tMap 替代品，专用于对已解析的 XML 结构化数据进行字段级映射、转换和重组，依赖严格匹配的输入 Schema，输出 Schema 直接定义生成 XML 的树形结构。
tXMLMap 组件的核心定位是什么？
tXMLMap 不是通用 XML 解析器，也不是替代 tFileInputXML 的组件。它专用于在已有 XML 结构化数据（通常来自 tFileInputXML 或 tXMLInput）进入作业后，做字段级映射、转换和重组——本质是「XML-aware 的 tMap 替代品」。如果你还没把 XML 解析成行数据，直接拖一个 tXMLMap 进来，它根本收不到输入流，会报 NullPointerException 或 Schema mismatch。
输入 Schema 必须匹配 XML 实际结构，否则映射失效
tXMLMap 依赖上游组件提供的元数据 Schema（比如 tFileInputXML 的 schema），且该 Schema 必须与真实 XML 内容严格一致：节点层级、重复性（minOccurs/maxOccurs）、命名空间声明都得对得上。常见翻车点：
- XML 中有
<ns:order>，但 Schema 没声明xmlns:ns="http://example.com"→ 字段全为空 - XML 中
<items><item>...</item><item>...</item></items>，但 Schema 把item定义为非重复（maxOccurs="1"）→ 只取第一个item - 用
tFileInputXML时勾选了Use XPath，但tXMLMap的输入 Schema 却按默认 flat 模式生成 → 字段名对不上，连线失败
验证方式：右键 tXMLMap → Edit schema，逐项对照 XML 示例文件的实际嵌套路径。
输出 XML 的结构由 tXMLMap 的“Output”标签页定义
不同于 tMap 输出平面结构，tXMLMap 的输出 Schema 直接决定生成 XML 的树形结构。关键操作都在 Output 标签页里完成：
- 右键 Output schema → Add child element 或 Add sibling element 构建层级
- 每个字段的
XML Path属性必须填写相对路径，例如：/order/header/orderId、/order/items/item/name - 若某字段需作为属性（如
<item id="123">），则在字段属性中勾选Is attribute，并确保其XML Path指向父元素（如/order/items/item） - 重复节点（如多个
item）需将对应字段的Max occurrences设为-1（表示 unbounded）
示例 Output Schema 片段（对应生成 <order><header><id>1</id></header><items><item><name>A</name></item></items></order>）：
+ order (root)
+ header
- id (XML Path: /order/header/id)
+ items
+ item (Max occurrences: -1)
- name (XML Path: /order/items/item/name)常见错误：空值、命名空间丢失、编码乱码
即使映射逻辑正确，生成的 XML 仍可能出问题：
-
null值字段默认不输出节点 → 若需强制输出（如<status xsi:nil="true"/>），得在字段属性中启用Use nil并配置xsi命名空间 - 输出 XML 缺失
xmlns声明 → 在tXMLMap的 Advanced settings 中手动填入Namespaces，格式如：ns=http://example.com, xsi=http://www.w3.org/2001/XMLSchema-instance - 中文乱码 → 确保
tFileOutputXML（下游组件）的Encoding设为UTF-8，且 XML 声明里显式写<?xml version="1.0" encoding="UTF-8"?>（后者需在tXMLMap的Advanced settings → XML declaration中勾选并指定 encoding）
真正容易被忽略的是：tXMLMap 不校验输出路径语法是否合法。写错一个斜杠或大小写（比如 /Order/items/Item/name 而实际 XML 是小写 order），它不会报错，只是静默跳过该字段。
