[直連]儀表板URL直接新增參數條件傳參

1.1 版本

1.2 問題描述

在整合環境下，使用者需要想要在開啟門店相關儀表板 URL 的時候，直接新增相關參數，如http://xxxxxxxx?店性質=管理店過濾出店性質為「管理店」的資料。

1.3 實現思路

• 在 SQL資料集 中新增參數；

• 在前端儀表板中直接增加參數條件，實現資料過濾功能。

若需要透過過濾組件傳遞參數，詳情參見：計算欄位中使用參數動態控制計算欄位結果值、跳轉到儀表板(網頁連結)。

2.1 新增  SQL 資料集

1）若同時擁有「直連資料」和「抽取資料」功能，則需要在資料列表中切換為「直連資料」，然後選擇「公共資料」，點選進入分組下業務包，點選「建立資料集>SQL 資料集」，如下圖所示：

注：只有 資料處理使用者 可以建立 SQL 資料集。

2）輸入 SQL 語句：select * from 門店銷售數據統計 where 店性質 in ('${店性質}')。${店性質}就是設定的參數變數，點選「重新整理」，設定參數的預設值為「自有店」，設定參數型別為文字型別，點選「預覽」，並確定儲存資料集，如下圖所示：

2.2 製作分組表

製作一個組件，圖表型別選擇「分組表」後，拖入欄位，如下圖所示：

2.3 傳遞參數

2.3.1 公共連結傳遞參數

若要實現在 URL 中的參數傳遞過濾，首先需要獲取該儀表板的 URL 。進入儀表板節點，對建立的儀表板選擇「建立公共連結」，開啓公共連結並「複製連結」，如下圖所示：

比如獲取的連結為：http://localhost:37799/webroot/decision/link/6uhj

在最後新增「?店性質=管理店」：http://localhost:37799/webroot/decision/link/6uhj?店性質=管理店

在位址欄輸入新增參數後的 URL，可以看到透過 URL 中的參數傳遞，實現「管理店」的過濾。

注：若瀏覽器不支援中文參數，即該參數傳遞過濾不生效，就需要把 json 型別的 url 參數值先進行編碼 encodeURIComponent()。比如 edge 瀏覽器。  

2.3.2 預覽連結傳遞參數

儀表板預覽的 URL 加上「?參數名稱=參數值」，也可以進行參數的傳遞。

例如點選「預覽儀表板」後可以獲取預覽的 URL ，如下圖所示：

在預覽的 URL 後加入「?店性質=管理店」，可以看到下方的分組表中過濾出了管理店的資料，實現參數的傳遞功能，如下圖所示：

在有多個參數的時候，URL 同樣可以透過新增參數來實現多個條件過濾的效果。

3.1 新增有多個參數的 SQL 資料集

新增 SQL 資料集，輸入帶包含多個參數的 SQL 語句：select *  from 門店銷售數據統計 where 店性質 in ('${店性質}' ) and 店風格 in ('${店風格}' )

點選「重新整理」，設定預設值為「時尚館」和「自有店」，並儲存資料集，如下圖所示：

3.2 建立儀表板

使用該資料表的欄位建立組件，包含「店性質」、「店風格」、「記錄數」欄位，組件中顯示欄位值均為參數預設值。如下圖所示：

3.3 傳遞參數

參考 2.3 節獲取該儀表板的連結，在獲取的 URL 之後加上多個參數及值：

例如獲取的預覽 URL 為：

http://localhost:37799/webroot/decision/link/84gRde3154bbeb059a00dba75689d

為其加上參數?店性質=管理店

http://localhost:37799/webroot/decision/link/84gRde3154bbeb059a00dba75689d?店性質=管理店

新增參數後儀表板可以直接過濾出對應的參數值，如下圖所示：