Skip to main content

流程属性设置

在流程设计器头部点击「流程属性设置」，统一配置审批页面、终态回调接口、通知模板、审批功能开关与操作文案。

概述​

「流程属性设置」是审批流的全局配置，作用于整条审批流的所有节点，与单个节点的属性相互独立。它在流程设计器标题栏的按钮中打开，配置内容保存到审批流主对象 MetaWorkflow 及其 Properties 字段，而不是流程图版本中。因此修改全局属性不会产生新版本，也无需重新发布。

全局配置分为以下几组：

分组作用
选择审批页面指定审批详情页面，用于在待办通知中跳转
自定义接口设置审批到达终态（同意 / 不同意 / 撤回 / 驳回）后回调用
消息模板设置审批最终结果通知发起人使用的消息模板
审批功能开关控制重新发起、审批意见必填等行为
自定义操作文案自定义审批按钮的显示文案

配置项​

配置项必填说明
选择审批页面是审批详情页面，待办通知会附带该页面链接
自定义最终同意后触发的接口否审批最终结果为同意时调用
自定义最终不同意后触发的接口否审批最终结果为不同意时调用
自定义撤回后触发的接口否发起人撤回后调用
自定义驳回后触发的接口否驳回后调用
自定义最终同意后的通知消息模板否通知发起人审批通过；留空使用系统默认模板
自定义最终不同意后的通知消息模板否通知发起人审批未通过；留空使用系统默认模板
同意后可重新发起否开关，默认关闭
拒绝后可重新发起否开关，默认关闭
同意时必须填写意见否开关，默认关闭
拒绝时必须填写意见否开关，默认关闭
驳回时必须填写意见否开关，默认关闭
同意按钮显示文案否留空使用系统默认文案
拒绝按钮显示文案否留空使用系统默认文案
驳回按钮显示文案否留空使用系统默认文案

自定义接口设置​

审批到达终态时，会按最终结果回调对应的自定义接口：

  • 最终同意：整条流程最终通过时触发；
  • 最终不同意：整条流程被拒绝时触发；
  • 撤回：发起人撤回审批时触发；
  • 驳回：审批被驳回时触发。

可选项仅包含标签为「功能」的接口，点击设置项旁的跳转图标可直接打开接口编辑器。

覆盖默认处理

如需自定义更复杂的业务逻辑，可在接口管理中自定义接口，并在这里选择它以覆盖默认处理逻辑。接口调用时会附带审批上下文参数（流程实例、业务数据、当前节点等），详见 审批节点 的接口调用说明。

审批功能开关​

开关打开后的效果
同意后可重新发起审批通过后允许再次发起该数据的审批
拒绝后可重新发起审批拒绝后允许再次发起该数据的审批
同意时必须填写意见审批人点击同意时审批意见必填
拒绝时必须填写意见审批人点击拒绝时审批意见必填
驳回时必须填写意见审批人点击驳回时审批意见必填

属性明细​

以下内容面向技术实现与知识库检索，说明全局属性的属性名、类型、含义与存储格式。

审批页面​

属性名类型含义取值/存储值
MetaPageIdstring审批详情页面 ID页面 ID；存储在 MetaWorkflow 主表的独立字段，非 Properties

自定义接口（位于 Properties）​

属性名类型含义取值/存储值
AgreeInterfaceIdstring最终同意后调用的接口 ID接口 ID
DisagreeInterfaceIdstring最终不同意后调用的接口 ID接口 ID
RevokeInterfaceIdstring撤回后调用的接口 ID接口 ID
ReturnInterfaceIdstring驳回后调用的接口 ID接口 ID

消息模板（位于 Properties）​

属性名类型含义取值/存储值
AgreeMessageTemplateIdstring最终同意后通知发起人的消息模板 ID留空使用系统默认模板
DisagreeMessageTemplateIdstring最终不同意后通知发起人的消息模板 ID留空使用系统默认模板

功能开关与文案（位于 Properties）​

属性名类型含义取值/存储值
CanBeRelaunchedIfAgreedbool同意后是否可重新发起true / false
CanBeRelaunchedIfRejectedbool拒绝后是否可重新发起true / false
OpinionRequiredWhenAgreebool同意时审批意见是否必填true / false
OpinionRequiredWhenDisagreebool拒绝时审批意见是否必填true / false
OpinionRequiredWhenReturnbool驳回时审批意见是否必填true / false
AgreeButtonDisplayTextstring同意按钮显示文案留空使用系统默认文案
DisagreeButtonDisplayTextstring拒绝按钮显示文案留空使用系统默认文案
ReturnButtonDisplayTextstring驳回按钮显示文案留空使用系统默认文案

存储示例​

MetaPageId 存储在 system_metaworkflow 主表；Properties 以 JSON 序列化后存储在同表的扩展列。

{
  "_id": "3f5a1c2d-8b77-4d21-9e10-6a2f0c4b7d33",
  "MetaObjectId": "b21c9e77-0a11-4f30-8c55-1e7a9d2f6b40",
  "Name": "合同审批",
  "Title": "合同审批流程",
  "MetaPageId": "7c2d4e51-33aa-4b6c-9f08-2d5e6a1b3c99",
  "Status": 1,
  "Version": "0e9d2b71-5c44-4a88-b3f6-8d1e7c2a5b60",
  "Properties": {
    "AgreeInterfaceId": null,
    "DisagreeInterfaceId": null,
    "RevokeInterfaceId": null,
    "ReturnInterfaceId": null,
    "AgreeMessageTemplateId": null,
    "DisagreeMessageTemplateId": null,
    "CanBeRelaunchedIfAgreed": false,
    "CanBeRelaunchedIfRejected": true,
    "OpinionRequiredWhenAgree": false,
    "OpinionRequiredWhenDisagree": true,
    "OpinionRequiredWhenReturn": false,
    "AgreeButtonDisplayText": null,
    "DisagreeButtonDisplayText": null,
    "ReturnButtonDisplayText": null
  }
}

终态回调逻辑​

流程到达终态或发生撤回 / 驳回时，引擎按状态选择回调接口并发送通知：

场景回调接口通知模板
最终同意Properties.AgreeInterfaceIdProperties.AgreeMessageTemplateId，留空使用系统默认结果模板
最终不同意Properties.DisagreeInterfaceIdProperties.DisagreeMessageTemplateId，留空使用系统默认结果模板
驳回Properties.ReturnInterfaceId由节点级「驳回时的通知消息模板」控制
撤回Properties.RevokeInterfaceId由节点级配置控制

下一步​