1.1 版本

1.2 應用場景

不知道如何美化範本？不想在樣式配置上耗費太多時間？需要固定本公司常用的組件樣式或功能，需要自帶資料的組件來快速搭建 demo。

FineReport 組件複用功能輕鬆幫您解決上述問題，使用者可以直接從線上組件下載官方提供的組件，下載後將組件拖曳到自己的報表中，改下資料、大小、背景色等即可使用。

若將自己製作好的組件進行封裝，儲存至本地組件，也能實現拖曳複用。

簡單操作示範視頻如下：

1.3 組件上新日誌

帆軟 組件商城 持續上新中，您可以透過 帆軟市場組件更新日誌 查看最新上架的組件。

2.1 Mini組件商城

11.0.3 版本及之後的設計器中，決策報表新增了「Mini組件商城」，相當於将 帆軟市場 中的組件部分内置到了設計器。

使用「Mini組件商城」的主要目的是：更清晰的展示組件效果、便於維護。另外組件庫中的「在線組件」Tab 頁将逐步弱化直至被替代。

2.1.1 功能入口

在決策報表中，有兩個地方可以點擊彈出「Mini組件商城」：

• body 上方的「套用組件」按鈕。

注：無網時，點擊「套用組件」會跳轉到右側組件庫的「本地組件」Tab 頁。

• 組件庫「綫上組件」Tab 頁中「查看更清晰的web視圖」按鈕。

注：打開 Mini組件商城時，不支持同時使用在線組件庫。

2.1.2 下載安裝

1）Mini組件商城支持搜索、篩選「組件包」或「組件」。如下圖所示：

2）點擊匯總頁面「組件包」右下角的「下載」可下載組件包中所有組件；也可點擊進入組件包詳情頁面，支持下載所有組件或單個組件。如下圖所示：

3）點擊匯總頁面「組件」右下角的「下載組件」可直接下載組件；在組件詳情頁面，支持點擊彈出對應的組件包，支持下載「曆史版本」。如下圖所示：

4）下載的「組件包」或「組件」自動安裝到本地，顯示在「本地組件」Tab 頁下。如下圖所示：

且下載安裝在「組件庫>本地組件」中的組件，均存儲在 %FR_HOME%\webapps\webroot\WEB-INF\assets\component 路徑下。如下圖所示：

2.1.3 主題獲取

組件庫中包含 10.0 版本和 11.0 版本的組件，兩個版本的組件均可複用，但是 11.0 版本的「組件包」中包含 範本主題 ，複用時可保存主題應用到模板中，其餘組件選擇「跟随主題」即可應用相同的主題素材或配色。如下圖所示：

注：遠程狀态下，無管理員權限的賬号，無法保存主題到該工程下。

2.2 在線組件庫

「組件庫>綫上組件」與 Mini組件商城 相比，内容展示效果欠佳，但支持的功能幾乎一緻。

2.2.1 下載安裝

1）點擊組件包右下角「詳情」進入該組件包頁面，點擊「下載全部組件」即可下載全部組件，也可下載單個組件。

2）「組件」Tab 下，可通過篩選條件篩選組件或直接搜索組件。鼠标懸浮於組件，點擊下載按鈕即可下載組件，下載成功的組件右下角會出現  标識。如下圖所示：

3）下載的組件和組件包同樣會自動安裝，顯示在「本地組件」頁面，存儲在 %FR_HOME%\webapps\webroot\WEB-INF\assets\component 路徑下。

2.2.2 主題獲取

注：只有在「在線組件」頁面下的 11.0 版本及以上的組件才能獲取主題。

1）鼠标懸浮在組件或組件包上時，組件預覽圖中會出現相關提示，如下圖所示：

2）鼠标懸浮在組件或組件包上，單擊鼠标右鍵，彈出提示框，點擊「獲取當前主題」，即可獲取該主題并應用。如下圖所示：

注1：遠程狀态下，無管理員權限的賬号，無法保存主題到該工程下。

注2：點擊提示框中的「詳細說明」，可跳轉至帆軟市場組件詳情頁面。

2.3 組件版本

随着設計器的功能疊代，組件也可能會翻新，即存在組件會有不同的版本，那麽就會存在「組件更新」和「版本不兼容」兩種情況。

2.3.1 組件更新

設計器檢測到「本地組件」中有可更新的組件時，頁面會出現更新提示，可選擇「取消更新」或「全部更新」。如下圖所示：

注意事項：

