查询条目问题单（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,
},
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
