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

目录:

0. 视频教程编辑

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

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

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

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

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

222

上传应用logo,填写应用名称、功能介绍以及首页地址需要可以先填一个决策平台的地址,具体的地址需要在报表服务器3.3章节里生成后,将生成的链接再粘贴过来,设置可见范围,设置完成后,点击【提交】,如下图:


222

这样应用就创建好了。

而此时我们需要关注三个参数:

  参数 含义 
  AgentID  应用ID
  CorpID  企业ID
  CorpSecret   授权码

1.1 获取参数
a.应用创建好了之后,点击【设置】,可以看到该应用的AgentID ,如下图:
222
b.依然在工作台目录,点击自建应用后面的【应用开发】,进入钉钉开发者平台,如下图:


222
左侧切换到开发授权,需要给开发者授予权限,如下图:

222
点击【新增授权】,填写内容,如下图:
注:钉钉后台新生成的开发授权CorpSecret,无法获取手机号,暂时无法使用手机号匹配;老的CorpSecret可以正常使用
222


CorpID可以直接看到,CorpSecret需要点击【点击查看】,弹出警告,再点击继续查看即可看到生成的CorpSecret,点击复制即可将内容复制到剪切板,如下图:
222


2. 报表服务器编辑

2.1 报表服务器要求
您的报表服务器必需是能够访问外网的,如果是http协议则访问端口推荐使用80,如果是https协议访问端口推荐使用443。
注:钉钉管理插件支持代理服务器的配置,若有些用户报表服务器是配置在内网,则需要配置代理服务器地址,来进行钉钉的访问,配置方法参考代理服务器配置
2.2 报表服务器版本
报表服务器版本  
jar包版本  
  钉钉管理插件版本 新移动端HTML5方式预览报表 
  10.0 2018-11-06  v10.0.45及以上  v10.0.45及以上

2.3 插件安装

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

服务器安装插件方法参照服务器插件管理
2.4 安装插件后效果
安装钉钉管理插件后,打开报表管理平台,管理系统下会增加钉钉管理节点,钉钉相关的配置管理都将会放在这个节点中去配置;
同时,设置定时任务的最后一步文件处理设置中,客户端通知里会增加推送钉钉消息。

3. 钉钉管理编辑

3.1 应用管理
登陆FR管理平台,点击管理系统>钉钉管理,如下图:
222

1)报表服务器
必须设置报表服务器地址并保存,如果不设置,推送的时候可能会有问题,例如:http://secure.finedevelop.com:65081/webroot/decision
2)企业钉钉
点击【+新建钉钉应用】将钉钉中的AgentiID、CorpID 和CorpSecret分别填到钉钉应用ID、CropID、CorpID中,点击【确定】,如下图:

222

注:请填写合乎规范的信息,钉钉应用名称、钉钉应用ID、CropID、Secret均不可为空,且钉钉应用名称不可重复。

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

222

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

222

3.2 成员管理

成员管理页面显示如下:

222

1) 用户匹配方式

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

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

222

2)成员管理

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

钉钉工号匹配,则是钉钉工号与报表里的用户名匹配;

手机号匹配,则是手机号与报表里用户的手机号匹配。

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


222

b. 手动匹配

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

222

c. 自定义匹配

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


222

d.通讯录更新

点击左侧【立即更新】按钮,立即更新通讯录内容;也可设置定时更新,点击【自动更新】按钮,弹出设置框,设置更新频率,如下图:
222



3.3 应用快捷配置

1)钉钉代理跳转

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


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

文本框中输入正确的代理服务器地址,点击【测试连接】,当连接成功,提示连接成功。

2)生成钉钉链接

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


222

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

3.4 钉钉管理后台创建报表微应用
在钉钉管理后台创建FR报表微应用时,将上面生成的链接复制到钉钉微应用的首页地址,做单点登录,如下图:
222
到这里钉钉集成配置完成,在钉钉中,点击工作台-文档测试,该用户会看到ta有权限的目录,如下图:
222

4. 消息推送编辑

1)钉钉和微信里的定时任务推送消息设置步骤一致,只需要勾选【钉钉通知】,选择先前新建好的企业钉钉应用即可,如下图:

222

详细设置步骤点击推送微信消息定时任务设置好后,每次执行后就会推送消息给对应的成员,若勾选了定时结果链接,那么点击详情即可打开定时生成的结果链接,效果如下图:

222

2)钉钉推送消息内容支持显示图片消息、文件消息。设置步骤详细可参考微信钉钉推送支持其他消息类型