文档首页/ISDP/API参考/API接口/任务管理/任务进展管理/创建任务调度（API名称：createTaskSchedule）
更新时间：2025-02-11 GMT+08:00
查看PDF
分享

创建任务调度（API名称：createTaskSchedule）

功能介绍

创建任务调度。

相关接口

接口名称

调用说明

获取Token

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

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/openTaskSchedule/createTaskSchedule

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

taskScheduleName

String

是

任务调度名称。

isEnable

String

是

是否启用。
  • 1：启用
  • 0：不启用

taskBody

Object

是

任务详情。

taskBody参数

参数

类型

是否必填

描述

taskName

String

是

任务名称。

sceneName

String

是

任务场景名称。

sceneId

Long

是

任务场景ID。

signSiteId

Long

否

作业对象ID。

signSiteCode

String

否

作业对象编码。

signSiteName

String

否

作业对象名称。

projectNo

String

否

项目编码。

projectName

String

否

项目名称。

supplierName

String

否

供应商。

assignedUserId

String

否

执行人ID。

assignedUserName

String

否

执行人名称。

userGroup

String

否

执行人群组ID。

userGroupName

String

否

执行人群组名称。

assignedUserType

String

否

执行人类型。
  • 1：用户
  • 2：群组

assignedUser

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

否

任务是否需要审批。
  • 0：不需要审批
  • 1：需要审批

collectionReviewId

Long

否

采集审批流ID。

collectionReviewName

String

否

采集审批流名称。

collectionProcessType

String

否

采集审批流类型。
  • 0：标准审批流
  • 1：临时审批流
  • 2：自定义审批流

priority

String

否

优先级。

schedulingMode

String

否

调度模式。

customerName

String

否

客户名称。

customerId

String

否

客户ID。

operationGuideList

List

否

操作指导。

attachmentList

List

否

附件。

taskMode

String

是

任务模式。
  • 1：简单任务
  • 2：任务下挂检查单

saveDraft

String

是

保持草稿、提交。
  • 0：保存草稿
  • 1：提交

taskExtendList

List

否

任务扩展属性。

scheduleType

Integer

否

调度类型。
  • 1：周
  • 2：月
  • 3：日期
  • 4：本月最后一天

scheduleHour

String

否

调度小时。

scheduleWeek

String

否

调度周日期。

scheduleDay

String

否

调度天。

cronExpr

String

否

调度表达式。

scheduleDayList

List

否

调度日期。

plannedBeginType

Integer

否

计划开始时间类型。
  • 0：当天
  • 1：调度后

beginNumberOfHours

Integer

否

计划开始时间多少小时后。

plannedCompletionType

Integer

否

计划结束时间类型。

  • 0：当天
  • 1：调度后

endNumberOfHours

Integer

否

计划完成时间多少小时后。

url

String

否

待办地址。

thirdUrl

String

否

第三方待办地址。

resource

String

否

数据源。

operUserId

Long

否

操作人ID。

响应参数

参数

类型

描述

stateCode

String

响应编码。

errorMessage

String

错误信息。

result

Object

响应数据。

请求示例

