Value-Map组件在MapForce左侧Components面板的Transformation分类下，图标为两个上下方块加等号；需拖入映射图并连接输入输出引脚，双击打开«Value Mapping Table»窗口编辑，仅支持字符串类型输入，静态映射用?作通配符，空值需显式配置，大小写默认敏感。
Value-Map 组件在哪找、怎么拖出来
在 MapForce 设计界面左侧的「Components」面板里，Value-Map 位于「Transformation」分类下，图标是两个上下对齐的方块加一个等号。直接拖到映射图中即可——它不是函数调用，而是一个独立的转换组件，必须连接输入和输出引脚才能生效。
- 不支持双击打开配置面板后直接编辑：必须先双击
Value-Map打开其专属编辑窗口（标题为 «Value Mapping Table»），否则右键菜单里的 «Edit Value Map» 是灰色不可用的 - 输入字段类型必须是字符串（
xs:string）或可隐式转为字符串的类型（如xs:integer）；如果连的是xs:boolean或xs:date，运行时会报错 «Cannot convert value to string» - 组件默认只有一对「源值→目标值」映射，新增行需点表格下方的 «+» 按钮，不能靠回车或 Tab 自动添加
如何设置静态映射关系（最常用场景）
静态映射即硬编码「输入值 → 输出值」的对照表，比如把 XML 中的 status 字段 "A" 映射为 "Active"，"I" 映射为 "Inactive"。
Source Value | Target Value -------------|--------------- A | Active I | Inactive P | Pending ? | Unknown
-
?是通配符，代表“其他所有未明确列出的输入值”，必须单独占一行，且只能出现一次 - 空格敏感：输入值
"A "（带尾部空格）和"A"被视为不同键，不会命中同一行 - 大小写敏感：默认区分大小写；如需忽略，勾选编辑窗口右上角的 «Case insensitive» 复选框
- 不支持正则表达式或通配符（如
A*），只有?这一个特殊符号
Value-Map 怎么处理空值和 NULL
当输入字段为 xsi:nil="true" 或空字符串（""）时，Value-Map 的行为取决于是否显式定义了对应映射行：
- 空字符串
""：仅当表格中存在一行Source Value为空（即该单元格完全空白）时才会匹配；否则不匹配任何行，最终输出为NULL（或目标字段的默认空值） -
xsi:nil="true"：一律不匹配任何行，输出为NULL；无法通过添加空行捕获 - 如果希望把 nil 和空字符串都映射为 "N/A"，必须手动添加两行：
— 第一行Source Value留空（对应""）
— 第二行填?（兜底其余情况，包括 nil）
与函数组合使用的典型错误
常见误操作是把 Value-Map 和 concat、upper 等函数串在一起却不注意执行顺序。例如想先转大写再查表，但错误地把 upper 的输出连到 Value-Map 的输入引脚，却忘了 Value-Map 本身不接受函数返回值作为配置参数——它的映射表是静态定义的，不能动态生成。
- 正确做法：用
upper函数处理原始字段 → 输出连给Value-Map的输入 →Value-Map查表输出 - 错误做法：试图在
Value-Map编辑窗口里写upper($input)当源值——语法不支持，保存会失败 - 性能提示：含上百行映射的
Value-Map在大数据量转换时可能成为瓶颈；若逻辑复杂（如需条件分支、范围判断），建议改用XSLT或外部脚本组件
实际项目里最容易卡住的地方，是空值处理和大小写默认敏感这两点——它们不会报编译错误，但运行时数据就悄悄变 NULL 或查不到，得盯着调试视图里每个节点的实时值才能发现。
