文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务进展管理/ 查询设备关联的任务&子任务列表(API名称:getSceneTaskList)
更新时间:2024-07-22 GMT+08:00
分享

查询设备关联的任务&子任务列表(API名称:getSceneTaskList)

功能介绍

用于用户系统查询设备关联的任务、子任务列表

相关接口

接口名称

调用说明

获取Token

调用该接口获取到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
    }
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档