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