Word報告入門範例

學習此文檔前需要您先前往 Word 報表插件簡介 瞭解並安裝 Word 報表插件，並完成基礎的權限分配操作，本文主要講解 Word 報表基本的製作方法。

1.1 製作流程

Word 報表整體製作流程如下圖所示：

1.2 使用前提

1）僅支援 HTTPS 工程使用

2）需要購買正版 office 軟體，使用購買後的帳號登入 MicroSoft 。

3）請參考：插件安裝方法 安裝插件後再進行使用。

4）遠端伺服器環境下，不支援設計器與 word 中同時開啟範本進行修改、預覽、儲存。

注：本地設計器與遠端伺服器需要確定是相同版本的插件。

擁有遠端設計權限的使用者可將設計器切換到遠端工作區間，在設計器工具欄中選擇「建立 Word 報表>建立 microsoft word 報表」，設計器將建立一個 CPT 檔案，如下圖所示：

設計器會自動喚醒 microsoft word 軟體，使用者在 word 軟體中選擇建立空白檔案，進入頁面後，在菜單欄中選擇「FineReport」，再點選「伺服器配置」設定項，在右側的「伺服器配置」對話框中輸入遠端伺服器地址，選擇「登入」輸入對應的帳號和密碼即可。

方法一：

點選「FineReport」載入項下的「儲存」，在報表工程下建立一個普通報表。選擇報表路徑並給範本命名後，點選「確定」，彈出「儲存成功」對話框，表示範本建立成功。這時回到設計器，點選報表管理面板的重新整理按鈕，就可以看到建立的普通報表了。雙擊進入範本，可以看到 A1~K60 已經合併為一片區域。這個區域是 Word 佔用的，預覽範本時，可以在這個區域展示 Word 的實時內容。

方法二：

在設計器端，將建立的 CPT 檔案進行儲存，並命名為：example，如下圖所示：

回到設計器，點選報表管理面板的重新整理按鈕，就可以看到建立的普通報表了。雙擊進入範本，可以看到 A1~K60 已經合併為一片區域。這個區域是 Word 佔用的，預覽範本時，可以在這個區域展示 Word 的實時內容。

傳回到 Word 中開啟建立好的檔案即可，如下圖所示：

Word 報表插件支援引用當前範本資源以及掛載到伺服器中的資源。

首先需要在設計器端製作範本所需要的資料欄、參數、表格、圖表、組件等。準備完成後，需要先儲存這張報表，然後在 Word 端重新整理即可在資源庫中顯示對應的資源。

普通報表中準備好資源後，點選「儲存」報表，這樣在 Word 中點選資源列表的「重新整理」按鈕，就可以讓這些資源顯示在資源列表處，如下圖所示：

注：只要在報表中改動了一些資源，想要在 Word 中重新整理生效，就一定要先儲存這張報表。

5.1 插入公式

Word 報告支援插入公式，公式的寫法與 FineReport 相同，將游標放在要插入公式的地方，點選左上角「公式」按鈕即可出現彈窗，在彈窗內輸入公式即可。如下圖所示：

5.2 插入儲存格

可以用公式按鈕，也可以直接手寫，在{{=}} 的等於號後面寫儲存格即可，如下圖所示：

引用儲存格的用法說明如下表所示：

5.3 插入資料欄

Word 報表支援引用當前範本和平台掛載範本中的資料欄，同時支援範本資料集和伺服器資料集。

選擇工具欄中的「資料欄」按鈕，可以在頁面左側的「資源中心」查看當前範本資料列以及平台掛載範本的資料欄，游標放置在需要引用資料欄的位置，再選擇需要引用的資料欄，雙擊即可引用對應的資料欄，如下圖所示：

5.4 插入表格

報表區域其實就是表格，Word 報表支援引當前範本和掛載到平台中報表區域，同時也支援使用在 Word 端插入表格，在表格中引用當前範本的資料欄來製作表格。

5.4.1 引用報表區域

把游標放在要插入的地方，在頁面左側的「資源中心」查看平台掛載範本的表格，選擇需要插入的表格，雙擊對應的 sheet 名稱，在彈出的「選擇表格區域」對話框內輸入插入的表格位置，選擇「尺寸」和「預覽/匯出時展示形式」，點選確定即可，如下圖所示：

1）「尺寸」若設定為自訂大小則在word內生成佔位元映像，可自行調節佔位元映像的大小與位置。預覽後的結果表格，與佔位元映像的大小與位置保持一致。若設定為表格原尺寸則表格尺寸保持不變。

2）引用的表格資源中「預覽/匯出時展示形式」設定為表格，則支援匯出後對錶格二次編輯。若設定為圖片匯出後表格顯示為圖片，不支援匯出後對錶格二次編輯。

