# 华为云Astro轻应用API数据集
通过调用华为云Astro轻应用的接口，来获取数据。
#### 前提条件
- 连接的数据源已创建，如何创建请参见[华为云Astro轻应用数据源](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6161.html)。
- 数据集所使用的转换器已创建，如何创建请参见[新建转换器](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6156.html)。
  华为云Astro轻应用预置了转换器供用户直接使用，用于把调用API接口返回的数据转换成二维结构。如果使用华为云Astro轻应用预置的转换器，则无需执行此操作。本示例中，请提前创建[图1]中的转换器。
  图1华为云Astro轻应用转换器   
  ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123027640.png "点击放大") 
 
 #### 创建数据集
1. 参考[登录华为云Astro大屏应用界面](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6008.html)中操作，登录华为云Astro大屏应用界面。
2. 在主菜单中，选择"数据中心"。
3. 在左侧导航栏中，选择"数据集 \> 全部"。
4. 在数据集管理页面，单击"新建数据集"。
5. 在新增数据集页面，设置数据集名称、选择数据类型、数据源和目录，单击"保存"。 
   图2新建华为云Astro大屏应用API数据集   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158425833.png)
   - 数据集名称：新建数据集的名称，用于标识该数据集。长度为1\~60个字符，可包括中文、字母、数字及下划线。
   
   - 数据类型：选择"AstroZero API"。
   
   - 数据源：选择[华为云Astro轻应用数据源](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6161.html)中，创建的数据源。
   
   - 目录：设置数据集的存放目录，配置为[（可选）新建目录](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6152.html)中新建的目录，也可以直接单击"新增目录"，新建一个目录。
   
   - 责任人：数据集的创建人。
   
   - 描述：新建数据集的描述信息，通常设置为数据集的功能。
   
   
   
   
6. 配置数据集参数。 
   图3设置数据集   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123185784.png "点击放大")
   - 应用：选择调用自定义接口所属的应用。
   
   - API接口：选择待调用的API接口，下拉框中的选项取值为接口的标签，如果接口标签取值为中文，则这里"API接口"显示为中文标签。如果接口标签未定义，则显示接口的操作名称。
   
   - 请求类型：API接口的请求类型，系统会自动填入。
   
   - 参数：接口入参，当有入参时，系统会自动展示，本示例不涉及。 当有入参时，单击参数后的"变量配置"，可给变量设置默认值。
     图4给变量设置默认值   
     ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158307393.png "点击放大") 
   
   - 测试API接口：用于测试该接口，单击"测试API接口"，"样例报文"中会显示输出结果。
   
   - 样例报文：对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。
     ```
     {"resCode":"0","resMsg":"成功","result":{"data":[{"name":"A市","value":806},{"name":"B市","value":421},{"name":"C市","value":332},{"name":"D市","value":165},{"name":"E市","value":729}]}}
     ```
     输入样例报文后，单击"格式化"，可对样例报文进行格式化处理。
     
   
   - 转换器：单击"新建转换器"或选择[新建转换器](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6156.html)中创建的转换器，用于对数据进行转换处理。
   
   - 数据预览：单击"数据预览"，可直观展示经过转换器处理后的样例报文。
   
   
   
   
7. 单击"保存"，完成数据集的创建。
 
#### 在组件中使用数据集
1. 返回华为云Astro大屏应用项目列表页面。
2. 进入开发页面，拖拽所需的组件（如基本柱图）到画布中。 
   图5拖拽所需组件到画布中   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158425825.png "点击放大")
   
   
3. 选中该组件，单击组件上方的![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123027660.png)，进入组件数据页面。
4. 在"数据类型"下拉框中，选择"数据集"，选择[创建数据集]中创建的数据集。
5. 配置全局变量。 
   全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。如何使用全局变量，可参考[如何基于页面级的全局变量实现组件交互](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_6173.html)\~[如何通过全局变量，实现组件数据的动态变化](https://support.huaweicloud.com/usermanual-astrocanvas/astrocanvas_05_7037.html)。本示例不做配置。
   
   
6. 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击"保存"。 
   图6拖拽字段到坐标轴   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123185760.png "点击放大")
   - 表格字段：展示[创建数据集]中，获取的数据。
   
   - 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据和系列中。
   
   - 刷新周期：每隔多少秒从华为云Astro轻应用中读取一次数据，默认配置为"0"，表示只获取一次。
   
   - 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。
   
   
   
   
7. 选中基本柱图组件，单击组件上方的![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002148293797.png)，设置标题内容为"各市1月降雨量(mm)"。
   
   图7设置图表标题   
   ![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158307397.png "点击放大")
   
   
8. 单击页面上方的![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002123286424.png)，保存设置页面。
9. 单击![](https://support.huaweicloud.com/usermanual-astrocanvas/zh-cn_image_0000002158647057.png)，进入预览页面，预览效果。