WeLink集成

1.1 版本

1.2 功能简介

管理员安装插件并配置，可实现 WeLink 集成，并进行消息推送。

2.1 安装插件

插件下载：WeLink管理插件、HTML5 移动端展现插件

插件安装：插件管理 

2.2 welink后台添加应用

2.2.1 新建应用

登录 WeLink 管理后台，点击「应用>自建应用>到开放平台创建」，在 WeLink 开放平台创建「轻应用」。如下图所示：

填入应用信息后，点击「提交」，创建应用。

注：未打 * 的项可以先不填。

2.2.2 开放接口权限

创建应用后，在轻应用中可以查看到新建的应用，点击进入新建应用后，点击「开发指引」，选择「申请权限」，进行权限设置。

需要开放的接口如下图所示，可根据需求进行开发。

2.2.3 获取应用参数

我们需要关注三个参数：

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代理跳转

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 「应用」中，找到该应用。