# 查询子任务（API名称：OpenSceneTask/querySubTaskList） #### 功能介绍 用户需要查询单个父任务下的子任务信息时，可以通过该接口查询子任务列表信息。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 | | [查询父任务](https://support.huaweicloud.com/api-isdp/api_01_0037.html) | 调用该接口获取到父任务ID。 查询子任务时，需要输入父任务ID。 | #### 调用流程 图1查询子任务流程 ![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002490654840.png "点击放大") #### URL | **请求方式** | **HTTPS地址** | **服务架构** | **消息体类型** | |:---|:---|:---|:---| | POST | https://***isdp+域名***/openapi/v1/OpenSceneTask/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的值 | #### 请求参数 | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | taskId | Long | 是 | 父任务id，只能单个查询，如果不传子任务则查询下属所有的子任务 获取父任务id API请参见：[查询父任务（API名称：queryParentTaskList）](https://support.huaweicloud.com/api-isdp/api_01_0037.html) | | subTaskId | Long | 否 | 子任务id | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | stateCode | String | 响应状态码： - 0-成功 - 其他-失败 | | errorMessage | String | 响应描述 | | result | List\ | 响应结果内容 | result出参： | **参数** | **类型** | **描述** | |:---|:---|:---| | 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 | 子任务关联工序 | result中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：不必填） | result中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 | 工序操作指导文件大小 | #### 请求示例 ``` { “taskId”:5064810, “subTaskId”:5010379 } ``` #### 响应示例 ``` { "stateCode": "0", "errorMessage": null, "result": [{ "sceneTaskId": 5010379, "taskId": 5064810, "taskName": "子任务1_20230204_164453", "status": 1, "createdBy": 1823, "createName": "张三", "currentProcedureId": null, "currentProcedureName": null, "pocedureOrNot": 0, "checkOrderId": null, "checkOrderName": null, "checkOrderType": null, "description": "", "actualEndTime": null, "actualBeginTime": null, "beginTimestamp": null, "endTimestamp": null, "processFeedback": null, "isNa": 0, "signSiteId": null, "signSiteCode": "", "signSiteName": "", "regionId": null, "regionPath": null, "regionName": null, "isExecute": 1, "priority": "", "jobDuration": null, "projectDuration": null, "administrativeDivision": "", "administrativeDivisionName": "", "skill": "", "address": "", "requiredStartTime": null, "requiredEndTime": null, "taskExtend": [{ "extendName": "子任务单枚2", "stage": 1, "fieldOrder": 3, "extendValue": "123", "udfName": "UDF7", "extendType": 2, "isNecessary": 2 }, { "extendName": "子任务多枚2", "stage": 1, "fieldOrder": 4, "extendValue": "多1;多2", "udfName": "UDF8", "extendType": 3, "isNecessary": 2 }, { "extendName": "短文本1", "stage": 1, "fieldOrder": 6, "extendValue": "默认值", "udfName": "UDF1", "extendType": 20, "isNecessary": 2 }], "procedureList": [{ "isAppraisal": null, "collectionReviewName": null, "licenseSwitch": 0, "operationGuideList": [], "description": "", "templateCode": null, "templateId": null, "version": null, "templateName": null, "licenseTag": 0, "taskName": "简单工序", "collectionReviewId": null, "procedureOrder": 1 }, { "isAppraisal": 1, "collectionReviewName": "测试审批流123", "licenseSwitch": 0, "operationGuideList": [], "description": "", "templateCode": "QC2022XXXXXXXXXXXXX", "templateId": 268612896, "version": "1.0", "templateName": "测试openApi导入模板1", "licenseTag": 0, "taskName": "工序带采集审批", "collectionReviewId": 100417, "procedureOrder": 2 }] }] } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。