查询设备关联的任务&子任务列表（API名称：getSceneTaskList）
功能介绍
用于用户系统查询设备关联的任务、子任务列表。
相关接口
接口名称 | 调用说明 |
|---|---|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
请求方式 | HTTPS地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
POST | https://isdp+域名/openapi/v1/openSceneTaskObject/getSceneTaskList | OpenAPI | application/json |
请求头
KEY | VALUE | 是否必填 | 描述 |
|---|---|---|---|
Content-Type | application/json | 是 | 无 |
Authorization | bearer ${access_token} | 是 | bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
page.start | int | 是 | 分页起始行 |
page.count | int | 是 | 分页大小 |
queryType | int | 是 | 查询类型(1:查询巡检计划列表；2：查询巡检历史列表) |
status | String | 否 | 任务、子任务状态(仅支持1：待执行；2：执行中；3：已完成状态。)多个任务状态用英文逗号隔开； |
orderType | int | 否 | 排序（1：升序；2：降序。如果queryType为1，按照计划完成时间升、降序排，queryType为2，按照实际完成时间升降序排），为空则按照升序排 |
timeRangeList | List<Long> | 否 | 计划完成、实际完成过滤范围，设置开始、结束时间的毫秒数 |
sourceObjectIdList | List<String> | 是 | 设备id集合，单次请求最多100个 |
响应参数
参数 | 类型 | 描述 |
|---|---|---|
stateCode | String | 接口响应编码，0成功，非0失败 |
errorMessage | String | 接口错误提示信息 |
result | Map | 接口响应数据。 |
result出参：
参数 | 类型 | 描述 |
|---|---|---|
result.data | List<Map<String,Object>> | 任务、子任务列表 |
data.taskName | String | 任务、子任务名称 |
data. taskType | int | 1:任务；2：子任务 |
data. sceneTaskId | Long | 任务、子任务主键id |
data. sceneMode | int | 任务模式 |
data.isNa | int | 是否子任务na |
data.status | int | 任务、子任务状态（1：待执行；2：执行中；3：已完成） |
data.endTimestamp | Long | 任务、子任务计划完成时间，毫秒数 |
data.parentCategory | String | 领域 |
data.sceneName | String | 场景 |
data. adminOrganization | String | 组织单元 |
data.actualEndTime | Long | 实际完成时间，毫秒数 |
data.executorList | List<Map<String,Object>> | 执行人 |
data.executorList.userId | Long | 执行人ID |
data.executorList.userName | String | 执行人名称 |
data.executorList.userType | int | 执行人类型1：个人；2：群组 |
data.executorList.sceneTaskId | Long | 执行人关联的任务、子任务ID |
data.totalCount | int | 进展任务总数 |
data.finishCount | int | 进展完成任务数 |
data.isExpire | String | 是否逾期0：未逾期；1：逾期 |
pos | int | 当前查询起始行 |
total_count | int | 任务总数 |
entityName | String | 实体名称 |
totalCount | int | 任务总数 |
请求示例
{
"page": {
"count": 15,
"start": 0
},
"queryType": 1,
"sourceObjectIdList": [
"H06041--1"
]
} 响应示例
{
"stateCode": "0",
"errorMessage": null,
"result": {
"data": [
{
"taskName": "1_20220908_144225",
"taskType": 2,
"sceneTaskId": 1919494,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": null,
"parentTaskId": 2949685,
"parentCategory": "",
"sceneName": "",
"adminOrganization": "",
"actualEndTime": null,
"executorList": [
{
"userId": 153169,
"userName": "lyl09修改",
"userType": 1,
"sceneTaskId": 1919494
}
],
"totalCount": 1,
"finishCount": 0,
"isExpire": 0
},
{
"taskName": "2_20220908_144225",
"taskType": 2,
"sceneTaskId": 1919495,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": null,
"parentTaskId": 2949685,
"parentCategory": "",
"sceneName": "",
"adminOrganization": "",
"actualEndTime": null,
"executorList": [
{
"userId": 153169,
"userName": "lyl09修改",
"userType": 1,
"sceneTaskId": 1919495
}
],
"totalCount": 1,
"finishCount": 0,
"isExpire": 0
},
{
"taskName": "1_20220908_144443",
"taskType": 2,
"sceneTaskId": 1919498,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": null,
"parentTaskId": 2949686,
"parentCategory": "",
"sceneName": "",
"adminOrganization": "",
"actualEndTime": null,
"executorList": [
{
"userId": 153169,
"userName": "lyl09修改",
"userType": 1,
"sceneTaskId": 1919498
}
],
"totalCount": 1,
"finishCount": 0,
"isExpire": 0
},
{
"taskName": "1_20220909_151311",
"taskType": 2,
"sceneTaskId": 1919657,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": null,
"parentTaskId": 2951381,
"parentCategory": "",
"sceneName": "",
"adminOrganization": "",
"actualEndTime": null,
"executorList": [
{
"userId": 153169,
"userName": "lyl09修改",
"userType": 1,
"sceneTaskId": 1919657
}
],
"totalCount": 1,
"finishCount": 0,
"isExpire": 0
},
{
"taskName": "子任务1_20220914_142712",
"taskType": 2,
"sceneTaskId": 1920826,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": 1663136980000,
"parentTaskId": 2955633,
"parentCategory": "",
"sceneName": "",
"adminOrganization": "",
"actualEndTime": null,
"executorList": [
{
"userId": 25804,
"userName": "刘月",
"userType": 1,
"sceneTaskId": 1920826
}
],
"totalCount": 1,
"finishCount": 0,
"isExpire": 1
},
{
"taskName": "14:40_20220908_144225",
"taskType": 1,
"sceneTaskId": 2949685,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": null,
"parentTaskId": 0,
"parentCategory": "",
"sceneName": "14:40",
"adminOrganization": "杨凌作业系统测试№",
"actualEndTime": null,
"executorList": [
{
"userId": 153169,
"userName": "lyl09修改",
"userType": 1,
"sceneTaskId": 2949685
}
],
"totalCount": 2,
"finishCount": 0,
"isExpire": 0
},
{
"taskName": "测试计划结束",
"taskType": 1,
"sceneTaskId": 2955633,
"sceneMode": 4,
"isNa": 0,
"status": 1,
"endTimestamp": 1663136980000,
"parentTaskId": 0,
"parentCategory": "",
"sceneName": "测试统计计划结束时间",
"adminOrganization": "杨凌作业系统测试№",
"actualEndTime": null,
"executorList": [
{
"userId": 25804,
"userName": "刘月",
"userType": 1,
"sceneTaskId": 2955633
}
],
"totalCount": 1,
"finishCount": 0,
"isExpire": 1
}
],
"pos": 0,
"total_count": 7,
"entityName": null,
"totalCount": 7
}
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
