概览
内容工具
第1步:在系统的门户网站中单击加号“+”,选择“数据源”。
第2步:在左侧数据源列表或者在右侧图标视图中选择文件型数据源“Json”。
第3步:创建连接。
首先为数据源命名,并将源类型选择为“网络”。
可见配置页面分为了左右两部分,左半部分是全局配置,右半部分是每个端点的配置。
我们先来看左半部分:
一个基址可搭配多个端点,这样一来就可以通过一个数据源来连接多个基址相同的JOSN URL。最终在数据源中一个端点就是一张数据表。
并且支持添加多个基址,这样一来,我们就可以通过一个JSON数据源将相关的数据都汇总起来,更加方便查看和管理。
比如有两个网络JSON 数据,URL如下:
https://jsonplaceholder.typicode.com/posts
https://jsonplaceholder.typicode.com/comments
这两个URL的蓝色部分相同,也就是基址,而剩余的部分就是他们各自的端点。
现在我们通过数据源连接它们。
首先单击基址后的加号,添加一个基址。
为基址添加名称和URL,然后保存。
接下来添加端点。
名称:必填项,为端点命名。
基址:选择该端点使用的基址,这里我们选择之前创建的基址001。您也可以选择“None”不使用任何基址,直接在端点中呈现URL的全部内容。
基址参数:如您在基址中添加了参数在此处就可以看到这些参数,方便在端点中使用。
API地址:必填项,填入URL去除基址后的剩余部分,作为端点地址。如 https://jsonplaceholder.typicode.com/posts 中的 “posts”。
端点参数:在端点中添加URI参数进行数据过滤,此参数与基址参数的用法相同,但可用范围较小,仅在当前端点中使用。
有关参数的详细介绍请见连接网络型JSON时使用参数。
保存之后可以在全局配置下的端点列表中看到保存的端点,但端点是未验证的状态。
接下里需要在右侧为端点进行详细配置,配置之后进行验证使端点生效。每个端点均需验证。
请求方法:根据服务端的设定选择使用 GET或 POST 的请求方法。
认证:下拉选择认证模式为None 或其他公用授权项。如需添加授权项,请按照以下提示内容进行添加。
提示
添加授权项的步骤:
1)单击右侧的加号按钮。
2)为认证授权项命名,选择认证模式为Basic 或OAuth2。
3)保存。保存之后,所有的端点在配置认证信息时,都可以在下拉列表中选择使用公用的授权项。免去一 一配置的麻烦。
基址参数:显示端点所用基址中的的参数列表,方便您在端点配置中使用这些参数。
端点参数:显示当前端点中已添加的参数,也可以单击右侧加号添加新的参数。
端点请求头:为当前选择的端点配置请求头,可添加Http 头字段,可设置字段名称和字段值。
如果端点配置和全局配置中都配置了请求头,则会优先使用端点配置中的请求头。如果端点中未配置请求头,则会继承全局中的请求头。
有效载荷:当使用POST 请求方法时,可根据需要传输数据的类型设置有效载荷。
预查询:查询Json数据,可以选择“Json路径”直接填写路径进行读取;也可以选择“SQL语句(使用Json函数)”对Json数据进行预处理。
单击“请求预览”按钮可预览整个请求的信息,方便您查看请求是否符合预期。
单击右下角的“验证”按钮,进行验证。
验证通过后,端点列表中显示成功,端点添加完成。您可以通过预览按钮,预览数据。
接下来,按照上述操作添加其他端点,并验证。
添加完成之后,单击页面右下角的“创建”按钮,创建数据源。
第4步:创建成功后,在门户网站的“数据源”分类下可以看到刚刚创建的数据源。单击文档名可预览数据源。
可见不同的端点最终会呈现为不同的数据表。
当使用本地Json文件出现乱码时,请将文件存储为UTF-8编码,然后再次上传。
使用Json数据源时如果检测到有重名列时,只有首次出现的列会被保留,重名列上的数据会被抛弃。