集成到阿里钉钉(DingTalk)

O2OA平台可以以第微应用的方式集成到阿里钉钉,同步钉钉的企业通讯录作为本地组织人员架构,并且可以将待办等通知直接推送到钉钉进行消息提醒。

如果O2OA成功接入钉钉,O2OA将会自动从钉钉拉取所有的人员和组织进行同步,O2OA的所有人员和组织以企业钉钉中创建的组织架构为准( 本地已经创建的人员和组织将保留不会被删除,可能会造成人员和组织重复 )。

对企业通讯录授权时,所对应的组织请设置为顶层组织,后续将会细化相应的权限设置。

O2OA接入钉钉建议先配置好钉钉应用,待组织和人员从钉钉同步完成后,再进行组织和人员的信息编辑,避免人员和组织信息的重复创建。

一、前提条件

1、完成O2OA部署,平台可以正常访问

2、确保O2OA平台可以正常通过公网进行访问(不是内网)

二、注册企业钉钉

注册地址:https://oa.dingtalk.com/#/login,此步骤需要企业自行准备。

企业注册钉钉

需要提供使用钉钉的企业相关信息。

企业首页

三、添加钉钉微应用

钉钉注册成功后,使用企业管理员账号登录企业钉钉,在[工作台] 页面中,点击自建应用链接,新建一个企业应用,如下图所示:

企业控制台工作台

填写应用基本信息,如下图所示:

创建自建应用

参数说明:

填写完成后点击下一步,填写配置开发信息,如下图所示:

配置应用详细信息

参数说明:

填写完成后点击提交即可完成应用创建,填写好的界面如下图所示:

自建应用创建完成

四、查询应用的AgentId、appKey、appSecret和CorpId信息

1、查询应用的AgentId、appKey、appSecret信息

点击自建应用设置,查看应用的详细设置信息

查询应用设置

查询已经创建好的应用设置信息,如下图所示:

请记录应用的AgentId、AppKey以及AppSecret信息,后续需要配置到服务器设置里

2、查询企业CropId信息

进入钉钉开放平台,点击左侧导航:开发信息 -> 开发账号信息:

查询CropId

请记录企业的CorpId信息,后续需要配置到服务器设置里。

五、设置钉钉微应用的通讯录权限

在已经创建好的微应用的权限设置栏可以对应用的操作权限进行设置,如下图所示:

设置通讯录权限

企业通讯录权限:请开启通讯录只读权限、手机号码信息以及邮箱等个人信息,并且将选择授权范围设置为最顶层组织。

至此,钉钉应用创建以及设置工作已经完成。

六、O2OA接入配置

1、进入o2oa安装目录,从o2server/configSample 目录下拷贝 dingding.json 到 o2server/config 目录(如果已经复制过了,请跳过此步骤);

2、使用文本编辑器打开dingding.json进行编辑:

参数说明:

钉钉上的智和办公平台

完成以上配置后重启O2OA,即可完成O2OA在企业钉钉中的接入,可以在企业钉钉中看到自己配置的企业应用。

七、手工从钉钉拉取组织人员数据

服务地址:http://localhost:20030/x_program_center/jest/index.html

服务名称:DingdingAction.pullSync

如下图所示界面,点击GET之后,观察服务器控制台或者日志文件信息(o2server/logs),可以查看到同步日志。

请注意,不要多次点击GET,点击一次后,控制台会有正在拉取组织人员信息相关的日志。

中心服务器API

Last updated

Was this helpful?