3）引用報表中的表格時支援儲存格樣式中的邊框、間距、段間距、縮排、分散對齊、靠下對齊設定，可在報表中提前設定好表格樣式。

注1：表格所處儲存格需要填寫大寫的英文字母和整數。

注2：插入公式引用儲存格無法引用儲存格樣式。

5.4.2 引用資料欄製作表格

把游標放在要插入的地方，在「開始」中插入表格，設定表格樣式後，點選「FineReport>資料欄」在表格中引用對應的資料欄將公式中的 "=" 換為 "|" 即可。同時在表格的第一欄是設次序號，並「編輯表格屬性」勾選「在各頁頂端以標題列形式重複出現」即可，如下圖所示：

注：僅支援引導當前範本的資料欄，支援簡單的縱向擴展，無條件屬性，無父子格關係，表格中僅支援序號、重複標題列基礎設定。

預覽效果：

5.5 插入圖表

Word 報表支援引用當前範本和平台掛載範本中的圖表，把游標放在要插入的地方，點選左上角「圖表」按鈕，可以在頁面左側的「資源中心」查看伺服器內的所有圖表，選擇需要插入的圖表，雙擊對應的圖表名稱，即可插入圖表，如下圖所示：

注：不支援擴展圖表。

5.6 參數查詢

1）Word 報表支援在範本中自訂參數可以直接引用自訂參數，以此來避免進行二次複雜計算。參數可以直接用公式來定義，如下圖所示：

2）支援引用在報表中定義參數，並在參數面板中新增元件，進而實現查詢效果，如下圖所示：

注：僅支援範本參數和全局參數，不支援資料集參數。

.5.7 重複動態正文

在 Word 中新增重複動態正文元件，可以將固定內容的重複一定的次數，重複的次數支援使用公式進行計算，元件內容可以為固定文字，FineReport 公式，資料欄，自訂參數等。

注：重複動態正文儘量避免放在段落中間。

點選左上角「可重複動態正文」按鈕，在彈窗中輸入需要重複的次數，點選確定，並在正文元件內輸入需要重複的內容，如下圖所示：

• 重複次數：count(UNIQUEARRAY(ds1.select(銷售員)))，意為計算 ds1 資料集中的銷售員的人數

• 需要重複的內容：{{=Value("ds2","銷售員")}}的銷售總量為{{=1:D4!}}，意為顯示 ds2 資料集中銷售員對應的銷售總量，銷售總量引用sheet2 中的 D4 儲存格的值。

5.8 插入組件

點選左上角「組件」按鈕，可以在頁面左側的「資源中心」查看FRM 範本中的套用組件，選擇需要插入的組件，雙擊對應的名稱，即可插入組件，如下圖所示：

有資源預覽時不希望報表和資源同時展示，那麼需要隱藏掉這些資源。

1）可以直接將行列隱藏或使用條件屬性，設定行高或列寬為 0，如下圖所示：

2）隱藏底部 sheet 欄：如果其他 sheet 有放資源，預覽時底部會出現 sheet 欄，預覽時想隱藏底部的 sheet 欄，只需要給範本新增一個「載入結束」事件，如下圖所示：

JavaScript 程式碼如下：

$(".fr-tabpane-controlbuttons.ui-state-enabled").hide()
$(".fr-tabpane-tabscontent-bg").hide();

插件支援使用 Word 原生目錄功能對範本進行調整，功能如下：

1）目錄和頁碼可以跟隨報表內容進行自動更新，預覽 word 報表支援點選目錄跳轉對應正文內容。開啟新 PDF 渲染後，在瀏覽器中預覽報表時，可以使用目錄、突出顯示、轉列、列印、查詢、旋轉等功能。如下圖所示：

.
2）匯出的 Word 文檔與原生一致，攜帶目錄導航等內容，同時在報表中增加的轉列、突出顯示等內容，在使用上方的儲存功能，將報表中內容儲存到本地時會同時儲存批准內容。如下圖所示：

Word 報表範本有設定參數查詢，預覽時希望直接顯示出元件預設值的查詢結果，而不是一篇空白，等着使用者去選參數然後點查詢。

設定方法：取消勾選參數面板屬性下的「點選查詢前不顯示報表內容」。

建議使用 Chrome 預覽 Word 報表，Word 端和設計器端都可以直接預覽報表的效果，入口分別如下：

1 ）Word 端：點選「FineReport」載入項下的「儲存」，再點選「預覽」即可。

2）設計器端：需要使用填報預覽範本。

注：只要改動了 Word 想要預覽時生效，就一定要先點「儲存」再點選「預覽」，否則改動不會生效。