# 任务服务管理

# 接口调用方式

本接口为主OA Http Rest，允许被异构系统远程调用，调用前需要调用Rest接口文档 (opens new window)获取Restful token身份凭证。

# 任务对象

# 任务对象实例

{
  "id" : 630056557619529069,
  "subject" : "任务名称",
  "plannedStartTime" : 1417363200000,
  "plannedEndTime" : 1419955200000,
  "importantLevel" : 1,
  "importantLevelText" : "普通",
  "status" : 2,
  "finishRate" : "0%",
  "managers" : "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.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" : [ ]
}

# 任务属性说明

参数	说明
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	-

# 按照任务ID获取任务信息

开发者可以通过【任务ID】来获取任务信息。

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/rest/task/{id}

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
id	是	任务ID

返回说明

正常情况下，会返回的是JSON格式任务信息，JSON数据包参考：任务对象实例

参数说明请参考:任务属性说明

# 按照用户ID获取待完成任务数

开发者可以通过【人员ID】来获取任务信息总数。

接口请求说明：

http请求方式：GET
http://ip:port/seeyon/tasks/{userId}

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
userId	是	人员ID

返回说明

正常情况下，返回任务总数，失败抛出异常。

# 修改任务进度

开发者可以通过【任务ID】【人员ID】【flag】来获取会议信息。

接口请求说明：

http请求方式：POST
http://ip:port/seeyon/task/update/

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
user_id	是	人员ID
task_id	是	任务ID
flag	是	flag=false 任务【进度=0%，状态=进行中】; flag=true 任务【进度=100%，状态=已完成】

注意

从V6.0开始，参数[userId]改为非必填（此参数传递不再生效）

返回说明

正常情况下，会返回的是boolean信息，成功返回true,失败返回false.

# 按照任务ID删除任务信息

开发者可以通过【任务ID】和【用户ID】删除任务

接口请求说明：

http请求方式：put
http://ip:port/seeyon/rest/task/remove/{taskId}/{userId}

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

注意V6.0版本开始此接口请求变动:

http请求方式：post
http://ip:port/seeyon/rest/task/remove/{taskId}

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
userId	是	人员ID
taskId	是	任务ID

返回说明

正常情况下，会返回的是boolean信息，成功返回true,失败返回false.

创建人：admin

修改人：het

快速跳转

任务服务管理

← 枚举服务管理业务生成器服务管理 →