工单流程
新建工单流程: /workFormFlows POST
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 |
---|---|---|---|---|
name | 服务流程 | string | 是 | 工单流程名称 |
phases | WorkFormFlowPhase[] | 否 | 阶段 | |
phases.name | 服务流程 | string | 是 | 工单流程流程阶段名称 |
phases.order | 1 | number | 是 | 工单流程流程阶段序号 |
phases.handlerIds | [1,2] | number[] | 是 | 处理人 |
phases.departmentIds | [1,2] | number[] | 是 | 处理部门 |
返回结果: 工单流程信息
请求示例:
{
"name": "工单测试流程",
"creatorId": 1,
"phases": [{
"order": 1,
"name": "测试",
"handlerIds": [1,2],
"departmentIds": [1,2]
}]
}
编辑工单流程: /workFormFlows/:id PUT
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 |
---|---|---|---|---|
name | 服务流程 | string | 是 | 工单流程名称 |
phases | WorkFormFlowPhase[] | 否 | 阶段 | |
phases.name | 服务流程 | string | 是 | 工单流程流程阶段名称 |
phases.order | 1 | number | 是 | 工单流程流程阶段序号 |
phases.handlerIds | [1,2] | number[] | 是 | 处理人 |
phases.departmentIds | [1,2] | number[] | 是 | 处理部门 |
返回结果: 工单流程信息
编辑工单流程: /workFormFlows/:id/status PUT
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 |
---|---|---|---|---|
status | 1 | string | 是 | 工单流程名称 0=禁用;1=启用 |
返回结果: 工单流程信息
请求示例:
{
"id": 1,
"status": 0
}
工单流程详情: /workFormFlows/:id GET
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 |
---|---|---|---|---|
id | 1 | number | 是 | 组织 id |
expand | 'creator,phases,updater,count' | string | 否 | 获取指定子资源数据 '' |
attributes | ["id", "name"] | array | 否 | 本资源的字段。不定义该字段时返回所有字段 |
返回结果: 工单流程信息
删除工单流程: /workFormFlows/:id DELETE
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 |
---|---|---|---|---|
id | 1 | number | 是 | 资源id |
返回示列
HTTP/1.1 204 NO CONTENT
工单流程列表: /workFormFlows GET
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 |
---|---|---|---|---|
page | 1 | number | 否 | 当前页数 |
pageSize | 10 | number | 否 | 每页条数 |
name | xxx | string | 否 | 名称 |
status | 1 | number | 是 | 处理状态 0=禁用;1=启用 |
sort | -createdAt | string | 否 | 排序。多个排序字段用,号隔开。sort=-a,b |
expand | 'creator' | string | 否 | 获取指定子资源数据 '' |
attributes | "id,name" | string | 否 | 本资源的字段。不定义该字段时返回所有字段;空数组不返回字段 |
返回参数
参数名 | 示列值 | 说明 |
---|---|---|
page | 1 | 当前页数 |
pageSize | 10 | 每页条数 |
limit | 10 | 同 pageSize |
offset | 2 | 起始条数 |
total | 3231 | 符合条件的总数量 |
items | [{ "id": 4, "name": "test2"] | 返回数据项 |
- items: 工单流程信息
参数名 | 示列值 | 类型 | 说明 |
---|---|---|---|
id | 1 | number | id |
name | 跑步 | string | 名称 |
index | 0 | number | 序号 |
description | '' | string | 描述 |
status | 0 | number | 状态 0=禁用 1=启用 |
workFormTotal | 4 | number | 引用的工单数 |
createdAt | 1650160322 | number | 创建时间 |
updatedAt | 1650160322 | number | 更新时间 |
返回示列
HTTP/1.1 200 OK
{
"items": [
{
"createdAt": 1653820717,
"updatedAt": 1653820750,
"id": 1,
"name": "工单测试流程",
"status": 1,
"creatorId": 1,
"workFormTotal": 6,
"deletedAt": null,
"phases": [
{
"id": 1,
"order": 1,
"name": "阶段1",
"handlerIds": "1,2",
"departmentIds": "1,2",
"handlers": [
{
"id": 1,
"name": "super_admin"
},
{
"id": 2,
"name": "周黎明"
}
],
"departments": []
},
{
"id": 2,
"order": 4,
"name": "阶段4",
"handlerIds": "1,2",
"departmentIds": "1,2",
"workFormTotal": 2,
"handlers": [
{
"id": 1,
"name": "super_admin"
},
{
"id": 2,
"name": "周黎明"
}
],
"departments": []
}
],
"creator": {
"id": 1,
"name": "super_admin"
}
}
],
"total": 4070,
"offset": 1,
"limit": 2,
"page": 1,
"pageSize": 2
}
所有工单流程: /listAll/workFormFlows GET
请求参数
参数名 | 示列值 | 类型 | 必须 | 说明 | 默认值 |
---|---|---|---|---|---|
name | xxx | string | 否 | 名称 | |
expand | '' | string | 否 | 获取指定子资源数据 '' | |
attributes | "id,name" | string | 否 | 本资源的字段。不定义该字段时返回所有字段;空数组不返回字段 |
返回结果: 工单流程信息
返回示列
HTTP/1.1 200 OK
[
{}
]