开源OA:手把手教你搭建OA办公系统(13)将O2OA集成到钉钉
钉钉集成
在前面移动办公的课程中,我们已经介绍了: O2OA移动APP的功能和能力,但是现在用户说,我们一直都是在使用钉钉进行移动办公,不想再安装其他新的APP了。能不能在钉钉中使用O2OA进行办公呢?
其实我们前面也提过,O2OA是支持钉钉、企业微信,华为welink的接入的。
我们这里就以钉钉为例,给大家演示如何接入。
前提:
这里提一下,因为O2OA接入钉钉后,将会自动从钉钉中同步所有的人员和组织,O2OA的所有人员和组织是以钉钉创建的组织架构为准的。
接下来,我们开始来操作:第一步
创建钉钉微应用:
接入钉钉,我们要先去钉钉管理后台创建一个应用,
打开地址:http://oa.dingtalk.com,通过手机钉钉扫码,
管理员进入钉钉管理后台,选择 工作台-应用管理 菜单。
点击 自建应用 创建按钮,进入钉钉开放平台,选择顶部菜单应用开发 -> 企业内部应用
点击创建应用按钮
创建后可以看到应用的凭证信息,这些凭证信息后续要用到O2OA的配置文件上。
创建完成应用后需要把通讯录的同步权限开启,否则无法将人员组织同步到O2OA,点击应用的权限管理菜单,申请如下六个权限:企业员工手机号信息,邮箱等个人信息,通讯录部门信息读权限,成员信息读权限,根据手机号姓名获取成员信息的接口访问权限,通讯录部门成员读权限。
修改O2OA服务器上的钉钉配置文件:
现在我们开始进行O2OA和钉钉的集成,管理员登录并打开系统设置菜单,点击平台配置,找到dingding(钉钉配置):
把钉钉新创建的应用凭证信息添加到这个配置文件中,分别是agentId 、appKey、appSecret。
还有一个corpId也可以在钉钉开放平台的首页找到。
填入这4个参数后,把第一个参数 enable 的值改成 true。重启O2OA服务器。
同步钉钉人员组织到O2OA:
O2OA服务器重启完成后 ,我们现在来看一下组织用户,点开组织管理,我们看到组织库里的组织信息是之前通过Excel导入的数据,不是钉钉的人员同步数据。
O2OA服务器会定时去同步组织和人员数据,但是第一次启用钉钉配置文件后,定时器应该还没执行,如果我们要看效果,可以马上去执行一次同步,这样就不用等定时器的执行了。
打开中心服务器的api地址,http://live.o2oa.net:20030/x_program_center/jest/index.html 。
如:http://127.0.0.1:20030/x_program_center/jest/index.html
找到API Menu中的钉钉接口 DingdingAction,找到里面的 立即同步(pullSync) 菜单,点击后右边区域会有接口地址,请求方法,描述等信息,下面有一个GET 按钮,点击这个 GET 按钮就会马上执行钉钉数据同步。
在点击之前,我们可以先打开日志查看器
点击刚才API页面的 GET 按钮后,就会在日志查看器中看到我们的同步日志。
o2平台是从钉钉的根组织开始同步的,如果同名会覆盖,如果不同名会保留。钉钉会限制每分钟访问的次数,所以同步需要些时间,耐心等待一会儿。 。。显示钉钉同步人员结束,再到组织库里 进行刷新。 我们看到了 这就是从钉钉同步下来的组织和人员。
查看组织架构
O2OA和钉钉的单点登录:
组织人员同步成功后,我们需要到钉钉应用管理中去配置刚才创建的钉钉微应用的打开链接。这个链接配置的是一个O2OA上的页面地址,如果想要打开这个页面,钉钉和O2OA之间需要完成单点登录的功能,不过O2OA其实已经集成好了这个单点的功能,所以我们不需要额外的开发,只需要在钉钉应用管理中配置特定的地址就行了:
在钉钉应用管理 -> 开发管理 中,填入应用首页地址,http://o2oa服务器域名/x_desktop/ddsso.html ,就完成了地址配置,打开手机操作(投屏,幕享),看一下,这时候就可以在钉钉APP上点击打开我们创建的应用了,点击之后,可以看到我们O2OA默认的办公中心页面。
钉钉应用如果不想打开这个默认的办公中心,而是想打开做好的手机门户的话,只需要在前面的连接地址上加一个redirect参数就行了:
redirect=portalmobile.html?id=门户标识
门户的id哪里获取呢?:
查看效果
更多配置信息:
接下来,我们回到O2OA平台,详细的说一下钉钉的配置文件里的相关参数,
前面说过我们填写了关于钉钉应用的几个应用凭证信息字段,但是下面还有更多的字段,这些字段有啥功能,这里大致介绍一下:
"enable": "是否启用企业钉钉接入: true | false", "corpId": "企业在钉钉开放平台上的corpId ", "agentId": "企业钉钉应用信息AgentId ", "appKey": "企业钉钉应用信息AppKey ", "appSecret": "企业钉钉应用信息AppSecret ", "forceSyncCron": "强制拉入同步cron, 默认在每天的8点和12点强制进行同步(10 45 8,12 * * ?)", "oapiAddress": "企业钉钉api服务器地址, 固定填写:https://oapi.dingtalk.com", "messageEnable": "是否允许推送消息到企业钉钉: true | false" "workUrl":"这个参数是为了钉钉推送的工作消息开启超链接功能,这里配置o2oa服务器地址, 如:http://dev.o2oa.net/x_desktop/", "messageRedirectPortal":"这个参数是配置一个门户id,是上面工作消息打开后处理完成跳转的门户页面", "scanLoginEnable": "是否开启钉钉扫码登录: true | false", "scanLoginAppId": "钉钉扫码登录的AppId", "scanLoginAppSecret": "钉钉扫码登录的appSecret"
前面5个字段已经一一对应过了,主要用来同步和单点登录的。
forceSyncCron
这个字段是一个定时表达式,根据这个表达式定时进行人员、组织数据的同步,让O2OA上的人员组织和钉钉上的同步。
oapiAddress
是钉钉api服务器地址,不需要修改。
workUrl
工作消息超链接功能。用户说,现在钉钉上消息是有了,但是是文字消息,没办法点开处理待办工作呀,那这个字段就需要填入O2OA的web服务器地址,如:http://o2oa服务器域名/x_desktop/
messageEnable
开启钉钉消息用的。比如用户说希望钉钉上能收到待办消息,那就需要开启这个字段,改为true
messageRedirectPortal
工作消息打开工作处理页面,完成工作后需要跳转的门户页面的标识。默认我们的工作处理完成后会打开我们O2OA的默认办公中心,如果有专门做好的门户,这里配置那个门户的标识就行。完成工作后就会打开这个门户页面。
scanLoginEnable
、scanLoginAppId
、scanLoginAppSecret
这三个字段是用来开启使用钉钉扫码登录O2OA用的,需要到钉钉管理后台申请单点登录应用,申请成功后会有appid和appSecret 的内容,分别填入scanLoginAppId
和scanLoginAppSecret
,并且开启 scanLoginEnable
为 true。我们的O2OA的登录界面就会多一个钉钉扫码登录按钮。就可以用钉钉扫码登录我们的O2OA了。
接下来,我们来操作:
钉钉扫码登录实现
新版还没找到这个功能,那么我们返回到旧版操作
选择应用开发---》移动接入应用->>登录
创建扫码登录应用授权
授权logo地址:
自己定制的一个logo图片,https://static.oschina.net/uploads/logo/o2oa_pTNm5.png
自己定制的一个logo图片 http://www.o2oa.net/image/o2oa_logo.png
这里要注意一下回调地址,直接使用:http://live.o2oa.net/x_desktop/oauth.html
创建完成后,修改O2OA的钉钉配置,根据获得的appId 和appSecret 修改 scanLoginAppId
、scanLoginAppSecret
,设置scanLoginEnable
为true ,重启服务。
重启后,我们就发现登录页面多了一个钉钉图标,点击图标我们就可以进行钉钉扫码登录了,ok,这样就顺利的进入到我们的平台首页了。
开源OA:手把手教你搭建OA办公系统(13)将O2OA集成到钉钉相关推荐
- 手把手教你搭建OA服务器
手把手教你搭建OA服务器 AnyOffice.Net 3.3 安装与配置说明 AnyOffice.Net在平台准备充分的情况下可以通过一次点击安装.配置IIS站点就能完成.所以在安装AnyOffice ...
- 开源!手把手教你搭建Arduino+英伟达Jetson的ROS小车(上)
1 引言 今年6月,我们应小伙伴儿的需求,写了两篇如何通过购买零件从零搭建一台ROS实体车的推文<开源!手把手教你搭建Arduino+树莓派的ROS小车(上)>.<开源!手把手教你搭 ...
- 手把手教你搭建SpringCloud项目(十六)集成Stream消息驱动
Spring Cloud全集文章目录: 零.什么是微服务?一看就会系列! 一.手把手教你搭建SpringCloud项目(一)图文详解,傻瓜式操作 二.手把手教你搭建SpringCloud项目(二)生产 ...
- 手把手教你搭建视频去重系统
#01 背景 如今,短视频平台对各类搬运视频的检测力度和精确度越来越高了.无论是影视号的剪辑,还是从油管搬运,即使做了各类复杂的视频变换,都很容易被检测出来.作者都会收到提醒,严重的甚至被封号. 乔布 ...
- 开源OA:手把手教你搭建OA办公系统(17)实现系统间单点登陆认证
O2OA是一款全开源的企业信息化开发平台,作为OA系统开发平台,O2OA着力于帮助企业降低信息化系统开发成本,帮助企业提升信息化能力.本系列主要以实战形式向大家介绍使用开源OA平台搭建一套协同办公系统 ...
- 开源OA:手把手教你搭建OA办公系统(1)服务器安装和数据初始化
如何下载O2OA办公系统的开源代码? O2OA办公平台以及其所有源码,都是可以免费获取的,主要有以下两种方式: 1.从O2OA办公系统官网下载可运行版本. 2.下载源码,自行编译可运行版本.(后面的课 ...
- 开源OA:手把手教你搭建OA办公系统(19)-系统上线之服务器集群设置
O2OA是一款全开源的企业信息化开发平台,作为OA系统开发平台,O2OA着力于帮助企业降低信息化系统开发成本,帮助企业提升信息化能力.本系列主要以实战形式向大家介绍使用开源OA平台搭建一套协同办公系统 ...
- 开源OA:手把手教你搭建OA办公系统(3)开发企业报销审批流程
需求 今天以OA系统中的报销审批流程为例来讲一下流程应用管理.首先介绍一下报销流程的需求,主要分为两部分,流程和表单. 流程 OA的报销流程部分,我们将其分成两种情况:报销金额<=3000元时, ...
- 开源OA:手把手教你搭建OA办公系统(9)快速搭建企业门户
OA系统门户介绍 一个门户OA办公系统的门面,把这个门面做的既实用又漂亮很重要.而今天要介绍的功能--门户管理,是OA办公系统管理是O2OA五大平台之一,主要用于设计各类页面,比如系统首页.列表页面. ...
最新文章
- 爬虫篇 --- 分布式爬虫
- thinkphp3.2与phpexcel带图片生成 完美案例
- [Java多线程]-J.U.C.atomic包下的AtomicInteger,AtomicLong等类的源码解析
- python教程循环语句,Python基础教程之循环语句(for、while和嵌套循环)
- 点击出现黑色背景的解决
- 升级sublime text4后激活及问题
- java中怎么判断依赖关系,在Maven 2中,我如何知道依赖性来自哪个依赖?
- 【Flask】下载多个文件
- 不同网段的直连怎么互通_什么样的网络能互通,什么样的网络不能互通?
- c语言实现shellcode转换工具
- 仿souhu页面设计
- 利用salt防范MD5字典攻击
- Multisim14.0详细安装教程图文
- 八、Servlet容器
- 晶振负载电容是什么意思?关于晶振负载电容
- Java全栈工程师知识体系介绍
- NetLimiter
- 你不需要完美-你需要的是行动与完成
- 【转】《飞鸟集》325首全文
- Oracle进阶(六)包(Package)和包体
热门文章
- 【论文阅读】(2020)Knapsack polytopes: a survey(上)
- 深度学习(二)吴恩达给你的人工智能第一课: 02.改善深层神经网络:超参数调试、正则化以及优化
- ADG-12A-02-D2-1-52不带位置反馈比例换向阀放大器
- STP格式公仔3D建模,IGS格式模型设计中文讲解视频教程
- 3.[转]web测试方法总结
- YED-M724嵌入式4G Cat1 核心板介绍
- B站台湾大学郭彦甫|MATLAB 学习笔记|09 图像处理II Image Processing
- Android网络下载速度测试
- Java、JSP物业管理信息系统毕业设计
- 前端安全,常见的攻击类型以及如何防御