1. 任务服务管理
1.1. 任务对象
1.1.1. 任务对象实例
{
"id" : 630056557619529069,
"subject" : "任务名称",
"plannedStartTime" : "2014-12-01",
"plannedEndTime" : "2014-12-31",
"importantLevel" : 1,
"importantLevelText" : "普通",
"status" : 2,
"finishRate" : "0%",
"managers" : "Member|7401620484776805666",
"managerNames" : "lsm",
"remindStartTime" : -1,
"remindEndTime" : -1,
"remindStartTimeText" : "无",
"remindEndTimeText" : "无",
"createUser" : 7401620484776805666,
"createUserName" : "lsm",
"parentId" : -1,
"parentTaskSubject" : null,
"logicalPath" : "630056557619529069",
"logicalDepth" : 0,
"plannedTaskTime" : 0.0,
"actualTaskTime" : "0小时",
"riskLevel" : 0,
"actualStartTime" : "",
"actualEndTime" : "",
"has_attachments" : false,
"milestone" : 0,
"content" : "内容",
"ischild" : false,
"haschild" : false,
"participators" : "Member|6346947374420280495",
"participatorsName" : "java",
"inspectors" : "",
"inspectorsName" : null,
"ishidden" : false,
"weight" : null,
"index" : 0,
"disable" : false,
"fulltime" : 1,
"projectId" : -1,
"projectPhaseId" : 1,
"sourceId" : -1,
"sourceName" : "",
"sourceType" : 0,
"isOverdue" : 0,
"projectName" : null,
"purviewList" : [ ]
}
1.1.2. 任务属性说明
| 参数 | 说明 |
|---|---|
| id | 主键 |
| subject | 任务标题 |
| plannedStartTime | 任务计划开始时间 |
| plannedEndTime | 任务计划结束时间 |
| importantLevel | 任务重要程度 |
| importantLevelText | |
| status | 任务状态 |
| finishRate | 完成百分率 |
| managers | 任务负责人 |
| managerNames | |
| remindStartTime | 开始前提醒时间间隔 |
| remindEndTime | 结束前提醒时间间隔 |
| remindStartTimeText | |
| remindEndTimeText | |
| createUser | 任务创建人 |
| createUserName | |
| parentId | 上级任务ID |
| parentTaskSubject | 上级任务名称 |
| logicalPath | 任务的逻辑路径 |
| logicalDepth | 任务的逻辑层级深度 |
| plannedTaskTime | 计划任务工时 |
| actualTaskTime | 实际任务工时 |
| riskLevel | 任务风险级别 |
| actualStartTime | 任务实际开始时间 |
| actualEndTime | 任务实际结束时间 |
| has_attachments | 是否包含附件 |
| milestone | 用于判断是否是里程碑任务，1代表是，0代表否 |
| content | 内容 |
| ischild | |
| haschild | |
| participators | |
| participatorsName | |
| inspectors | |
| inspectorsName | |
| ishidden | |
| weight | |
| index | |
| disable | |
| fulltime | |
| projectId | 关联的项目ID |
| projectPhaseId | 关联的项目阶段ID |
| sourceId | 用于保存其他业务转任务的来源编号 |
| sourceName | |
| sourceType | 用于保存其他业务转任务的来源类型 |
| isOverdue | |
| projectName | |
| purviewList | - |
1.2. 按照任务ID获取任务信息
开发者可以通过【任务ID】来获取任务信息。
接口请求说明：
http请求方式：GET
http://ip:port/seeyon/rest/task/{id}
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| id | 是 | 任务ID |
返回说明
正常情况下，会返回的是JSON格式任务信息，JSON数据包参考：任务对象实例
参数说明 请参考:任务属性说明
1.3. 按照用户ID获取待完成任务数
开发者可以通过【人员ID】来获取任务信息总数。
接口请求说明：
http请求方式：GET
http://ip:port/seeyon/tasks/{userId}
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| userId | 是 | 人员ID |
返回说明
正常情况下，返回任务总数，失败抛出异常。
1.4. 修改任务进度
开发者可以通过【任务ID】【人员ID】【flag】来获取会议信息。
接口请求说明：
http请求方式：POST
http://ip:port/seeyon/task/update/
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| user_id | 是 | 人员ID |
| task_id | 是 | 任务ID |
| flag | 是 | flag=false 任务【进度=0%，状态=进行中】; flag=true 任务【进度=100%，状态=已完成】 |
注意
从V6.0开始，参数[userId]改为非必填（此参数传递不再生效）
返回说明
正常情况下，会返回的是boolean信息，成功返回true,失败返回false.
1.5. 按照任务ID删除任务信息
开发者可以通过【任务ID】和【用户ID】删除任务
接口请求说明：
http请求方式：put
http://ip:port/seeyon/task/remove/{taskId}/{userId}
注意V6.0版本开始此接口请求变动:
http请求方式：post
http://ip:port/seeyon/task/remove/{taskId}
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| userId | 是 | 人员ID |
| taskId | 是 | 任务ID |
返回说明
正常情况下，会返回的是boolean信息，成功返回true,失败返回false.