參數功能

1.1 版本

1.2 功能簡介

在組件設定內可以新增參數並進行綁定，在儀表板中過濾組件也綁定參數，可以實現對目標組件傳值的功能。

目前可以綁定參數進行傳值的過濾組件有：時間過濾組件、文字組件、數值下拉組件。

2.1 計算欄位中使用參數

在計算欄位中使用參數參與計算，在過濾組件中綁定參數實現動態控制計算欄位結果值。詳情參見：計算欄位中使用參數動態控制計算欄位結果值。

例如：使用者可以用過濾組件綁定參數進行傳值，動態更改大訂單和小訂單的衡量標準，當數值下拉組件的值為 2000000 時，2000000 被傳參到組件內部實現計算比較，合同金額大於 2000000 的訂單為大訂單，數量為 41 。如下圖所示：

2.2 欄位過濾綁定參數

在組件編輯介面對欄位進行過濾過程中綁定參數，過濾組件也綁定參數，即可實現對欄位過濾進行傳參。詳情可見：欄位過濾綁定參數實現動態過濾資料。

例如，在數值下拉中輸入數值 5 ，過濾出銷售額前 5 名的店名；輸入數值 9 ，過濾出銷售額前 9 名的店名，如下圖所示：

2.3 明細過濾綁定參數

在指標明細過濾中綁定參數並設定過濾條件，過濾組件綁定參數，可以實現動態過濾。詳情可見：動態計算某時間段內的新增數、動態展示過濾組件值前後一段時間的資料、動態展示天/週/月/年資料

例如：預設顯示距離當前時間前 15 天的資料，對日期過濾組件設定過濾條件後，資料也顯示過濾條件前 15天的資料。

選擇過濾條件為「2020-12-01」，則顯示「2020-12-01」之前 15 天的資料，如下圖所示：

在組件設定內新增建立參數，可對參數名稱進行修改，參數型別包括日期、文字、數值，建立對應型別後不支援修改型別，新增參數有兩種方式，如下圖所示：

• 新增組件參數，如下圖所示：

6.0.10版本 FineBI 支持设置组件参数默认值，组件界面会根据该值对添加了参数的字段进行过滤。方便用户进行数据校验。

• 新增組件參數後出現參數模組，此時可以在參數模組新增參數，如下圖所示：
  

• 參數暫時不支援單獨作為欄位拖入組件中使用

• 欄位明細過濾、欄位過濾綁定參數需要具備匹配關係：對應設定內容屬於文字值的只能綁定文字參數，屬於數值值的只能綁定數值參數，屬於日期值的只能綁定日期參數，如果文字欄位的過濾設定前N項，則綁定參數欄位為數值參數

• 一個過濾組件支援綁定多個參數欄位；同一個儀表板同一個組件參數只能被一個過濾組件綁定一次，綁定過後顯示灰化

• 在儀表板中過濾組件綁定參數，根據對應過濾組件型別，對應顯示相應型別的組件參數，如數值過濾組件，僅展示數值型別參數，如下圖所示：

在過濾組件編輯介面中，可以綁定 SQL 參數。

• 支援綁定 SQL 參數的過濾組件有，數值下拉過濾組件，文字過濾組件以即時間過濾組件。

• 關於 SQL 參數的使用，可參見：SQL 資料集參數。

• 日期區間、年月區間僅支援按開始區間、結束區間綁定參數，按照年月區間綁定會提示：不支援綁定 SQL 參數，如下圖所示：