1. 概述
1.1 版本
| Finereport 版本 | WeLink 管理插件版本 | H5移动端展现插件 | 功能变动 |
|---|---|---|---|
| 11.0.2 | V11.0.54 | V11.0.54 | - |
| V11.0.62 | V11.0.62 | 「成员管理」支持同步多个企业的数据 | |
| V11.0.72 | V11.0.72 | 「成员管理」支持同步根部门下的用户 | |
| 11.0.9 | V11.0.74 | V11.0.74 | 优化单点登录性能 |
1.2 功能简介
管理员安装插件并配置，可实现 WeLink 集成，并进行消息推送。
2. 操作步骤
2.1 安装插件
点击下载插件：WeLink管理插件、HTML5 移动端展现插件
设计器插件安装方法请参见：设计器插件管理
服务器安装插件方法请参见：服务器插件管理
2.2 welink后台添加应用
2.2.1 新建应用
登录 WeLink 管理后台，点击「应用>自建应用>到开放平台创建」，在 WeLink 开放平台创建「轻应用」。如下图所示：
填入应用信息后，点击「提交」，创建应用。
注：未打 * 的项可以先不填。
2.2.2 开放接口权限
创建应用后，在轻应用中可以查看到新建的应用，点击进入新建应用后，点击「开发指引」，选择「申请权限」，进行权限设置。
需要开放的接口如下图所示，可根据需求进行开发。
推送文件消息&图片消息需要开启云空间权限。
2.2.3 获取应用参数
我们需要关注三个参数：
| 参数 | 含义 |
|---|---|
| Client_Id | 客户ID |
| 租户ID | 租户ID |
| Client_Secret | 授权码 |
1）在 welink 开放平台，「轻应用」选择应用，点击「基本信息」，获取Client_Id、Client_Secret。
2）在 WeLink 管理后台，点击「设置>租户信息」获取租户ID。
2.3 报表服务器添加应用
返回工程，在「管理系统> WeLink 管理」下设置。需要在 2.1 节安装插件后才具备该节点。
2.3.1 服务器地址
在「管理系统> WeLink 管理」，填写「服务器地址」。必须设置服务器地址并保存，如果不设置，推送的时候可能会有问题，报表服务器地址示例：http://域名:端口号/webroot/decision
注：请使用二级或二级以上域名，且需通过 ICP 备案。
2.3.2 新建WeLink应用
点击「新建 WeLink 应用」填入轻应用名称、Client_Id、Client_Secret、租户ID。应用参数信息在 2.2.3 节获取。
完成后如下图所示：
2.4 成员管理
可根据实际情况选择一种用户匹配方式。
用户匹配方式：WeLink成员ID匹配、手机账号匹配、手动匹配、自定义匹配。「成员管理」页面如下图所示：
注：不管集成几个 WeLink 应用，用户统一进行管理。
2.4.1 WeLink成员ID匹配
WeLink 成员 ID 对应报表用户名，若一个成员 ID 对应多个报表用户名，则遍历取第一个报表用户进行匹配。
2.4.2 手机号匹配
WeLink 成员手机号对应报表用户手机号，若一个成员手机号可对应多个报表用户名，则遍历取第一个报表用户进行匹配。
2.4.3 手动匹配
手动设置 WeLink 用户匹配具体报表用户。当匹配方式为手动匹配时，成员列表中多出「用户名」一列信息，点击出现下拉框，选择相应的用户名，进行手动匹配。如下图所示：
注1：手动匹配时，用户名支持选择「不选」选项。
注2：手动匹配方式是用户可以自由选择与 WeLink 用户匹配的报表用户，可实现多个 WeLink 用户匹配同一个报表用户。
2.4.4 自定义匹配
选择对应服务器数据集，选择对应列，实现 WeLink 成员 ID 匹配对应报表成员用户名。
即通过设置的服务器数据集，将对应数据列的 WeLink 用户和报表用户相匹配。若出现一个 WeLink 用户对应了多个报表用户的情况，默认匹配第一个报表用户。选择自定义匹配时，下方多出「匹配设置」项，选择数据集、WeLink 成员账号及用户名，进行匹配。如下图所示：
2.5 应用快捷配置
2.5.1 WeLink代理跳转
点击「应用快捷配置>代理服务器地址」，输入地址后点击「测试连接并保存」。
注：和微信的代理服务器地址配置逻辑相同，服务器需要可以与外网互通，配置正向代理后，在此处填写对应代理地址。代理配置参考：微信钉钉集成环境准备第 4.2 节
WeLink 代理跳转说明：
1）判断是否需要填写代理服务器地址
若服务器是配置在外网环境中，则不需要设置代理服务器地址。
若服务器是配置在内网环境中，且客户服务器可以访问外网，网络正常，则不需要填写服务器地址。
若服务器是配置在内网环境中，且客户服务器访问不到WeLink服务器，访问不到外网时，需要配置代理服务器地址。
2）判断内网环境是否可访问到外网
①先判断报表服务器上，ping open.welink.huaweicloud.com，能 ping 通，代理服务器配置这边不用填写。
②ping不通，找一个代理服务器配置nginx正向代理，代理配置如下：
server {
listen 8115; # welink代理服务器端口
server_name 192.168.5.137; # welink代理服务器IP
location / {
proxy_redirect off;
proxy_pass https://open.welink.huaweicloud.com; #welink服务器域名
}
location = /favicon.ico {
log_not_found off;
}
}
2.5.2 生成WeLink链接
此处生成的链接，用于挂载在 WeLink 轻应用首页地址，或者用于推送的自定义链接处，可实现单点登录。
生成链接的时候一定要选择对应企业应用名称。
可以生成两种 WeLink 链接：一是用来单点登录到平台目录的；二是用来单点登录到模板的。
应用场景：应用的 主页 配置；
定时调度最后一步「文件处理>客户端通知」推送「自定义链接」。可参考文档：定时调度任务详细设置步骤；
模板消息事件插件推送： 模板消息事件插件 可以将该链接推送给移动端用户，用户点开后即可访问链接对应的内容。
1）生成访问决策平台的 WeLink 链接
首先要选择轻应用名称，链接页面下拉选择决策平台，点击生成链接后，点击复制按钮即可，如下图所示：
2）生成访问某个模板的 WeLink 链接
首先要选择轻应用名称，链接页面下拉选择单个模板，然后选择一张模板，如果需要设置参数，可以点击设置参数默认值进行设置，设置了参数后可以根据自己的需要选择是否解析参数值，最后点击生成链接，点击复制按钮即可，如下图所示：
设置参数默认值
点击设置参数默认值后，如果模板本身有参数，那么会显示在下方，用户可以设置参数的默认值，当然也可以点击右上角「添加」参数，如下图所示：
注：如果想删除参数，可以鼠标悬浮在参数列表的右边，会出现删除按钮。
解析参数值
假如一张模板a.cpt设置了一个参数date，其值为公式${today}。
如果勾选了解析参数值，那么点击生成链接后，链接中会自动解析出今天的日期，也就是变成了：a.cpt&date=2020-11-03。
如果不想链接中直接解析参数，想要保留这个公式，可以取消勾选解析参数值，点击生成链接后，公式保留：a.cpt&date=${today}。
注：必须勾选「解析参数值」，否则将导致参数丢失。模板消息推送的消息链接可选择不解析参数值，从而实现推送的公式计算。
2.5.3 新建WeLink群
点击「新建 WeLink 群」，可实现推送消息到群，群成员除群主外还要至少两人。
注：群消息推送不支持图文消息推送。
2.6 WeLink后台发布应用
返回 WeLink 开放平台进行应用配置，发布应用。
2.6.1 设置首页地址
本文第 2.4.2 节「应用快捷配置」生成的 WeLink 链接，挂在 WeLink 后台可实现单点。在 WeLink 开放平台的「轻应用>版本管理」下，「设置首页地址」。
填入工程中生成的 WeLink 链接。
2.6.2 发布应用
在「版本管理」点击「发布应用」，并审核通过后，成功上线。如下图所示：
2.6.3 设置可见范围
发布后，可在 WeLink 后台的「应用>自建应用」下看见发布的轻应用。
点击查看可见范围，默认是全体员工。不可以单个用户，目前仅支持选择全体员工/部门，如果可见范围选择部门，需要选择根部门。
2.7 效果预览
实现集成后，在 WeLink 「应用」中，找到该应用。
