億信BI在設計報表時提供了多種報表引數，那什麼是報表引數，包含哪些型別？都有什麼作用呢？在設計報表時我們如何正確使用這些報表引數？今日課題為你詳解報表引數的相關內容。

 

1什麼是報表引數

億信BI報表內容都可以作為引數，使用者可以根據實際需求將報表中的可變數作為引數。

 

更簡單點說，引數好比一個十字路口，站在十字路口的我們最後所到達的目的地（分析結果），會根據選擇前後左右方向（選擇引數）的不同而不同。

 

用sql的眼睛來看，引數可以影響到sql語句的任意部分，它可以決定select中的內容、where的內容、group by的內容、order by的內容，有SQL的地方就會有引數的影子。

 

2為什麼要使用引數

按照報表內容的可變性，報表分為靜態報表和動態報表（引數化報表）。

 

億信BI引數面板支援編輯框、列舉框、勾選框組、維下拉框和日期型等多種引數型別。如果是列舉型別、勾選框組的引數，該型別引數的下拉列表內容可以是靜態手工輸入的，也可以來自於第三方資料來源，其內容可以隨第三方資料來源資料動態變化。

 

引數面板中提供了引數型別對應引數內容變化的行為響應事件(引數聯動)，極大的方便了使用者使用引數化報表時對引數的選擇或輸入，減少了使用者重複定製引數條件生成報表的工作量。

 

3引數設定入口

進入報表模板設計器介面，下圖所示位置：

 

4引數型別及使用說明

目前億信BI支援如下12種報表引數：

下面我們一起來了解一下報表引數的型別的屬性和它的使用說明。

按鈕

按鈕用於需要有特殊點選事件的情形，如在報表上新增一個“匯出”按鈕。

 

 

還可增加其它常用按鈕，比如計算、清空、編輯、匯出、日誌、訂閱、新增到收藏夾、列印、列印預覽、檢視報表說明等。

 

按鈕新增完成後，可以在按扭屬性的“事件”中直接選擇配置；如果你有更多的需求，可以在事件中自行寫指令碼實現。

 

 

下拉按鈕

當分析表含有多個點選事件，但設定多個按鈕介面又不夠美觀，那麼下拉按鈕就能很好的解決此問題。

 

 

如上圖的效果，只需拖動一個下拉按鈕引數元件到引數面板區，按需設定【選單設定】屬性就可以完成。

滑塊

滑塊引數使用時可以根據滑鼠的拖動改變引數值，如下圖所示：

 

具體屬性設定如下：

 

  

 

【最大值】滑塊最右邊（到頂）的數值。

【最小值】滑塊最左邊的數值。

【步數】可將滑動塊等分為所設定的步數。

滑動塊常與鑽取合用於即時重新整理統計圖。

輸入框

輸入框型別的引數通常用於使用者手工輸入引數，如下圖所示：紅色框架中的“20000”資料是手工錄入的。

 

具體的屬性設定如下圖：

 

日期

該型別用於選擇日期的引數。精確到天，以日曆的形式展現，如下圖所示：

 

具體的屬性設定如下圖：

 

 

【引數型別】有日期、年月、年供選擇

【允許選擇時間】勾選後即可選擇具體時間，精確到秒

【起始時間】日曆中可以選擇的最早時間

【截止時間】日曆中可以選擇的最晚時間

如果勾選了“允許選擇時間”，可選擇精確到秒：

 

年月

年月型別預設是當前年月，也可以根據自己需要寫預設值。其他屬性的介紹詳見《引數屬性詳細說明》。

 

年

 

起止日期

起止日期可輸入“時間軸刻度”，拖動時間點來實現資料的更新。

當“最近”按鈕在左側時，時間按照“時間軸刻度”顯示：

 

當“最近”按鈕在右側時，可選擇“開始時間”和“結束時間”：

 

 

具體屬性設定：

 

勾選框

勾選框型別引數一般用於控制引數的顯示。

 

 

【預設值】是T 時表示勾選，F表示不勾選。

【選中時的值】勾選框選中後，“選中時的值”中的數值，才有作用；如果勾選框沒有選，那麼該值是沒有作用的。

如下圖所示：

勾選框組

勾選框組的資料可以是列舉值也可以使用系統的維表。

 

 

如下圖，使用系統中的維表“行政區劃”的屬性設定：

 

 

設定後效果如圖：

 

可直接在分析表格中對此引數進行過濾設定即可。

列舉下拉

列舉下拉列表可配合列舉值一起使用：

 

設定效果如下：

 

 

 

【列舉值】引數可選值由顯示值和實際值組成，用分號’;’分隔開。例如：人民幣:10;美元:20;日元:30。

【允許多選】勾選後，引數可以選擇多個；不勾選，則只能選擇一個。

 

維下拉

該型別用維表作為引數，方便使用者選擇，與列舉下拉框一樣可以支援多選。

此處“引數型別”包含3種：

 

 

維下拉框

如果選擇了維下拉框，下方會顯示“維表”屬性用使用者選擇，此處會列出主題域下所有維表。

 

單位級次下拉框

單位次級下拉框是根據主題域或者主題集設定的資料級次維和當前使用者的許可權來顯示，支援多選。

 

資料期下拉框

該型別是根據所設定的主題表的資料期來顯示的。選擇該引數時所列的可選項是根據資料的實際情況顯示，即實際資料中有資料期才在報表期下拉框中列出，否則沒有。必須和某一主題表關聯，該主題表是可選擇的；而且該主題表需要設定資料期欄位。

 

具體屬性詳解如下：

【高階輸入】如果勾選選擇，將直接顯示資料期面板，引數名稱必須是set_bbqoption，所選的資料期引數將會自動作用報表。

【主題表】設定資料期型別引數時，需指定主題表，即使用某一主題表的資料期內容。如不指定，即為空的狀態，系統會自動分析當前報表所引用的主題表，選取第一個作為顯示資料期的主題表。

【顯示方式】可以只顯示程式碼或者文字，也可以都顯示。

【自動過濾】 勾選後，會根據該引數的相關屬性，自動設定過濾條件，不需要手工書寫和該引數相關的過濾條件。例如：勾選後，計算時會自動產生報表過濾條件：dim('維xxx')[email protected]。該屬性還可用於“單位級次下拉框”、“資料期下拉框”引數型別。

【根節點顯示】所有下級節點都可以設定為根節點。輸入方式形如A0000;B0000;C0000 這樣的格式，表示該下拉列表的根節點有三項。例如：110000;120000。如圖235北京市和天津市被設定為了根節點。該屬性的值也可以用其他引數值，如是其他引數的值，只需要填入該引數的名稱即可。

【包含根節點】當勾選時，就顯示“根節點顯示”中指定的根節點，如果“根節點顯示”為空表示以維度的頂級節點為根節點，該屬性是和“根節點顯示”屬性配合使用！

【節點過濾】根據節點過濾表示式篩選出符合條件的節點。維節點表示式中的特殊物件，item在遍歷每一個節點時，item是當前遍歷的維節點物件，根據item物件可以獲取到維的相關屬性。

 

 

例如要返回維程式碼前三位為010的節點，那節點表示式為left(item.id,3)=’010’。

【節點排序】格式是級數和排序引數用冒號分隔，每一級在用分號分隔開，例如0:desc;1:asc級數從0開始，0表示第一級，左邊的引數表示第1級降序第二級升序。

在下圖中“節點排序”屬性中輸入“0:desc”，資料按降序顯示：

【節點選擇】該屬性設定控制引數值選擇時只能選擇葉子節點，不能選擇父節點。

其他屬性的介紹詳見《引數屬性詳細說明》。

 

5引數屬性詳細說明

各屬性的詳細介紹：

【代號】引數容器的代號

【左邊距、上邊距、寬、高】用來確定引數的邊距和大小

【疊放次序】多個引數相互有重疊遮蓋時的疊放次序

【大小自適應】引數很多並且並排放時可以自適應大小

【水平位置、垂直位置、背景顏色、背景圖片、邊框】用於設定位置和外觀顯示

【顯示】下拉框選項，分別有隱藏、不列印可預覽、不列印不預覽、不匯出

【禁用】可對引數進行禁用，禁用後引數將不起作用。

【鑽取設定】可對引數進行點選鑽取設定。使用方法可參閱鑽取章節。

【引數型別】設定引數的資料型別，有文字、整數和浮點供選擇。

【引數順序】多個引數時，顯示的順序，系統會根據新增先後自動給出預設順序值。

【引數名稱】報表引數的代號，建議使用數字、字母與特殊字元的組合，主要用於對引數的引用。例如：@zczj。

【引數標題】給引數命名，報表引數的標題。例如：註冊資金。

【引數標題顏色】給引數標題設定顏色。

【顯示引數標題】可以控制顯示或者不顯示引數的標題。

【長度】引數值的最大長度

【預設值】沒有選擇引數前，預設的值。

【記錄結果集】上次選擇的引數內容是否保留以便下次使用時不需要再次選擇。

【自動過濾】勾選後，會根據該引數的相關屬性，自動設定過濾條件，不需要手工書寫和該引數相關的過濾條件。

 

6引數佈局

億信BI中的引數一般都是按預設的方式進行排列的，每個引數的寬度預設為200px，當一行顯示不了的時候，在自動換行顯示。如下圖所示：

這樣的方式可以滿足大多數的需求，但有些報表需要特殊排版，所以我們提供了引數佈局的設定面板。在引數面板空白處，點選右鍵->高階設定，如下圖：

有3種排版方式可供選擇：

 

 

系統預設佈局方式為系統自適應，如果無法滿足您的需求，也可以自己設定每行n個報表引數，或者設定自助拖動後，自己拖動報表引數到想要的位置。