反馈已提交

网络繁忙

WeLink集成

  • 文档创建者:April陶
  • 历史版本:11
  • 最近更新:April陶 于 2023-07-17
  • 1. 概述

    1.1 版本

    Finereport 版本
     WeLink 管理插件版本H5移动端展现插件
    功能变动
    11.0.2V11.0.54V11.0.54-
    V11.0.62V11.0.62「成员管理」支持同步多个企业的数据
    V11.0.72V11.0.72「成员管理」支持同步根部门下的用户
    11.0.9V11.0.74V11.0.74优化单点登录性能

    1.2 功能简介

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

    2. 操作步骤

    2.1 安装插件

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

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

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

    2.2 welink后台添加应用

    2.2.1 新建应用

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

    2021-10-19_11-47-13.png

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

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

    2021-10-19_13-37-17.png

    2.2.2 开放接口权限

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

    2021-10-19_14-16-18.png

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

    2021-10-19_14-36-01.png

    推送文件消息&图片消息需要开启云空间权限。

    image-2023-04-11-13-56-05-666.png

    2.2.3 获取应用参数

    我们需要关注三个参数:

    参数
    含义
    Client_Id客户ID
    租户ID租户ID
    Client_Secret授权码

    1)在 welink 开放平台,「轻应用」选择应用,点击「基本信息」,获取Client_IdClient_Secret

    2021-10-20_11-16-20.png

    2)在 WeLink 管理后台,点击「设置>租户信息」获取租户ID

    2021-10-20_11-17-41.png

    2.3 报表服务器添加应用

    返回工程,在「管理系统> WeLink 管理」下设置。需要在 2.1 节安装插件后才具备该节点。

    2.3.1 服务器地址

    在「管理系统> WeLink 管理」,填写「服务器地址」。必须设置服务器地址并保存,如果不设置,推送的时候可能会有问题,报表服务器地址示例:http://域名:端口号/webroot/decision

    注:请使用二级或二级以上域名,且需通过 ICP 备案。

    2021-10-20_10-35-33.png

    2.3.2 新建WeLink应用

    点击「新建 WeLink 应用」填入轻应用名称、Client_Id、Client_Secret、租户ID。应用参数信息在 2.2.3 节获取。

    2021-10-20_11-35-20.png

    完成后如下图所示:

    2021-10-20_11-38-55.png

    2.4 成员管理

    可根据实际情况选择一种用户匹配方式。

    用户匹配方式:WeLink成员ID匹配手机账号匹配手动匹配自定义匹配。「成员管理」页面如下图所示:

    注:不管集成几个 WeLink 应用,用户统一进行管理。

    2021-10-20_14-07-38.png

    2.4.1 WeLink成员ID匹配

    WeLink 成员 ID 对应报表用户名,若一个成员 ID 对应多个报表用户名,则遍历取第一个报表用户进行匹配。

    2021-10-20_14-09-55.png

    2.4.2 手机号匹配

     WeLink 成员手机号对应报表用户手机号,若一个成员手机号可对应多个报表用户名,则遍历取第一个报表用户进行匹配。

    2021-10-20_14-09-55.png

    2.4.3 手动匹配

    手动设置 WeLink 用户匹配具体报表用户。当匹配方式为手动匹配时,成员列表中多出「用户名」一列信息,点击出现下拉框,选择相应的用户名,进行手动匹配。如下图所示:

    注1:手动匹配时,用户名支持选择「不选」选项。

    注2:手动匹配方式是用户可以自由选择与 WeLink 用户匹配的报表用户,可实现多个 WeLink 用户匹配同一个报表用户。

    2.4.4 自定义匹配

    选择对应服务器数据集,选择对应列,实现 WeLink 成员 ID 匹配对应报表成员用户名。

    即通过设置的服务器数据集,将对应数据列的 WeLink 用户和报表用户相匹配。若出现一个 WeLink 用户对应了多个报表用户的情况,默认匹配第一个报表用户。选择自定义匹配时,下方多出「匹配设置」项,选择数据集WeLink 成员账号用户名,进行匹配。如下图所示:


    2.5 应用快捷配置

    2.5.1 WeLink代理跳转

    点击「应用快捷配置>代理服务器地址」,输入地址后点击「测试连接并保存」。

    1634711226779923.png

    注:和微信的代理服务器地址配置逻辑相同,服务器需要可以与外网互通,配置正向代理后,在此处填写对应代理地址。代理配置参考:微信钉钉集成环境准备第 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 链接

    首先要选择轻应用名称,链接页面下拉选择决策平台,点击生成链接后,点击复制按钮即可,如下图所示:

    2021-10-20_14-33-13.png

    2)生成访问某个模板的 WeLink 链接

    首先要选择应用名称,链接页面下拉选择单个模板,然后选择一张模板,如果需要设置参数,可以点击设置参数默认值进行设置,设置了参数后可以根据自己的需要选择是否解析参数值,最后点击生成链接,点击复制按钮即可,如下图所示:

    2021-10-20_14-40-05.png

    • 设置参数默认值

    点击设置参数默认值后,如果模板本身有参数,那么会显示在下方,用户可以设置参数的默认值,当然也可以点击右上角「添加」参数,如下图所示:

    注:如果想删除参数,可以鼠标悬浮在参数列表的右边,会出现删除按钮。

    2021-10-20_14-46-57.png


    • 解析参数值

    假如一张模板a.cpt设置了一个参数date,其值为公式${today}

    如果勾选了解析参数值,那么点击生成链接后,链接中会自动解析出今天的日期,也就是变成了:a.cpt&date=2020-11-03

    如果不想链接中直接解析参数,想要保留这个公式,可以取消勾选解析参数值,点击生成链接后,公式保留:a.cpt&date=${today}

    注:必须勾选「解析参数值」,否则将导致参数丢失。模板消息推送的消息链接可选择不解析参数值,从而实现推送的公式计算。

    2021-10-20_14-49-56.png


    2.5.3 新建WeLink群

    点击「新建 WeLink 群」,可实现推送消息到群,群成员除群主外还要至少两人。

    注:群消息推送不支持图文消息推送。

    2021-10-20_14-58-26.png

    2.6 WeLink后台发布应用

    返回 WeLink 开放平台进行应用配置,发布应用。

    2.6.1 设置首页地址

    本文第 2.4.2 节「应用快捷配置」生成的 WeLink 链接,挂在 WeLink 后台可实现单点。在 WeLink 开放平台的「轻应用>版本管理」下,「设置首页地址」。

    2021-10-20_15-07-34.png

    填入工程中生成的 WeLink 链接。

    2021-10-20_15-09-02.png

    2.6.2 发布应用

    在「版本管理」点击「发布应用」,并审核通过后,成功上线。如下图所示:

    2021-10-20_15-20-22.png

    2.6.3 设置可见范围

    发布后,可在 WeLink 后台的「应用>自建应用」下看见发布的轻应用。

    2021-10-20_15-22-17.png

    点击查看可见范围,默认是全体员工。不可以单个用户,目前仅支持选择全体员工/部门,如果可见范围选择部门,需要选择根部门。

    2021-10-20_15-30-07.png

    2.7 效果预览

    实现集成后,在 WeLink 「应用」中,找到该应用。

    5dc36b94e4a6980d2d83444f9afc78ee.jpg

    附件列表


    主题: 移动端应用
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

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

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

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持