文档首页/ ISDP/ API参考/ API接口/ 问题管理/ 查询条目问题单(API名称:findissue)
更新时间:2024-01-18 GMT+08:00
分享

查询条目问题单(API名称:findissue)

功能介绍

该接口提供给用户查询质量检查任务在执行过程中,或者质量审核过程中创建的“问题”,包括问题描述、类别、问题严重级别,问题对应的图片等。

相关接口

接口名称

调用说明

获取Token

调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。

创建问题单

查询条目问题单操作时,如果没有条目问题单,查询结果为空。

可以调用该接口创建条目问题单后,再执行查询操作,了解查询条目问题单接口。

调用流程

图1 查询条目问题单

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

问题严重级别:

  • 0:一般
  • 1:重要
  • 2:严重

accountableParty

String

问题责任方:

  • 0:自有
  • 1:供应商
  • 2:客户

kcpName

String

KCP名称,如:kcp1

itemName

String

条目名称,如:天线安装

issueSource

String

问题来源:

  • 0:审核问题
  • 1:执行问题

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

是否必填:

  • 1-是
  • 0-否

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

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档