文档首页/ ISDP/ API参考/ API接口/ 任务管理/ 任务进展管理/ 修改任务(API名称:modifyTask)
更新时间:2024-01-31 GMT+08:00
分享

修改任务(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

  1. 无现成子任务关系,则初始值赋 X=50 Y=50
  2. 后置子任务,则在当前子任务基础上赋值:X不变,Y增加250
  3. 兄弟子任务,则在当前子任务基础上赋值:X增加150,Y不变

y

int

taskPreLocation参数说明:

参数

类型

是否必填

描述

x

int

  1. 无现成子任务关系,则初始值赋 X=50 Y=50
  2. 后置子任务,则在当前子任务基础上赋值:X不变,Y增加250
  3. 兄弟子任务,则在当前子任务基础上赋值: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
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档