文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务进展管理/ 查询子任务(API名称:OpenSceneTask/querySubTaskList)
更新时间:2024-07-22 GMT+08:00
分享

查询子任务(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

响应参数

参数

类型

描述

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

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档