Cell 報表開發實戰筆記（二）：常見問題排查與 Web 集成要點

學習心法：快速掌握新技術的四大法寶

1. 論壇沉浸：官方/社區論壇是實戰經驗寶庫，遇到疑難雜癥首選搜索歷史帖。
2. 官方文檔（CHM）：Cell 自帶的 CHM 帮助文件是權威參考，類比 JDK API 文檔/MSDN，功能細節、API 簽名、屬性說明一應俱全。
3. 向有經驗者請教：「姜還是老的辣」，同事/前輩的一句點撥常能省去數天摸索。
4. 及時總結筆記：無總結無進步，將踩坑記錄、最佳實踐沉澱為個人知識庫。

高頻問題彙總

Q1: 設置 WorkbookReadonly = true 後仍能修改頁簽？

原因：WorkbookReadonly 僅鎖定工作表內容，不限制頁簽（Sheet Label）編輯。
解決：在 AllowEditSheetLabel 事件中設置 approve = 0 禁止修改頁簽。

Q2: AddImage 一個單元格只能插入一張圖片嗎？

區別：

• 內嵌圖片（AddImage）：綁定單元格，隨單元格大小調整，一個單元格僅支持一張。
• 浮動圖片：獨立於單元格層，可自由拖拽、縮放、疊加，不受單元格限制。

Q3: 如何獲取當前編輯單元格的行列號？

• GetCurrentCol() / GetCurrentRow()：獲取當前焦點單元格座標。
• EditFinish 事件中調用上述方法，返回的是剛結束編輯的單元格座標；若用戶點擊其他單元格，焦點已移動，返回值為新單元格座標。
• ChangeCell 事件參數直接提供被修改單元格的行列號，更可靠。

Web 開發集成步驟

1. 將 Cell 報表安裝目錄下 eSReport 文件夾所有文件複製到 Web 項目的 js/jsp 同級目錄。
2. 參考 erreport.html 改造 JSP 頁面，保留與 Web 交互相關的代碼（Object/Embed 標籤、參數設置、事件綁定）。
3. JSP 中調用 Cell 插件（ActiveX），提供終端用戶與報表的交互功能（查詢、導出、打印等）。

避坑指南：文件保存陷阱

場景：Web 項目需將報表文件保存到服務器。
錯誤：直接調用 FileSaveAs → 該方法默認保存到客戶端瀏覽器所在機器，開發環境（客戶端=服務器）測試通過，生產環境失效。
正確：使用 FileUpload 方法將報表數據流上傳到服務器端 Servlet/Action，再由服務器寫入磁盤/數據庫。
教訓：項目缺乏設計文檔、數據字典，接手需大量溝通驗證，文檔建設刻不容緩。