組件事件管理器

1.1 版本

1.2 應用場景

1）目前FR的自訂事件共有四種，參考 FineReport事件：

• 元件/組件事件：是指在元件/組件裏面新增的事件。元件包括參數元件，報儲存格件或其對應條件屬性中的元件，元件介紹請參考 元件簡介；組件包括決策報表塊、複合式報表塊等，請參考決策報表元件

• Web 頁面事件：是指在範本>範本 Web 屬性>分頁預覽設定/填報頁面設定/資料分析設定中新增的事件，請參考範本web屬性；

• 按鈕自訂事件：是指報表工具欄上新增自訂按鈕時，在按鈕上新增的事件，請參考自訂按鈕；

• 填報提交事件：是指在範本>報表填報屬性中新增的事件，請參考報表填報屬性簡介

範本中其他三種事件，都有統一的入口進行查看和管理。元件/組件事件則散落在不同的元件/組件中，當元件/組件較多時，尋找、修改已有的事件操作較繁瑣。

2）此功能應用於元件/組件事件較多、或需要統一排查修改事件的範本，為報表開發/維護者提供一個方便的事件管理入口。

3）元件、組件以下統稱為”組件“。

1.3 功能適用範圍

• 支援的報表類型：普通報表、複合式報表、決策報表。

• 支援的報表範圍：當前範本。

• 支援的組件類型：儲存格元件、儲存格條件屬性-元件、para組件和參數元件、body組件、絕對畫布塊、tab塊、報表塊、圖表塊。

• 支援的組件範圍：當前範本中具有事件設定的上述組件。

• 支援的事件類型：事件相應方式中所有設定項。包括js/提交/郵件等。

2.1 安裝插件

點選下載插件：組件事件管理

設計器插件安裝方法參照：設計器插件管理

伺服器安裝插件方法參照：伺服器插件管理

2.2 使用方法

設計器中，範本>workbook下，進入組件事件管理器，其中會列出當前範本中具有事件設定的組件，選中列表中的組件後，可以在右側管理器中進行事件的管理。事件管理與事件回應方式的操作相同。

注：在參數介面處於編輯狀態時，範本選單下面不會顯示組件事件管理器。

不同的報表類型，管理器的介面不同。下面區分報表類型來進行講解。

3.1 管理介面說明

1）報儲存格件/參數元件選擇器：可以選擇查看報儲存格件事件，或參數元件事件。

2）sheet選擇器：可以選擇查看某個sheet的報儲存格件事件。如果sheet太多，顯示不下，可以點選右側的箭頭組，切換顯示的sheet。

3）具有事件的組件列表：

• 展示了當前sheet中具有事件的組件列表，預設全部展開。點選某個組件後，在右側進行事件管理。

• 如果選中目錄層級，則右側不會顯示事件管理介面，提示“該物件未設定過事件”。

• 點選列表旁邊的小三角可以摺疊或展開列表區域。

• 若組件名稱太長，則可拖動組件列表下方的捲軸展示，或滑鼠移到組件名稱上顯示tooltip。

4）事件管理介面：可以進行事件的增刪改，具體操作其他相關文檔有介紹，不做贅述。

5）事件相應方式設定：可以進行事件相應方式/具體內容的編輯，具體操作其他相關文檔有介紹，不做贅述。

6）點選組件事件管理器右上角的關閉符號，即可自動儲存並關閉管理視窗。

3.2 儲存格元件

sheet1，儲存格B1按鈕元件，設定瞭如下的點選JS事件：

開啟組件事件管理器，選擇報儲存格件>sheet1，可以看到B1出現在組件列表內，前方的圖示提示是為儲存格按鈕元件。

在右側將js內容修改為“test”，關閉管理器。

再次查看B1按鈕元件的事件，發現內容已經修改。

注：當正在右側面板設定當前元件的事件時，開啟事件管理器，修改剛才正在編輯的事件；關閉管理器後，右側面板不會自動重新整理。需要點選別處後再次傳回，才能更新。

3.3 儲存格條件屬性-元件

sheet1，儲存格B1新增條件屬性，條件屬性名稱修改為TestCondWidget。新增條件屬性>元件>正文元件，設定瞭如下的JS事件：

開啟組件事件管理器，選擇報儲存格件>sheet1，可以看到B1(TestCondWidget)出現在組件列表內，括號中為條件屬性名，前方的圖示提示是為正文元件。

3.4 複合式報表塊中的元件

複合式報表塊中的儲存格元件、儲存格條件屬性-元件，與上述兩種類似。

這裏我們建立一個複合式報表sheet，拖入一個複合式報表塊，在A2儲存格處新增條件屬性，條件屬性名稱不做修改。新增條件屬性>元件>數字元件，設定瞭如下的JS事件：

開啟組件事件管理器，選擇報儲存格件>sheet2，在Block1目錄下，可以看到A2(條件屬性1)出現在組件列表內，括號中為預設條件屬性名，前方的圖示提示是為數字元件。

3.5 Para組件和參數元件

點選參數介面進入編輯，拖入正文元件和一個查詢按鈕。

對正文元件不做設定。查詢按鈕formSubmit0新增初始化後>傳送郵件的事件。

點選para組件（參數介面），新增一個初始化後>提交入庫的事件。

跳出參數編輯介面，開啟組件事件管理器，選擇參數元件tab，可以看到做過事件設定的para組件、查詢按鈕formSubmit0出現在組件列表內，名稱為組件名。正文元件因為沒有設定事件，所以不在其中。

4.1 管理介面說明

1）具有事件的組件列表：

• 展示了當前決策報表中具有事件的組件列表，預設展開到para/body層級。點選某個組件後，在右側進行事件管理。

• 如果選中未設定過事件的目錄層級，則右側不會顯示事件管理介面，提示“該組件未設定過事件”。

• 點選列表旁邊的小三角可以摺疊或展開列表區域。

2）事件管理介面：可以進行事件的增刪改，具體操作其他相關文檔有介紹，不做贅述。

3）事件相應方式設定：可以進行事件相應方式/具體內容的編輯，具體操作其他相關文檔有介紹，不做贅述。

4）點選組件事件管理器右上角的關閉符號，即可自動儲存並關閉管理視窗。

4.2 組件事件範例

決策報表中，本身不支援儲存格元件、儲存格條件屬性-元件、複合式報表塊，也不需要區分sheet，所以組件事件相關設定較為簡單。

例如，對決策報表參數面板下的下拉框元件comboBox0，設定初始化後事件。

開啟組件事件管理器，在para目錄下，可以看到comboBox0出現在組件列表內，前方的圖示提示是為下拉框元件。