更新待办任务状态

用于更新任务处理人的处理状态；

接口说明

请求URL：http[s]://{网关地址}/casp-tdc/task/modify

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
第三方任务ID	taskId	M	String(64)	任务业务主键，由第三方提供
处理人ID	processorId	M	String(50)	处理人ID
处理人类型	processorType	O	integer	1：学工号
用户范围类型	objectScope	O	integer	1：校内用户（默认） 2：校外用户
任务状态	status	M	String	ACTIVE(激活) COMPLETE（完成） ROLLBACK（退回） WITHDRAW(撤回) TRANSFER(移交) DELEGATE(委派) ABORT(终止)
流程图地址	processInstanceImgUrl	O	String(512)	流程图地址
流程记录地址	processInstanceRecordUrl	O	String(512)	流程记录地址
更新时间 3.5.5.Beta1+	updateTime	O	String	更新时间（yyyy-MM-dd HH:mm:ss)
处理意见	taskComment	O	String(1000)	处理意见
pc已办任务地址	donePcUrl	O	String(512)	pc已办任务地址。如果第三方待办和已办地址不同，需要传入
h5已办任务地址	doneH5Url	O	String(512)	h5已办任务地址。如果第三方待办和已办地址不同，需要传入
推送终端 3.5.2+	terminalType	O	String	0：不推送” 1：钉钉” 2：weLink ” （逗号隔开） 默认：1,2

注：只有当status不是ACTIVE时才会推送weLink，且weLink只支持修改状态，不支持修改地址等其他信息。会签时会等到所有人都处理完成后一起修改weLink中的待办状态。

请求示例

{
    "taskId":"taskExp01",
    "processorId":"test-gh",
    "status":"ACTIVE"
}

响应说明

响应体

参数名	类型	描述
errcode	string	返回码
errmsg	string	返回描述

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "traceId": null
}

错误码

错误码	描述
371002	参数异常（详细描述信息参见接口返回）
376999	系统异常，详细描述信息参见接口返回
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
TaskModifyRequest request = new TaskModifyRequest();
request.setTaskId("20240716");
request.setProcessorId("user01");
request.setProcessorType(ProcessorType.USER_ACCOUNT);
request.setTaskComment("同意");
request.setStatus(TaskStatusType.COMPLETE);
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}