0. 视频教程编辑
http://bbs.fanruan.com/lesson-319.html
注:微信/钉钉集成过程中,必须确保各版本相对应,详情参照:微信、钉钉、H5、服务器、jar之间的依赖关系。
注:钉钉集成下若使用“扫码控件”, 要求单点登录。
1. 创建钉钉企业应用编辑
管理员登录钉钉企业号,点击微应用管理>创建应用,如下图:
填写应用名称、上传应用logo、应用简介,开发方式选择“企业内部自主开发”,最后点击【下一步】,如下图:
开发模式为开发应用、”开发应用类型选择“微应用”、应用首页地址可以先填决策平台的地址,具体的地址需要在报表服务器3.3章节里生成后,将生成的链接再粘贴过来、设置服务器出口IP、设置可见范围,设置完成后,点击【创建】,如下图:
(注意:)范围应以部门为主,不能选择到个人。
这样应用就创建好了。
1.1 获取参数的值
而此时我们需要关注四个参数:
参数 | 含义 |
---|---|
AgentID | 在创建应用时,系统会自动生成一个AgentId,可用于发送企业会话消息等场景。 |
AppKey | 在创建应用时,系统会自动分配一对AppKey和AppSecret,该AppKey是应用开发过程中的唯一性标识。 |
AppSecret | AppSecret和上面AppKey一同生成,使用AppKey和AppSecret来换取access_token。 |
CorpID | 企业id |
在应用中,点击基础信息,点击查看详情,即可查看三个参数的值,如下图:
首页里可以看到企业的CorpID,如下图:
1.2 开启权限
在应用的权限里要启用通讯录,手机号权限,点击权限管理,申请“通讯录只读权限”、“手机号码信息”,如下图:
开通后如下图:
2. 报表服务器编辑
2.1 报表服务器要求
您的报表服务器必需是能够访问外网的,如果是http协议则访问端口推荐使用80,如果是https协议访问端口推荐使用443。
注:钉钉管理插件支持代理服务器的配置,若有些用户报表服务器是配置在内网,则需要配置代理服务器地址,来进行钉钉的访问,配置方法参考代理服务器配置。
2.2 报表服务器版本
报表服务器版本 | jar包版本 | 钉钉管理插件版本 | 新移动端HTML5方式预览报表 |
---|---|---|---|
10.0 | 2018-11-06 | 10.1.04及以上 | v10.0.45及以上 |
2.3 插件安装
设计器插件安装方法参照设计器插件管理
服务器安装插件方法参照服务器插件管理
2.4 安装插件后效果
安装钉钉管理插件后,打开报表管理平台,管理系统下会增加 节点,钉钉相关的配置管理都将会放在这个节点中去配置;
同时,设置定时任务的最后一步文件处理设置中,客户端通知里会增加
3. 钉钉管理编辑
3.1 应用管理
登陆FR管理平台,点击管理系统>钉钉管理,如下图:
1)报表服务器
必须设置报表服务器地址并保存,如果不设置,推送的时候可能会有问题,例如:http://secure.finedevelop.com:65081/webroot/decision
2)企业钉钉
点击【+新建钉钉应用】将钉钉中的AgentiID、CorpID 和CorpSecret分别填到钉钉应用ID、CropID、CorpID中,点击【确定】,如下图:
注:请填写合乎规范的信息,钉钉应用名称、钉钉应用ID(AgentId)、CropID、AppKey、AppSecret均不可为空,且钉钉应用名称不可重复。
注:老一套钉钉参数,在配置钉钉应用时,对应的 钉钉应用ID,CorpID,APPkey,APPsecret四个输入框中,分别填写上:钉钉应用ID,CorpID,CorpID,CorpSecret 即可
设置成功后,点击右侧的两个按钮,可以对信息进行修改和删除,如下图:
支持集成多个钉钉应用,如上图。
3.2 成员管理
成员管理页面显示如下:
1) 用户匹配方式
用户匹配方式分为:钉钉工号匹配、手机号匹配、手动匹配及自定义匹配,默认为钉钉工号匹配
注:不管集成几个钉钉,用户统一进行管理
2)成员管理
a. 钉钉工号匹配和手机号匹配相同
钉钉工号匹配,则是钉钉工号与报表里的用户名匹配;
手机号匹配,则是手机号与报表里用户的手机号匹配。
选择这两个匹配方式时,钉钉通讯录信息展示:姓名、钉钉工号、钉钉成员ID、钉钉部门和钉钉成员手机号,显示页面如下:
b. 手动匹配
当匹配方式为【手动匹配】时,钉钉成员列表中多出“报表用户名”一列信息,点击出现下拉框,选择相应的报表用户名,进行手动匹配,如下所示:
c. 自定义匹配
选择【自定义匹配】时,下方多出【匹配设置】项,选择数据集、钉钉成员ID以及报表用户名,进行匹配,如下图所示:
d.通讯录更新
点击左侧【立即更新】按钮,立即更新通讯录内容;也可设置定时更新,点击【自动更新】按钮,弹出设置框,设置更新频率,如下图:
3.3 应用快捷配置
1)钉钉代理跳转
若有些用户报表服务器是配置在内网,则需要配置代理服务器地址,来进行钉钉的访问,如下图:
注:钉钉集成既需要设置正向代理,也需要设置反向代理,配置方法参考代理服务器配置。
文本框中输入正确的代理服务器地址,点击【测试连接】,当连接成功,提示连接成功。
2)生成钉钉链接
选择相应的钉钉应用名称和链接页面,生成决策报表服务器地址,如下图所示:
点击【复制】可自动复制生成的报表服务器地址链接到剪切板。
3.4 钉钉管理后台创建报表微应用
在钉钉管理后台创建FR报表微应用时,将上面生成的链接复制到钉钉微应用的首页地址,做单点登录,如下图:
到这里钉钉集成配置完成,在钉钉中,点击工作台-文档测试,该用户会看到ta有权限的目录,如下图:
4. 消息推送编辑
1)钉钉和微信里的定时任务推送消息设置步骤一致,只需要勾选【钉钉通知】,选择先前新建好的企业钉钉应用即可,如下图:
详细设置步骤点击推送微信消息,定时任务设置好后,每次执行后就会推送消息给对应的成员,若勾选了定时结果链接,那么点击详情即可打开定时生成的结果链接,效果如下图:
2)钉钉推送消息内容支持显示图片消息、文件消息。设置步骤详细可参考微信钉钉推送支持其他消息类型。