该事件用于业务流任务渲染之前执行额外的动作，包括但不限于以下功能： 1. 获取当前任务数据 2. 强制打开编辑内容弹窗/页面

参数

参数	说明	类型
getTaskData	获取任务数据（示例）	Function
forceShowEditForm	强制打开编辑内容弹窗/页面（示例）	Function
agreeOpinionRequired	同意意见是否必填（示例）	Function
rejectOpinionRequired	不同意意见是否必填（示例）	Function
customFormButtons	自定义流程布局/表单_二级操作按钮（示例）	Function

基础示例

一、getTaskData

功能描述

用于获取当前任务的数据。

参数

无

返回结果

参数	说明	类型
taskName	任务名称	String
taskId	任务ID	String
entityId	对象的apiName	String
objectId	对象ID	String
sourceWorkflowId	原始流程ID	String
workflowId	流程定义ID	String
workflowInstanceId	实例ID	String
action	操作	String

参数代码示例

无

代码示例

// getTaskData()
export default class Plugins{
    apply() {
        return [
            {
                event: 'bpm.process.render.before',
                functional: this.bpmProcessRenderBefore.bind(this)
            }
        ]
    }

    bpmProcessRenderBefore(api) {
        let taskData = api.getTaskData();
        console.log(taskData);
    }
}

二、forceShowEditForm

功能描述

产品现状

1. 如果编辑内容配置的是普通布局，在没有必填或必填已有数据的情况下，则不弹出编辑内容弹窗，直接完成任务
2. 如果编辑内容配置的是流程布局，在没有必填且没有从对象的情况下，则不弹出编辑内容弹窗，直接完成任务

若在配置此PWC插件，那么即使在上述两种情况下，依然会打开编辑内容弹窗 / 页面，进行字段编辑，从而完成任务 强制打开编辑内容弹窗/页面。

参数

无

返回结果

无

参数代码示例

无

代码示例

// forceShowEditForm()
export default class Plugins{
    apply() {
        return [
            {
                event: 'bpm.process.render.before',
                functional: this.bpmProcessRenderBefore.bind(this)
            }
        ]
    }

    bpmProcessRenderBefore(api) {
        api.forceShowEditForm();
    }
}

三、agreeOpinionRequired

功能描述

产品现状

1. 业务流审批节点目前不支持必填配置

若在配置此PWC插件，则在业务流审批节点，同意审批节点时，审批意见必填

参数

无

返回结果

无

参数代码示例

无

代码示例

// agreeOpinionRequired()
export default class Plugins{
    apply() {
        return [
            {
                event: 'bpm.process.render.before',
                functional: this.bpmProcessRenderBefore.bind(this)
            }
        ]
    }

    bpmProcessRenderBefore(api) {
        api.agreeOpinionRequired();
    }
}

四、rejectOpinionRequired

功能描述

产品现状

1. 业务流审批节点目前不支持必填配置

若在配置此PWC插件，则在业务流审批节点，不同意审批节点时，审批意见必填

参数

无

返回结果

无

参数代码示例

无

代码示例

// rejectOpinionRequired()
export default class Plugins{
    apply() {
        return [
            {
                event: 'bpm.process.render.before',
                functional: this.bpmProcessRenderBefore.bind(this)
            }
        ]
    }

    bpmProcessRenderBefore(api) {
        api.rejectOpinionRequired();
    }
}

五、customFormButtons

功能描述

自定义流程布局/表单_二级操作按钮命名、显隐及顺序

参数

参数	说明	类型
customFn	是一个方法。需要有入参和返回	Function

返回结果

无

参数代码示例

// 入参示例
function(btns){
    return btns.map(e => {
        return {
          action:e.action,
          label:'哈哈哈哈'+'滴滴答答'
        }
    })
}

代码示例

export default class Plugin {
    apply() {
        return [
            {
                event: 'bpm.process.render.before',
                functional: this.bpmProcessRenderBefore.bind(this)
            }
        ]
    }
    bpmProcessRenderBefore(api){
        api.customFormButtons((btns)=>{
          return btns.map(e => {
            return {
              action:e.action,
              label:'哈哈哈哈'+'滴滴答答'
            }
          })
        })
    }
}

使用说明

1. 按钮显示控制：只有返回数组中包含的按钮才会显示，未包含的按钮将被隐藏
2. 按钮顺序：返回数组中按钮的顺序决定了按钮在界面上的显示顺序
3. 自定义标签：通过 label 属性可以自定义按钮的显示文本，不提供则使用系统默认标签

注意

1. 入参中的按钮数组不包含"取消"操作按钮
2. 返回的按钮配置必须基于入参中的按钮进行定制
3. 如果某个按钮在返回数组中不存在，该按钮将被隐藏
4. 按钮的显示顺序完全由返回数组的顺序决定