钉钉管理插件

目录:

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

管理员登录钉钉企业号,点击工作台>应用管理>自建应用,点击【自建应用】,如下图:

222

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



222

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

注:只适用部门,不适用个人。

1.1 获取参数的值

而此时我们需要关注二个参数:

  参数 含义 
  CorpID  企业ID
  CorpSecret   授权码

在应用中,点击基础信息,点击查看详情,即可查看二个参数的值,如下图:
222
1.2 开启权限
在应用的权限里要启用通讯录,手机号权限,点击权限管理,申请“通讯录只读权限”、“手机号码信息”,如下图:

222
开通后如下图:
222


2. 报表服务器

2.1 报表服务器版本
报表服务器版本 
  钉钉管理插件版本 新移动端HTML5方式预览报表
  9.0  v2.0.7  v5.0.5


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

2.2 插件安装

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

服务器安装插件方法参照服务器插件管理
注:钉钉集成不需要修改xml文件
另:钉钉集成需要安装h5插件,钉钉集成必须设置HTML5解析
2.3 安装插件后效果
安装钉钉管理插件后,打开报表管理平台,管理系统下会增加钉钉管理节点,钉钉相关的配置管理都将会放在这个节点中去配置;

注:钉钉管理插件版本为v2.0.6时,才支持代理服务器的配置,若有些用户报表服务器是配置在内网,则需要配置代理服务器地址,来进行钉钉的访问,配置方法参考代理服务器配置

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

3. 钉钉管理

3.1 钉钉管理
登陆FR管理平台,点击管理系统>钉钉管理节点:
将钉钉中的AppKey 和AppSecret分别填到钉钉企业号ID和管理组凭证密码中,设置Token获取路径,可以自定义获取的url,详细查看钉钉插件自定义token获取,如果不写则采用内置的方式获取,保存,如下图:


3.2 钉钉管理后台创建报表微应用
在钉钉管理后台创建FR报表微应用时,例如http://secure.finedevelop.com:65080/WebReport1/ReportServer?op=fs&corpid=$CORPID$,后面要加上参数&corpid=$CORPID$,这样后台会获取到corpid,然后取到钉钉userid,做单点登录;
注:若在首页地址的url添加参数后无法获取页面,那就加上企业的实际corpID,如http://secure.finedevelop.com:65080/WebReport1/ReportServer?op=fs&corpid=dingXXXXXX
注:自jar包为2018.12.21及之后版本,钉钉支持单模板访问,详情参考:开启模板权限时访问单个模板需要用DingtalkServer
3.3 钉钉用户与报表用户关联
按照钉钉提供的方法,读取钉钉通讯录的成员,需要的字段有userid、name、department
进入FR报表管理平台fs,点击钉钉管理节点,除了基本信息外,增加了钉钉成员管理,点击效果如下:
表格中会自动读取钉钉企业号通讯录中的所有成员,并且在每次打开该页面时刷新为最新的;
“更新通讯录”可手动刷新钉钉成员,若钉钉通讯录人员过多,如10000个,这时加载时间过长,会出现加载提示;
钉钉用户与报表用户的匹配方式有三种:
(1)根据钉钉工号匹配
(2)根据手机号匹配
注:平台用户手机号非唯一,如果遇到多个报表平台用户为同一手机号,后台匹配的时候取第一个匹配到的报表用户。
(3)手动匹配
默认为“根据钉钉工号匹配”,因为大部分情况下,钉钉成员名和报表用户名是统一的,如下图所示:
如果您的钉钉成员名与报表用户名是不一样的,可选择手动匹配,此时报表用户名,可以将钉钉成员与报表用户进行关联,如下图:
3.4 单点登陆
钉钉提供免登服务,与微信类似,通过code可以获取当前账号的userid,获取到userid后,通过关联关系自动登录报表后台
3.5 消息推送
钉钉和微信里的定时任务推送消息设置步骤一致,只需要将勾选“微信消息”换成“钉钉消息”即可,这里的应用ID就是应用的AgentID,如下图:
详细点击推送微信消息,效果如下图:


附件列表


主题:

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