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

目录:

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）如果有多个定时调度应用不同，则升级后，打开钉钉管理，依据定时调度中的应用数，有多组应用，与微信兼容相同