纷享销客开发者手册

简体中文

English

审批内容区增强

约 748 字大约 2 分钟

2026-04-16

在审批详情页中，「审批内容」区域用于展示本次审批内容实例名称、审批操作内容、字段变更、从对象变更等。当默认展示无法满足业务诉求时，可通过审批详情插件对该区域做增强。

典型场景例如：

  • 渲染后自定义实例名称、操作说明、字段/从对象变更区块的展示方式
  • 渲染前在移动端挂载自定义组件，替换或扩展审批内容卡片区域
  • 需要触发「查看编辑记录」「查看从对象变更记录」等联动行为

适用场景

适用于「审批内容区需要定制布局、补充说明或与业务数据强关联的展示」；

适用页面

  • 审批详情页中的审批内容区

什么时候适合做审批内容区增强

  • 需要改写审批内容标题、操作信息、字段变更、从对象变更等模块的呈现
  • 移动端需要在内容渲染前注入自定义组件（含对象详情页审批卡片等场景）
  • 需要在内容渲染完成后基于 getContentData / 控制参数做二次加工

开发思路

  1. 区分 Web「渲染之后」与移动端「渲染之前」两类接入点，避免混用能力假设
  2. 在审批详情插件中注册事件 / Hook，按参考手册使用 api 或返回结构完成定制
  3. 发布后在线上流程中验证不同对象、不同从对象数据量下的表现

开发流程

  1. 明确终端与时机

    • Web：内容区渲染之后（approval.content.render.after）
    • 移动端：内容区渲染之前（flow.approval.detail.approval.content.render.before）

  2. 创建审批详情插件

    在后台创建 审批详情 类插件（Web / 移动端按实际终端选择），与 Web端审批详情插件说明或移动端审批详情插件说明文档对齐。

  3. 选择事件或 Hook 并编写逻辑

    Web 端：在插件 apply 中注册事件 approval.content.render.after，在回调内使用文档提供的 api 方法（如 getContentData、setTitle、setFieldChange 等）。

    移动端：注册 Hook flow.approval.detail.approval.content.render.before，配置 customComponent（文档拼写以参考手册为准）及 objectDetailCardEnable 等参数。

  4. 联调与验证

    • 覆盖有/无从对象、多字段变更、按钮触发配置表单等分支
    • 对照参考手册核对数据获取、样式定制与返回值

  5. 发布与上线

    开发完成后发布插件，在对应审批详情场景中启用，并在真实流程任务上回归审批内容区展示。

推荐入口

Web 端

下一步