DIV CSS 佈局教程網

用 JavaScript 驅動 Excel 列印報表:以學生成績單為例的完整方案
編輯:關於JavaScript     

做 Web 開發都遇過列印的難題。表格一複雜,瀏覽器的列印功能就顯得笨拙——分頁位置亂、表頭重複、欄位對不齊。本文示範另一條路:把資料灌進 Excel 模板,再交由 Excel 完成列印。

一、環境設定:用信任網站取代全面降級

要在瀏覽器中呼叫 Excel,需要放行 ActiveX 元件。常見但糟糕的做法是直接把 IE 安全性調到最低,結果連 3721 這類不必要的程式都會自動安裝。

更好的方式是保留原本的 IE 設定,只把自己的站點加入「信任網站」,再針對信任網站區域調整安全性等級。這樣等於替自己的站點開了一條專用通道,同時仍能阻擋其他來路不明的元件入侵。前提是使用者得先匯入一份註冊表設定——若系統是自己內部使用,溝通成本很低;若面對外部客戶,就需要多花點力氣說服了。

二、資料組織:把資料提取獨立成物件

以學生成績單為例,資料量相當可觀:學年學期、學分績點、照片、學位授予、學籍處理、四六級成績、實習、輔修成績、實踐紀錄……動輒上百筆。逐筆拼 XML 既費力又難維護。

最後採用的做法是:把資料提取獨立寫成一個物件,讓任何頁面都能重複使用;資料來源直接選用 HTML table,畫面上顯示的就是要輸出的內容,不必再另外生成 XML。以下為 Gettabledata.js 的介面說明:

// Obj 參數指定資料來源(限定 Table),預設第一行為欄位名稱列
// MoveNext 方法:將游標上/下移動指定位數,正數向下、負數向上
//               例:.MoveNext(1) / .MoveNext(-1)
// GetFieldData 方法:取得目前列的指定欄位值
//               例:.GetFieldData("考試成績") / .GetFieldData(1)
// Sort_desc 方法:對指定欄位降冪排序,例:.Sort_desc("學年","學期")
// Sort_asc 方法:對指定欄位升冪排序
//               .Sort_asc("考試成績:number") 冒號後可指定資料型別
// GetData 方法:回傳欄位值為特定值的資料陣列,建議在外部處理
// Delete 方法:刪除目前記錄,陣列少一列
// UpdateField 方法:更新目前列的指定欄位
//               .UpdateField("課程號", MyData.GetFieldData("原課程號"))
// MoveFirst / MoveLast:游標移到第一/最後一筆(資料從第二列起算)
// Distinct:回傳所選記錄相異值的維度數組,同時升冪排序
// 初始化:Obj 為 table 名稱,Leftlen 為左側多餘資料長度,Rightlen 為右側
// rows 屬性:陣列列數;cols 屬性:欄數

三、開啟模板並填充資料

列印腳本(如 Print_bzcjd.js)一開始先開啟 Excel 模板:

var xlBook = xls.Workbooks.Open("c:\\xsxycjb.xls");
var xlsheet = xlBook.Worksheets(1);

模板也可以放在網路上,直接給網址:

var xlBook = xls.Workbooks.Open("https://you.com/PrintTemplates/xsxycjb.xls");
var xlsheet = xlBook.Worksheets(1);

這裡有個實用技巧:table 的資料即使隱藏起來(display:none)也照样取得出來,因此可以塞入大量資料而不影響畫面。

另外要準備 Excel.js 做善後清單——Excel 進程結束後常常沒有真正退出,需要主動清理,這點不如 .NET 的托管資源回收來得省心。

四、把 Table 直接轉成 Excel 的簡易範例

只要給定表格 id,就能生成一份 xls:

MakeExcel("TABLE1", true, "1.xls");   // 後面幾個參數可省略
function MakeExcel(Obj, ProceVisible, SaveAsFilename, SortType, SortField){
    var MyData = new GetTableData(Obj, 0, 0);
    var myrows = MyData.rows;
    var i, j;

    try {
        var xls = new ActiveXObject("Excel.Application");
    }
    catch(e) {
        alert("要列印該表,您必須安裝 Excel 電子表格軟件,"
            + "同時瀏覽器須使用「ActiveX 控件」,並允許執行控件。"
            + " 請點擊【幫助】了解瀏覽器設置方法!");
        return "";
    }

    if (typeof(ProceVisible) == "undefined") {
        xls.visible = true;
    } else {
        xls.visible = (ProceVisible == "true");
    }

    var xlBook = xls.Workbooks.Add;
    var xlsheet = xlBook.Worksheets(1);
    xls.Cells.Select;
    xls.Selection.NumberFormatLocal = "@";

    for (i = 0; i < MyData.rows; i++) {
        for (j = 0; j < MyData.cols; j++) {
            if (typeof(MyData.GetFieldData(j)) == "number") {
                xlsheet.Cells(i+1, j+1).NumberFormatLocal = "0.00_ ";
            }
            xlsheet.Cells(i+1, j+1).Value = MyData.GetFieldData(j);
        }
        MyData.MoveNext();
    }

    if (SaveAsFilename == "" || typeof(SaveAsFilename) == "undefined") {
        var fname = xls.Application.GetSaveAsFilename("*.xls",
            "Excel Spreadsheets (*.xls), *.xls");
        if (fname != "") xlBook.SaveAs(fname);
    } else {
        xlBook.SaveAs(SaveAsFilename);
    }

    xlBook.Close(savechanges = false);
    xls.Quit();
    xls = null;
    window.setInterval("Cleanup();", 1);   // 結束 Excel 進程
}

五、方案評估

這條路徑的優點很明確:報表排版交給 Excel,複雜的合併、圖片、分頁都能沿用既有模板,前端只需負責填資料。缺點同樣明顯——它綁死了 Windows、IE 與本機 Office,使用者的安全性設定一動就可能失效,部署與維護成本都不低。

如果今天要重新規劃報表列印,比較合適的方向是:單純的表格用 CSS 的 @media print 加上 page-break 控制分頁;需要更精細的排版則在伺服器端用 PDF 產生器輸出檔案;若確實需要 Excel 格式,也應該在後端用 Office 的 interop 或第三方套件生成,再讓使用者下載,而不是在瀏覽器裡開 Excel 進程。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved