主题
修改待办任务 3.4.1+
用于更新任务的字段内容,如任务名称、任务处理人等字段,不涉及状态变更;
接口说明
请求URL:http[s]://{网关地址}/casp-tdc/task/modifyInfo
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 第三方任务ID | taskId | M | string(64) | 任务业务主键,由第三方提供 |
| 业务场景编码 | sceneCode | O | string(128) | 业务场景编码;可通过查询业务场景进行获取 |
| 任务主题 | subject | O | string(300) | 任务主题 |
| 紧急程度 | priority | O | integer | 1:特急 2:紧急 3:一般 |
| 过期时间 | expireTime | O | String | 过期时间(yyyy-MM-dd HH:mm:ss) |
| pc待办任务地址 | pcViewUrl | O | String(512) | pc待办任务地址,点击后的跳转地址 |
| h5待办任务地址 | h5ViewUrl | O | String(512) | h5待办任务地址,点击后的跳转地址 |
| 流程图地址 | processInstanceImgUrl | O | String(512) | 流程图地址,用于门户查看流程图 |
| 流程记录地址 | processInstanceRecordUrl | O | String(512) | 流程记录地址 |
| processors | O | List<Processor> | 处理人列表 | |
| pc已办任务地址 3.5.2+ | donePcUrl | O | String(512) | pc已办任务地址,点击后的跳转地址 |
| h5已办任务地址 3.5.2+ | doneH5Url | O | String(512) | h5已办任务地址,点击后的跳转地址 |
| 推送终端 3.5.2+ | terminalType | O | String | 0:不推送 1:钉钉 2:weLink (逗号隔开) 默认: 1,2 |
| 3.5.5.Beta2+ | subjectMultiLangs | O | List<MultiLang> | 任务主题多语言 |
注:该接口不支持推送至weLink
Processor(返回)
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 处理人类型 | processorType | M | integer | 1:学工号(用户名) |
| 处理人ID | processorId | M | String(50) | 当processorType=1,传学工号(用户名) |
| 用户范围类型 | objectScope | O | integer | 1:校内用户(默认) 2:校外用户 |
MultiLang(返回)
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 多语言国家 | langCountry | M | String | zh_CN(简体中文,默认) en(英文) ru(俄文) |
| 多语言值 | langValue | O | String | 多语言值 |
请求示例
json
{
"sceneCode":"testCode1",
"taskId":"taskExp02",
"subject":"subj01",
"priority":2,
"expireTime":"2023-12-31 12:00:00",
"subjectMultiLangs":[
{
"langCountry" : "en",
"langValue" : "en-taskSub"
}
]
}1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
响应说明
响应体
| 字段名 | 参数名 | 类型 | 描述 |
|---|---|---|---|
| 返回码 | errcode | String | 返回码 |
| 返回描述 | errmsg | String | 返回描述 |
响应示例
json
{
"errcode": "0",
"errmsg": "success",
"traceId": null
}1
2
3
4
5
2
3
4
5
错误码
| 错误码 | 描述 |
|---|---|
| 371002 | 参数异常参数异常(详细描述信息参见接口返回) |
| 376999 | 系统异常,详细描述信息参见接口返回 |
| 999 | 统一错误码,详细描述信息参见接口返回 |
Demo
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
TaskModifyInfoRequest request = new TaskModifyInfoRequest();
request.setTaskId("xxx");
request.setSubject("test");
request.setPriority(PriorityEnum.COMMON);
request.setProcessors(Arrays.asList(new Processor("user01"), new Processor("user02")));
BaseResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13

