查询子任务（API名称：OpenSceneTask/querySubTaskList）

功能介绍

用户需要查询单个父任务下的子任务信息时，可以通过该接口查询子任务列表信息。

接口名称	调用说明
获取Token	调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。
查询父任务	调用该接口获取到父任务ID。查询子任务时，需要输入父任务ID。

调用流程

图1 查询子任务流程
点击放大

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中获取的access_token的值

请求参数

参数	类型	是否必填	描述
taskId	Long	是	父任务id，只能单个查询，如果不传子任务则查询下属所有的子任务获取父任务id API请参见：查询父任务（API名称：queryParentTaskList）
subTaskId	Long	否	子任务id

参数

类型

是否必填

描述

taskId

Long

是

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

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

subTaskId

Long

否

子任务id

响应参数

参数	类型	描述
stateCode	String	响应状态码： 0-成功其他-失败
errorMessage	String	响应描述
result	List<Map>	响应结果内容

参数

类型

描述

stateCode

String

响应状态码：

0-成功
其他-失败

errorMessage

String

响应描述

result

List<Map>

响应结果内容

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
		}]
	}]
}