历史版本13 :钉钉管理插件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

0. 视频教程编辑

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

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

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

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

管理员登录钉钉企业号，点击微应用管理>创建应用，如下图：

222

填写应用名称、上传应用logo、应用简介，开发方式选择“企业内部自主开发”，最后点击【下一步】，如下图：



222

开发模式为开发应用、”开发应用类型选择“微应用”、应用首页地址可以先填决策平台的地址，具体的地址需要在报表服务器3.3章节里生成后，将生成的链接再粘贴过来、设置服务器出口IP、设置可见范围，设置完成后，点击【创建】，如下图：
222

这样应用就创建好了。

1.1 获取参数的值

而此时我们需要关注四个参数：

  参数 含义 
  AgentID  在创建应用时，系统会自动生成一个AgentId，可用于发送企业会话消息等场景。
  AppKey  在创建应用时，系统会自动分配一对AppKey和AppSecret，该AppKey是应用开发过程中的唯一性标识。
  AppSecret   AppSecret和上面AppKey一同生成，使用AppKey和AppSecret来换取access_token。
 CorpID 企业id
在应用中，点击基础信息，点击查看详情，即可查看三个参数的值，如下图：
222
首页里可以看到企业的CorpID，如下图：
222

1.2 开启权限
在应用的权限里要启用通讯录，手机号权限，点击权限管理，申请“通讯录只读权限”、“手机号码信息”，如下图：

222
开通后如下图：
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）钉钉推送消息内容支持显示图片消息、文件消息。设置步骤详细可参考微信钉钉推送支持其他消息类型。