WeLink 轻应用免登录集成 FineReport

•  
•  
•  
•  
• 文档创建者：Leo.Tsai
•  
• 编辑次数：5次
•  
• 最近更新：Leo.Tsai 于 2020-03-09

1. 概述

1.1 版本

1.2 应用场景

以 H5 的方式将 FineReport 集成到 WeLink 。

1.3 插件安装

实现 WeLink 轻应用免登录集成 FineReport 需要安装两个插件，分别为：

1）可在插件商城或设计器内下载安装插件：HTML5 移动端展现

2）从本地安装附件压缩包中的插件：fr-plugin-welink-1.7.zip

设计器插件安装方法参照：设计器插件管理

服务器安装插件方法参照：服务器插件管理

2.操作步骤

1）将附件压缩包中的 welink.html 放入报表工程根目录下，放置路径为：%FR_HOME%\webapps\webroot\welink.html，如下图所示：

2）将附件压缩包中的 welink.properties 放到工程的%FR_HOME%\webapps\webroot\WEB-INF\resources路径下，如下图所示：

3）访问 WeLink开放平台 获取本公司的微码应用 Appid 和 AppSecret ，如下图所示：

4）编辑器打开 welink.properties，将 Appid 和 AppSecret 改成上面已经获取到的本公司微码应用 Appid 和 AppSecret，如下图所示：

5）Welink 开放平台配置 FineReport 轻应用的集成方式，选择其他方式，勾选来自纯H5页面链接方式，将第一步中放置的 welink.html 的访问路径配置到这里，参考如下样例，然后将此应用申请发布。

6）重启 FineReport 报表服务器。从 WeLink 应用列表点击你发布的 FineReport 轻应用，实现单点登录集成。

3. 注意事项

1）目前集成方式只支持简单的单点登录集成，以 H5 访问方式访问 FineReport 服务。尚未支持用户、组织部门等其他信息同步功能。

2）管理用户时，需要提前在报表决策平台的用户管理中添加用户，其中 FineReport 的用户名对应 WeLink 中的英文名部分，当英文名校验一致后，FineReport 进行登录。

WeLink中的用户信息如下：

决策平台添加用户时，用户名需要跟上面的 WeLink 英文名保持一致。

3）如果您想用其他信息作为 FineReport 的登录校验信息，可以自行修改 welink.html 文件。其中 H5 Login 方法内会做对应的用户信息获取工作，其中 userinfo 会返回如下图所示的信息：

默认使用返回的 userNameEn 进行用户匹配，可更换成对应你想用的其他字段，只需要修改 welink.html 的 H5Login 方法即可，如下图获取对应的匹配信息：