[]
        
(Showing Draft Content)

连接网络型JSON

本文为您介绍连接网络型 JSON 数据的过程。

操作介绍

1. 在系统的门户网站中单击加号,选择数据源

image2022-5-12_16-13-41.png


2. 在左侧数据源列表或者在右侧图标视图中选择文件型数据源 Json

image2021-5-6_12-3-25.png

type=info

提示

如未见数据源的连接入口,需请管理员到后台管理的数据源管理中勾选该数据源,仅勾选的数据源可以使用。更多介绍,请见数据源管理

3. 创建连接。

首先为数据源命名,选择源类型网络

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

image2021-11-8_10-16-28.png


我们先来看左半部分:

全局配置

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

一个基址可搭配多个端点,这样一来就可以通过一个数据源来连接多个基址相同的 JOSN URL。最终在数据源中一个端点就是一张数据表。

并且支持添加多个基址,这样一来,我们就可以通过一个 JSON 数据源将相关的数据都汇总起来,更加方便查看和管理。


比如有两个网络 JSON 数据,URL如下:

https://jsonplaceholder.typicode.com/posts

https://jsonplaceholder.typicode.com/comments

这两个 URL 的加粗部分相同,也就是基址,而剩余的部分就是他们各自的端点。

现在我们通过数据源连接它们。


首先单击基址后的加号,添加一个基址。

image2021-11-8_10-30-58.png


为基址添加名称和 URL,然后保存。

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

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

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


接下来添加端点。

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


image2021-11-8_11-27-42.png

名称: 必填项,为端点命名。

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

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

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

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

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


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

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

image2021-11-8_11-39-34.png

端点配置

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

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

type=info

提示

添加授权项的步骤:

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

image2021-11-8_11-40-56.png

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

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

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

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

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

image2021-3-18_14-28-46.png

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

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

端点请求头: 为当前选择的端点配置请求头,可添加 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 函数详解

端点验证

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

image2021-11-8_15-14-35.png


单击右下角的验证,进行验证。

image2021-11-8_15-16-18.png


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

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


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


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

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

image2021-11-8_15-22-9.png


4. 创建成功后,在门户网站的数据源分类下可以看到刚刚创建的数据源。单击文档名可预览数据源。

image2022-5-12_16-14-9.png


可见不同的端点最终会呈现为不同的数据表。

image2022-5-12_16-14-25.png

注意事项

  • 当使用本地 Json 文件出现乱码时,请将文件存储为 UTF-8 编码,然后再次上传。

  • 使用 Json 数据源时如果检测到有重名列时,只有首次出现的列会被保留,重名列上的数据会被抛弃。