# 查询子任务场景列表（API名称：openTaskScene/querySubTaskList） #### 功能介绍 查询子任务场景列表。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 | #### 请求参数 请求参数 Object | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | taskId | Long | 是 | 父任务id，只能单个查询，如果不传子任务则查询下属所有的子任务 获取父任务id API请参见：[查询父任务（API名称：queryParentTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0037.html) | | 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\ | 响应结果内容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 } } ```