1. 概述
1.1 版本
报表服务器版本 |
|---|
| 11.0 |
1.2 功能简介
基于已有的微信小程序，然后将报表集成过去，帮助用户实现将微信小程序集成。小程序需要用户自己准备。
示例演示的小程序为「帆软平台开发」小程序。
注：本文方案依赖 微信管理插件、HTML5 移动端展现插件 。
2. 申请小程序
若用户已有非个人主体的小程序，本操作可忽略。
1）配置微信小程序，首先需要准备以下内容：
一个邮箱地址账号
企业营业执照注册号
银行卡
管理员身份证手机
准备好 https 协议的报表环境，端口使用默认的 443 端口
2）申请微信小程序：点击申请
依次完成申请步骤：
1）填写个人信息注册
2）小程序激活
3）信息登记
注：由于个人类型的小程序不支持使用 web-view 组件，无法将H5项目以小程序的形式发布，必须使用非个人主体注册。
4）完善小程序信息
3. 配置业务域名
1）首先小程序只支持 https 的域名，准备一个https工程。例如：https://www.finereporthelp.com/h5/decision
2）下面配置业务域名。进入微信公共平台，打开「开发管理>开发设置>业务域名」，点击「下载校验文件」。如下图所示：
将校验文件放置到工程域名根目录下，以 Tomcat 工程为例，是在 %Tomcat%/webapps/ROOT路径下，如下图所示：
添加业务域名，如下图所示：
存在问题可参考文档：业务域名设置--校验文件检查失败自查指引
4. 代码开发
代码开发暂时只能依靠用户自己开发，有两种方式：
通过微信开发者工具导入项目进行代码修改：可以通过微信开发者工具看到小程序展示效果，比较推荐。
通过其他编辑器修改代码：需要开发者有一定代码能力。
4.1 微信开发者工具代码修改
1）下载并打开微信开发者工具：点击下载
2）在「开发者管理>开发设置」页面查看 AppID 和 AppSecret ，如下图所示：
3）在「微信开发者工具」中导入项目并填写 appID 。如下图所示：
4）将项目中的 src 修改为我们希望发布的 h5 项目的 url 地址。
4.2 使用其他编辑器修改代码
2）将项目中的 src 修改为我们希望发布的 h5 项目的 url 地址。
4.3 对设置的URL进行说明
若客户只是单纯集成报表平台，仅实现能访问报表环境即可，无需单点登录。
则配置 url 为：https://www.finereporthelp.com/webroot/decision
配置好以后小程序访问时直接到 H5 登录页，需要用户登录，此场景无需查看第7、8节内容。
若客户设置了跨域单点集成，参见文档：HTML5 单点登录，这部分单点实现需要客户自行开发。
则配置 url 为：https://www.finereporthelp.com/webroot/login.html
配置好以后小程序访问时可直接单点登录访问平台目录，此场景无需查看第7、8节内容。
则配置 url 的格式参见本文 8.4 节。
5. 代码上传
代码上传有两种方式，一种是通过可视化界面操作上传代码，一种是通过命令行进行代码上传。推荐使用第一种。
示例为可视化页面点击「上传」，如下图所示：
6. 小程序发布
进入小程序管理后台。打开「目录管理>版本管理」找到「开发版本」中上传的版本，提交审核。如下图所示：
若客户想要利用微信插件实现微信集成单点。还需进行以下步骤：
7. 个人微信添加企业微信公众号
1）管理员登录企业微信管理平台，前往「通讯录」，添加个人微信账号。
2）个人微信扫描二维码加入企业。
3）个人微信关注企业公众号。
4）取消勾选设置「 成员使用微信插件时需要使用企业微信客户端」。
5）显示效果如图所示：
点开后效果如下图所示：
8. 配置企业微信集成单点配置
请事先将报表环境配置好 https 环境，以及工程域名端口用默认的 443端口 访问。例如：https://www.finereporthelp.com/h5/decision
8.1 新建应用
企业微信管理平台新建微信应用。
注：这里设置的「可见范围」一定要选择「部门/标签」，不可选择单个用户，否则会导致集成失败。
8.2 微信管理设置
8.2.1 安装插件
报表平台上，插件管理安装微信插件。
点击下载插件：微信管理、HTML5 移动端展现插件
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
注：微信/钉钉集成过程中，必须确保各版本相对应，详情参见：微信、钉钉、H5、服务器、JAR 之间的依赖关系
8.2.2 添加报表服务器地址
在「微信管理>应用管理」页面配置服务器地址。示例为：https://www.finereporthelp.com/h5/decision
8.2.3 新建微信应用
1）新建企业微信应用，输入信息。
2）新建应用需要使用的两个参数，获取如下：
打开「企业微信管理平台>我的企业>企业信息」获取 CorpID 。
打开「应用管理」获取 Secret 。
8.2.4 同步与匹配用户信息
在「微信管理>成员原理」，设置匹配方式，同步更新通讯录，做好报表用户和微信用户之间的匹配关联，具体匹配步骤参见：企业微信集成 第 4.3 节 成员管理。
8.2.5 一键配置
在「微信管理>应用快捷配置」，进行一键配置。
8.3 进行域名校验
打开微信管理平台，进行域名校验。步骤参见文档：微信集成后文件控件&文本控件扫码无法使用
8.4 验证集成是否成功
用户直接在微信点击企业微信号，打开进入目录列表，无需登录即说明配置正常。
8.4 生成小程序所需URL
详情可参见 企业微信集成 4.2 节 应用快捷配置。
实现单点登录平台
打开「微信管理>应用快捷配置」，链接页面选择「决策平台」生成链接，复制获取 URL 。
实现单点登录打开某个模板
打开「微信管理>应用快捷配置」，链接页面选择「单个模板」生成链接，复制获取 URL。
上一篇：微信公众号消息推送插件