{
    "taskScheduleName": "zhangsan测试22222",
    "isEnable": "1",
    "taskBody": {
        "beginTimeBlur": false,
        "endTimeBlur": false,
        "issueId": 307892,
        "creatorDescribe": "处理人关闭",
        "label": {
            "location": "作业对象修11",
            "administrativeDivision": "行政区域修改11",
            "address": "详细地址11",
            "projectNo": "项目修改11",
            "supplier": "供应商1",
            "customer": "客户1",
            "jobDuration": "标准作业时长1",
            "projectDuration": "工期1",
            "planBeginDate": "计划开始时间1",
            "planEndDate": "计划完成时间1",
            "requiredStartTime": "要求开始时间1",
            "requiredEndTime": "要求完成时间1",
            "priority": "优先级1",
            "skill": "要求技能1",
            "schedulingMode": "调度模式1",
            "operationGuide": "操作指导1",
            "attachment": "附件1",
            "associatedIssues": "关联问题1",
            "taskDescription": "任务描述12",
            "ccPerson": "抄送人1",
            "owner": "责任人1",
            "executor": "执行人"
        },
        "taskName": "ytest0721001_wuXX720003",
        "assignedUserId": "467848",
        "assignedUserName": "呵呵",
        "userGroup": "",
        "userGroupName": "",
        "sceneName": "wuXX720003",
        "sceneId": 108090,
        "sceneCode": "TS20220720171813709",
        "sceneVersion": "1.0",
        "signSiteId": 98990882,
        "signSiteCode": "ytest0721001",
        "signSiteName": "ytest0721001",
        "projectNo": null,
        "projectName": null,
        "supplierName": "",
        "beginTimestamp": "",
        "endTimestamp": null,
        "requiredStartTime": 1658419199000,
        "requiredEndTime": 1668009599000,
        "projectDuration": "111",
        "jobDuration": "111",
        "adminOrganizationName": "XX区11112223333",
        "adminOrganization": "833",
        "administrativeDivisionName": "test0610>DFS>11111111111111111111111111111111111111111111111111",
        "administrativeDivision": "314863,417321,502567",
        "sceneLicense": null,
        "templateId": "263513",
        "templateCode": "QC2022XXXXXXXXXXXXX",
        "templateName": "wuXX720",
        "version": "1.0",
        "reviewRuleId": "",
        "reviewRuleName": "",
        "taskRemark": "测试",
        "procedureList": [],
        "subTaskList": [],
        "isAppraisal": "0",
        "collectionReviewId": "",
        "collectionReviewName": "",
        "collectionProcessType": "",
        "priority": null,
        "schedulingMode": null,
        "address": null,
        "skill": "123",
        "customerName": null,
        "customerId": null,
        "operationGuideList": [],
        "attachmentList": [],
        "taskExtend": [],
        "isApplyApprove": 0,
        "processType": "",
        "signInConfig": null,
        "ccPerson": "",
        "ccPersonName": "",
        "ccPersonGroup": "",
        "ccPersonGroupName": "",
        "owner": "",
        "ownerName": "",
        "ownerGroup": "",
        "ownerGroupName": "",
        "customApproveReviewerList": [],
        "customCollectionReviewerList": [],
        "adminRegion": "314863;417321;502567",
        "adminRegionName": "test0610;DFS;11111111111111111111111111111111111111111111111111",
        "regionId": 502567,
        "regionName": "11111111111111111111111111111111111111111111111111",
        "regionPath": "314863,417321,502567",
        "adminiRegionFlag": true,
        "projectDurationFlag": true,
        "executorFlag": true,
        "templateType": "",
        "taskMode": 2,
        "saveDraft": "1",
        "plannedBeginType": "0",
        "plannedCompletionType": "0",
        "beginNumberOfHours": 0,
        "endNumberOfHours": 0,
        "scheduleDayList": [],
        "scheduleDay": "",
        "scheduleType": "1",
        "scheduleMoon": "",
        "scheduleWeek": "1,2,3,4,5,6,7",
        "scheduleHour": "0",
        "url": "http://www.域名1.com",
        "thirdUrl": "http://www.域名1.com",
        "resource": "appcube",
        "operUserId": 467848
    }
}

响应示例

