工单流程

新建工单流程: /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"] 返回数据项
参数名 示列值 类型 说明
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
[
  {}
]