在DataV中,回调ID是指某个组件在响应用户操作或者自动触发更新时,向其他组件传递的参数,这个参数可以在其他组件中作为数据查询时的动态变量。本文档以数字翻牌器组件为例,为您介绍回调ID的使用方法。

  1. 登录DataV控制台
  2. 我的可视化页面,单击您创建的可视化应用项目。
    如果页面中没有可视化应用项目,需要首先创建可视化应用项目,详情请参见使用模板创建可视化应用
  3. 选择数字翻牌器组件,单击编辑器右侧的交互页签。
    交互面板
    说明 DataV提供了一个回调ID的独立编辑区块,即上图中的交互面板,方便您清晰快速地使用回调ID功能。
  4. 选中数字变化响应事件右侧的启用
  5. 修改绑定到变量中的变量名称,如下图所示,将value修改为income
    修改变量名称
    说明
    • 变量名称修改为income后,在需要响应回调ID的组件中就可以使用income来获取参数值。
    • 使用这一特性,您可以给不同的组件设置不一样的变量名称,达到区分使用不同参数的目的。
  6. 单击需要响应回调ID的组件,在数据配置页面的数据源编辑框中,通过:变量名(如:income)使用您已经配置的变量。
    示例如下。
    • SQL(以下提供两种方式):
      select :income as value
      select A from table where count = :income

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

    • API:
      http://api.test?count=:income&id=:myid

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

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

高级功能

设置自定义字段

  1. 选择数字翻牌器组件,单击编辑器右侧的数据页签。
  2. 单击配置数据源
  3. 在数据源中设置一个id字段,值为123
    设置自定义字段
  4. 单击关闭图标返回配置面板。
  5. 单击交互页签。
  6. 交互配置页签内,单击新建一个字段
  7. 字段列输入id,在绑定到变量列输入您要设置的变量名称。
    新建一个字段
    说明 只有同时填写了字段绑定到变量后,这个变量才会生效。

设置回调ID的默认值

您可以通过在URL中设置请求参数的形式来设置回调ID的默认值,示例如下。
http://datav.aliyun.com/screen/000000?myid=123
000000表示屏幕id。

通过这个URL访问可视化应用时,在打开页面的同时,回调ID的myid的值已经被设置为123

多个回调ID之间使用“&”符号连接,如下的示例中同时设置了回调ID的myidincome的默认值。
http://datav.aliyun.com/screen/000000?myid=123&income=1000
000000表示屏幕id。

常见问题

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

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