全部產品
Search
文件中心

DataV:如何配置數字翻牌器組件的回調ID

更新時間:Jun 08, 2024

在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訪問可視化應用時,在開啟頁面的同時,回調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?參數名=參數值