1. 概述
1.1 版本
报表服务器版本 | 插件版本 |
---|---|
11.0 | V1.1-beta |
1.2 应用场景
微信公众号,为企业和组织提供更强大的业务服务与用户管理能力,给用户带来及时丰富业务信息。
通过此插件可提供在 FineReport 中更加方便、快捷关联公众号内容,可提供定时公众号消息推送功能、FineReport 系统 HTML5 页面免登录功能。
相信通过 FineReport 强大报表展示能力,再结合 微信公众号信息传播优势,一定能实现企业系统应用如虎添翼效果。
场景概述:
在公众号基础上对接 FineReport,对企业产品的消费者参与者进行管理、推广。定期任务或事件推送,消费提醒、结算提醒、积分提醒、及客户产品使用的维保提醒等信息。
实时推送消息至移动端,可以做到信息的快速传输。无论是一线人员还是企业管理者,都可以随时随地通过手机了解业务状态,提高数据的信息价值。
结合公众号可以用来管理企业供应商,把公众号做为供应链系统的,外延消息发送端使用。比如,给供应商发送订单变更信息、定期给供应商发送货品消耗情况,利于提前备货。
其他应用场景可结合企业实际需求进行拓展。
1.3 功能介绍
插件功能基于微信公众平台开发接口,开发的公众号消息相关功能,可定时发送公众号模板消息、FineReport 系统 HTML5 页面免登录功能。
主要功能:
公众号相关单点登录。在公众号或小程序中嵌入的 H5 报表链接,点击时自动实现免登访问报表资源或平台资源。
定时调度任务推送公众号消息。可选择公众号后台消息模板,关联 FineReport 内容,定时向用户发送重要的服务通知。
支持多个公众号和小程序配置参数、选择消息模板功能。
公众号消息模板事件功能,支持 PC 端和 HTML5 页面事件执行事件触发。
小程序链接页面单点登录。beta 测试功能。
注:因微信平台权限限制,插件功能仅支持公众号服务号,不支持订阅号。
2. 插件介绍
2.1 插件安装
点击下载插件:微信公众号消息推送插件
设计器插件安装方法参照 设计器插件管理
服务器安装插件方法参照 服务器插件管理
2.2 操作方法
安装插件后分别进行「微信公众号平台配置」和「决策系统相关配置」。
2.2.1 微信公众号平台配置
1)配置可信域名
JS 接口安全域名
公众号在「网页授权获取用户基本信息」中设置「授权回调页面域名」。
注:微信公众号的可信域名需要与数据决策系统「管理系统>公众号管理>应用管理」中的「报表服务器地址」一致。
2)获取基本配置信息
在「基本配置」中获取公众号/小程序的 appid、secret。
3)配置模板消息接口
设置模板ID、模板标题和模板内容。模板内容设定规则详情见 3.4 节。
2.2.2 服务器数据集配置
新建服务器数据集,用于查询公众号/小程序用户的 openId 和报表系统用户名的映射关系。
服务器数据集中的用户数据,来源于微信公众号平台扫码获取。如下图所示:
注:这里的服务器数据集名即对应「管理系统>公众号管理>应用管理」中的「公众号数据集」。
2.2.3 公众号管理配置
1)应用管理
管理者登录数据决策系统,选择「管理系统>公众号管理>应用管理」,配置「微信公众号」相关值。
具体参数说明如下表所示:
参数 | 说明 | 备注及示列 |
---|---|---|
报表服务器地址 | 数据决策系统 URL,公众号设置此域名白名单 | 例如:https://localhost/webroot/decision |
公众号appid | 公众号后台查询 appID | |
公众号secret | 公众号后台查询 appsecret | |
公众号数据集 | 公众号 openid 与报表用户关联 | 服务器数据集名称 |
公众号报表用户名 | 数据集中报表用户列序号 | 默认为 2 |
公众号用户名 | 数据集中 openid 列序号 | 默认为 1 |
小程序appid | 小程序管理后台查询 AppID | 所需跳转到的小程序 appid。
|
小程序secret | 小程序管理后台查询 AppSecret | |
小程序pagepath | 模板消息跳转小程序页面路径 | 例如:pages/fr/fr |
小程序数据集 | 小程序 openid 与报表用户关联 | 服务器数据集名称 |
小程序报表用户名 | 数据集中报表用户列序号 | 默认为 2 |
小程序用户名 | 数据集中 openid 列序号 | 默认为 1 |
2)应用快捷配置
可设置微信代理服务器功能、生成微信登录认证链接功能。
3. 示例
3.1 配置微信公众号平台
配置公众号的可信域名,并获取基本配置信息。详情见 2.2.1 节,具体操作可自行百度搜索。
3.2 配置服务器数据集
管理员登录数据决策系统,点击「管理系统>数据连接>服务器数据集」,新建一个服务器数据集 offiaccount。
数据来源于微信公众号平台扫码获取(详情见 2.2.2 节),「OPENID」对应获取结果中的「微信号」,「USERNAME」对应定时调度>基本设置中的「用户」。如下图所示:
3.3 配置公众号管理
选择「管理系统>公众号管理>应用管理」,新建一个微信公众号,并配置相关值。
3.4 定时调度推送公众号
注:不支持推送文件到公众号
管理员登录数据决策系统,选择「定时调度>任务管理>添加任务」。如下图所示:
1)基本设置
设置任务名称为「公众号测试」
默认用户组选择服务器数据集中设置的 USERNAME,本例中为「陈斌(Jack)」
2)调度对象
选择「产品明细-phone.cpt」模板,文件处理选择「不清理」。
3)调度周期
默认设置即可。
4)文件处理
处理方式:勾选「客户端通知」。
推送终端:勾选「公众号消息推送」,在下方出现的下拉框,选择公众号项。
注:公众号项由 数据决策平台>公众号管理中设置的应用名称 和 微信公众号平台中设置的模板标题 组成。消息类型:选择「消息模板」。
主题、内容:分别输入对应「标题」、「内容」、「信息」、「电话」、「地址」。
链接:选择「自定义链接」,并在下方输入对应自定义链接。
注1:自定义链接可以设置推送的模板为其他模板,定时结果链接推送的模板就是调度对象里选择的模板。
注2:自定义链接地址使用模板预览链接。
「主题」、「内容」的规则说明如下:
微信公众号平台中,参数需以 {{ 开头,以 .DATA}} 结尾。报表端模板只需将 DATA 替换为 ${单元格} 的形式。
微信公众号平台模板 | 数据决策系统平台 |
---|---|
标题:{{subject.DATA}} 内容:{{content.DATA}} 电话:{{phone.DATA}} | 标题:{{subject.${A1}}} 内容:{{content.${A3}}} 信息:{{message.${B4}}} 电话:{{phone.${D11}}} 地址:{{address.${D13}}} |
注:报表端的「主题」和「内容」的值在后台先合并,然后产生公众号消息模板所需数据。
3.5 效果预览
公众号消息推送消息效果如下图所示:
4. 单点登录链接访问报表
单点登录链接访问报表,支持 FineReport 系统 HTML5 页面链接的访问。可用在微信公众号的菜单链接、公众号消息推送链接、微信小程序链接中。
点击推送消息,会打开链接地址进行访问,点击「继续访问」进行网页授权,会跳转到结果报表展示画面,此时用户已登录。
5. 模板事件推送消息
5.1 添加模板事件
1)单元格事件
选中单元格,点击右侧「控件设置」添加任意控件。点击「事件>添加事件」添加一个初始化事件。
编辑该初始化后事件,选择「微信公众号消息」,如下图所示:
2)模板事件
点击菜单栏「模板>模板 Web 属性」,分别为「分页预览设置」、「填报页面设置」、「数据分析设置」都添加 加载结束事件。
在加载结束事件的事件设置中选择「微信公众号消息」,如下图所示:
5.2 设置消息接收对象
公众号消息可以发送给平台用户、角色和机构部门,最终接收对象为三项的并集。这里以用户做示例,发送模板消息给 Jack 。
5.3 填写消息内容
1)客户端:默认支持 PC 平台。用户可通过安装微信公众号插件,增加微信公众号客户端。「微信公众号应用」选择框下拉读取公众号插件中配置的应用名称。
2)链接:表示模板消息发送后打开的模板,该模板以「分页预览」的方式打开。链接不能为空。
3)标题:模板消息发送的标题。
4)内容:消息提示内容。如下图所示:
保存模板报表后,触发事件执行操作,即可收到推送微信公众号消息。
6. 注意事项
公众号和小程序功能已有客户成功使用案例,如有相关插件应用方案和改善建议,可及时反馈以获得技术支持。
电脑版微信打开报表预览,如出现出现 WECHAT_EMPTY_TITLE,可选择浏览器打开链接。
因微信平台权限限制,插件功能仅支持公众号服务号,不支持订阅号。