查询条目问题单(API名称:findissue)
功能介绍
该接口提供给用户查询质量检查任务在执行过程中,或者质量审核过程中创建的“问题”,包括问题描述、类别、问题严重级别,问题对应的图片等。
相关接口
调用流程
URL
| 请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| POST | https://isdp+域名/openapi/v1/openTask/findissue | OpenAPI | application/json |
请求头
| KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
| Content-Type | application/json | 是 | 无 |
| Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| customerTaskId | List<String> | 否 | 客户任务id |
| issueId | List<Long> | 否 | 问题单id |
| projectNo | String | 否 | 项目编码 |
| signSiteCode | List<String> | 否 | 作业对象编码,一次最多50 |
| createBeginDate | String | 否 | 创建开始时间:YYYY-MM-DD |
| createEndDate | String | 否 | 创建结束时间:YYYY-MM-DD |
| updateBeginDate | String | 否 | 修改开始时间:YYYY-MM-DD |
| updateEndDate | String | 否 | 修改结束时间:YYYY-MM-DD |
| pageStart | int | 否 | 当前页码,从0开始 |
| pageSize | int | 否 | 每页数量,默认50条 |
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| stateCode | String | 响应状态码:0-成功;其他-失败 |
| errorMessage | String | 响应描述,如:null |
| result | Object | 响应结果内容result{ } |
result出参:
| 参数 | 类型 | 描述 |
|---|---|---|
| pos | int | 当前页:从0开始 |
| total_count | int | 总数量,如:1 |
| data | List<Object> | 响应结果内容data:[] |
data出参:
| 参数 | 类型 | 描述 |
|---|---|---|
| taskId | Long | 任务id,如:123456 |
| issueId | Long | 问题单id,如:546789 |
| projectNo | String | 项目编码,如:Test168 |
| customerTaskId | String | 客户任务id:如:9876 |
| type | String | 业务类型,如:巡检 |
| code | String | 问题编码,如:98765 |
| signSiteCode | String | 作业对象编码,如:云谷7809 |
| signSiteName | String | 作业对象名称,如:云谷路12号 |
| adminRegionName | String | 地市,如:中国->北京->丰台区 |
| issueType | String | 问题类别:
|
| creatorDescribe | String | 问题描述,如:天线角度不对 |
| issueLevel | Int | 问题严重级别:
|
| accountableParty | String | 问题责任方:
|
| kcpName | String | KCP名称,如:kcp1 |
| itemName | String | 条目名称,如:天线安装 |
| issueSource | String | 问题来源:
|
| createdBy | Long | 问题提出人ID,如:12395 |
| createdName | String | 问题提出人姓名,如:张三 |
| creatorWorkUnit | String | 提交人所在分包商,如:XXXX公司 |
| issueHandlerId | String | 问题处理人id,多个用;隔开,如:123;789 |
| issueHandlerName | String | 问题处理人姓名,多个用;隔开,如:"王五";"李四" |
| confirmedBy | Long | 问题确认人ID,如:579 |
| createName | String | 问题确认人姓名,如:张三 |
| creationDate | Date | 问题提出时间,如:2020-09-01 18:00:00 |
| dealDate | Date | 问题处理时间,如:2020-09-01 18:00:00 |
| closedDate | Date | 问题关闭时间,如:2020-09-01 18:00:00 |
| handlerFeedback | String | 进展反馈,如:处理中 |
| issueTypeLevelOne | String | 问题级别1,多个用逗号分隔,如:"问题描述1";"问题描述2" |
| issueTypeLevelTwo | String | 问题级别2,多个用逗号分隔,如:"问题描述1";"问题描述2" |
| outPutMessages | List<Object> | 输出项列表outPutMessages[] |
outPutMessages出参:
| 参数 | 类型 | 描述 |
|---|---|---|
| itemId | Long | 条目id,如:123399000 |
| outPutName | String | 输出项名字,如:输出项示例 |
| outPutId | Long | 输出项id,如:45678934 |
| outPutType | String | 输出项类型: 1-枚举;2- 文本;3-图片/视频;4-多枚举;5-整数;6-小数;7-日期;9-条码;10-NA;11-GPS;13-图片;14-视频;15-时间;16-文件 |
| isNecessary | Int | 是否必填:
|
| outputValue | String | 如果是图片、视频和文件类型,则返回其文件id;如果是NA类型,则返回Y;如果是其他类型,则返回值。 多个值用;隔开,下载地址(fileId就是文件id): ${path}/ plat.file/file/serveFile?fileId= fileId),如为 文本内容:XXXX |
请求示例
{
"customerTaskId": [
456456464654,
1234567893
]
} 响应示例
{
"stateCode": "0",
"errorMessage": "query success",
"result": {
"data": [
{
"taskId": 123456,
"projectCode": "123-my project",
"customerTaskId": 23456,
"businessType": "巡检1",
"code": "ISSUE-2141",
"signSiteCode": "作业对象编码",
"signSiteName": "作业对象名称",
"adminRegionName": "中国-XX-XX",
"issueType": "质检任务",
"creatorDescribe": "问题描述",
"issueLevel": 1,
"accountableParty": "0",
"kcpName": "KCP1",
"itemName": "ITEM1",
"issueSource": "1",
"createdBy": "liuyue",
"creatorWorkUnit": "供应商单位",
"issueHandler": "张三;李四",
"confirmedBy": "王五",
"creationDate": "2020-09-01 10:00:00",
"dealDate": "2020-09-01 10:00:00",
"closedTime": "2020-09-01 10:00:00",
"handlerFeedback": "进展反馈内容",
"outPutMessages": [
{
"outPutName": "输出项名称1",
"outPutId": 123456789,
"outPutType": "文本",
"isNecessary": 1,
"outputValue": "输出项文本内容",
}
],
}
],
"pos": 0,
"total_count": 1,
},
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。