文档首页> ISDP> API参考> API接口> 任务管理> 任务进展管理> 根据扩展字段查询任务列表（API名称：openTaskScene/queryTaskComponent）

更新时间：2024-02-19 GMT+08:00

根据扩展字段查询任务列表（API名称：openTaskScene/queryTaskComponent）

功能介绍

根据扩展字段查询任务列表

接口名称	调用说明
获取Token	调用该接口获取到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	任务模式： 1：简单任务 2：启用检查单 3：启用工序 4：父子任务
status	Integer	任务状态： 0：草稿 1：待执行 2：执行中 3：已完成 4：已取消 5：申请待审批 9：已驳回
createdBy	Long	创建人id
createName	String	创建人姓名
createDate	Long	任务创建时间
planStartTime	Long	计划开始时间
planEndTime	Long	计划完成时间
actualBeginTime	Long	实际开始时间
actualEndTime	Long	实际完成时间
processFeedback	String	进展反馈
currentProcedureId	Integer	当前工序步骤
currentProcedureName	String	当前工序名称
licenseSwitch	Integer	是否受许可控制开关： 1-是 0-否
checkOrderId	Long	关联检查单id
checkOrderName	String	关联的检查单名称
checkOrderType	Integer	任务生成的检查单类型： 0：EHS 1：质量检查 2：巡检
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	任务模式： 1：简单任务 2：启用检查单 3：启用工序 4：父子任务
status	Integer	任务状态： 0：草稿 1：待执行 2：执行中 3：已完成 4：已取消 5：申请待审批 9：已驳回
createdBy	Long	创建人id
createName	String	创建人姓名
createDate	Long	任务创建时间
planStartTime	Long	计划开始时间
planEndTime	Long	计划完成时间
actualBeginTime	Long	实际开始时间
actualEndTime	Long	实际完成时间
processFeedback	String	进展反馈
currentProcedureId	Integer	当前工序步骤
currentProcedureName	String	当前工序名称
licenseSwitch	Integer	是否受许可控制开关： 1-是 0-否
checkOrderId	Long	关联检查单id
checkOrderName	String	关联的检查单名称
checkOrderType	Integer	任务生成的检查单类型： 0：EHS 1：质量检查 2：巡检
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
    }
}

父主题： 任务进展管理

上一篇：获取指定时间区间的派工人数（API名称：queryPeopleCount）

下一篇：作业标准管理

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

根据扩展字段查询任务列表（API名称：openTaskScene/queryTaskComponent）

功能介绍

相关接口

URL

请求头

请求参数

响应参数

请求示例

响应示例

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线