Fx.approval:審批相關(guān)的函數(shù)
1、查詢對象上的審批實例-findInstances
Fx.approval.findInstances(String objectApiName, List<String> state, String dataId, int limit, int skip);
參數(shù) | 說明 |
---|---|
objectApiName | 對象的apiName |
state | 實例狀態(tài),傳list,空list表示全部狀態(tài),目前支持的實例狀態(tài):in_progress(進行中), pass(通過), cancel(取消), error(異常), reject(拒絕) |
dataId | 業(yè)務(wù)數(shù)據(jù)Id,可選,不傳則返回該對象下所有正在審批的實例 |
limit | 限制查詢條數(shù),最大100條 |
skip | 跳過多少條初始數(shù)據(jù) |
返回值類型:QueryResult,返回審批相關(guān)的字段包括:
審批流程id(instanceId)
審批流APIName(approvalName)
數(shù)據(jù)Id(dataId))
審批開始時間(startTime)
審批結(jié)束時間(endTime)
代碼例:
def retData = Fx.approval.findInstances("object_pjy2L__c", ["in_progress"], "5e9858f5865dbc000155dd87", 10, 0) log.info(retData)
2、查詢審批實例的所有任務(wù)節(jié)點-findTasks
Fx.approval.findTasks(String instanceId);
參數(shù) | 說明 |
---|---|
instanceId | 審批實例Id |
返回值類型:審批任務(wù)List,返回審批任務(wù)相關(guān)的字段包括:
審批任務(wù)Id(taskId),
dataId(業(yè)務(wù)數(shù)據(jù)Id),
objectName(業(yè)務(wù)對象的API名稱)
創(chuàng)建時間(createTime),
耗時(duration),*毫秒
審批人Id(approverId)(可能多個),
任務(wù)類型(task_type),
審批結(jié)果(result),
審批意見(comment)
代碼例:
def ret = Fx.approval.findTasks("5fa89df8f791130001557774") log.info(ret)
3、撤回審批-cancelApproval
Fx.approval.cancelApproval(String objectApiName, String dataId, String comment);
參數(shù) | 說明 |
---|---|
objectApiName | 對象的apiName |
dataId | 業(yè)務(wù)數(shù)據(jù)Id |
comment | 審批意見 |
返回值類型:操作成功的數(shù)據(jù)Id
代碼例:
def ret = Fx.approval.cancelApproval("object_pjy2L__c", "5e9858f5865dbc000155dd87", "取消") log.info(ret)
4、對審批任務(wù)節(jié)點進行操作-approvalAction
Fx.approval.approvalAction(String taskId, String actionType, String comment, String userId);
參數(shù) | 說明 |
---|---|
taskId | 審批任務(wù)節(jié)點Id |
actionType | 操作類型,支持的類型有agree(同意), reject(拒絕) |
comment | 審批意見 |
userId | 審批人Id |
返回值類型:taskId : 操作成功的taskId
代碼例:
def ret = Fx.approval.approvalAction("5fa89df8f791130001557775", "agree", "同意", "1027") log.info(ret)
5、更換審批任務(wù)節(jié)點的審批人-setApprovalIds
Fx.approval.setApprovalIds(String taskId, List<String> userList);
參數(shù) | 說明 |
---|---|
taskId | 審批任務(wù)節(jié)點Id |
userList | 審批人列表 |
返回值類型:無
代碼例:
def ret = Fx.approval.setApprovalIds("5fa8a1c2f791130001557776", ["1007", "1017"]) log.info(ret)