Quick BI提供全局參數來設定一些變量,在配置報表時,可以通過引用全局變量的方式支持一些需要參數變化的場景。本文為您介紹跳轉、郵件訂閱和報表嵌入等場景的全局參數配置方法。
背景信息
在報表的使用過程中,用戶經常有這樣的需求:以一個銷售團隊為例,如果該銷售團隊的業務范圍是全國,那么意味著該銷售團隊需要隨時掌握30多個省的銷售情況,而且每一個省還有若干個城市,每一個城市還有若干個縣;隨著業務量的不斷增大和擴容,該銷售團隊所要查閱的銷售數據也會日益增加。在如此龐大且復雜的數據中,如果能夠實現每一個區域的負責人只看到自己負責的那份數據,那么既可以提高相關責任人的工作效率,又可以避免泄露敏感的商業數據。
全局參數是為報表提供一個標準化的入口,允許報表使用者在預覽報表時能夠通過URL參數注入的方式,動態改變報表內部圖表和查詢控件的過濾條件,從而達到從外部控制圖表內部數據展示結果的效果。全局參數的作用對象目前主要有以下兩種:
查詢控件:查詢控件接受到全局參數后,會直接以全局參數注入的條件作為默認值,綁定到某個具體的子組件上。
說明實際作用的圖表還需要依賴于對應子組件選擇的作用范圍。因為只是改變了默認值,所以其實報表使用者可以改變子組件的實際值來脫離全局參數的控制。
圖表:全局參數關聯到的圖表,本質上是在圖表最后的查詢SQL上拼接and片段(例如
and area = '華北'
),這個過程是服務器直接解析全局參數配置生成的,因此報表使用者無法更改這個結果,只能通過最終生成的sqlText來驗證數據結果。
全局參數配置說明
全局參數配置的入口位于報表頂部。新建報表時,全局參數圖標會被隱藏起來,只有保存后才會展示。全局參數配置頁面如下所示。
區域 | 描述 |
① | 全局參數配置入口。 全局參數配置依賴于報表內部的組件數據模型,建議在每次更新完圖表模型后重新配置全局參數。 |
② | 設置全局參數名稱。命名規則如下:
您可以單擊圖標,新建多個全局參數。 |
③ | 選擇參數關聯控件與圖表。
說明 為了保證參數注入的準確性和有效性,實際使用中應該盡量確保每個參數的職責是明確和單一的,謹慎將一個全局參數關聯到多個查詢控件,或者混合使用查詢控件和數據集,如實際業務需要,建議添加多個參數分別控制不同的查詢控件和圖表。 字段選擇:
|
④ | 參數設置。
|
為了保證參數的有效性,全局參數的配置過程中是實時檢測的,一個參數出現沖突時,所有全局參數都無法保存。
全局參數配置的過程依賴當前報表的內容,報表出現變更可能會導致已經配置的全局參數注入失效,因此建議每次報表變更后復查全局參數的配置是否有效。如果全局參數的配置出現沖突時,請根據提示調整對應參數的內容。
全局參數使用場景
跳轉場景
以排行榜(訂單信息)跳轉交叉表(商品信息)為例。
登錄Quick BI控制臺。
進入儀表板頁面。
在淘寶商品訂單詳情儀表板中,創建商品信息交叉表,并配置交叉表全局參數。
在數據頁簽選擇銷售數據為數據集,并命名為淘寶商品訂單詳情。
添加交叉表至儀表板中,命名為商品信息,并在儀表板頂部菜單欄,單擊保存。
在儀表板頂部菜單欄,單擊圖標。
在全局參數配置頁面,按照下圖示例,配置全局參數后,單擊確定。
在儀表板頂部菜單欄,單擊保存并發布。
在訂單銷售詳情儀表板中,創建訂單信息排行榜,并設置跳轉至商品信息交叉表。
在儀表板編輯頁面的數據頁簽,選擇銷售數據為數據集,并命名為訂單銷售詳情。
添加如下圖排行榜到儀表板,并命名為訂單信息。
單擊分析頁簽,在數據交互區域的跳轉配置右側,單擊圖標。
在跳轉頁面,按照下圖設置參數后,單擊確定。
跳轉設置更詳細的操作,請參見跳轉。
單擊排行榜訂單信息中的目標訂單編號,將自動跳轉至儀表板淘寶商品訂單詳情,并顯示目標訂單編號的商標信息。
跳轉的頁面如下圖所示。
郵件訂閱場景
在做郵件訂閱任務的時候,可以通過全局參數,給報表內的圖表注入過濾條件。以下僅介紹郵件訂閱中全局參數的使用,創建訂閱任務的詳細操作,請參見創建訂閱任務。
郵件、釘釘工作通知、飛書通知、企業微信通知、釘釘群、飛書群和企業微信群這7種訂閱方式都支持配置全局參數,本文僅介紹郵件訂閱場景。
在郵件訂閱的新建任務頁面,設置訂閱任務的內容為一個配置過全局參數的儀表板。
設置為一個配置過全局參數的儀表板后,系統會自動帶出相應的全局參數列表,且全局參數初始狀態是未配置,默認不生效。參數值設置為空和參數未設置是兩個不同的狀態。參數值設置為空,如果在關聯的查詢控件允許為空,會將關聯條件的值重置為空值。參數值未設置,則不會對查詢控件和圖表造成影響。
單擊操作列的圖標,對全局參數進行配置。
參數配置項的內容會隨著參數關聯字段的類型自動匹配。關聯圖表時,參數配置允許切換條件形式;關聯查詢控件時,只允許變更操作符和值。
完成訂閱任務的參數配置后,即可保證每次在做訂閱任務時,對應的參數會自動注入到報表的過濾條件中。
如您想通過配置全局參數實現不同用戶訂閱不同數據,請參見配置全局參數實現不同用戶訂閱不同數據。
報表嵌入場景
報表嵌入的全局參數使用說明,請參見報表嵌入數據權限控制和傳參的安全增強方案。