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

目录:

0. 视频教程编辑

注:目前文档内容还是FR9.0的,待10.0适配好之后再进行更新。

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

1. 报表服务器编辑

1.1 报表服务器版本
报表服务器版本  
jar包版本  
  钉钉管理插件版本 新移动端HTML5方式预览报表 
  9.0  2018-07-04  v3.0  v5.0.5


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

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

服务器安装插件方法参照服务器插件管理
注1:钉钉集成不需要修改xml文件
注2:钉钉集成需要安装h5插件。
1.3 安装插件后效果
安装钉钉管理插件后,打开报表管理平台,管理系统下会增加钉钉管理节点,钉钉相关的配置管理都将会放在这个节点中去配置;

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

222

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

2. 钉钉企业应用编辑

管理员登录钉钉企业号,进入微应用设置,需要关注的信息有:
钉钉应用ID:创建钉钉应用后自动生成的AgentID。
CorpID : 是企业在钉钉中的标识,每个企业拥有一个唯一的CorpID;
CorpSecret : 是企业每个应用的凭证密钥。

首先进入工作台>应用管理>自建应用,点击【自建应用】,如下图:

222

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

222

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

3. 钉钉管理编辑

登陆FR管理平台,点击管理系统>钉钉管理节点:
222
3.1 应用管理
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:设置步骤详细可参考微信钉钉推送支持其他消息类型

5. 升级兼容说明编辑

如果您已经配置好了钉钉管理,想要升级至钉钉管理v3.0,您需要:
卸载老插件,安装新插件,来使您的应用运行正常。除此之外,升级到v3.0之后还需要注意以下几点:
1)如果没有定时调度推送钉钉,则升级后,打开钉钉管理,弹出的兼容设置应用id为空,需要手动填写
2)如果只有一个定时调度,则升级后,打开钉钉管理,弹出的兼容设置应用名赋值推送应用id,应用名称为应用(定时推送)
3)如果有多个定时调度应用不同,则升级后,打开钉钉管理,依据定时调度中的应用数,有多组应用,与微信兼容相同