本文档介绍在DataV控制台中单击某一个图表,需要另外一个图表的数据也会有相应变化时,可以通过配置组件的回调ID,来实现图表联动的方法。

什么是回调ID

回调ID可以理解为参数变量,用于控制组件之间参数的传递,从而达到交互的目的。例如下图中的地图组件,单击地图上的某一个点显示这个点的详细信息,就是通过配置地图子组件的回调ID来实现的。地图组件回调ID

如何设置回调ID

  1. 选择某个组件,单击编辑器画布右侧的交互页签。
  2. 勾选数字变化响应事件右侧的启用
    启用回调ID
  3. 修改绑定到变量中的变量名称。

    如下图所示,将lng修改为 xlat修改为y

    修改变量名称

    配置完成后,其他组件就可以使用xy来取得对应的参数值了。

如何使用回调ID

在SQL或API数据源中,通过:变量名(如 :x)使用您已经配置的变量。示例如下:
  • SQL(以下提供两种方式):
    select :x as value
    select A from table where lng = :x

    x为您配置的回调ID;value为您自定义的字段,用来接收回调ID的值;lngA为您数据库中的字段。

  • API:
    http://api.test?lng=:x&lat=:y

    xy为您配置的回调ID,lnglat为您数据库中的字段。

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

常见问题

Q:在大屏编辑页面,配置了回调ID后,无法获取回调值,导致数据查询失败怎么办?

A:大屏编辑页面无法触发事件,获取回调值,因此请求失败。您可以选择以下两种方式,查看请求的返回值:
  • 预览页面查看。在浏览器控制台Network中查看请求的返回值,或者直接通过组件显示方式查看。
  • 编辑页面查看。在大屏URL后添加测试参数来测试数据,添加方式如下。
    https://datav.aliyun.com/admin/screen/99999?参数名=参数值