• 文档
  • Get Service Request Details

Get Service Request Details

获取服务请求详情。

请求格式

​       POST https://{apigw-address}/work-management/v1.0/s-taskmgmtds/cmms/service-request/detail

请求参数（URI）

名称

位置（Path/Query）

必需/可选

数据类型

描述

srId

Query

必需

String

查询的服务请求 ID。

响应参数

名称

数据类型

描述

data

Data 结构体

成功的返回信息。其结构参见 Data 结构体。

Data 结构体

名称

数据类型

描述

orgId

String

组织 ID。

srId

String

服务请求 ID。

srNum

String

服务请求编号。

title

String

服务请求标题。

description

String

服务请求描述。

srStatus

Integer

服务请求状态码。

siteId

String

场站 ID。

siteName

String

场站名称。

rootModelId

String

场站模型。

priority

Integer

服务请求优先级。

assigneeName

String

指派人名称。

assigneeId

String

指派人 ID。

assignee

User 结构体

指派人。其结构参见 User 结构体。

createUserId

String

创建人 ID。

createUser

String

创建人名称。

createTime

String

票单创建时间。

createLocalTime

String

票单本地创建时间。

updateUserId

String

票单更新人 ID。

updateUser

String

票单更新人名称。

updateTime

String

票单更新时间。

sourceType

Integer

来源类型。该接口接受枚举值。1：告警；2：预警；3：运维建议；4：手工；5：停机记录；6：运维计划（内部保留值）；7：服务请求（内部保留值）。

expectedCompletionDate

String

期望完成日期。

customizedParam

List 格式 Param 结构体

自定义字段。其结构参见 Param 结构体。

timezone

String

场站时区。

deviceId

String

设备 ID 列表。以逗号分隔。

fileIds

List 格式 String

文件 ID 列表。

files

List 格式 File 结构体

文件信息列表。其结构参见 File 结构体。

relatedIssue

Integer

关联票单数量。

actualCause

String

实际原因。

completionNote

String

票单完成信息。

expired

Boolean

是否逾期。

remainingTime

String

票单剩余时间（ms）。

estimateEffort

Integer

票单预估工时。

processInstanceId

String

流程 ID。

requestType

Integer

请求类型。

User 结构体

名称

数据类型

描述

userId

String

用户 ID。

username

String

用户名称。

Param 结构体

名称

数据类型

描述

key

String

自定义字段标识符，需要在工作管理表单中注册。

value

String

所查询的字段值。

File 结构体

名称

数据类型

描述

fileId

String

文件 ID。

fileName

String

文件名。

fileSize

Long

文件大小。

fileUrl

String

文件 URL。

createUser

String

文件创建人。

createTime

String

文件创建时间。

错误码

名称

描述

96134

场站 ID 无效。

96146

自定义字段 key 不支持筛选，请检查配置或更改参数。

示例

请求示例

url: https://{apigw-address}/work-management/v1.0/s-taskmgmtds/cmms/service-request/detail
method: POST
requestBody:
{
    "pageNo": 1,
    "pageSize": 50,
    "siteIds":["siteId1","siteId2"],
    "startTime":"2021-05-09 16:28:39",
    "endTime":"2021-06-09 16:28:39",
    "keyword":""
}

返回示例

{
  "code": 0,
  "data": {
    "orgId": "orgId",
    "srId": "srId",
    "srNum": "srNum",
    "title": "test jimmy",
    "description": "description",
    "srStatus": 30,
    "siteId": "siteId",
    "siteName": "siteName",
    "rootModelId": "rootModelId",
    "priority": 4,
    "assigneeName": "assigneeName",
    "assigneeId": "assigneeId",
    "assignee": {
      "userId": "assigneeId",
      "username": "assigneeName"
    },
    "createUserId": "createUserId",
    "createUser": "createUser",
    "createTime": "2022-05-18 15:47:08",
    "createLocalTime": "2022-05-18 15:47:08",
    "updateUserId": "updateUserId",
    "updateUser": "updateUser",
    "updateTime": "2022-05-25 10:31:23",
    "sourceType": 4,
    "expectedCompletionDate": "2022-05-19",
    "customizedParam": [
      {
        "key": "key",
        "value": "value",
        "label": null,
        "section": null,
        "displayOrder": null
      }
    ],
    "timezone": "+08:00",
    "status": 1,
    "deviceId": "deviceId1,deviceId2",
    "fileIds": [
      "fileId1",
      "fileId2"
    ],
    "files": [
      {
        "taskId": "taskId",
        "taskNum": "taskNum",
        "fileId": "fileId",
        "fileName": "fileName.jpeg",
        "fileUrl": "fileUrl",
        "createTime": "2022-05-19 16:37:19",
        "fileSize": 3700,
        "createUser": "createUser"
      }
    ],
    "relatedIssue": 2,
    "note": "",
    "actualCause": "reason test",
    "completionNote": "note test",
    "remainingTime": "-1",
    "estimateEffort": 8,
    "processInstanceId": "processInstanceId",
    "currentTask": "Close Service Request",
    "taskId": "taskId",
    "processStatus": 1,
    "requestType": 1
  }
}