查询子任务（API名称：OpenSceneTask/querySubTaskList）
功能介绍
用户需要查询单个父任务下的子任务信息时，可以通过该接口查询子任务列表信息。
相关接口
调用流程
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 |
响应状态码：
|
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
}]
}]
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