{
    "stateCode": "0",
    "errorMessage": null,
    "result": {
        "parentTaskScheduleId": 0,
        "taskScheduleLevel": 1,
        "taskScheduleName": "wuXX测试22222",
        "isEnable": 1,
        "taskBody": "{\"isSubTask\":null,\"issueId\":307892,\"sceneId\":108090,\"sceneTaskId\":null,\"sceneName\":\"wuXX720003\",\"sceneCode\":\"TS20220720171813709\",\"sceneVersion\":\"1.0\",\"signSiteId\":98990882,\"signSiteCode\":\"ytest0721001\",\"signSiteName\":\"ytest0721001\",\"adminRegion\":\"314863;417321;502567\",\"adminRegionName\":\"test0610>DFS>11111111111111111111111111111111111111111111111111\",\"projectNo\":null,\"projectName\":null,\"adminOrganization\":\"833\",\"adminOrganizationName\":\"XX区11112223333\",\"supplierName\":\"\",\"taskName\":\"ytest0721001_wuXX720003\",\"templateId\":263513,\"templateName\":\"zhangsan720\",\"templateCode\":\"QC2022XXXXXXXXXXXXX\",\"version\":\"1.0\",\"beginTimestamp\":1658419200000,\"endTimestamp\":1658505599999,\"taskRemark\":\"测试\",\"taskMode\":2,\"assignedUserId\":\"467848\",\"assignedUserName\":\"呵呵\",\"userGroup\":\"\",\"userGroupName\":\"\",\"signInConfig\":null,\"submitBy\":null,\"submitName\":null,\"operationGuideList\":[],\"attachmentList\":[],\"taskExtend\":[],\"procedureList\":[],\"subTaskList\":[],\"reviewRuleId\":null,\"reviewRuleName\":\"\",\"processType\":null,\"saveDraft\":1,\"isApplyApprove\":0,\"licenseSwitch\":null,\"isAppraisal\":0,\"collectionReviewId\":null,\"collectionReviewName\":\"\",\"collectionProcessType\":null,\"sceneLicense\":null,\"customCollectionReviewerList\":[],\"customApproveReviewerList\":[],\"terminalType\":null,\"priority\":null,\"jobDuration\":111,\"projectDuration\":111,\"schedulingMode\":null,\"administrativeDivision\":\"314863,417321,502567\",\"administrativeDivisionName\":\"test0610>DFS>11111111111111111111111111111111111111111111111111\",\"regionId\":502567,\"regionPath\":\"314863,417321,502567\",\"regionName\":\"11111111111111111111111111111111111111111111111111\",\"address\":null,\"requiredStartTime\":1658419199000,\"requiredEndTime\":1668009599000,\"skill\":\"123\",\"customerId\":null,\"customerName\":null,\"category\":\"\",\"categoryId\":null,\"parentCategory\":\"\",\"parentCategoryId\":null,\"isAssociationIssue\":null,\"associationIssueId\":null,\"ccPerson\":\"\",\"ccPersonName\":\"\",\"owner\":\"\",\"ownerName\":\"\",\"ccPersonGroup\":\"\",\"ccPersonGroupName\":\"\",\"ownerGroup\":\"\",\"ownerGroupName\":\"\",\"url\":\"http://www.${域名1}.com\",\"thirdUrl\":\"http://www.域名1.com\",\"resource\":\"appcube\",\"status\":null,\"positionName\":null,\"cronExpr\":\"0 0 0 ? * 1,2,3,4,5,6,7\",\"scheduleHour\":\"0\",\"scheduleWeek\":\"1,2,3,4,5,6,7\",\"scheduleMoon\":\"\",\"scheduleDay\":\"\",\"scheduleDayList\":[],\"scheduleType\":1,\"beginNumberOfHours\":0,\"endNumberOfHours\":0,\"plannedCompletionType\":0,\"plannedBeginType\":0,\"creatorDescribe\":\"处理人关闭\",\"schedulerBy\":null,\"schedulerName\":null,\"schedulerTimestamp\":null,\"schedulerDate\":null,\"validateFile\":true}",
        "platJobId": 1041998,
        "deleteFlag": 0,
        "tenantId": 886,
        "createdBy": 390841,
        "createName": "zdrun-test",
        "creationTimestamp": 1658479981662,
        "creationDate": "2022-07-22 16:53:01",
        "lastUpdatedBy": 390841,
        "lastUpdateName": "zdrun-test",
        "lastUpdateTimestamp": 1658479981662,
        "lastUpdateDate": "2022-07-22 16:53:01",
        "entityName": "IsdpTaskSchedule",
        "taskScheduleId": 4874,
        "appName": "isdp-task-server",
        "affectedRows": 1
    }
}

父主题：任务进展管理

相关文档