值转换规则（候选键映射）
1 简介
1.1 功能介绍
候选键映射是根据已配置的集成方案中候选键关系，自动映射目标输出值的一种值转换规则类型；数据集成方案中需要映射的值可以通过现有的其他方案映射出目标输出值。
1.2 应用场景
使用候选键映射类型的值转换规则时，要求所依赖的方案已经执行过，并且源和目标系统都已经存在对应的基础数据。
例如收款信息依赖方案“行名行号同步”，那“行名行号同步”方案需要先执行，使得两个系统都存在对应的行名行号信息，并且建立了映射关系。
优势：当需要映射的基础数据量很大时，采用人工映射不仅耗费时间也耗费空间。而使用自动映射就可以充分利用现有方案中的映射关系，节省时间和空间，不需要通过人工映射重新同步两个系统的全量基础数据然后再匹配。
1.3 系统路径
【集成管理】→【数据集成】→【值转换规则】
1.4 字段/按钮说明
字段说明：
| 字段名称 | 详细解释 |
| 规则类型 | 选择规则类型为“候选键映射” |
| 数据集成方案 | 映射时使用该数据集成方案中的候选键映射关系 |
| 源对象 | 需要转换的源对象 |
| 目标对象 | 需要转换的目标对象 |
| 编码 | 规则编码，可自动生成 |
| 名称 | 规则名称，可自动生成 |
| 默认值 | 当找不到对应的映射数据时取当前设置的默认值 |
| 映射类型 | 根据所选对象自动生成 |
| 取值属性 | 取目标对象属性，候选键映射默认取值属性为ID |
| 缓存转换结果 | 缓存转换结果，从而提高转换效率 |
| 目标值不存在时执行数据集成 | 当根据参数值找不到目标值时，以参数值作为集成方案源对象的主键值自动执行数据集成，结果单的ID作为本次转换的目标值。 |
| 数据集成启动方案 | 如果设置了数据集成启动方案，当值转换结果为空时，则系统自动执行此方案将源对象数据同步到目标系统，然后再次执行值转换规则。注意：该设置通常仅适用于系统间基础资料的ID转换。 |
按钮说明：
| 按钮名称 | 详细解释 |
| 保存 | 保存值转换规则 |
| 测试 | 测试值转换规则 |
| 缓存结果 | 缓存值转换结果，从而提高转换效率 |
| 关联查询 | 查询值转换规则所关联的集成方案、服务流程 |
| 历史版本 | 查看历史版本 |
2 主要操作
2.1 新增候选键映射
步骤1：进入值转换规则列表，点击“新增”按钮，规则类型选择“候选键映射”；
步骤2：选择一个数据集成方案，复用其候选键映射关系；
步骤3：选择和输入相关内容后保存。
步骤4：在编辑/查看页面，点击“测试”按钮，可以输入源对象的值，验证转换结果
2.2 目标值不存在时执行数据集成
步骤1：开启“目标值不存在时执行数据集成”开关；
Tips：当根据某输入参数值找不到对应的目标值时，系统将以参数值作为集成方案源对象的主键值自动执行数据集成，结果单的ID作为本次转换的目标值。
步骤2：选择数据集成启动方案。
Tips: 当值转换结果为空时，自动执行数据集成启动方案将源对象数据同步至目标系统，然后再次执行值转换规则。注意：该设置通常仅适用于系统间的基础资料ID转换。
示例说明：在“计量单位组-计量单位分组(星空-苍穹)”值转换规则中，开启“目标值不存在时执行数据集成”开关，数据集成启动方案选择“预置_计量单位分组(星空-苍穹)_3”。
在此示例中，需要根据星空计量单位分组映射转换为苍穹计量单位分组。在使用该候选键映射规则时，首先需要两个系统都已经存在基础数据值。所以当目标苍穹没有对应的基础数据时，就可以先自动执行数据集成启动方案（此处是“预置_计量单位分组(星空-苍穹)_3”），进行基础数据同步，然后再正确地进行数值映射。
值转换异常分析请点击下面链接：
值转换规则（候选键映射）
本文2024-09-23 00:49:37发表“云苍穹知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-cangqiong-141989.html
