[新]9.0钉钉管理插件

目录:

0. 视频教程

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

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


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

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

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

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

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

3. 钉钉管理

登陆FR管理平台，点击管理系统>钉钉管理节点：
3.1 应用管理
1）报表服务器
必须设置报表服务器地址并保存，如果不设置，推送的时候可能会有问题
2）企业钉钉
点击【+新建钉钉应用】将钉钉中的 AgentiID、CorpID 和CorpSecret 分别填到钉钉应用 ID、CropID、CorpID 中，点击【确定】，如下图：
注：请填写合乎规范的信息，钉钉应用名称、钉钉应用 ID(AgentId)、CropID、AppKey、AppSecret 均不可为空，且钉钉应用名称不可重复。

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

支持集成多个钉钉应用，如下图：

222

3.2 成员管理

成员管理页面显示如下：

注：不管集成几个钉钉，用户统一进行管理

也可设置定时更新，点击【自动更新】按钮，弹出设置框，设置更新频率，如下所示：

3.3 应用快捷配置

1）生成钉钉链接

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

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

注：需要将钉钉插件版本升级为v3.0。

2）钉钉代理跳转

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

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

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

3.4 钉钉管理后台创建报表微应用
在钉钉管理后台创建FR报表微应用时，将上面生成的链接复制到钉钉微应用的首页地址，做单点登录，如下图：
注：自jar包为2018.12.21及之后版本，钉钉支持单模板访问，详情参考：开启模板权限时访问单个模板需要用DingtalkServer。

4. 消息推送

1）钉钉和微信里的定时任务推送消息设置步骤一致，只需要勾选【钉钉通知】，选择先前新建好的企业钉钉应用即可，如下图：
推送微信消息，效果如下图：
注1：默认为链接消息。

注2：设置步骤详细可参考微信钉钉推送支持其他消息类型。

5. 升级兼容说明

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

附件列表


主题：
标签： 已验证 9.0

文档内容仅供参考，如果你需要获取更多帮助，付费/准付费客户请咨询帆软技术支持
关于技术问题，您还可以前往帆软社区，点击顶部搜索框旁边的提问按钮
若您还有其他非技术类问题，可以联系帆软传说哥（qq：1745114201）