历史版本3 :钉钉集成 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

0. 视频教程编辑

http://bbs.fanruan.com/lesson-319.html

注:微信/钉钉集成过程中,必须确保各版本相对应,详情参照:微信、钉钉、H5、服务器、jar之间的依赖关系

注:钉钉集成下若使用“扫码控件”, 要求单点登录。

1. 创建钉钉企业应用编辑

管理员登录钉钉企业号,点击工作台>应用管理>自建应用,点击【自建应用】,如下图:

222

上传应用logo,填写应用名称、功能介绍以及首页地址例如http://secure.finedevelop.com:65081/webroot/decision,设置可见范围,设置完成后,点击【提交】,如下图:


222

这样应用就创建好了。

依然在工作台目录,点击自建应用后面的【应用开发】,进入钉钉开发者平台,如下图:
222
CorpID可以直接在钉钉开发者平台看到,若是超级管理员,可以直接看到CorpSecret,若是子管理员,点击生成CorpSecret,填写可以生成对应的CorpSecret,填写名称、勾选关联部门如下图:
222
生成的CorpSecret点击查看即可,如下图:
222

2. 报表服务器编辑

2.1 报表服务器版本
报表服务器版本  
jar包版本  
  钉钉管理插件版本 新移动端HTML5方式预览报表 
  10.0 2018-11-06  v10.0.45及以上  v10.0.45及以上

1.2 插件安装

设计器插件安装方法参照设计器插件管理

服务器安装插件方法参照服务器插件管理
1.3 安装插件后效果
安装钉钉管理插件后,打开报表管理平台,管理系统下会增加钉钉管理节点,钉钉相关的配置管理都将会放在这个节点中去配置;

注:钉钉管理插件支持代理服务器的配置,若有些用户报表服务器是配置在内网,则需要配置代理服务器地址,来进行钉钉的访问,配置方法参考代理服务器配置

同时,设置定时任务的最后一步文件处理设置中,客户端通知里会增加推送钉钉消息,如下图:

3. 钉钉管理编辑

3.1 应用管理
登陆FR管理平台,点击管理系统>钉钉管理,如下图:
222
1)报表服务器
必须设置报表服务器地址并保存,如果不设置,推送的时候可能会有问题
2)企业钉钉
点击【+新建钉钉应用】将钉钉中的AgentiID、CorpID 和CorpSecret分别填到钉钉应用ID、CropID、CorpID中,保存,如下图:
222
注:请填写合乎规范的信息,钉钉应用名称、钉钉应用ID、CropID、CorpID和Secret均不可为空,且钉钉应用名称不可重复。

设置成功后,点击右侧的两个按钮,可以对信息进行修改和删除,如下图所示:

222

支持集成多个钉钉应用,如下图所示:

222

3.2 成员管理

成员管理页面显示如下:

222

1) 用户匹配方式

用户匹配方式分为:钉钉工号匹配、手机号匹配、手动匹配及自定义匹配,默认为钉钉工号匹配

注:不管集成几个钉钉,用户统一进行管理

222

2)成员管理

a. 钉钉工号匹配和手机号匹配相同

选择这两个匹配方式时,钉钉通讯录信息展示:姓名、钉钉工号、钉钉成员ID、钉钉部门和钉钉成员手机号,显示页面如下:

222

b. 手动匹配

当匹配方式为【手动匹配】时,钉钉成员列表中多出“报表用户名”一列信息,点击出现下拉框,选择相应的报表用户名,进行手动匹配,如下所示:

222

c. 自定义匹配

选择【自定义匹配】时,下方多出【匹配设置】项,选择数据集、钉钉成员ID以及报表用户名,进行匹配,如下图所示:

222

d.通讯录更新

点击左侧【立即更新】按钮,更新通讯录内容,如下所示:

222

也可设置定时更新,点击【自动更新】按钮,弹出设置框,设置更新频率,如下所示:
222
3.3 应用快捷配置

1)生成钉钉链接

选择相应的钉钉应用名称和连接页面,生成决策报表服务器地址,如下图所示:

222

点击【复制】可自动复制生成的报表服务器地址链接到剪切板。

2)钉钉代理跳转

注:需要将钉钉插件版本升级为v3.0。

若有些用户报表服务器是配置在内网,则需要配置代理服务器地址,来进行钉钉的访问,如下图:

注:钉钉集成既需要设置正向代理,也需要设置反向代理,配置方法参考代理服务器配置

222

文本框中输入正确的代理服务器地址,点击【测试连接】,如下图:

222

3.4 钉钉管理后台创建报表微应用
在钉钉管理后台创建FR报表微应用时,例如http://www.finereporthelp.com:8181/h5/ReportServer?op=fs&corpid=$CORPID$,后面要加上参数&corpid=$CORPID$,这样后台会获取到corpid,然后取到钉钉userid,做单点登录;
注:若在首页地址的url添加参数后无法获取页面,那就加上企业的实际corpID,如http://www.finereporthelp.com:8181/h5/ReportServer?op=fs&corpid=dingXXXXXX 
222
除了参数&corpid=$CORPID$,也可以填入刚才生成的钉钉链接,如下图:
222

4. 消息推送编辑

1)钉钉和微信里的定时任务推送消息设置步骤一致,只需要勾选【钉钉通知】,选择先前新建好的企业钉钉应用即可,如下图:
222
详细点击推送微信消息,效果如下图:
222
2)钉钉推送消息内容支持显示图片、支持推送文件。如图,点击消息类型下拉框出现:链接消息、图文消息、文件消息。
注1:默认为链接消息。

222
可以看到推送收到了下图所示的图文消息和文件消息。
222
注2:设置步骤详细可参考微信钉钉推送支持其他消息类型