流程
[TOC]
# [附属]
> 状态说明
state: todo(待办) doing（在办）done(已办) monitor （监控）all(全部)
("CANCEL", "申请作废"),
("CANCELED", "确认作废"),
("REJECT", "驳回"),
("BACK", "退回"),
("WITHDRAW", "撤回"),
("ACTIVE", "进行中"),
("SUSPENDED", "已暂停"),
("COMPLETED", "已完成"),
("EXTERNALLY_TERMINATED", "外部终止"),
("INTERNALLY_TERMINATED", "内部终止"),
("TIMEOUT", "超时"),
("TRANSFER", "转派");
# [预警回复接口]
## 1. /flow/createOrder
### 1.1. 接口功能
> 创建工单
### 1.2. 请求方式
> post
### 1.3. 请求参数
|参数|必选|类型|说明|
|:----- |:-------|:-----|:-----|
|business_key|false|varchar|流程编码|
|_next_assignee|false|varchar|下一环节处理人|
|...|false|varchar|配置所有表单字段key:value|
|creator_id|false|varchar|创建人|
|creator_nm|false|varchar|创建人名字|
```
RequestBody：
{
"business_key":"HD201900003", // 流程编号，可为空，空时已bpm系统规则生成流程编号
"_next_assignee": "" // 下一环节处理人 为空时不限
… //配置的所有表单字段 key:value
"creator_id":"创建人ID",
"creator_nm":"创建人name"
}
```
## 2 /flow/list
### 2.1. 接口功能
> 工单列表
### 2.2. 请求方式
> post
### 2.3. 请求参数
|参数|必选|类型|说明|
|:----- |:-------|:-----|:-----|
|Token|true|varchar|绑定的用户信息 对于 extend_s4值|
|startTimeFrom|false|varchar|开始时间|
|startTimeTo|false|varchar|结束时间|
|state|true|varchar|状态|
|index|false|int|查询序列|
|size|false|int|查询页数大小|
|name|false|varchar|流程名称|
|categories|false|varchar|工单分类|
|businessKey|false|varchar|工单编号|
```请求体
RequestBody：
{
"Token":"119",
"state":"todo",
"index":1
}
```
```返回体
ResponseBody：
{
"status": 200,
"message": "SUCCESS",
"error": "",
"error_description": "",
"timestamp": 1584935278354,
"data": {
"total": 9,
"rows": [
{
"id": "03f9ba6f-591a-11ea-91ef-4aca71737411",
"processDefinitionName": "工作联络单", //流程名称
"processDefinitionKey": "enfi_gd", //流程关键字
"startTime": "", //开始时间
"endTime": "2020-02-27 12:32:18", //最后处理时间 结束时间
"state": "ACTIVE",//状态
"creator": null,
"businessKey": "BK2020000032",//工单编号
"variables": {
"taskDefKey": "Task_1tdp1nt",
"ywdzt": "退回测试2",/业务标题
"czpizhu": "ok", //批注
"creator_nm": "和达管理员", //创建人
"creator_gid": "241",
"field_1565867223923": "",
"changzpizhu": "通过", //厂长批注
"business_key": "BK2020000032",
"message": "牛士栋退回",
"jjcd$$text": "一般",
"fzbm": "G287",
"jjcd": "一般", //紧急程度
"nrzy": "",//摘要
"yystart": "finish", //运营部预处理
"creator_gnm": "软件管理", //创建部门
"fzbm$$text": "运营管理部", //发送处理部门
"creator_id": "5e4ccbe86e6814191c1a9ec7",
"_next_assignee": "",
"complete_nm": "牛士栋", //最后处理人
"_category": "gd",
"files__": "", //附件
"complete_id": "5d4a5f58e2532d22f4b234d2",
"definitionId": "enfi_gd:413:274a34c5-538d-11ea-8a23-4aca71737411"
},
"processInstanceId": "d55fc7e9-5919-11ea-9a09-4aca71737411",
"taskPersons": [
{
"node": "厂长审核",//节点名称
"handler": [
{
"userId": "119",
"userName": "张文",
"groupName": "孝感中设水务有限公司高管层"
}
]
}
]
}
]
}
}
```
## 3 /flow/history
### 3.1. 接口功能
> 任务历史
### 3.2. 请求方式
> post
### 3.3. 请求参数
|参数|必选|类型|说明|
|:----- |:-------|:-----|:-----|
|id|true|varchar|任务列表接口返回的processInstanceId|
```请求体
RequestBody：
{
"id":"ec67b8b0-6ccc-11ea-b556-4aca71737411"
}
```
```返回体
ResponseBody：
{
"status": 200,
"message": "SUCCESS",
"error": "",
"error_description": "",
"timestamp": 1584933044159,
"data": [
{
"name": "厂长审核",
"endTime": "2020-02-20 10:21:56",
"data": {
"complete_nm": "张文",
"complete_group": "孝感中设水务有限公司高管层",
"message": null,
"complete_id": "119",
"isRecover": null,
"isCancel": null,
"_next_assignee": "5d4a5f58e2532d22f4b234d2",
"type": "结束",
"creator_nm": null,
"creator_id": null,
"czpizhu": "finish"
}
},
{
"name": "工单派发",
"endTime": "2020-02-20 10:17:41",
"data": {
"complete_nm": "和达管理员",
"complete_group": null,
"message": null,
"complete_id": "5e4ccbe86e6814191c1a9ec7",
"isRecover": null,
"isCancel": null,
"_next_assignee": "119",
"type": "提交",
"creator_nm": "和达管理员",
"creator_id": "5e4ccbe86e6814191c1a9ec7",
"czpizhu": null
}
}
]
}
```
## 4 /flow/complete
### 4.1. 接口功能
> 任务流转
### 4.2. 请求方式
> post
### 4.3. 请求参数
|参数|必选|类型|说明|
|:----- |:-------|:-----|:-----|
|Token|true|varchar|用户ID|
|type|true|varchar|操作类型 transfer pass back |
|taskId|true|varchar|任务ID|
|data|true|object|配置所有表单字段key:value|
```请求体
RequestBody：
提交
{
"Token":"119",
"taskId":"b9463eb9-6cc7-11ea-a686-4aca71737411",
"data": {
"complete_nm": "张文",
"complete_id": "119",
"field_1565867223923": "sdfdsfsdfs",
"_next_assignee": "145",
"changzpizhu": "sssssss",
"czpizhu": "ok",
"files__": ""
}
}
运营预处理
{
"complete_nm": "牛士栋",
"complete_id": "5d4a5f58e2532d22f4b234d2",
"field_1566454263849": "stttt",
"clbm": "1",
"clbm$$text": "部门处理",
"_next_assignee": "154",
"field_1566455043167": "bbbbb",
"yystart": "ok",
"files__": ""
}
部门处理人
{
"complete_nm": "高琪",
"complete_id": "154",
"field_1566455328103": "stttt",
"clfa": "sdfsdfsdfs",
"_next_assignee": "121",
"bmpizhu": "sdfsdf",
"bmstart": "ok",
"files__": ""
}
总工程师审核
{
"complete_nm": "骆平",
"complete_id": "101",
"field_1566973851054": "stttt",
"field_1566973899809": "sdfsdfsdfs",
"_next_assignee": "118",
"cgcssh": "总工程师审核 111",
"zgcsstart": "ok",
"files__": ""
}
副总审核
{
"complete_nm": "高信刚",
"complete_id": "118",
"field_1566979598008": "stttt",
"field_1566979616910": "sdfsdfsdfs",
"_next_assignee": "108",
"bmfzpz": "sdfsdf",
"zgfzstart": "ok",
"files__": ""
}
实施确认
{
"complete_nm": "斯剑松",
"complete_id": "108",
"ssqrpz": "实施确认批注111",
"ssfazy": "实施确认方案111",
"field_1566980360682": "stttt",
"field_1566980748829": "sdfsdfsdfs",
"ssqrstart": "ok",
"files__": ""
}
李伟结束流程
{
"complete_nm":"李伟",
"complete_id":"145",
"field_1566454263849":"sdfdsfsdfs",
"clbm":null,
"clbm$$text":"",
"field_1566455043167":null,
"yystart":"finish",
"files__":""
}
张文退回
{
"complete_nm": "张三",
"complete_id": "2099",
"taskDefKey": "Task_1tdp1nt",
"message": "退回给张文"
}
张文 改派 斯剑松
{
"assignee": "108", //斯剑松
"complete_nm": "张文",
"complete_id": "119",
"message": "工单改派"
}
张三作废
{
"complete_nm": "张三",
"complete_id": "2099",
"isCancel": 1,
"message": "uyuyuty"
}
```
## 5 /flow/detail
### 5.1. 接口功能
> 获取任务的下一步处理方式 下一步处理人 表单信息
### 5.2. 请求方式
> post
### 5.3. 请求参数
|参数|必选|类型|说明|
|:----- |:-------|:-----|:-----|
|Token|false|varchar|用户ID|
|instanceId|false|varchar|任务ID|
|taskDefinitionKey|false|object|任务定义关键字|
|processDefinitionId|false|object|流程定义ID|
```请求体
RequestBody：
{
"Token":"119",
"instanceId":"bccff8d7-6ce8-11ea-b556-4aca71737411",
"taskDefinitionKey":"Task_1tdp1nt",
"processDefinitionId":"enfi_gd:414:db008b22-5921-11ea-9a09-4aca71737411"
}
```
```返回体
ResponseBody：
{
"status": 200,
"message": "",
"error": "",
"error_description": "",
"timestamp": 1585014315575,
"data": {
//下一步处理人候选
"nextCandidate": [
{
"id": "5d4a5f58e2532d22f4b234d2",
"name": "牛士栋",
"taskKey": "Task_1w5uq2j"
},
{
"id": "260",
"name": "张薛龙",
"taskKey": "Task_1wa9c9d"
}
],
//下一步处理方式
"nextTasks": [] ,
//表单属性
"fields": [
{
"multiple": 0,
"default_value": "",
"labelLine": 0,
"showtype": "combo",
"required": 0,
"extend": "enfei_task_button",
"colspan": 1,
"editiable": 0,
"readonly": 0,
"field": "czpizhu",
"datatype": "String",
"width": "100%",
"camundaLable": "厂长审批",
"name": "厂长审批",
"camundaType": "string",
"order": 0
},
{
"multiple": 0,
"default_value": "${nrzy}",
"labelLine": 1,
"showtype": "textarea",
"rows": 8,
"required": 0,
"extend": "",
"colspan": 1,
"editiable": 0,
"readonly": 1,
"field": "field_1565867223923",
"datatype": "String",
"width": "100%",
"camundaLable": "内容摘要",
"name": "内容摘要",
"camundaType": "string",
"order": 1
},
{
"magicPoc": 0,
"multiple": 0,
"default_value": "",
"labelLine": 1,
"showtype": "next-assignee",
"required": 1,
"extend": "",
"colspan": 1,
"editiable": 0,
"readonly": 0,
"field": "_next_assignee",
"datatype": "String",
"width": "50%",
"camundaLable": "下一步处理人",
"name": "下一步处理人",
"text": "",
"camundaType": "string",
"order": 2
},
{
"multiple": 0,
"default_value": "",
"labelLine": 1,
"showtype": "textarea",
"rows": 2,
"required": 1,
"extend": "",
"colspan": 1,
"editiable": 0,
"readonly": 0,
"field": "changzpizhu",
"datatype": "String",
"width": "100%",
"camundaLable": "批注",
"name": "批注",
"camundaType": "string",
"order": 3
}
]
}
}
```