# 修改任务（API名称：modifyTask） #### 功能介绍 用于修改任务使用的接口。 #### 相关接口 | **接口名称** | **调用说明** | |:---|:---| | [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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 | 是 | 1. 无现成子任务关系，则初始值赋 X=50 Y=50 2. 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 3. 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变 | | y | int | 是 | 1. 无现成子任务关系，则初始值赋 X=50 Y=50 2. 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 3. 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变 | taskPreLocation参数说明： | **参数** | **类型** | **是否必填** | **描述** | |:---|:---|:---|:---| | x | int | 是 | 1. 无现成子任务关系，则初始值赋 X=50 Y=50 2. 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 3. 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变 | | y | int | 是 | 1. 无现成子任务关系，则初始值赋 X=50 Y=50 2. 后置子任务，则在当前子任务基础上赋值：X不变，Y增加250 3. 兄弟子任务，则在当前子任务基础上赋值：X增加150，Y不变 | #### 响应参数 | **参数** | **类型** | **描述** | |:---|:---|:---| | 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 } ``` #### 状态码 状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。 #### 错误码 错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。