修改任务（API名称：modifyTask）

功能介绍

用于修改任务使用的接口。

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

URL

请求方式	HTTPS地址	服务架构	消息体类型
POST	https://*isdp+域名*/openapi/v1/openSceneTask/modifyTask	OpenAPI	application/json

请求头

KEY	VALUE	是否必填	描述
Content-Type	application/json	是	无
Authorization	bearer ${access_token}	是	bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数	类型	是否必填	描述
sceneTaskId	Long	是	任务ID
operUserId	Long	否	操作人ID
operUserNo	String	否	操作人编码
customerTaskId	Long	否	客户任务ID
resource	String	否	任务来源
taskName	String	是	任务名称
sceneName	String	是	任务场景名称
sceneId	Long	是	任务场景ID
sceneCode	String	是	场景编码
sceneVersion	String	是	场景版本
signSiteId	Long	否	作业对象ID
signSiteCode	String	否	作业对象编码
signSiteName	String	否	作业对象名称
projectNo	String	否	项目编码
projectName	String	否	项目名称
supplierName	String	否	供应商
assignedUserType	String	否	执行人类型
assignedUser	String	否	执行人账号
assignedUserId	String	否	执行人ID
assignedUserName	String	否	执行人名称
beginTimestamp	Long	否	计划开始时间
endTimestamp	Long	否	计划完成时间
requiredStartTime	Long	否	要求开始时间
requiredEndTime	Long	否	要求完成时间
projectDuration	String	否	工期
jobDuration	String	否	标准时长
adminOrganizationName	String	是	管理组织单元名称
adminOrganization	String	是	管理组织单元编码
administrativeDivision	String	否	行政区域
administrativeDivisionName	String	否	行政区域名称说明：支持输入多个值，多个值时用分号隔开。
regionName	String	否	行政区域名称
regionId	String	否	行政区域ID
regionPath	String	否	行政区域路径
skill	String	否	技能
address	String	否	详细地址
templateId	Long	否	模板ID
templateCode	String	否	模板编码
templateName	String	否	模板名称
version	String	否	版本
reviewRuleId	Long	否	任务申请审批流ID
reviewRuleName	String	否	任务申请审批流名称
taskRemark	String	否	任务备注
isAppraisal	String	否	任务是否需要审批
collectionReviewId	Long	否	采集审批流ID
collectionReviewName	String	否	采集审批流名称
collectionProcessType	String	否	采集审批流类型(
priority	String	否	优先级
schedulingMode	String	否	调度模式
customerName	String	否	客户名称
customerId	String	否	客户ID
operationGuideList	List	否	操作指导
attachmentList	List	否	附件
taskMode	String	是	任务模式
saveDraft	String	是	保持草稿、提交
taskExtend	List	否	任务扩展属性
url	String	否	待办地址
thirdUrl	String	否	第三方待办地址

taskExtend扩展属性每个Object字段说明

参数	类型	是否必填	描述
extendName	Long	是	任务扩展属性名称
extendType	Long	是	扩展属性类型（1：长文本；2：枚举；3：多枚举；4：日期；5：时间；6：整数；7：小数；20：短文本）
extendValue	String	否	任务扩展属性值
fieldOrder	Integeer	否	任务扩展属性顺序
isNecessary	String	是	扩展属性是否必填（1：必填；2：不必填）
sceneTaskId	Long	是	任务id
stage	Integer	否	任务扩展属性阶段 1：创建阶段 2：执行阶段
unitName	String	否	单位名称

preTaskList子任务前后置关系每个Object字段说明：

参数	类型	是否必填	描述
isEnabledScenePre	String	否	是否继承场景前后置关系 Y：从场景获取，不取接口参数 N ：不从场景获取，只取接口入参为准；默认Y，从场景集成
preTaskName	String	是	前置任务名称
preTaskLocation	String	是	前置任务位置信息
taskPreName	String	是	后置任务名称
taskPreLocation	String	是	后置任务位置
preType	String	是	前置后置关系

preTaskLocation参数说明：

参数	类型	是否必填	描述
x	int	是	无现成子任务关系，则初始值赋 X=50 Y=50 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变
y	int	是

taskPreLocation参数说明：

参数	类型	是否必填	描述
x	int	是	无现成子任务关系，则初始值赋 X=50 Y=50 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变
y	int	是

响应参数

参数	类型	描述
stateCode	String	接口响应编码，0成功，非0失败
errorMessage	String	接口错误提示信息
result	Map	接口响应数据。1：待执行；2：执行中；3：已完成。注意，result可能会是空map，请注意判空处理。

请求示例

{
    "actualBeginTime": null,
    "actualEndTime": null,
    "address": null,
    "adminOrganization": "25245",
    "adminOrganizationName": "信息展示子系统SIT测试租户",
    "administrativeDivision": null,
    "administrativeDivisionName": null,
    "assignedUserId": "864221",
    "assignedUserName": "15319700143",
    "attachmentList": [],
    "beginTimestamp": null,
    "category": null,
    "categoryId": null,
    "ccPerson": "",
    "ccPersonGroup": "",
    "ccPersonGroupName": "",
    "ccPersonName": "",
    "checkOrderId": null,
    "checkOrderName": null,
    "collectionProcessType": null,
    "collectionReviewId": null,
    "collectionReviewName": null,
    "commandSwitch": "N",
    "createName": "153xxxx0143",
    "createdBy": 864221,
    "creationDate": "2023-02-08T09:19:50.000+00:00",
    "creationTimestamp": 1675847990937,
    "customerId": null,
    "customerName": null,
    "endTimestamp": null,
    "isApplyApprove": 0,
    "isAppraisal": null,
    "jobDuration": null,
    "latitude": "",
    "longitude": "",
    "operUserId": 864221,
    "operationGuideList": [],
    "owner": "",
    "ownerGroup": "",
    "ownerGroupName": "",
    "ownerName": "",
    "parentCategory": null,
    "parentCategoryId": null,
    "priority": null,
    "processType": null,
    "projectDuration": null,
    "projectName": null,
    "projectNo": null,
    "regionId": null,
    "regionName": null,
    "regionPath": null,
    "regionPathName": null,
    "requiredEndTime": null,
    "requiredStartTime": null,
    "reviewRuleId": null,
    "reviewRuleName": "",
    "saveDraft": "0",
    "sceneCode": "TS20230206201933023",
    "sceneId": 127790,
    "sceneLicense": null,
    "sceneMode": 4,
    "sceneName": "父子任务有扩展属性",
    "sceneTaskId": 3233357,
    "sceneVersion": "1.0",
    "schedulingMode": null,
    "signInConfig": null,
    "signSiteCode": "新建作业对象编码",
    "signSiteId": 99054145,
    "signSiteName": "新建作业对象名称",
    "skill": null,
    "status": 0,
    "subTaskList": [
        {
            "address": "",
            "administrativeDivision": null,
            "administrativeDivisionName": null,
            "allIssueList": [],
            "assignedUserId": "864221",
            "assignedUserName": "15319700143",
            "beginTimestamp": null,
            "ccPerson": "",
            "ccPersonGroup": "",
            "ccPersonGroupName": "",
            "ccPersonName": "",
            "collectionReviewName": null,
            "description": "",
            "endTimestamp": null,
            "isAppraisal": 0,
            "isNA": 0,
            "issueId": null,
            "keyPoint": null,
            "latitude": "",
            "licenseSwitch": 0,
            "longitude": "",
            "modeOrder": 1,
            "oldTaskName": "子任务1",
            "operationGuideList": [],
            "owner": "",
            "ownerGroup": "",
            "ownerGroupName": "",
            "ownerName": "",
            "parentTaskId": 3233357,
            "priority": null,
            "procedureOrNot": 0,
            "regionName": null,
            "regionPath": null,
            "sceneModeCode": "225814",
            "sceneTaskId": 1959907,
            "signSiteCode": "",
            "signSiteId": "",
            "signSiteName": "",
            "skill": null,
            "status": 0,
            "taskExtend": [
                {
                    "extendName": "实际工作量",
                    "extendType": 7,
                    "extendValue": "1.00",
                    "fieldOrder": 1,
                    "isNecessary": 1,
                    "maxValue": "2000.00",
                    "minValue": "1.00",
                    "precision": 2,
                    "sceneTaskId": 1959907,
                    "stage": 2,
                    "udfName": "UDF1",
                    "unitName": "公斤"
                },
                {
                    "extendName": "计划工作量",
                    "extendType": 7,
                    "extendValue": "1.00",
                    "fieldOrder": 2,
                    "isNecessary": 1,
                    "maxValue": "2000.00",
                    "minValue": "1.00",
                    "precision": 2,
                    "sceneTaskId": 1959907,
                    "stage": 1,
                    "udfName": "UDF2",
                    "unitName": "公斤"
                }
            ],
            "taskName": "子任务1",
            "taskObjectType": "",
            "taskType": 2,
            "templateCode": "",
            "templateName": "",
            "userGroup": "",
            "userGroupName": "",
            "version": ""
        },
        {
            "address": "",
            "administrativeDivision": null,
            "administrativeDivisionName": null,
            "allIssueList": [],
            "assignedUserId": "864221",
            "assignedUserName": "15319700143",
            "beginTimestamp": null,
            "ccPerson": "",
            "ccPersonGroup": "",
            "ccPersonGroupName": "",
            "ccPersonName": "",
            "collectionReviewName": null,
            "description": "",
            "endTimestamp": null,
            "isAppraisal": 0,
            "isNA": 0,
            "issueId": null,
            "keyPoint": null,
            "latitude": "",
            "licenseSwitch": 0,
            "longitude": "",
            "modeOrder": 2,
            "oldTaskName": "子任务2",
            "operationGuideList": [],
            "owner": "",
            "ownerGroup": "",
            "ownerGroupName": "",
            "ownerName": "",
            "parentTaskId": 3233357,
            "priority": null,
            "procedureOrNot": 0,
            "regionName": null,
            "regionPath": null,
            "sceneModeCode": "225815",
            "sceneTaskId": 1959908,
            "signSiteCode": "",
            "signSiteId": "",
            "signSiteName": "",
            "skill": null,
            "status": 0,
            "taskExtend": [
                {
                    "extendName": "实际工作量",
                    "extendType": 7,
                    "extendValue": "1.00",
                    "fieldOrder": 1,
                    "isNecessary": 1,
                    "maxValue": "2000.00",
                    "minValue": "1.00",
                    "precision": 2,
                    "sceneTaskId": 1959908,
                    "stage": 2,
                    "udfName": "UDF1",
                    "unitName": "公斤"
                },
                {
                    "extendName": "计划工作量",
                    "extendType": 7,
                    "extendValue": "1.00",
                    "fieldOrder": 2,
                    "isNecessary": 1,
                    "maxValue": "2000.00",
                    "minValue": "1.00",
                    "precision": 2,
                    "sceneTaskId": 1959908,
                    "stage": 1,
                    "udfName": "UDF2",
                    "unitName": "公斤"
                }
            ],
            "taskName": "子任务2",
            "taskObjectType": "",
            "taskType": 2,
            "templateCode": "",
            "templateName": "",
            "userGroup": "",
            "userGroupName": "",
            "version": ""
        }
    ],
    "supplierName": null,
    "taskExtend": [
        {
            "extendName": "计划工作量",
            "extendType": 7,
            "extendValue": "10",
            "fieldOrder": 1,
            "isNecessary": 1,
            "maxValue": "12.000",
            "minValue": "2.000",
            "precision": 3,
            "sceneTaskId": 3233357,
            "stage": 1,
            "udfName": "UDF20",
            "unitName": "公斤"
        },
        {
            "extendName": "实际工作量",
            "extendType": 6,
            "extendValue": "10",
            "fieldOrder": 2,
            "isNecessary": 2,
            "maxValue": "20",
            "minValue": "5",
            "precision": 0,
            "sceneTaskId": 3233357,
            "stage": 2,
            "udfName": "UDF1",
            "unitName": "公斤"
        }
    ],
    "taskMode": 4,
    "taskName": "新创建",
    "taskObjectType": "公路站",
    "taskRemark": null,
    "templateCode": null,
    "templateId": null,
    "templateName": null,
    "userGroup": "",
    "userGroupName": "",
    "version": null
}

响应示例

{
"stateCode": "0",
    "errorMessage": null,
    "result": null
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 任务进展管理

上一篇：查询父任务&子任务（API名称：queryParentAndSubTaskInfos）

下一篇：删除任务（API名称：deleteSceneTask）

修改任务（API名称：modifyTask）

功能介绍

相关接口

URL

请求头

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

您对此文档页面的整体评价？