引擎API

FineReport 設計器與伺服器已經能夠滿足大部分的需求，但某些個性化需求可能無法實現，這時就需要透過二次開發的方式來實現這些需求。

FineReport 開放了一些後台API供應用開發人員進行深入的開發與控制。想要使用這些API，首先必須瞭解 FineReport 核心結構。如下圖所示：

Finereport 報表分兩個基本面，範本和結果，沒有執行過的工作薄或者報表就是範本，而執行過後就是結果。

設計器中建立一個工作薄就是建了一個 WorkBook，WorkBook 相當於一個容器，裏面可以放任意個 WorkSheet，就相當於在一個工作薄中建立了多個 sheet。每個 WorkSheet 由任意個儲存格 CellElement 組成，因此 CellElement是一個範本的最小元素。如果要對報表中的 CellElement 進行操作，獲得 WorkBook 後，必須取得對應的 WorkSheet。

瞭解了以上核心架構後，就可以透過 API 直接後台修改和設定範本。

如獲取到 CellElement 之後，透過 CellElement 的屬性設定儲存格的文字色彩、背景、邊框、字體、字號等；每個 WorkSheet 中可以新增，刪除儲存格；設定每個 sheet 的頁面屬性；給每個 sheet 中新增圖表懸浮元素等；對 WorkBook 進行執行獲得結果並匯出成各種格式、可以進行列印、新增工具欄等。

本章提供了一些常用的後台API和範例，使用者可以參考使用，來滿足自己對產品的一些開發需求。如下圖所示：

注：文檔中提供的 FineReport 相關 API API，對 FineBI 是不適配的。

2.1 報表資料源

FineReport 設計器本身已經提供了資料庫資料源、正文資料源、XML 資料源等多種資料來源方式，同時程式員還可以透過Java 程式自行生成資料來源，只要實現了 AbstractTableData 抽象類，FineReport 報表引擎就能夠讀取使用者自訂的資料源。詳細內容可參考：程式資料源

2.2 報表呼叫

在程式中可以建立一個報表物件，也可以直接讀取一個 cpt 範本，建立或讀取後，您可以對報表物件的儲存格屬性、Web 屬性、參數、頁面設定等多個屬性進行控制，可以自由控制儲存格的顯示樣式、工具欄的按鈕等。經過處理的報表最終可以匯出成多種形式，可以儲存為程式網路報表在 Web 端直接存取。詳細內容可參考：程式網路報表

2.3 自訂函式

FineReport 提供了大量的自帶函式來滿足使用者的報表製作需求，但是在一些特殊場景，可能需要一些特殊的函式，在這種情況下，FineReport 提供了自訂函式機制，可以由使用者根據業務需要自己來定義一些函式。詳細內容可參考：自訂函式

2.4 報表匯出

FineReport 提供了強大的輸入匯出功能，所有的這些輸入/匯出類都在 com.fr.report.io 包裏面。使用者可以透過編譯 Java 程式呼叫工程資源後台將範本匯出成 cpt 、內建資料 cpt 、PDF 、Excel 、Word 、SVG 、CSV 、image (包含 png 、 jpg 、gif 、bmp )等多種檔案格式。詳細內容可參考：匯出API