根据扩展字段查询任务列表(API名称:openTaskScene/queryTaskComponent)
功能介绍
根据扩展字段查询任务列表
相关接口
接口名称 |
调用说明 |
---|---|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
URL
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
---|---|---|---|
POST |
https://isdp+域名/openapi/v1/openTaskScene/queryTaskComponent |
OpenAPI |
application/json |
请求头
KEY |
VALUE |
是否必填 |
描述 |
---|---|---|---|
Content-Type |
application/json |
是 |
无 |
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
page |
Object |
否 |
分页参数 |
dataSource |
String |
是 |
数据来源 (只支持 appcube 入参) |
fieldList |
List<Object> |
是 |
扩展字段查询 |
sceneName |
String |
否 |
一级工艺名称 |
sceneModeName |
String |
否 |
二级工艺名称 |
ownerList |
List<Long> |
否 |
质检userId集合 |
exceutorList |
List<Long> |
否 |
作业userId集合 |
createBeginTime |
Long |
否 |
创建开始时间 |
createEndTime |
Long |
否 |
创建结束时间 |
fieldList入参
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
fieldName |
String |
是 |
扩展字段编码(udf1 – udf40) |
fieldValue |
String |
是 |
扩展字段值 |
inspection |
Boolean |
否 |
false-支持空值查询 |
page入参
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
start |
Integer |
否 |
开始行 默认0 |
count |
Integer |
否 |
总行数 默认15 |
响应参数
参数 |
类型 |
描述 |
---|---|---|
stateCode |
String |
响应状态码。 |
0:成功 |
||
其他:失败 |
||
errorMessage |
String |
响应描述。 |
result |
Object |
响应结果内容data |
result出参
参数 |
类型 |
描述 |
---|---|---|
pos |
Integer |
当前页码,从0开始 |
total_count |
Integer |
查询结果总条数 |
data |
List<Object> |
场景列表 |
data出参
参数 |
类型 |
描述 |
---|---|---|
sceneTaskId |
Long |
任务id |
taskName |
String |
任务名称 |
sceneMode |
Integer |
任务模式:
|
status |
Integer |
任务状态:
|
createdBy |
Long |
创建人id |
createName |
String |
创建人姓名 |
createDate |
Long |
任务创建时间 |
planStartTime |
Long |
计划开始时间 |
planEndTime |
Long |
计划完成时间 |
actualBeginTime |
Long |
实际开始时间 |
actualEndTime |
Long |
实际完成时间 |
processFeedback |
String |
进展反馈 |
currentProcedureId |
Integer |
当前工序步骤 |
currentProcedureName |
String |
当前工序名称 |
licenseSwitch |
Integer |
是否受许可控制开关:
|
checkOrderId |
Long |
关联检查单id |
checkOrderName |
String |
关联的检查单名称 |
checkOrderType |
Integer |
任务生成的检查单类型:
|
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 |
任务作业对象类型名称 |
createAttribute |
Object(UDF1-UDF40对应任务场景中的扩展属性编码) |
创建阶段扩展属性 |
executeAttribute |
Object(UDF1-UDF40对应任务场景中的扩展属性编码) |
执行阶段扩展属性 |
executorList |
Object |
任务执行人 |
ownerList |
Object |
任务责任人 |
preTaskList |
List< Object > |
子任务关联关系 |
subTaskInfo 出参
参数 |
类型 |
描述 |
---|---|---|
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 |
对应得父任务信息 |
executorList |
Object |
任务执行人 |
ownerList |
Object |
任务责任人 |
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 |
任务模式:
|
status |
Integer |
任务状态:
|
createdBy |
Long |
创建人id |
createName |
String |
创建人姓名 |
createDate |
Long |
任务创建时间 |
planStartTime |
Long |
计划开始时间 |
planEndTime |
Long |
计划完成时间 |
actualBeginTime |
Long |
实际开始时间 |
actualEndTime |
Long |
实际完成时间 |
processFeedback |
String |
进展反馈 |
currentProcedureId |
Integer |
当前工序步骤 |
currentProcedureName |
String |
当前工序名称 |
licenseSwitch |
Integer |
是否受许可控制开关:
|
checkOrderId |
Long |
关联检查单id |
checkOrderName |
String |
关联的检查单名称 |
checkOrderType |
Integer |
任务生成的检查单类型:
|
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 |
任务作业对象类型名称 |
data中executorList字段说明:
参数 |
类型 |
描述 |
---|---|---|
userId |
Long |
人员ID |
userName |
String |
人员名称 |
userType |
Integer |
任务类型 |
data中preTaskList字段说明:
参数 |
类型 |
描述 |
---|---|---|
taskPreId |
Long |
后置任务id |
preTaskId |
Long |
前置任务id |
taskPreName |
String |
后置任务名称 |
preTaskName |
String |
前置任务名称 |
preType |
Integer |
前置任务类型 |
preTaskLocation |
String |
前置任务位置信息 |
taskPreLocation |
String |
后置任务位置信息 |
taskId |
Long |
父任务ID |
sceneId |
Long |
场景ID |
请求示例
{ "UDF6": " sffffff", "dataSource": "appcube" }
响应示例
{ "stateCode": "0", "errorMessage": null, "result": { "data": [ { "sceneTaskId": 5074832, "sceneMode": 4, "status": 1, "createdBy": 1823, "createName": "张三", "currentProcedureId": null, "currentProcedureName": null, "licenseSwitch": null, "processFeedback": null, "checkOrderId": null, "checkOrderName": null, "checkOrderType": null, "creationTimestamp": 1691810940095, "actualBeginTime": null, "schedulerDate": 1691810940000, "schedulerTimestamp": 1691810940094, "schedulerBy": 1823, "schedulerName": "张三", "actualEndTime": null, "lastUpdatedBy": 1823, "lastUpdateName": "张三", "lastUpdateTimestamp": 1691810940095, "taskType": 1, "category": "", "categoryId": null, "parentCategory": "", "parentCategoryId": null, "taskName": "测试_01_20230812_112826", "sceneId": 5004167, "sceneName": "测试_01", "signSiteId": null, "signSiteName": null, "signSiteCode": null, "regionId": null, "regionPath": null, "regionName": null, "supplierName": null, "adminOrganizationName": "1508098844233300", "adminOrganization": "1543", "sceneCode": "TS20230812112813464", "projectNo": "", "taskObjectType": null, "projectName": "", "requiredEndTime": null, "planStartTime": null, "planEndTime": null, "deleteFlag": 0, "deleteReason": null, "priority": null, "jobDuration": null, "projectDuration": null, "schedulingMode": null, "administrativeDivision": null, "administrativeDivisionName": null, "skill": null, "customerId": null, "customerName": null, "address": null, "requiredStartTime": null, "executorList": [ { "sceneTaskId": 5074832, "taskType": 1, "userId": 1823, "userInfoId": 5276777, "userName": "张三", "userType": 1 } ], "createAttribute": { "UDF28": null, "UDF27": null, "UDF29": null, "UDF24": null, "UDF23": null, "UDF26": null, "UDF25": null, "UDF20": null, "UDF6": "sffffff", "UDF5": "123", "UDF22": null, "UDF4": "1691810741000", "UDF21": null, "UDF3": "1691769600000", "UDF2": "123", "UDF1": "123", "UDF40": null, "UDF9": null, "UDF8": null, "UDF7": "sffff", "UDF17": null, "UDF39": null, "UDF16": null, "UDF38": null, "UDF19": null, "UDF18": null, "UDF13": null, "UDF35": null, "UDF12": null, "UDF34": null, "UDF15": null, "UDF37": null, "UDF14": null, "UDF36": null, "UDF31": null, "UDF30": null, "UDF11": null, "UDF33": null, "UDF10": null, "UDF32": null }, "executeAttribute": null, "subTaskList": [ { "sceneTaskId": 5022056, "taskId": 5074832, "taskName": "子任务1_20230812_112826", "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": null, "jobDuration": null, "projectDuration": null, "administrativeDivision": "", "administrativeDivisionName": "", "skill": null, "address": null, "requiredStartTime": null, "requiredEndTime": null, "executorList": [ { "sceneTaskId": 5022056, "taskType": 2, "userId": 1823, "userInfoId": 5276779, "userName": "张三", "userType": 1 } ], "createAttribute": { "UDF28": null, "UDF27": null, "UDF29": null, "UDF24": null, "UDF23": null, "UDF26": null, "UDF25": null, "UDF20": null, "UDF6": "sffffff", "UDF5": "123", "UDF22": null, "UDF4": "123", "UDF21": null, "UDF3": "1691810875000", "UDF2": "123", "UDF1": "123", "UDF40": null, "UDF9": null, "UDF8": null, "UDF7": null, "UDF17": null, "UDF39": null, "UDF16": null, "UDF38": null, "UDF19": null, "UDF18": null, "UDF13": null, "UDF35": null, "UDF12": null, "UDF34": null, "UDF15": null, "UDF37": null, "UDF14": null, "UDF36": null, "UDF31": null, "UDF30": null, "UDF11": null, "UDF33": null, "UDF10": null, "UDF32": null }, "executeAttribute": { "UDF28": null, "UDF27": null, "UDF29": null, "UDF24": null, "UDF23": null, "UDF26": null, "UDF25": null, "UDF20": null, "UDF6": null, "UDF5": null, "UDF22": null, "UDF4": null, "UDF21": null, "UDF3": null, "UDF2": null, "UDF1": null, "UDF40": null, "UDF9": null, "UDF8": null, "UDF7": null, "UDF17": null, "UDF39": null, "UDF16": null, "UDF38": null, "UDF19": null, "UDF18": null, "UDF13": null, "UDF35": null, "UDF12": null, "UDF34": null, "UDF15": null, "UDF37": null, "UDF14": null, "UDF36": null, "UDF31": null, "UDF30": null, "UDF11": null, "UDF33": null, "UDF10": null, "UDF32": null } } ] }, { "sceneTaskId": 5022056, "sceneMode": 1, "status": 1, "createdBy": 1823, "createName": "张三", "currentProcedureId": null, "currentProcedureName": null, "licenseSwitch": null, "processFeedback": null, "checkOrderId": null, "checkOrderName": null, "checkOrderType": null, "creationTimestamp": 1670485972874, "actualBeginTime": null, "schedulerDate": 1670485973000, "schedulerTimestamp": 1670485972874, "schedulerBy": 1823, "schedulerName": "张三", "actualEndTime": null, "lastUpdatedBy": 1823, "lastUpdateName": "张三", "lastUpdateTimestamp": 1670485972874, "taskType": 1, "category": null, "categoryId": null, "parentCategory": null, "parentCategoryId": null, "taskName": "任务导入1800", "sceneId": 5001392, "sceneName": "测试任务导入场景-简单", "signSiteId": 9911293387, "signSiteName": "bzh00201", "signSiteCode": "bzh00201", "regionId": 1393930, "regionPath": "1849,1851,1231589,4544,1393930", "regionName": "龙岗区", "supplierName": "是合作伙伴不", "adminOrganizationName": "1508098844233300", "adminOrganization": "1543", "sceneCode": "TS20221207121254521", "projectNo": "导入001", "taskObjectType": null, "projectName": "导入001", "requiredEndTime": null, "planStartTime": null, "planEndTime": null, "deleteFlag": 0, "deleteReason": null, "priority": null, "jobDuration": null, "projectDuration": null, "schedulingMode": null, "administrativeDivision": "1849,1851,1231589,4544,1393930", "administrativeDivisionName": "中国>广东省>广东省>深圳>龙岗区", "skill": null, "customerId": 16690, "customerName": "移动", "address": null, "requiredStartTime": null, "executorList": [ { "sceneTaskId": 5022056, "taskType": 1, "userId": 1823, "userInfoId": 5081358, "userName": "张三", "userType": 1 } ], "createAttribute": null, "executeAttribute": null, "subTaskList": [] } ], "pos": 0, "total_count": 3, "entityName": null, "totalCount": 3 } }