钉钉管理插件

编辑
  • 文档创建者:ukae
  • 浏览次数:8246次
  • 编辑次数:17次
  • 最近更新:Kevin-s 于 2019-06-06
  • 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)钉钉推送消息内容支持显示图片消息、文件消息。设置步骤详细可参考 微信钉钉推送支持其他消息类型


    附件列表


    主题: 移动端应用
    标签: 暂无标签
    如果您认为本文档还有待完善,请编辑

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

    此页面有帮助吗?只是浏览 [ 去社区提问 ]