• 若選擇取消更新，那麽組件保持原來的版本，直至關閉設計器；重新打開設計器時再次彈出提示。

• 全部更新會将所有可更新組件更新。若要單個更新，可在 Mini組件商城 中直接下載對應組件的新版本即可覆蓋舊組件。 

• 更新的組件對模板中已使用的組件無影響。

• 若要下載曆史版本的組件，可删除當前組件後，再在 Mini組件商城 中「獲取曆史版本」下載安裝。

2.3.2 版本不兼容

在 Mini組件商城中 下載「組件包」或「組件」時，若存在組件适配的設計器版本高於當前使用的設計器版本，會彈出提示：組件的版本高於設計器版本，下載後可能無法使用。是否繼續下載？ 如下圖所示：

若繼續下載，下載後在「本地組件」中會顯示爲「版本不兼容」，且不支持使用。如下圖所示：

2.4 使用組件

在「本地組件」中直接将組件拖入決策報表 body 中即可，如果是絕對布局還能自由調整組件位置和大小。

1）選中組件，其右上角會多出一個「幫助設定」按鈕  ，點擊按鈕進入幫助設置頁面，可以查看組件使用說明和組件中所有條件屬性、JS、超鏈接這些特殊設置項。（如果組件沒有特殊設置項，則不顯示。）

如下圖所示：

2）組件庫中的組件顯示在組件設置列表時，組件圖标右上角會有個藍色 logo ，組件名稱會根據決策報表中已有組件在封裝的組件名稱後自動添加後綴。如下圖所示：

3）組件庫中組件被拖曳到模板中時，若該模板應用的主題，和組件使用的主題名稱一緻，那組件中設置了「跟随主題」的設置項就保持「跟随主題」；若不一緻，則相關設置項全部處於「自定義」狀态，樣式設置值保持組件原有設置不變。例如下圖：

3.1 創建組件

如果您想将自己制作的組件保存起來，方便下次直接使用，就可以通過「創建組件」功能實現。

1）創建組件時，會将整個模板中所有的數據集一起封裝爲組件的内置數據集，所以創建組件時需保證模板中沒有與組件無關的數據集存在。

2）選中組件，支持多選，然後進入組件庫的「本地組件」頁面，點擊「添加組件>創建組件」，彈出組件生成的配置頁面。

3）設置相關信息後，點擊确定即可生成組件，生成的組件顯示在本地組件頁面，同樣保存至 %FR_HOME%\webapps\webroot\WEB-INF\assets\component 路徑下，也可将 .reu 文件直接複制給他人使用。

步驟如下圖所示：

注：自己本地生成的組件不能獲取主題使用。

3.2 安裝組件

當有些用戶是内網環境，通過 帆軟市場 下載的組件，或組件來源於他人分享，這時就需要通過「本地組件>安裝組件」将組件安裝到設計器再使用。

• 下載的「組件」以 .reu 文件的形式保存，「組件包」即将所有 .reu 文件打包壓縮後以壓縮包的形式保存。

• 設計器打開「組件庫>本地組件」頁面，點擊「添加組件>安裝組件」，選擇 .reu 文件打開，提示「組件安裝成功」後，即可在「本地組件」頁面中看到已安裝的組件。

如下圖所示：

注：支持選中多個 .reu 文件批量安裝組件。

3.3 添加分組

有時候本地組件太多了，整個頁面非常亂，找的時候也難找，可以将組件整理到不同分組下，這樣以後可以直接打開對應分組來找，節省時間。

1）點擊「本地組件」頁面下的「新增分組」按鈕，可以新建分組。

2）鼠标右鍵單擊組件後點擊「移動分組」，可以将組件移到某個分組。

如下圖所示：

3.4 批量操作

組件很多時，支持批量删除和移動分組，點擊「本地組件」頁面下的「管理組件」按鈕即可多選操作。如下圖所示：

4.1 新用戶須知

第一次打開組件庫頁面時，會彈出新手提示框，關閉後不再出現，如下圖所示：

4.2 遠程設計報錯

問題現象

遠程設計時，服務器 JAR 包版本跟設計器版本是一緻的，但是打開組件庫仍會出現如下圖所示報錯：

原因分析

可能是由於服務器組件目錄下的組件使用特殊符号命名導緻的。例如下圖使用橫線給組件命名：

如果确實是組件命名的問題，在 fanruan.log 日志中還會有錯誤信息：文件名、目錄名或卷标語法不正确。

解決方案

将組件名稱中的特殊符号去掉即可。