自定义业务流任务卡片上的操作按钮。

功能描述

在任务卡片按钮渲染之前，自定义外露按钮、更多按钮和异常状态下的按钮，包括按钮名称、顺序和显隐控制。

典型场景示例

• 场景 1：审批节点自定义同意/驳回按钮
  例如：修改"同意"按钮文案为"通过并发送通知"
• 场景 2：根据处理人隐藏按钮
  例如：当前用户不是处理人时隐藏所有操作按钮
• 场景 3：异常任务特殊按钮处理
  例如：异常状态下显示"重试"和"忽略"两个自定义按钮

适用场景

• 需要精细控制卡片级按钮的展示和交互
• 需要处理不同任务类型或状态下的按钮展示
• 需要根据用户权限控制按钮显隐

适用页面

• 对象详情页-任务卡片区域

开发思路

功能增强通常可以拆成三步理解：

1. 明确要增强的是哪一个环节

   • 确定是要修改按钮文案、调整按钮顺序，还是控制按钮显隐
   • 识别需要自定义的按钮类型（外露/更多/异常）

2. 选择合适的扩展事件/钩子

   • 移动端：flow.bpm.detailcard.item.bottombtn.render.before
   • Web 端：bpm.detailCard.render.before

3. 在插件中接入扩展点并验证行为

   • 获取当前任务下的按钮数据
   • 根据 taskId、state 等条件筛选目标按钮并修改

开发流程

1. 确定按钮范围
   • 识别需要自定义的按钮类型（外露/更多/异常）
   • 明确修改的具体字段
2. 选择事件
   • 移动端：flow.bpm.detailcard.item.bottombtn.render.before
   • Web 端：bpm.detailCard.render.before
3. 编写自定义逻辑
   • 根据特殊需求进行逻辑定制
4. 配置到流程
   • 在自定义插件配置中选择对应插件

推荐入口

移动端

• flow.bpm.detailcard.item.bottombtn.render.before

Web 端

• bpm.detailCard.render.before

注意事项

1. 不要新增按钮：只可以在原有按钮的数据上进行删、改、换
2. 保持数据结构完整：必须保持原有数据结构完整
3. 权限影响：按钮的最终显隐还可能受权限和任务状态影响