本技能用于在 Celigo 集成中编写映射与转换,即数据重塑层,控制一个系统字段如何翻译为另一系统字段。映射用于流、API 和工具中。
用途与体系:共有四类重塑系统。Mapper 2.0 用于导入的现代递归字段映射(mappings[] 数组),支持任意深度嵌套对象与数组、查找、条件与日期转换,是除 NetSuite 和 Salesforce 外新导入的默认项。Mapper 1.0 是 NetSuite 和 Salesforce 导入的旧式扁平映射(mapping.fields[] / mapping.lists[]),许多旧版 HTTP/FTP/RDBMS 导入也在用。Transformation 2.0 用于导出的规则式重塑(transform.expression.rulesTwoDotZero),分 create(全新构建)与 modify(改字段,未映射字段透传)两种模式。响应映射用 Transformation 1.0 的 extract/generate 对,把查找或导入响应回填到记录,位于流的 pageProcessors[]。查找表为静态键值或 LookupCache 引用,NetSuite 导入使用查询实时记录的独立查找系统。
用法要点:编辑既有资源前先检查其用 mappings[] 还是 mapping.fields[],切勿混用。每个映射需 generate、dataType、extract 三属性;extract 支持 JSON 路径($., 始终从根引用)、Handlebars({{ }})与硬编码三种写法。对象用 dataType: "object" 加子 mappings,数组需配 buildArrayHelper,日期需设 extractDateFormat/generateDateFormat。输入上下文可选 record 或 envelope。更新映射遵循 GET→修改→PUT 整个资源。
限制:generate 不可用点号表示法;每条映射需 status: "Active",否则 API 拒绝;仅在请求上下文等必要场景添加转换,避免无意义的恒等转换。