待办补偿 3.3.1.Beta2+

用于业务系统将一段时间内容的待办任务推送至待办中心，由待办中心比对通过该接口推送的数据，是否一致，若否则进行数据补偿；

接口说明

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

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
开始时间	startTime	M	String	开始时间(yyyy-MM-dd HH:mm:ss)
结束时间	endTime	M	String	结束时间(yyyy-MM-dd HH:mm:ss)
本页条数	pageSize	M	integer	本页条数
当前页码	currentPage	M	integer	当前页码
总条数	totalSize	M	integer	总条数
数据	data	M	List<TaskReq>	数据

TaskReq

字段名	参数名称	必填	类型	描述
业务场景编码	sceneCode	M	String(128)	业务场景编码，由英文、数字、下划线组成
第三方任务ID	taskId	M	String(64)	任务业务主键，由第三方提供。业务系统唯一，可使用英文、数字、下划线组成，长度小于64位
任务主题	subject	M	String(300)	任务主题
紧急程度	priority	M	integer	1:特急 2:紧急 3:一般
任务类型	taskType	M	integer	1：待阅 2：分发 3：普通 4：内部待阅3.7.3.Beta1+ 5：内部分发3.7.3.Beta1+
发起人类型	initiatorType	M	integer	1：学工号
发起人ID	initiatorId	M	String(50)	当initiatorType=1，传学工号
处理类型	processType	O	integer	1:只需要一个人处理（默认） 2:所有人都需处理
pc待办任务地址	pcViewUrl	O	String(512)	pc待办任务地址
h5待办任务地址	h5ViewUrl	O	String(512)	h5待办任务地址
流程图地址	processInstanceImgUrl	O	String(512)	流程图地址
流程记录地址	processInstanceRecordUrl	O	String(512)	流程记录地址
任务状态	status	M	String	ACTIVE(激活) COMPLETE（完成） ROLLBACK（退回） WITHDRAW(撤回) TRANSFER(移交) DELEGATE(委派) ABORT(终止)
过期时间	expireTime	O	String	过期时间(yyyy-MM-dd HH:mm:ss)
更新时间	updateTime	M	String	更新时间(yyyy-MM-dd HH:mm:ss)
是否删除	isDeleted	M	integer	0：未删除 1：删除
处理人列表	processors	M	List<Processor>	处理人列表

Processor(返回)

字段名	参数名	必填	类型	描述
处理人类型	processorType	M	integer	1：学工号
处理人ID	processorId	M	String(50)	当processorType=1，传学工号
用户范围类型	objectScope	O	integer	1：校内用户（默认） 2：校外用户

请求示例

{
    "startTime":"2020-01-01 12:00:00",
    "endTime":"2023-01-01 12:00:00",
    "pageSize":100,
    "currentPage":1,
    "totalSize":1,
    "data":[{
        "sceneCode":"expCode1",
        "taskId":"taskId1",
        "subject":"subj01",
        "priority":1,
        "processType":1,
        "taskType":1,
        "initiatorType":1,
        "initiatorId":"wiseduUser",
        "pcViewUrl":"www.wiseduUrl.pc.com",
        "h5ViewUrl ":"www.wiseduUrl.h5.com",
        "status":"RUNNING",
        "expireTime":"2023-01-01 12:00:00",
        "updateTime":"2023-01-01 12:00:00",
        "isDeleted":0,
        "processors":[
            {
                "processorType":1,
                "processorId":"wiseduUserId"
            }
        ]
    }]
}

响应说明

响应体

参数名	类型	描述
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);
// 创建请求对象
TaskCompensateRequest request = new TaskCompensateRequest();
request.setCurrentPage(1);
request.setPageSize(1);
request.setTotalSize(2);
request.setStartTime("2024-07-01 00:00:00");
request.setEndTime("2024-07-02 00:00:00");
TaskCompensateRequest.TaskReq taskReq = new TaskCompensateRequest.TaskReq();
taskReq.setTaskId("2024071701");
taskReq.setSceneCode("scene001");
taskReq.setInitiatorId("user01");
taskReq.setInitiatorType(ProcessorTypeEnum.USER_ACCOUNT);
taskReq.setSubject("test主题");
taskReq.setPriority(PriorityEnum.COMMON);
taskReq.setTaskType(TaskTypeEnum.COMMON);
taskReq.setStatus(TaskStatusEnum.ACTIVE);
taskReq.setUpdateTime("2024-07-01 12:03:44");
taskReq.setIsDeleted(YNEnum.N);
taskReq.setProcessors(Collections.singletonList(new Processor("user02")));
request.setData(Collections.singletonList(taskReq));

BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}