API资产—JSON数据导入功能详解
前言
什么是JSON数据？
一、官方解释
JSON是一种存储结构化信息的格式。它主要用于在服务器和客户端之间传输Web应用程序数据。JSON以字符串或对象的形式出现在扩展名为.json的文件中或在引号内，以其他文件格式分配给变量。
二、JSON数据结构
由于JSON结构基于JavaScript对象文字语法，因此它们有许多相似之处。
这些是JSON语法的核心元素：
- 数据以key/value对的形式呈现。
- key与value用英文冒号
- 数据元素用英文逗号分隔。
- 花括号{}确定对象。
- 方括号[]表示数组。
JSON数据如下所示：
//普通JSON数据格式
{
"key1": "value1",
"key2": "value2",
"key3": "value3"
}
//对象嵌套数组
{
"key1": "value1",
"key2": "value2",
"key3": [
"value3",
"value4",
"value5"
]
}
//数组嵌套对象
[
{
"key1": "value1",
"key2": "value2"
},
{
"key3": "value3",
"key4": "value4"
}
]
三、在线JSON工具
- JSON数据校验工具
- JSON数据对比工具
功能介绍
在轻易云数据集成平台中最为重要的就是API资产，在过去的实施经验中发现，如果API资产没有维护好就会导致每次用到同一个API都要从零开始配置，这样非常耗费时间而且容易出错。这就越发突显出维护好API资产是迫在眉睫的事情。但是在维护API资产的过程中发现，有的API请求的时候字段非常的多，如果要一个一个去添加的话也是非常耗费时间的，所以为了加快API资产的维护工作故开发了此功能。
在各类开放的API文档中，几乎都会提供一个成功请求的JSON示例。在过往的操作中我们需要根据字段一个一个去添加，但是使用此功能，即可直接将JSON数据直接转成API资产中的请求参数，大大的提高了API资产的维护效率。
操作教程
一、获取JSON数据
首先我们需要获取到一段格式正确的JSON数据。
注：如何判断JSON数据格式是否正确可以使用上文提到的 JSON数据校验工具 。JSON数据我们一般可以从API文档中去获取到，在这里我们以管易ERP的开放API为例给大家讲解一下该功能是如何使用的。
二、导入JSON数据
新建一个API资产或打开一个现成的API资产，找到JSON导入按钮，将获取到的JSON数据粘贴到JSON文本框，然后点击确定，就可以看到JSON数据已经转为API资产中的请求参数了。
注：在前言部分介绍JSON数据的时候就已经提过JSON数据是键值对形式的，那么在导入过程中键的部分将转为请求参数中的字段，值的部分将转为默认值的部分。
三、分录子集导入
该功能不仅支持多维导入也支持分录子集导入。也就是选中需要导入子集的字段然后点击JSON导入将JSON数据导入到选中字段的子集中。
注：分录子集导入功能仅支持字段类型为多行分录或者子表对象的。该功能不支持多字段同时导入。
