2.4.0

2.4.0
preview

简体中文

English
简体中文

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
  }
}

Get Service Request Details