文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务场景管理/ 查询子任务场景列表（API名称：openTaskScene/querySubTaskList）
更新时间：2026-03-30 GMT+08:00
查看PDF
分享

查询子任务场景列表（API名称：openTaskScene/querySubTaskList）

功能介绍

查询子任务场景列表。

相关接口

接口名称

调用说明

获取Token

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

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/openTaskScene/querySubTaskList

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

请求参数 Object

参数

类型

是否必填

描述

taskId

Long

是

父任务id，只能单个查询，如果不传子任务则查询下属所有的子任务

获取父任务id API请参见：查询父任务（API名称：queryParentTaskList）

subTaskId

Long

否

子任务id

UDF1

String

否

扩展属性1,执行阶段

UDF2

String

否

扩展属性2,执行阶段

UDF3

String

否

扩展属性3,执行阶段

UDF4

String

否

扩展属性4,执行阶段

UDF5

String

否

扩展属性5,执行阶段

UDF6

String

否

扩展属性6,执行阶段

UDF7

String

否

扩展属性7,执行阶段

UDF8

String

否

扩展属性8,执行阶段

UDF9

String

否

扩展属性9,执行阶段

UDF10

String

否

扩展属性10,执行阶段

pageStart

int

否

当前页码，从0开始

pageSize

int

否

每页数量，默认15条，最多100条

响应参数

参数

类型

描述

stateCode

String

响应状态码：

  • 0-成功
  • 其他-失败

errorMessage

String

响应描述

result

Object

响应结果内容data、分页数据

result出参：

参数

类型

描述

pos

int

当前页，从0开始

total_count

int

总数量

data

List<Object>

响应结果内容data

data出参：

参数

类型

描述

sceneTaskId

Long

子任务ID

taskId

Long

父任务ID

taskName

String

子任务名称

status

Integer

0：草稿；1：待执行；2：执行中；3：已完成

4：已取消；5：申请待审批；6：待调度；9：已驳回

createdBy

Long

创建人ID

createName

String

创建人姓名

currentProcedureId

Long

当前工序

currentProcedureName

String

当前工序名称

pocedureOrNot

Integer

子任务是否包含工序（0：否；1：是）

checkOrderId

Long

子任务关联检查单ID

checkOrderName

String

子任务关联检查单名称

checkOrderType

Integer

子任务关联检查单类型（0：EHS;1:质检；2：巡检）

description

String

子任务描述

actualEndTime

Long

子任务实际结束时间

actualBeginTime

Long

子任务实际开始时间

beginTimestamp

Long

计划开始时间

endTimestamp

Long

计划完成时间

processFeedback

String

子任务进展反馈

isNa

Integer

子任务NA

signSiteId

Long

子任务作业对象ID

signSiteCode

String

子任务作业对象编码

signSiteName

String

子任务作业对象名称

regionId

Long

子任务行政区域ID

regionPath

String

子任务行政区域路径

regionName

String

子任务行政区域名称

isExecute

Integer

子任务是否可执行

priority

String

子任务优先级

jobDuration

Integer

子任务工时

projectDuration

Integer

子任务工期

administrativeDivision

String

子任务行政区域ID串

administrativeDivisionName

String

子任务行政区域名称串

skill

String

子任务要求技能

address

String

子任务详细地址

requiredStartTime

Long

子任务要求开始时间

requiredEndTime

Long

子任务要求完成时间

taskExtend

List

子任务扩展属性

procedureList

List

子任务关联工序

parentTaskList

List

对应的父任务信息

data中taskExtend字段说明：

参数

类型

描述

extendName

String

子任务扩展属性名称

stage

Integer

子任务扩展属性所属阶段1：创建；2：执行

fieldOrder

Integer

子任务扩展属性顺序

extendValue

String

扩展属性值

udfName

String

扩展属性编码

extendType

Integer

扩展属性类型（1：长文本；2：枚举；3：多枚举；

4：日期；5：时间；6：整数；7：小数；20：短文本）

isNecessary

Integer

扩展属性是否必填（1：必填；2：不必填）

data中procedureList字段说明：

参数

类型

描述

isAppraisal

Integer

是否采集审批0：否；1：是

collectionReviewName

String

采集审批流名称

licenseSwitch

Integer

是否受许可控制0：否；1：是

operationGuideList

List

操作指导

description

String

工序描述

templateCode

String

采集模板编码

templateId

Long

采集模板ID

version

String

采集模板版本

templateName

String

采集模板名称

licenseTag

Integer

许可标识0-无，1-许可启动，2-许可终结

taskName

String

工序名称

collectionReviewId

Long

采集审批流

procedureOrder

Integer

工序顺序

procedureList中operationGuideList字段说明：

参数

类型

描述

fileId

Long

工序操作指导文件ID

filename

String

工序操作指导文件名称

fileType

String

工序操作指导文件类型

