Fx.work:和协同工作相关的API
1、发任务-createTask
定义:Fx.work.createTask(<String title>,<String content>,<DateTime deadLine>,<Map<List> executeUsers>, <Map<List> atUsers>)
参数说明:
参数 | 说明 |
---|---|
title | 任务标题 |
content | 任务内容 |
deadLine | 任务完成时间 |
executeUsers | 执行人 |
atUsers | 抄送范围 |
注:executeUsers map keys : "users" 用户 ,"departments" 部门
atUsers map keys : "users" 用户 ,"departments" 部门
举例:
DateTime deadLine = DateTime.now + 1.days Fx.work.createTask("hello", "world", deadLine, [users: ["1059"]], [users: ["1059","1025"],departments:["253937"]])
2、发日程-createSchedule
定义:
Fx.work.createSchedule(<String content>,<DateTime beginTime>,<DateTime endTime>, <boolean isFullDate>,<boolean needReceipt>,<List remindTimes>,<Map<List> atUsers>)
参数说明:
参数 | 说明 |
---|---|
content | 日程内容 |
beginTime | 日程开始时间 |
endTime | 日程结束时间 |
isFullDate | 是否全天日程 |
needReceipt | 是否需要回执 |
remindTimes | 提醒时间 |
atUsers | 抄送范围/参与人 |
注:remindTimes枚举值:
1、RemindTime.BEGIN - 开始时;
2、RemindTime.FIVE_MINUTES_AGO:5分钟前;
3、RemindTime.FIFTEEN_MINUTES_AGO:15分钟前;
4、RemindTime.THIRTY_MINUTES_AGO-30分钟前;
5、RemindTime.ONE_HOURS_AGO-1小时前;
6、RemindTime.TWO_HOURS_AGO -2小时前
atUsers map keys : "users" 用户 ,"departments" 部门
举例:
DateTime endTime = DateTime.now + 1.hours Fx.work.createSchedule("hello", DateTime.now(), endTime , false, false, [RemindTime.BEGIN()], [users: ["1000","1002"]])
3、发销售记录-createSalesRecord
定义:Fx.work.createSalesRecord(<String content>,<Map objects>,<Map<List> atUsers>)
参数说明:
参数 | 说明 |
---|---|
content | 销售记录内容 |
objects | 关联对象 |
atUsers | 抄送范围 |
注:objects map keys :"object_api_name" 对象APIName , "id" 对象Id
atUsers map keys : "users" 用户 ,"departments" 部门
举例:
Fx.work.createSalesRecord("hello",[[object_api_name:"AccountObj",id:"4d79c3068aca42b28aebbc98223e8bed"]], [users:["1025"]])
注:不支持选销售记录类型
4、创建任务v2-createTaskV2
定义:Fx.work.createTaskV2(<String title>,<String content>,<DateTime deadLine>,<boolean multiExecute>,<Map<List> executeUsers>,<Map<List> atUsers>)
参数说明:
参数 | 说明 |
---|---|
title | 任务名称 |
content | 任务描述 |
deadLine | 任务的过期时间 |
multiExecute | 是否对人执行 |
executeUsers | 任务执行人列表,可参考原有的createTask函数 |
atUsers | 任务发送成功后抄送人员列表 |
data返回值类型:String(任务id)
举例:
DateTime deadLine = DateTime.now + 1.days Fx.work.createTaskV2("hello", "world", deadLine, true, [users: ["1021","1017","1020"]], [users: ["1021","1017","1020"]])
5、执行任务-executeTask
定义:Fx.work.executeTask(<String taskId>,<String executor>)
参数说明:
参数 | 说明 |
---|---|
taskId | 任务id |
executor | 任务执行人 |
data返回值类型:无
举例:
Fx.work.executeTask("3b4d8c49b207417f99941688c8ee719f", "1017")
6、取消任务-cancelTask
定义:Fx.work.cancelTask(<String taskId>)
参数说明:
参数 | 说明 |
---|---|
taskId | 任务id |
data返回值类型:无
举例:
Fx.work.cancelTask("3b4d8c49b207417f99941688c8ee719f")
7、创建日程绑定业务对象-createSchedule
定义:Fx.work.createSchedule(<String content>,<DateTime beginTime>,<DateTime endTime>, <boolean isFullDate>,<boolean needReceipt>,<List remindTimes>,<Map<List> atUsers>,<List<Map> objects>)
参数说明:
参数 | 说明 |
---|---|
content | 日程内容 |
beginTime | 日程开始时间 |
endTime | 日程结束时间 |
isFullDate | 是否全天日程 |
needReceipt | 是否需要回执 |
remindTimes | 提醒时间 |
atUsers | 抄送范围/参与人 |
objects | 绑定的业务数据 |
注:remindTimes枚举值:
1、RemindTime.BEGIN - 开始时;
2、RemindTime.FIVE_MINUTES_AGO:5分钟前;
3、RemindTime.FIFTEEN_MINUTES_AGO:15分钟前;
4、RemindTime.THIRTY_MINUTES_AGO-30分钟前;
5、RemindTime.ONE_HOURS_AGO-1小时前;
6、RemindTime.TWO_HOURS_AGO -2小时前
atUsers map keys : "users" 用户 ,"departments" 部门
object keys : "apiName" 对象API名称 ,"dataId" 业务数据Id
举例:
``` DateTime endTime = DateTime.now + 1.hours; def ret = Fx.work.createSchedule("hello", DateTime.now(), endTime , false, false, [RemindTime.BEGIN()], [users: ["1001","1017","1018"]], [[apiName:"LeadsObj", dataId:"5dc276e1a25b1800018dafe9"],[apiName:"AccountObj", dataId:"5f3f86136ede600001da386e"]]); ```