钉钉管理插件
1. 创建钉钉企业应用编辑
管理员登录钉钉企业号,点击工作台>应用管理>自建应用,点击【自建应用】,如下图:
填写应用名称、上传应用logo、应用简介,开发方式选择“企业内部自主开发”,最后点击【下一步】,如下图:
开发模式为开发应用、”开发应用类型选择“微应用”、应用首页地址可以先填决策平台的地址,具体的地址需要在报表服务器3.3章节里生成后,将生成的链接再粘贴过来、设置服务器出口IP、设置可见范围,设置完成后,点击【创建】,如下图:
注:只适用部门,不适用个人。
1.1 获取参数的值
而此时我们需要关注二个参数:
参数 | 含义 |
---|---|
CorpID | 企业ID |
CorpSecret | 授权码 |
在应用中,点击基础信息,点击查看详情,即可查看二个参数的值,如下图:
1.2 开启权限
在应用的权限里要启用通讯录,手机号权限,点击权限管理,申请“通讯录只读权限”、“手机号码信息”,如下图:
开通后如下图:
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)