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。 |
请求参数(Header)¶
名称 | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|
authorization | 必需 | String | 从应用门户获取的用户 Token 信息。 |
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
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
}
}