專刊內文

當前位置:首頁>專刊分享>內文

瀏覽次數 : 896



EEP全新Word&Excel套表方案

訊光科技/Ken

 

前言

    在現今的Web資訊系統中,除了UI介面的基本操作變化與後端邏輯的運算處理外,文件匯出的需求也是相當頻繁。

 

而常見的文件匯出方法如下:

1.      將畫面HTML組合後,透過Content-Disposition以附件的形式,和MIME 通訊協定設定ContentType直接將畫面上的HTML轉為Word格式,提供使用者下載,基本上可以達到所見即所得的結果,但設計畫面的部分就都是在網頁HTML上,適合具備網頁開發能力者。

 

2.      利用報表工具,設計資料呈現格式,處理一些複雜的運算或是分頁分群等功能,大部分會需要安裝報表環境,或是有額外的LicenseRuntime時的費用支出。使用者在線上瀏覽後,透過報表的轉檔功能產生輸出文件,偶爾會有格式跑掉的問題。適合有程式撰寫與報表開發工具能力者。

 

3.      利用WordExcel設定套表格式,並把資訊系統所整理出來的資料欄位,Mapping到文件畫面上的相對位置,套印在Office文件中。現今大多數一般使用者皆具備操作Office軟體的能力,簡單好上手。

 

其中Word Excel有功能強大、介面親合和門檻較低的優勢,讓使用者快速完成套表排版樣式設計。當格式需要異動時,可直接修改範本檔,存檔便完成更新,不須重新編譯程式。

 

套表原理

 

    一般套表的基本作法就是將系統資料顯示在Office文件中輸出或再利用。在資訊系統中存放所需的欄位資料,而文件處理的使用者通常已經有一份既定格式的Office文件,當畫面排版完成後,最後的步驟就是把資料放在相對應的位置上呈現。

    此次的套表功能適用在RWD & JQueryUI設計中,直接將畫面上的資料丟給iCoder的文件處理引擎,產生出套表範本所定義好的Word & Excel文件。

 

與先前套表的差異

 

    先前JQ模組所使用的套表功能,底層使用的是Com Class。透過Microsoft.Office.Interop來產生Office文件。本質上是利用程式碼模擬操作Office Application,在Server端執行WordExcel處理程序,所以Server端需要安裝Office環境,且權限設定等等的步驟相對複雜。且執行過程中容易有一些不穩定的錯誤,或是背景執行時若遇到Error,處理程序並無法自動釋放,資源會被咬住等等的問題。

 

   正式上線時,遇到多人同時使用文件產生的功能,每個人都會在Server端產生一個Office處理程序,如果程式有錯誤,處理程序不會自動回收,久了就造成Server效能低落甚至直接掛掉等問題。且藉由Client端呼叫Server端的處理程序,會有一些安全上的疑慮。

 

    這種設計方式在微軟的文件中(KB255757)有一段說明,表示他們不建議用這種方式進行從Server透過程式自行產生文件。

 

原文與翻譯節錄如下:

Microsoft does not currently recommend, and does not support, Automation of Microsoft Office applications from any unattended, non-interactive client application or component (including ASP, ASP.NET, DCOM, and NT Services), because Office may exhibit unstable behavior and/or deadlock when Office is run in this environment.

 

    Microsoft 目前建議不要從任何無人參與、非交互式客戶端應用程式或組件(包括 ASPDCOM NT Service)中進行 Microsoft Office 應用程式的自動化,也不為此提供支援,因為Office 在這種環境中執行時可能會出現不穩定的現象也可能會有Deadlock的現象。

 

參考網址:
https://support.microsoft.com/en-us/help/257757/considerations-for-server-side-automation-of-office

 

    現在EEP所推出的套表方案,使用第三方的類別庫(NPOI)。對於Microsoft Office格式檔案擁有讀寫功能,可以在Server端產生Office文件。

 

    優點除了只需要獨立引用,無須安裝Office環境之外,因為NPOI提供了許多封裝好的各類方法,開發時的程式碼相對簡潔而且靈活。檔案格式支援Office 20032007.doc/.docx.xls/.xlsx檔案類型等,對於處理文件時的效能表現大幅提升。

 

    另外針對套表範本文件中欄位的標籤設定,簡化成跟iCoder相同概念的標記方式,套表設計人員不需要完全了解資料表結構,只要套表範本的欄位名稱與RWD表單上的顯示名稱相同時,便可自動找到Mapping定義。

 

 

