tXMLMap通过XPath过滤+多输出流实现XML到多表路由，需为每表设独立output flow及匹配filter，共享input schema；数组节点须设父级loop路径；XSD不可直接导入，应先用tExtractXMLField生成样例schema。
如何用 tXMLMap 实现 XML 到多表的条件路由写入
tXMLMap 本身不支持“按 XML 标签名顺序控制写入 DB 表先后”，但它能通过 filter + 多输出流（output table）实现逻辑上的分发路由。关键不是靠 XML 出现顺序，而是靠 XPath 表达式精准定位目标节点。
- 为每张目标表（如
SITES、PLANTS）单独建一个 output flow，每个 flow 的 filter 表达式只匹配对应name属性值：[row1.body:/data/entry/@name] == "site"
- 确保所有 output flow 共享同一个 input schema（即统一解析
/data/entry节点），避免因路径层级不同导致字段不可见 - 不要试图在单个 output flow 中“拼接四张表的数据”——tXMLMap 不是 tMap，它不支持跨 output 的变量共享或执行时序控制
- 若需严格事务顺序（如先插 SITES 再插 PLANTS），必须拆成多个子作业（subjob），用
onSubjobOk连接，而非依赖 tXMLMap 内部行为
tXMLMap 中处理重复子节点（如多个 <item></item>）的正确姿势
遇到含数组结构的 XML（例如一个 <footprint></footprint> 下有多个 <item></item>），tXMLMap 默认只取第一个匹配项。要展开全部，必须启用循环（loop）并绑定到父级上下文。
- 在 input flow 中，将循环路径设为
/rdf/footprint（父级），而非直接写/rdf/footprint/item - 在 output flow 中，用相对 XPath 引用子节点：
./item/itemcd或./custid，其中.指当前 loop 节点 - 切勿在 filter 中对子节点做
!= null判断——这会过滤掉整个父节点，而不是跳过空子项；应改用./item是否存在来判断是否进入该 loop 实例 - 如果需要生成父子关系 ID（如
footprint_id关联多个item），可在 output flow 中用Numeric.sequence("s1", 1, 1)生成临时序列，再通过 tMap 做外键补全
用 tXMLMap 直接生成 HTML 邮件内容的关键配置细节
tXMLMap 可以输出带格式的 HTML 字符串供 tSendMail 发送，但必须遵守严格的 XHTML 结构规则，否则邮件客户端渲染错乱。
<table> 必须作为最外层容器；<code><thead> 和 <code><tbody> 必须显式分离，不能用纯 <code><tr> 堆叠 <li>背景色、边框等样式必须用内联 <code>style，不要依赖 class 或外部 CSS：<td style="background-color:#f0f8ff; border:1px solid #ccc;">...
- 动态数据需用
rowX.xxx引用，但注意：如果输入是单行 XML（如配置类），loop 路径应设为/root，否则字段无法展开 - 邮件正文赋值给 context 变量后，
tSendMail的Message字段要拼接完整 HTML："<html><body>" + context.emailBody + "</body></html>"
，否则部分邮箱会当纯文本显示 - 可行做法：用
tExtractXMLField先解析 XML 示例文件，勾选Guess Schema，自动生成输入结构，再拖入 tXMLMap —— 这比手动写 XPath 更可靠 - 若已有 XSD，可用在线工具（如 FreeFormatter XSD to XML）生成符合结构的样例 XML，再喂给
tExtractXMLField - 绝对不要尝试手动编辑 tXMLMap 的 .xml 模式文件去“硬塞” XSD 定义——会导致组件校验失败或运行时报
Schema mismatch - 复杂嵌套场景（如 choice、any、mixed content），建议绕过 tXMLMap，改用
tJavaRow+ Java DOM/SAX 解析，可控性更高
为什么 XSD 无法直接导入 tXMLMap？替代方案是什么
tXMLMap 不接受标准 XSD 文件作为模式源，这是设计限制，不是操作错误。Talend 的 XML 组件依赖其私有 schema 描述（.xsd 文件被转换为 .xml + .properties 的组合），所以“上传 XSD → 自动生成流”这条路走不通。
All in one 属性——开启后它会把整个输入流合并为单个 Document 输出，适合生成汇总 XML；关闭则按 loop 实例逐条输出。这个开关不显眼，但一开一关，下游组件（比如 tFileOutputXML）的行为可能完全相反。
