使用DataV可视化应用展示数据返回结果

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

本文为您介绍如何在DataV中调用DataWorks的数据服务API,并将数据返回结果展示在DataV可视化应用中。

前提条件

在开始本案例前,您需要首先完成准备工作,并已经生成了数据服务API

背景信息

警告

您必须使用HTTP协议进入DataV控制台,否则会导致API数据响应失败。

通过DataV调用数据服务API主要包含以下二个步骤。

  1. 添加DataWorks数据源:在DataV中添加DataWorks数据源。

  2. 在可视化应用中调用数据服务API:在组件的数据配置中,配置API数据源参数。

操作步骤

  1. 添加DataWorks数据源。

    1. 使用HTTP协议进入DataV控制台,选择我的数据 > 添加数据

    2. 单击类型下拉箭头,选择数据类型为DataWorks数据服务

    3. 添加数据对话框中填写DataWorks数据服务项目信息,本案例的配置信息如下图所示。

      添加数据

      参数

      说明

      自定义数据源名称

      数据源的显示名称,可以自由命名。

      项目

      DataWorks项目(工作空间)。

      Region

      需要与您的DataWorks项目在同一Region下。

      AppKey/AppSecret

      参考使用DataWorks数据服务生成API中的第三步,获取AppKeyAppSecret

  2. 在可视化应用中调用数据服务API。

    1. DataV控制台中,单击我的可视化 > PC端创建

    2. 选择一个模板,单击创建项目

    3. 创建数据大屏对话框中,输入数据大屏名称,单击创建

      示例选择如下模板。7d88658c0194faaaefc1ad24c7fa384a

      模板中的组件自带了静态数据,本案例以模板中的基本折线图组件为例,将组件数据配置为查询成交金额增长趋势的API

    4. 单击模板中的基本折线图组件,在右侧的数据配置面板中,单击配置数据源

    5. 设置数据源页面中,选择数据源类型DataWorks数据服务已有数据源为您第一步中添加的数据源,API为您已经发布的API。image

      说明

      本案例将上图中的pageSize设置为5,表示查询5天的数据。

    6. 单击预览数据源返回结果,查看API的查询结果,如下图所示。查看数据源返回结果

    7. 返回组件的数据面板,在字段映射关系中,将x字段映射为date1(日期为x轴),y字段映射为amount(成交额为y轴)。映射字段关系

      说明

      配置完成后,可以看到,当前xy无法匹配到字段。这是由于DataV对数据格式有一定要求,不能识别结构较深的字段。因此需要添加一个数据过滤器,过滤掉不必要的字段,在本案例中直接返回rows数组即可。

    8. 在组件的数据面板中,勾选数据过滤器,单击添加过滤器

    9. 设置数据源页面中,单击添加过滤器右侧的+

    10. 在过滤器代码编辑框中输入return data.data.rows;,单击测试(需要开启过滤器调试功能)。测试成功后,单击保存 > 完成添加数据过滤器

      数据过滤器支持使用JavaScript代码对数据结果进行二次过滤和处理,过滤器的data参数为API返回结果的JSON对象。本案例中,您只需要返回API结果中的rows数组,故需要输入代码return data.data.rows;即可,过滤完成后可以看到数据匹配成功。数据匹配成功

      说明

      此时折线图并没有正确展示,由于API返回的日期格式与组件默认的格式不一样,因此您还需要设置x轴的轴标签样式。

    11. 切换到组件的配置面板,设置x轴标签数据种类类目型设置x轴的轴标签样式

      组件的样式和数据都配置完成后,可以看到组件使用API数据,且显示正常。

后续步骤

按照以上方法,可以配置其他组件的数据和样式,完成可视化应用制作。