主题
更新申请
用于更新申请的字段内容,如申请节点、申请状态等;
接口说明
请求URL:http[s]://{网关地址}/casp-tdc/processInstance/modify
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 第三方申请ID | processInstanceId | M | String(64) | 申请业务主键, 由第三方提供 |
| processors | *M | List<Processor> | 当前节点待处理人列表 | |
| 当前节点名称 | nodeName | *M | String(40) | 当前节点名称 |
| 当前节点id | nodeId | O | String(50) | 当前节点id |
| 申请状态 | processInstanceStatus | M | String | RUNNING(正常运行) COMPLETE(正常结束) ABORT(强行中止) REPLY(待重新提交) |
| 流程图地址 | processInstanceImgUrl | O | String(512) | 流程图地址 |
| 流程记录地址 | processInstanceRecordUrl | O | String(512) | 流程记录地址 |
| 流程结束时间 | processInstanceEndTime | O | String | yyyy-MM-dd HH:mm:ss |
| 服务id | serviceId | O | String(128) | 服务id |
| 服务名称 | serviceName | O | String(300) | 服务名称 |
| subjectMultiLangs | O | List<MultiLang> | 申请主题多语言 |
提示
当processInstanceStatus 为RUNNING时,processors和nodeName为必填;
当processInstanceStatus 为COMPLETE时,processors和nodeName会被清空;
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
{
"processInstanceId":"PIIDEXP0",
"processInstanceStatus":"ABORT",
"nodeName":667,
"processors":[
{
"processorType":1,
"processorId":"user-01"
}
],
"subjectMultiLangs":[
{
"langCountry": "en",
"langValue" : "en-subject"
}
]
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
响应说明
响应体
| 字段名 | 参数名 | 类型 | 描述 |
|---|---|---|---|
| 返回码 | 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);
// 创建请求对象
ProcessInstanceModifyRequest request = new ProcessInstanceModifyRequest();
request.setProcessInstanceId("xxx");
request.setProcessInstanceStatus(ProcessInstanceStatusType.RUNNING);
request.setNodeId("002");
request.setNodeName("002");
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
14
2
3
4
5
6
7
8
9
10
11
12
13
14

