MapForce中concat()遇null返回null，需用if-empty()兜底；date-from-string()须显式指定格式；mapforce:lookup()需声明命名空间；generate-id()不稳定，唯一标识应改用uuid:generate()。
MapForce 中 concat() 函数拼接空值时返回 null 而非空字符串
MapForce 默认把 concat() 当作严格 SQL 风格处理：任一参数为 null，整个结果就是 null。这和多数开发者直觉（比如 JavaScript 的 '' + null === 'null'）不符，也容易导致下游映射字段意外丢失。
- 实际场景中，常见于数据库字段允许 NULL、但目标 XML/JSON 要求非空字符串的转换任务
-
解决方法不是改用
string-join()（它不接受任意数量参数），而是前置用if-empty()或coalesce()做兜底 - 推荐写法：
concat(if-empty($a, ''), if-empty($b, ''), if-empty($c, '')) - 注意：
if-empty()只判断空字符串和null，不处理空白字符串（如' '），如需过滤空白，得嵌套normalize-space()
日期转换函数 date-from-string() 对格式敏感且无自动推断
MapForce 不会像 Python 的 dateutil.parse() 那样尝试猜测输入格式。date-from-string() 必须显式指定格式字符串，否则解析失败并抛出运行时错误 Invalid date format。
- 常见错误：源数据是
'2024-05-21'，却用格式'MM/dd/yyyy'导致整行映射中断 - ISO 格式（
yyyy-MM-dd）可直接用xs:date($input)，更轻量且不需格式串 - 非 ISO 格式必须严格匹配：例如
'dd.MM.yyyy'不能写成'd.M.yyyy'（少前导零会失败） - 时区信息需额外用
adjust-dateTime-to-timezone()处理，date-from-string()本身不解析时区
在 XSLT 输出映射中调用 mapforce:lookup() 需手动声明命名空间
MapForce 生成的 XSLT 若启用了“外部查找表”功能，会插入类似 mapforce:lookup('countries', $code) 的调用，但该函数不属于标准 XSLT，必须在生成的 XSLT 文件顶部显式声明命名空间，否则执行时报错 Function 'mapforce:lookup' not found。
pui 是一款基于jQyery开发的插件库。目前线上稳定使用已有2年多，丰富的接口，简单明了的调用方式，灵活的回调函数，让您轻轻松松打造出富有灵活交互的Web前端界面解决方案。 插件库封装了布局、表单元素、表单校验、弹窗、toast、气泡pop、tab切换、日历时间、分页、表格、树、css命名等功能
- 声明方式（加在
xmlns:mapforce="http://www.altova.com/mapforce" - 若使用 Saxon 或 Xalan 等第三方处理器，还需确认其支持自定义扩展函数；默认配置下部分引擎会禁用扩展
- 替代方案：不用
mapforce:lookup()，改用标准key()实现相同效果，兼容性更好
generate-id() 在重复调用时行为不稳定，不适合做唯一键生成
MapForce 提供的 generate-id() 函数本意是模拟 XPath 的节点标识生成，在单次映射中对同一节点返回相同 ID。但它**不保证跨行、跨批次、或不同 MapForce 版本间的一致性**，更无法作为业务主键或关联键使用。
- 典型误用：用它给 CSV 每行生成“唯一 ID”，结果导出多批次文件时 ID 冲突
- 真正需要稳定唯一标识时，应改用
uuid:generate()（需启用 UUID 扩展库）或外部传入序列号 - 若仅用于临时内存去重（如
distinct-values()配合），generate-id()可用，但别存入持久化目标 - 注意：MapForce 2023+ 版本中该函数已标记为 legacy，未来可能被
system:unique-id()替代
/* 示例：安全生成 UUID（需在 MapForce 中启用 'UUID Functions' 库） */ uuid:generate()
复杂点在于：MapForce 函数库不是“开箱即用”的通用工具集，每个函数背后都绑定着特定执行上下文（XSLT/XQuery 引擎、数据流阶段、是否启用扩展）。漏掉一个命名空间、错配一个格式串、或高估某个函数的稳定性，都可能让看似跑通的映射在真实数据规模下突然失效。
