覆盖主要内容
版本: 下个版本

本文档介绍使用ID实现图表的联动功能。

回调ID介绍

什么是回调ID

回调ID可以理解为参数变量,用于控制组件之间的参数传递,从而达到交互的目的。例如下图中的基础柱图,单击图表中的某一项,然后显示该分类下子分类各年的详细销售额,就是通过配置组件的回调ID来实现的。

如何设置回调ID

  1. 登录Uniplore数据大屏系统。
  2. 在我的可视化页面,单击您创建的可视化应用项目。如果页面中没有可视化应用项目,需要首先创建可视化应用项目。
  3. 选择某个组件,单击编辑器画布右侧的交互页签。
  4. 选中当点击数据项时右侧的启用。  
  5. 修改绑定到变量中的变量名称。如下如所示,将x改成cate,y改成value,s改成series。
  6. 配置完成后,其他组件就可以使用cate、value、series来取得对应的参数值了。

如何使用回调ID

在数据模型过滤器、数据库(SQL)或API数据源中,通过 :变量名(如 :cate )使用您已经配置的变量。示例如下:

  • SQL
SELECT :cate as category
select A from table1 where B = :cate

cate为您配置的回调ID;category为您自定义的字段别名;AB为您数据库中的字段。

  • API
http://api.test?A=:cate&B=:value

catevalue是您配置的回调ID,AB为您API请求中的参数。

说明

  • 如果您的数据源类型为静态数据,则不支持回调ID的使用。
  • Uniplore数据大屏系统提供了回调参数自动补全功能。在配置数据源时,只要键入** : ,编辑器将提示当前屏幕下所有配置过的变量名称。您可以使用上下键选择某个变量,然后按Enter**键确定。当大屏中有大量交互组件的时候,这个功能可以帮助您方便快速地使用回调ID。

常见问题

  • Q:在画布编辑器页面,配置了回调ID后,无法获取回调值,导致数据查询失败怎么办?
  • A:画布编辑器无法触发事件,且预览或者发布页面,图表一开始加载数据的时候,也没有相关事件的触发,所以您设置的回调ID无法被设置为正确的值,这时候我们建议您使用受控模式。在数据配置面板的底部有一个受控模式选项,打开即可。这时候,图表在初始化时不会去加载数据。而是等到关联的事件被触发或者使用蓝图编辑器主动触发加载数据时才会去加载数据。