fileSize

Long

工序操作指导文件大小

data中parentTaskList字段说明：

参数

类型

描述

sceneTaskId

Long

任务id

taskName

String

任务名称

sceneMode

Integer

任务模式：

  • 1：简单任务
  • 2：启用检查单
  • 3：启用工序
  • 4：父子任务

status

Integer

任务状态：

  • 0：草稿
  • 1：待执行
  • 2：执行中
  • 3：已完成
  • 4：已取消
  • 5：申请待审批
  • 9：已驳回

createdBy

Long

创建人id

createName

String

创建人姓名

createDate

Long

任务创建时间

planStartTime

Long

计划开始时间

planEndTime

Long

计划完成时间

actualBeginTime

Long

实际开始时间

actualEndTime

Long

实际完成时间

processFeedback

String

进展反馈

currentProcedureId

Integer

当前工序步骤

currentProcedureName

String

当前工序名称

licenseSwitch

Integer

是否受许可控制开关：

  • 1-是
  • 0-否

checkOrderId

Long

关联检查单id

checkOrderName

String

关联的检查单名称

checkOrderType

Integer

任务生成的检查单类型：

  • 0：EHS
  • 1：质量检查
  • 2：巡检

sceneId

Long

场景id

sceneName

String

场景名称

signSiteId

Long

作业对象id

signSiteName

String

作业对象名称

signSiteCode

String

作业对象编码

supplierName

String

供应商名称

adminOrganizationName

String

组织单元名称

projectNo

String

项目编码

projectName

String

项目名称

deleteFlag

Integer

删除标识：0未删除，1已删除

taskObjectType

String

任务作业对象类型名称

请求示例

{
    "status": "",
    "taskName": "",
    "actualEndTimeMin": "",
    "planEndTimeMin": "",
    "planEndTimeMax": "",
    "deleteFlag": 0,
    "pageStart": 0,
    "objectTypeList": [
        "绿地站",
        "公路站"
    ],
    "pageSize": 15,
    "regionId": "",
    "signSiteIdList": "",
    "planBeginTimeMin": "",
    "planBeginTimeMax": "",
    "sceneId": "",
    "parentCategoryId": "",
    "categoryId": "",
    "parentCategory": "",
    "statusStr": "",
    "sceneTaskId": "",
    "resource": "",
    "userId": ""
}

响应示例

{
    "stateCode": "0",
    "errorMessage": null,
    "result": {
        "data": [
            {
                "sceneTaskId": 5005973,
                "sceneMode": 1,
                "status": 5,
                "createdBy": 1823,
                "createName": "superman",
                "currentProcedureId": null,
                "currentProcedureName": null,
                "licenseSwitch": 1,
                "processFeedback": null,
                "checkOrderId": null,
                "checkOrderName": null,
                "checkOrderType": null,
                "creationTimestamp": 1668050261726,
                "actualBeginTime": null,
                "schedulerDate": 1668050262000,
                "schedulerTimestamp": 1668050261726,
                "schedulerBy": 1823,
                "schedulerName": "superman",
                "actualEndTime": null,
                "lastUpdatedBy": 1823,
                "lastUpdateName": "superman",
                "lastUpdateTimestamp": 1668050261726,
                "taskType": 1,
                "category": "",
                "categoryId": null,
                "parentCategory": "",
                "parentCategoryId": null,
                "taskName": "测试任务创建1",
                "sceneId": 101375,
                "sceneName": "yqq测试001",
                "signSiteId": 9911275515,
                "signSiteName": "测试作业对象",
                "signSiteCode": "测试作业对象",
                "regionId": null,
                "regionPath": null,
                "regionName": null,
                "supplierName": null,
                "adminOrganizationName": "1508098844233300",
                "adminOrganization": "1543",
                "sceneCode": "TS20220413150640042",
                "projectNo": "",
                "taskObjectType": "公路站",
                "projectName": "",
                "requiredEndTime": null,
                "planStartTime": null,
                "planEndTime": null,
                "deleteFlag": 0,
                "deleteReason": null,
                "priority": null,
                "jobDuration": 3,
                "projectDuration": null,
                "schedulingMode": null,
                "administrativeDivision": null,
                "administrativeDivisionName": null,
                "skill": null,
                "customerId": null,
                "customerName": null,
                "address": null,
                "requiredStartTime": null,
                "totalCount": 1,
                "finishCount": 0,
                "signSiteType": "公路站",
                "executorList": [
                    {
                        "sceneTaskId": 5005973,
                        "taskType": 1,
                        "userId": 1957,
                        "userInfoId": 5012415,
                        "userName": "张三",
                        "userType": 1
                    }
                ]
            }
        ],
        "pos": 0,
        "total_count": 3745,
        "entityName": null,
        "totalCount": 3745
    }
}
父主题： 任务场景管理

相关文档