新建与编辑对象变更规则

配置对象变更的生效机制、校验条件、可变更字段范围及历史值记录规则。

概述

💡 开启对象变更功能后，管理员需要通过配置变更规则来确定哪些字段允许修改、是否记录修改前的原值、何时将修改后的数据回填到原单中，以及前台发起变更时需要满足哪些前置条件。

开始之前

IMPORTANT

• 角色权限：您必须拥有系统管理员权限。
• 前置条件：目标业务对象（如合同）已成功开启对象变更功能。

配置步骤

第一步：进入规则设置页面

1. 前往 管理后台 > 对象管理 > 对象变更管理。
2. 找到已开启变更的目标对象，在操作列中点击 规则设置。

第二步：配置基本信息

在 基本信息 区域中，配置以下参数：

• 名称：输入变更规则的描述性名称。
• 生效时机：指定变更单通过审批后，内容回填至源单的时间点：
  • 审核后自动生效：变更单审批通过后，系统自动将数据回填至源单。
  • 人工生效：审批通过后，需要用户在变更单详情页中手动点击 生效 按钮才能回填。
• 校验时机：指定系统对变更单数据执行规则校验的时间点：
  • 提交：用户在前台提交变更单审批时执行校验。
  • 生效：变更单执行回填生效时（如点击 生效 按钮时）执行校验。

第三步：设置校验条件

在 校验条件 区域中，设定数据回填时必须满足的条件：

• 可使用当前对象和查找关联对象下的字段构建过滤条件。
• 支持业务侧预设的特殊校验逻辑，用于防止不合规的变更数据写入源单。

第四步：设置变更条件

在 变更条件 区域中，设定允许用户在前台发起变更的前提条件：

• 简单条件：通过直接配置字段值过滤条件进行校验。
• 复杂条件：通过编写 APL 函数进行高级逻辑判断。如果源单数据不符合此处的变更条件，前台用户点击 变更 按钮时系统将拦截并弹出提示。

第五步：核对业务类型映射

在 业务类型映射 区域中，查看源单与变更单的业务类型映射关系：

• 此映射关系默认由系统自动生成，暂时为不可编辑状态。
• 如果存在从对象（明细表），需在此处同时展示并核对从对象的业务类型映射。

第六步：配置可变更字段与原值记录

在 字段配置 列表中，针对每一个字段设置其控制属性：

• 可变更：勾选后，前台用户创建和编辑变更单时，该字段才处于可编辑状态。
• 记录原值：勾选后，系统会自动创建对应的原值字段，并在回填生效时，将变更前的值记录下来，用于展示新旧值对比。

CAUTION

1. 如果一个字段配置为 可变更 但 不记录原值，那么执行变更生效后，原单上的旧值会被新值直接覆盖，且无法比对差异。
2. 自增编码、引用字段、签到组件、支付组件、签名字段以及系统只读字段（如统计字段、计算字段等）不支持字段的可变更与记录原值配置。

同步源对象字段配置

当您在源对象（如合同）上新增、删除或修改字段属性后，系统会自动将变更同步至对应的变更单对象。

• 若由于网络或系统原因自动同步失败，请在变更规则设置页面右上角点击 同步 按钮执行手动同步。

对象属性变更的影响规则

在源对象或关联对象发生启用、禁用、删除等变更时，对应的变更规则和映射关系将受到如下影响：

映射类型	前提关系	执行操作	系统影响
普通映射	A 主对象 变更 B 主对象	源对象删除	映射规则被系统同步删除。
		目标对象删除	映射规则被系统同步删除。
		源对象或目标对象禁用	1. 禁用对象时自动禁用对应的映射规则； 2. 重新启用对象时，映射规则不会自动启用； 3. 无法手动启用规则，会提示“对象已经禁用”； 4. 可以删除映射规则； 5. 点击 下一步 无反应且无提示信息。
主从映射	A 主对象 变更 B 主对象； a1 从对象 变更 b1 从对象； a2 从对象 变更 b2 从对象。	源从对象部分禁用：禁用 a1 从对象	1. 映射规则仍可编辑； 2. 进入编辑页面时会提示“请选择源对象”，原“a1从 变更 b1从”的对应位置显示为空； 3. 可以点击 下一步 保存规则，保存后该条从对象映射关系自动删除。
		目标对象部分禁用：禁用 b1 从对象	1. 映射规则仍可编辑； 2. 编辑页面展示“a1从 变更 b1从”，但目标对象 b1 显示为空； 3. 可以点击 下一步 保存规则，保存后该条从对象映射关系自动删除。
		源从对象全部禁用：同时禁用 a1 和 a2 从对象	1. 映射规则仍可编辑； 2. 编辑页面不显示原来的从对象映射规则； 3. 无法点击 下一步 保存规则。
		目标从对象全部禁用：同时禁用 b1 和 b2 从对象	1. 映射规则仍可编辑； 2. 编辑页面展示从对象规则，但目标对象为空； 3. 无法点击 下一步 保存规则。
		删除从映射中的源或目标从对象	1. 映射规则仍可编辑； 2. 编辑页面不显示原来的从对象映射规则； 3. 可以点击 下一步 保存规则。

相关主题

• 开启对象变更
• 如何使用对象变更功能