简体中文
对象详情页实例区域
约 469 字大约 2 分钟
2026-05-08
改写新版实例卡片当前阶段的任务列表,或插入实例级自定义组件。
适用场景
适用于 移动端。
功能描述
在业务流详情页的实例卡片渲染之前,允许修改阶段任务列表或插入实例级自定义组件。
典型场景示例
- 场景 1:任务筛选
例如:只显示进行中的任务 - 场景 2:任务排序调整
例如:按创建时间倒序排列 - 场景 3:插入实例级组件
例如:在实例卡片顶部显示任务统计信息
适用场景
- 需要根据条件筛选或排序阶段内的任务
- 需要在实例卡片区域插入自定义组件
适用页面
- 对象详情页-实例卡片区域
开发思路
功能增强通常可以拆成三步理解:
明确要增强的是哪一个环节
- 确定是要筛选任务、排序任务还是插入组件
选择合适的扩展事件/钩子
- 移动端:
flow.bpm.detailcard.instancecard.render.before
- 移动端:
在插件中接入扩展点并验证行为
- 获取阶段信息
- 执行业务逻辑(筛选、排序或计算统计)
开发流程
- 明确修改需求
- 确定是要筛选任务、排序任务还是插入组件
- 编写增强逻辑
module.exports = function (context, pluginService, pluginParam) { return { apply() { return [{ event: "flow.bpm.detailcard.instancecard.render.before", functional: async function (context, options) { let allTasks = options && options.allTasks; return Promise.resolve({ customComponten: {} }); } }]; } }; }; - 配置插件
- 在流程高级配置中关联插件
推荐入口
注意事项
- 阶段上下文:操作时需要考虑当前阶段的上下文
- 组件定位:插入的组件会在实例卡片区域渲染
- 数据完整性:修改任务列表时要确保数据完整性
