反馈已提交

网络繁忙

微信小程序集成

  • 文档创建者:April陶
  • 编辑次数:7次
  • 最近更新:April陶 于 2022-04-08
  • 1. 概述

    1.1 版本

    报表服务器版本

    11.0

    1.2 功能简介

    基于已有的微信小程序,然后将报表集成过去,帮助用户实现将微信小程序集成。小程序需要用户自己准备。

    示例演示的小程序为「帆软平台开发」小程序。

    2. 申请小程序

    若用户已有非个人主体的小程序,本操作可忽略。

    1)配置微信小程序,首先需要准备以下内容:

    • 一个邮箱地址账号

    • 企业营业执照注册号

    • 银行卡

    • 管理员身份证手机

    • 准备好 https 协议的报表环境,端口使用默认的 443 端口

    2)申请微信小程序:点击申请

    依次完成申请步骤:

    1)填写个人信息注册

    2)小程序激活

    3)信息登记

    注:由于个人类型的小程序不支持使用 web-view 组件,无法将H5项目以小程序的形式发布,必须使用非个人主体注册。

    4)完善小程序信息

    3. 配置业务域名

    1)首先小程序只支持 https 的域名,准备一个https工程。例如:https://www.finereporthelp.com/h5/decision

    2)下面配置业务域名。进入微信公共平台,打开「开发管理>开发设置>业务域名」,点击「下载校验文件」。如下图所示:

    2021-02-22_17-00-10.png

    将校验文件放置到工程域名根目录下,以 Tomcat 工程为例,是在 %Tomcat%/webapps/ROOT路径下,如下图所示:

    1600053766z9bS3C7B.jpg

    添加业务域名,如下图所示:

    1613985241959927.png

    存在问题可参考文档:业务域名设置--校验文件检查失败自查指引 

    4. 代码开发

    代码开发暂时只能依靠用户自己开发,有两种方式:

    • 通过微信开发者工具导入项目进行代码修改:可以通过微信开发者工具看到小程序展示效果,比较推荐。

    • 通过其他编辑器修改代码:需要开发者有一定代码能力。

    4.1 微信开发者工具代码修改

    1)下载并打开微信开发者工具:点击下载

    1600053766d3w1fHko.jpg

    2)在「开发者管理>开发设置」页面查看 AppID 和 AppSecret ,如下图所示:

    2021-02-22_10-16-14.png

    3)在「微信开发者工具」中导入项目并填写 appID 。如下图所示:

    2021-02-19_15-21-01.png

    4)将项目中的 src 修改为我们希望发布的 h5 项目的 url 地址。

    2021-02-19_15-22-09.png

    4.2 使用其他编辑器修改代码

    1)打开 project.config.json,填写 appid 。如下图所示

    1600053766bvxY8qRR.jpg

    2)将项目中的 src 修改为我们希望发布的 h5 项目的 url 地址。

    1600053766P5x8UW38.jpg

    4.3 对设置的URL进行说明

    • 若客户只是单纯集成报表平台,仅实现能访问报表环境即可,无需单点登录。

    则配置 url 为:https://www.finereporthelp.com/webroot/decision

    配置好以后小程序访问时直接到 H5 登录页,需要用户登录,此场景无需查看第7、8节内容。

    • 若客户设置了跨域单点集成,参见文档:HTML5 单点登录,这部分单点实现需要客户自行开发。

    则配置 url 为:https://www.finereporthelp.com/webroot/login.html

    配置好以后小程序访问时可直接单点登录访问平台目录,此场景无需查看第7、8节内容。

    • 若客户想要利用微信插件实现微信集成单点,则具体微信集成配置步骤参见第7、8节内容

    则配置 url 的格式参见本文 8.4 节。

    5. 代码上传

    代码上传有两种方式,一种是通过可视化界面操作上传代码,一种是通过命令行进行代码上传。推荐使用第一种。

    示例为可视化页面点击「上传」,如下图所示:

    2021-02-19_15-22-09.png

    6. 小程序发布

    进入小程序管理后台。打开「目录管理>版本管理」找到「开发版本」中上传的版本,提交审核。如下图所示:

    2021-02-23_10-54-14.png

    若客户想要利用微信插件实现微信集成单点。还需进行以下步骤:

    7. 个人微信添加企业微信公众号

    1)管理员登录企业微信管理平台,前往「通讯录」,添加个人微信账号。

    2021-02-23_11-36-00.png

    2)个人微信扫描二维码加入企业。

    1614058680223510.png

    3)个人微信关注企业公众号。

    2021-02-23_14-26-12.png

    4)取消勾选设置「 成员使用微信插件时需要使用企业微信客户端」。

    2021-02-23_14-26-12.png

    5)显示效果如图所示:

    1614062246168351.jpg    

    点开后效果如下图所示:

    1614062246868904.jpg

    8. 配置企业微信集成单点配置

    请事先将报表环境配置好 https 环境,以及工程域名端口用默认的 443端口 访问。例如:https://www.finereporthelp.com/h5/decision

    8.1 新建应用

    企业微信管理平台新建微信应用。

    1614063650834050.jpg

    注:这里设置的「可见范围」一定要选择「部门/标签」,不可选择单个用户,否则会导致集成失败。

    1614063708548248.jpg

    8.2 微信管理设置

    8.2.1 安装插件

    报表平台上,插件管理安装微信插件。

    点击下载插件:微信管理HTML5 移动端展现插件

    设计器插件安装方法请参见:设计器插件管理

    服务器安装插件方法请参见:服务器插件管理

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

    8.2.2 添加报表服务器地址

    在「微信管理>应用管理」页面配置服务器地址。示例为:https://www.finereporthelp.com/h5/decision

    2021-02-23_16-00-39.jpg

    8.2.3 新建微信应用

    1)新建企业微信应用,输入信息。

    1614065974548747.jpg

    2)新建应用需要使用的两个参数,获取如下:

    打开「企业微信管理平台>我的企业>企业信息」获取 CorpID 。

    1614065555547844.jpg

    打开「应用管理」获取 Secret 。

    8.2.4 同步与匹配用户信息

    在「微信管理>成员原理」,设置匹配方式,同步更新通讯录,做好报表用户和微信用户之间的匹配关联,具体匹配步骤参见:企业微信集成 第 4.3 节 成员管理。

    8.2.5 一键配置

    在「微信管理>应用快捷配置」,进行一键配置。

    1614067697417709.jpg

    8.3 进行域名校验

    打开微信管理平台,进行域名校验。步骤参见文档:微信集成后文件控件&文本控件扫码无法使用

    8.4 验证集成是否成功

    用户直接在微信点击企业微信号,打开进入目录列表,无需登录即说明配置正常。

    1600053766p60wkRjI.jpg

    8.4 生成小程序所需URL

    详情可参见 企业微信集成 4.2 节 应用快捷配置。

    • 实现单点登录平台

    打开「微信管理>应用快捷配置」,链接页面选择「决策平台」生成链接,复制获取 URL 。

    2021-02-23_16-20-06.jpg

    • 实现单点登录打开某个模板

    打开「微信管理>应用快捷配置」,链接页面选择「单个模板」生成链接,复制获取 URL。

    2021-02-23_16-19-27.jpg

    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