HTTP连接器

前提条件

连接的数据源已创建，如何创建请参见HTTP连接器数据源。

创建HTTP连接器数据集

1. 参考登录AstroCanvas界面中操作，登录AstroCanvas界面。
2. 在主菜单中，选择“数据中心”。
3. 在左侧导航栏中，选择“数据集 > 全部”。
4. 在数据集管理页面，单击“新建数据集”。
5. 在新增数据集页面，设置数据集名称、选择数据类型、数据源和目录，单击“保存”。
   图1 新建数据集
   
   • 数据集名称：新建数据集的名称，用于标识该数据集。长度为1~60个字符，可包括中文、字母、数字及下划线。
   • 数据类型：选择“HTTP连接器”。
   • 数据源：选择HTTP连接器数据源中，创建的数据源。
   • 目录：设置数据集的存放目录，配置为（可选）新建目录中新建的目录，也可以直接单击“新增目录”，新建一个目录。
   • 责任人：数据集的创建人。
   • 描述：新建数据集的描述信息，通常设置为数据集的功能。

6. 配置数据集参数。
   图2 配置数据集参数
   
   • 动作：创建HTTP连接器时，定义的执行动作。
   • 参数：执行动作在连接器中，定义的参数。字段类型为“表达式”时，在字段值中单击鼠标，可进入表达式设置页面。在表达式设置页面，可从下方左侧面板选择字段名、函数或者直接输入函数，如图3。
     图3 表达式设置
     
   • 测试API接口：用于测试该接口，单击“测试API接口”，“样例报文”中会显示输出结果。
   • 样例报文：对应API接口的响应样例报文数据格式，数据集的元数据结构由该样例报文经转换器处理后的数据结构确定。

     单击“格式化”，可对样例报文进行格式化处理。

   • 转换器：选择新建转换器中创建的转换器或AstroCanvas预置的转换器，用于对数据进行转换处理。

7. 单击“保存”，完成HTTP连接器数据集的创建。

在组件中使用数据集

1. 返回AstroCanvas项目列表页面。
2. 进入大屏应用开发页面，拖拽所需组件（如水平基本柱图）到画布中。
   图4 拖拽水平基本柱图到画布中
   

3. 选中该组件，单击组件上方的，进入组件数据页面。
4. 在“数据类型”下拉框中，选择“数据集”，选择创建HTTP连接器数据集中创建的数据集。
5. 配置全局变量。

   全局变量可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的，例如图表联动、自定义字段等功能。如何使用全局变量，可参考如何基于页面级的全局变量实现组件交互~如何通过全局变量，实现组件数据的动态变化。本示例不做配置。

6. 在组件预览中，选择要展示的表字段，即从左边栏中拖入到右边栏中，单击“保存”。
   图5 拖拽字段到坐标轴
   
   • 表格字段：展示创建HTTP连接器数据集中，获取的数据。
   • 配置：从表格字段中，拖拽所需的字段到X轴数据、Y轴数据和系列中。
   • 刷新周期：每隔多少秒从HTTP连接器中读取一次数据，默认配置为“0”，表示只获取一次。
   • 共享数据：是否共享数据。勾选后，如果多个组件调用了相同的桥接器URL请求，不会各自只调用，而是共享结果数据。

7. 选中水平基本柱图组件，单击组件上方的，设置标题内容为“各功能操作频率统计”。
   图6 设置图表标题
   

8. 单击页面上方的，保存设置页面。
9. 单击，进入预览页面，预览效果。
   图7 最终呈现效果