修改任务(API名称:modifyTask)
功能介绍
用于修改任务使用的接口。
相关接口
接口名称 |
调用说明 |
---|---|
调用该接口获取到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 |
是 |
|
y |
int |
是 |
taskPreLocation参数说明:
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
x |
int |
是 |
|
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
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。