[]
        
在线Demo 免费试用
(Showing Draft Content)

连接网络型JSON

1. 概述

1.1 功能概述

Wyn支持连接网络型JSON,然后对接入的数据进行加工和处理,并最终通过仪表板或报表实现数据的可视化展示。

1.2 应用场景

当您需要使用网络型JSON,并将其数据接入 Wyn,借助 Wyn 强大的可视化图表与报表功能进行数据展示时,本文将为您详细介绍网络型JSON数据接入 Wyn 的具体操作流程,为您提供全面且实用的参考。

2. 操作步骤

2.1 前提条件

连接网络型JSON数据前,需满足以下条件:

  1. 接口准备:请提前准备好网络型JSON接口。

2.2 操作步骤

步骤一:创建数据源,选择Json

  1. 文档门户单击创建文档image2018-7-30_10-56-34.png,选择数据源

    创建文档

  2. 下图图标视图选择Json

    image

步骤二:填写配置信息

  1. 填写配置信息,首先为数据源命名,选择源类型网络

    可见配置页面分为了左右两部分,左半部分是全局配置,右半部分是每个端点地址的配置。

    image

  2. 全局配置

    基准地址,端点地址:在连接网络型 Json 数据时,我们将最终的 URL 拆分成了“基准地址”和“端点地址”两部分。

    一个基准地址可搭配多个端点地址,从而通过一个数据源连接多个基准地址相同的 JSON URL。最终,一个端点地址对应一张数据表。支持添加多个基准地址,方便将相关数据汇总,便于查看和管理。

    例如,以下两个网络 JSON 数据,URL如下:

    https://jsonplaceholder.typicode.com/posts

    https://jsonplaceholder.typicode.com/comments

    这两个 URL 的加粗部分相同,属于基准地址,剩余部分是他们各自的端点地址。现在我们通过数据源连接它们。

    1)首先单击基准地址后的加号,添加一个基准地址。

    image

    2)为基准地址添加名称和 URL,然后保存。

    image2021-11-8_11-0-25.png

    属性介绍如下:

    属性

    含义

    名称

    基址名称

    URL

    基址URL

    参数

    在基准地址中添加 URL 参数进行数据过滤,此参数相比端点地址中添加的参数用法相同,但可用范围较广,可在基准地址以及下属所有端点地址中使用。有关参数的详细介绍请见连接网络型JSON时使用参数

    请求头

    全局添加 Http 头字段,可以设置字段名称和字段值,配置之后所有的端点地址都可以使用。但如果端点地址配置中也配置了请求头,则优先使用端点地址配置。

    3)接下来添加端点地址。在端点地址右侧点击加号。

    image

    4)配置端点地址。

    image

    属性介绍如下:

    属性

    含义

    名称

    必填项,为端点地址命名。

    基准地址

    选择该端点地址使用的基准地址,这里我们选择之前创建的基准地址 001。您也可以选择 “None” 不使用任何基准地址,直接在端点地址中呈现URL的全部内容。

    基准地址参数

    如您在基准地址中添加了参数在此处就可以看到这些参数,方便在端点地址中使用。

    API地址

    必填项,填入 URL 去除基准地址后的剩余部分,作为端点地址。如 https://jsonplaceholder.typicode.com/ posts 中的 “ posts ”。

    端点地址参数

    在端点地址中添加 URL 参数进行数据过滤,此参数与基准地址参数的用法相同,但可用范围较小,仅在当前端点地址中使用。

    有关参数的详细介绍请见连接网络型JSON时使用参数

    5)保存之后可以在全局配置下的端点地址列表中看到保存的端点地址,但端点地址是未验证的状态。

    接下里需要在右侧为端点地址进行详细配置,配置之后进行验证使端点地址生效。每个端点地址均需验证。

    image

  3. 端点地址配置

    请求方法: 根据服务端的设定选择使用 GET或 POST 的请求方法。

    认证: 下拉选择认证模式为 无或其他公用授权项。如需添加授权项,请按照以下提示内容进行添加。

    type=info

    提示

    添加授权项的步骤:

    1)单击右侧的加号按钮。

    image


    2)为认证授权项命名,选择认证模式为 Basic 或 OAuth2。

    当认证模式为 Basic 时,需设置用户名和密码。

    当认证模式为 OAuth2 时,需设置授权类型、TokenEndpoint、ClientID、ClientSecret、用户名和密码等信息。

    image2021-3-18_13-58-30.png


    3)保存。保存之后,所有的端点地址在配置认证信息时,都可以在下拉列表中选择使用公用的授权项。免去一一配置的麻烦。

    image

    属性

    含义

    基准地址参数

    显示端点地址所用基准地址中的的参数列表,方便您在端点地址配置中使用这些参数。

    端点地址参数

    显示当前端点地址中已添加的参数,也可以单击右侧加号添加新的参数。

    端点地址请求头

    为当前选择的端点地址配置请求头,可添加 Http 头字段,可设置字段名称和字段值。

    如果端点地址配置和全局配置中都配置了请求头,则会优先使用端点地址配置中的请求头。如果端点地址中未配置请求头,则会继承全局中的请求头。

    有效载荷

    当使用 POST 请求方法时,可根据需要传输数据的类型设置有效载荷。

    预查询

    查询 Json 数据,可以选择“ Json路径 ”直接填写路径进行读取;也可以选择“ SQL语句(使用Json函数) ”对Json数据进行预处理。

    • Json路径:即解析JSON数据结构并取出指定数据集合的JSON Path表达式,如 $.bookstore.books[*]。有关JSON Path的语法,参见http://goessner.net/articles/JsonPath/

    • SQL语句(使用Json函数):使用Json 函数对Json 数据进行预处理,可解析数据行的字符串单元格,并且可与其他表进行连接。详见Json 函数详解

  4. 端点地址验证

    1)单击请求预览可预览整个请求的信息,方便您查看请求是否符合预期。

    image

    2)单击验证按钮,进行验证。

    image

    3)验证通过后,端点地址列表中显示成功,端点地址添加完成。您可以通过预览按钮,预览数据。

    image

    4)预览数据列表界面

    image2021-11-8_15-20-8.png

    5)接下来,按照上述操作添加其他端点地址,并验证。

步骤三:保存

  1. 添加完成之后,单击页面右下角的创建,保存Json数据源。

    image

Wyn成功连接网络型JSON数据后,可以在「文档门户>我的分析>数据源」列表中找到创建成功的本地型JSON数据源。保存后的文件更多介绍,请见数据源操作