如何配置数字翻牌器组件的回调ID

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

操作步骤

  1. 登录DataV控制台
  2. 选择任一可视化应用,单击编辑,进入画布编辑器页面。

  3. 添加数字翻牌器组件和通用标题组件到画布中。

  4. 选择数字翻牌器组件,单击编辑器右侧的交互页签。

    说明

    DataV提供了回调ID的独立编辑区域,即上图中的交互面板,方便您清晰快速地使用回调ID功能。

  5. 选中当前值变化时事件右侧的启用。修改绑定到变量中的变量名称。

    说明
    • 变量名称修改为income后,在需要响应回调ID的资产中就可以使用income来获取参数值。

    • 您可以给不同的资产设置不一样的变量名称,达到区分使用不同参数的目的。

  6. 单击需要响应回调ID的资产,在数据配置页面的数据源编辑框中,通过:变量名(如:income)使用您已经配置的变量。以通用标题组件为例。

    说明

    如果您的数据源类型静态数据或者CSV 文件,不支持回调ID。

    • SQL模式image

      select :income as value

      image

      select city from test_id_3 where id = :income
      说明
      • income为您配置的回调ID,value为您自定义的字段,用来接收回调ID的值。

      • idcity为您数据库中的字段,test_id_3为数据库中数据表的表名。

    • API模式image

      https://api.test?id=:income&city=:mycity
      说明

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

高级功能

设置自定义字段

  1. 选择数字翻牌器组件,单击编辑器右侧的数据页签。

  2. 单击配置数据源

  3. 在静态数据中新增一个id字段,值为123。

  4. 选择交互页签,单击新建一个字段

  5. 字段列输入id,在绑定到变量列输入您要设置的变量名称。

    说明

    只有同时填写了字段值和绑定到变量对应的值后,这个变量才会生效。

设置回调ID的默认值

您可以通过在URL中设置请求参数的形式来设置回调ID的默认值,示例如下。

http://datav.aliyun.com/screen/000000?myid=123

000000表示屏幕id。通过这个URL访问可视化应用时,在打开页面的同时,回调IDmyid的值已经被设置为123。多个回调ID之间使用“&”符号连接,如下的示例中同时设置了回调IDmyidincome的默认值。

http://datav.aliyun.com/screen/000000?myid=123&income=1000

000000表示屏幕id。

常见问题

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

A:画布编辑页面无法触发事件,获取回调值,因此请求失败。您可以选择以下两种方式,查看请求的返回值。

  • 预览页面查看。在浏览器控制台Network中查看请求的返回值,或者直接通过资产显示方式查看。

  • 编辑页面查看。在可视化应用URL后添加测试参数来测试数据,添加方式如下。

    https://datav.aliyun.com/admin/screen/99999?参数名=参数值