# activiti Demo API
红色: 新增内容
交互流程:
新增业务交互
实际业务交互
activiti Demo API
前端地址 http://192.168.8.101:8080/list
- 流程相关状态
// 状态 1 已提交 2 通过(归档) 3 审核中 4 退回int BUSINESS_STATUS_SUBMIT = 1;int BUSINESS_STATUS_PASS = 2;int BUSINESS_STATUS_AUDITING = 3;int BUSINESS_STATUS_REFUSE = 4;int BUSINESS_STATUS_ROLLBACK = 5;//撤回
- 分页
"totalPages": 2, //总页数"totalElement": 3,//总元素个数"numberOfElements": 1,//当前页元素个数"size": 2,//页面大小"number": 2,//当前页码
用户登录
login
参数
- username
- password
返回
失败{"code": 0,"result": null,"msg": "密码不正确"}
成功
{"code": 200,"result": {"id": 1,//用户id"name": "employee01",//登录名"nickName": "员工01",//用户名称"avatar": null,"password": "123456","salt": null,"email": null,"mobile": null,"status": null,"deptId": null,"createBy": null,"createTime": null,"lastUpdateBy": null,"lastUpdateTime": null,"delFlag": null},"msg": "成功"}
申请
POST flow/apply
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| userId | String | 用户id | |
| businessKey | String | 业务类型 | |
| formParam | String | 表单参数 json的键值对 | |
返回
成功或者失败
编辑
POST flow/edit
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| id | 记录id | ||
| userId | 当前用户id | ||
| taskId | 任务id | ||
| businessKey | String | 业务类型 | |
| formParam | String | 表单参数 json的键值对 | |
返回
成功或者失败
详情(非审核查看详情)
POST flow/detail
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| id | String | 业务记录id |
返回
成功或失败
private String id;//业务idprivate String userId;//申请人idprivate String userName;//申请人姓名@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")private Date requestDate;//申请日期private String procInstId;//流程实例idprivate String businessKey;//业务keyprivate String businessName;//业务名称private String businessData;//业务最新表单数据private Integer status;//审核状态@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")private Date createTime;private String taskId;//当前任务idprivate String taskName;//当前任务名称private String businessForm;//当前业务表单
审核详情(进入审核页面)
会查询当前任务对应表单,以及对应表单最新数据
POST flow/auditDetail
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| id | String | 业务记录id |
返回
成功实体类
private String id;//业务idprivate String userId;//申请人idprivate String userName;//申请人姓名@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")private Date requestDate;//申请日期private String procInstId;//流程实例idprivate String businessKey;//业务keyprivate String businessName;//业务名称private String businessData;//业务最新表单数据private Integer status;//审核状态private Date createTime;private String taskForm;//任务表单字符串 jsonprivate String taskParam;//任务当前最新表单数据 jsonprivate String taskId;//当前任务idprivate String taskName;//当前任务名称
签收任务
POST flow/claim
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| userId | String | 当前用户id | |
| taskId | String | 任务id |
返回
成功或者失败
取消签收任务
POST flow/unclaim
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| userId | String | 当前用户id | |
| taskId | String | 任务id |
返回
成功或者失败
审核
POST flow/audit
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| id | 业务记录id | ||
| userId | 用户id | ||
| taskId | String | 任务id | |
| audit | boolean | true 通过 false 不通过 | |
| comment | String | 审批意见 | |
| formParam | String | 表单数据 json |
返回
成功或者失败
分页查询我的申请
POST flow/myapply
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| userId | String | 用户id | Y |
| businessKey | String | 业务类型 | |
| pageNum | int | 页码 默认1 | |
| pageSize | int | 页面大小 默认10 |
|status | int | 1 通过(归档) 2 待审批 3 退回 暂时不用 | |
|startDate | String | 开始日期 yyyy-MM-dd 暂时不用 | |
|endDate | String | 结束日期 yyyy-MM-dd 暂时不用 | |
返回
成功或失败
private String id;//业务idprivate String userId;//申请人idprivate String userName;//申请人姓名@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")private Date requestDate;//申请日期private String procInstId;//流程实例idprivate String businessKey;//业务keyprivate String businessName;//业务名称private String businessData;//业务最新表单数据private Integer status;//审核状态private Date createTime;private String taskId;//当前任务idprivate String taskName;//当前任务名称
分页查询用户代办
POST flow/todo
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| userId | Long | 用户id | Y |
| businessKey | String | 业务类型 | |
| pageNum | int | 页码 默认1 | |
| pageSize | int | 页面大小 默认10 |
|status | int | 1 通过(归档) 2 待审批 3 退回 | |
|startDate | String | 开始日期 yyyy-MM-dd | |
|endDate | String | 结束日期 yyyy-MM-dd | |
private String id;//业务idprivate String userId;//申请人idprivate String userName;//申请人姓名@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")private Date requestDate;//申请日期private String procInstId;//流程实例idprivate String businessKey;//业务keyprivate String businessName;//业务名称private String businessData;//业务最新表单数据private Integer status;//审核状态private Date createTime;private String taskForm;//任务表单字符串 jsonprivate String taskParam;//任务当前最新表单数据 jsonprivate String taskId;//当前任务idprivate String taskName;//当前任务名称private Boolean isClaim;//是否已签收 如果true,展示签收按钮(调用签收接口),否则显示审核按钮(调用审核接口)
分页查询用户已办
POST flow/done
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| userId | Long | 用户id | Y |
| businessKey | String | ||
| pageNum | int | 页码 默认1 | |
| pageSize | int | 页面大小 默认10 |
|status | int | 1 通过(归档) 2 待审批 3 退回 | |
|startDate | String | 开始日期 yyyy-MM-dd | |
|endDate | String | 结束日期 yyyy-MM-dd | |
返回
private String id;//业务idprivate String userId;//申请人idprivate String userName;//申请人姓名@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")private Date requestDate;//申请日期private String procInstId;//流程实例idprivate String businessKey;//业务keyprivate String businessName;//业务名称private String businessData;//业务最新表单数据private Integer status;//审核状态private Date createTime;private String taskForm;//任务表单字符串 jsonprivate String taskParam;//任务当前最新表单数据 jsonprivate String taskId;//当前任务idprivate String taskName;//当前任务名称
查询记录对应日志
POST flow/logs
参数
| 字段名 | 类型 | 说明 | 是否必填 |
|---|---|---|---|
| id | Long | 业务记录id | Y |