Word套表實例

    舉例有一張員工資料表格式如下,我們可以將各欄位所在的顯示名稱右方或下方,填上”#”符號,系統會自動對應。除了一般欄位,還有日期格式、數值格式和圖片顯示等功能。

 

日期欄位: “#D 日期格式” #D yyyy/MM/dd HH:mm:ss

數值欄位: “#N N小數位數”  #N N2

圖片欄位: “#P”系統會直接抓取DataGrid中該欄位Image路徑下的圖檔

 

 

RWDForm的設計畫面中,找到DataGrid元件,從ToolItems的屬性中增加一個按鈕,呼叫myExport方法(也可自訂其他名稱)

 

接著在網頁的原始檔中,貼上這段JavaScript程式碼。

 

<script>

        function myExport() {

           $('#dgMaster').datagrid('exportWord', '員工資料表範本');

        }

</script>

 

其中dgMaster是畫面上的DataGridID

第一個參數:exportWord  是固定的共用方法,代表套表的格式為Word

如果希望匯出PDF格式的檔案,可以改用exportWordPdf

第二個參數:員工資料表範本  是範本Word文件的檔案名稱(不需要副檔名)

 

範本放置路徑固定為JQWebClient網站下的DocFiles資料夾(如果不存在,可自行手動新增)

 

Runtime畫面中的DataGrid中點選按鈕,執行套表功能。

 

 

產生的套表結果如下:

 

如果Word套印中有明細表的需求,則是使用”##”符號。

系統會直接把RWD網頁上的明細資料自動帶入。

 

例如以下的範本設計:

 

再次點選套表按鈕後,輸出結果如下圖:

 

 

Excel套表實例

 

■統計式套表範例

 

Excel套表範本中,設定的方法與上述的Word套表大致相同。

只要把呼叫的方法名稱改為exportExcel,或是PDF格式就使用exportExcelPdf

 

<script>

        function myExport() {

           $('#dgMaster').datagrid('exportExcel', '出貨統計表範本');

        }

</script>

 

 

功能差異的地方則是多了群組功能和統計功能。

 

如果在資料中需要設定群組,可以在該欄位填入”#G”,同時支援多欄位分群,會依照順序由左至右依序分群。

 

在畫面中我們設定合計欄位的格式為  ”#NT N0 總計 小計

 

首先”#N”代表數值格式,

若我們設定”#NT”代表此欄位需要加總統計,

接著“N0”代表小數點位數到整數,

最後的總計小計是因應上述的分群,可自定義的顯示名稱字串。

 

最後呈現結果如下圖:

 

■清單式套表範例

 

Excel中,有時一筆資料會有同欄多列呈現的情形,這時欄位名稱也可直接作定義。

範本設定如下圖所示:

 

可以看到上述的客戶資料,在欄位的排列上就可以有多種變化,可以滿足多樣化的套表需求。

 

總計的欄位除了先前提到的”NT”之外,也可使用Excel原生的函式SUM()的運算方法。

 

套表輸出的結果如下圖:

 

 

總結

    透過EEP的全新Word & Excel套表方案,新增按鈕呼叫共用方法,不須複雜的程式碼撰寫,即可快速完成。在Office的範本文件中只需要簡單的”#”符號即可完成Mapping定義,整體概念與設計方法和iCoder的精神一致,學習門檻極低。

 

    除了報表範本的設計變得容易之外,此次結合了iCoder的文件處理引擎,在產生文件的效能方面有顯著的提升,並提高Server端印表的穩定性。

 

    此次的Word & Excel套表方案,將於下一版的EEP RWD/JQuery模組中, 免費提供。讓一般使用者就能簡單設計套表範本,既能節省程式開發人員的時間成本,使得套印文件的過程更加輕鬆寫意。