Fx.approval:审批相关的函数
1、查询对象上的审批实例-findInstances
Fx.approval.findInstances(String objectApiName, List<String> state, String dataId, int limit, int skip);
参数 | 说明 |
---|---|
objectApiName | 对象的apiName |
state | 实例状态,传list,空list表示全部状态,目前支持的实例状态:in_progress(进行中), pass(通过), cancel(取消), error(异常), reject(拒绝) |
dataId | 业务数据Id,可选,不传则返回该对象下所有正在审批的实例 |
limit | 限制查询条数,最大100条 |
skip | 跳过多少条初始数据 |
返回值类型:QueryResult,返回审批相关的字段包括:
审批流程id(instanceId)
审批流APIName(approvalName)
数据Id(dataId))
审批开始时间(startTime)
审批结束时间(endTime)
代码例:
def retData = Fx.approval.findInstances("object_pjy2L__c", ["in_progress"], "5e9858f5865dbc000155dd87", 10, 0) log.info(retData)
2、查询审批实例的所有任务节点-findTasks
Fx.approval.findTasks(String instanceId);
参数 | 说明 |
---|---|
instanceId | 审批实例Id |
返回值类型:审批任务List,返回审批任务相关的字段包括:
审批任务Id(taskId),
dataId(业务数据Id),
objectName(业务对象的API名称)
创建时间(createTime),
耗时(duration),*毫秒
审批人Id(approverId)(可能多个),
任务类型(task_type),
审批结果(result),
审批意见(comment)
代码例:
def ret = Fx.approval.findTasks("5fa89df8f791130001557774") log.info(ret)
3、撤回审批-cancelApproval
Fx.approval.cancelApproval(String objectApiName, String dataId, String comment);
参数 | 说明 |
---|---|
objectApiName | 对象的apiName |
dataId | 业务数据Id |
comment | 审批意见 |
返回值类型:操作成功的数据Id
代码例:
def ret = Fx.approval.cancelApproval("object_pjy2L__c", "5e9858f5865dbc000155dd87", "取消") log.info(ret)
4、对审批任务节点进行操作-approvalAction
Fx.approval.approvalAction(String taskId, String actionType, String comment, String userId);
参数 | 说明 |
---|---|
taskId | 审批任务节点Id |
actionType | 操作类型,支持的类型有agree(同意), reject(拒绝) |
comment | 审批意见 |
userId | 审批人Id |
返回值类型:taskId : 操作成功的taskId
代码例:
def ret = Fx.approval.approvalAction("5fa89df8f791130001557775", "agree", "同意", "1027") log.info(ret)
5、更换审批任务节点的审批人-setApprovalIds
Fx.approval.setApprovalIds(String taskId, List<String> userList);
参数 | 说明 |
---|---|
taskId | 审批任务节点Id |
userList | 审批人列表 |
返回值类型:无
代码例:
def ret = Fx.approval.setApprovalIds("5fa8a1c2f791130001557776", ["1007", "1017"]) log.info(ret)