填報暫存

1.1 版本

1.2 應用場景

填報暫存可以將填寫內容儲存起來，當離開或者重新整理了頁面，再次進入時，會顯示之前填寫的資料。

如下圖所示，頁面重新整理後，之前填寫的資料仍然保留。

注：使用 11.0.1 版本設定暫存的範本，不支援版本回退後暫存。

11.0.1 及之後的版本，當頁面中存在暫存資料時，頁面重新載入時會提醒使用者有暫存資料。如下圖所示：

提醒內容為：當前頁面已讀取暫存資料

注：填報暫存不支援在行動端使用 。

1.3 功能邏輯

• 包括手動暫存和自動暫存 2 種方式 。

• 暫存資料儲存在平台資料庫finedb中。在使用清空功能或者提交成功後，暫存資料會被刪除 。

• 會根據登入使用者來儲存暫存資料 。
  

• 不支援暫存以下內容：圖片、檔案元件上傳的檔案、圖表、自適應效果 。

• 不支援根據不同的查詢參數來暫存頁面資料，不支援行動端 。

2.1 手動暫存

手動暫存是指在填報工具欄中新增暫存按鈕，點選該按鈕後，已填寫的頁面資料會被儲存。

新增按鈕的方法：設計器菜單欄點選範本→範本Web屬性，開啟的編輯介面選擇填報頁面設定→為該範本單獨設定，選中暫存按鈕，新增到頂部工具欄即可，如下圖1所示。

填報預覽時，手動暫存操作如下圖2所示。

2.2 自動暫存

自動暫存是指使用者只要頁面上填寫了資料，系統會立即將資料儲存。

設定方法：設計器菜單欄點選範本→範本Web屬性，開啟的編輯介面選擇填報頁面設定→為該範本單獨設定，勾選自動暫存即可，如下圖1所示。

填報預覽時，自動暫存效果如下圖2所示。

填報暫存的資料儲存在平台FineDB 資料庫中的PUBLIC.FINE_WRITE_STASH表中，FineDB資料庫內容詳見：B14-03 報表內建FineDB資料庫。

3.1 建立資料連結

設計器菜單欄中點選伺服器→定義資料連結，在定義資料連結頁面中點選「」建立 JDBC 資料連結，如下圖所示。

雙擊建立的連結，重新命名為「fineDB」。

點選測試連結，顯示測試成功即可進行連結。

注1：表格中 URL 在 Windows／Linux／Mac 下通用。

注2：步驟3中的驅動器下拉框中沒有所需的驅動器「com.fr.third.org.hsqldb.jdbcDriver」，需手動輸入該驅動器名稱。

輸入連結配置，配置內容如下表所示:

3.2 查看暫存資料

建立資料查詢資料集，資料庫選擇 「FineDB」。

輸入SQL 語句：SELECT * FROM PUBLIC.FINE_WRITE_STASH。

點選「」進行預覽，PUBLIC.FINE_WRITE_STASH表下的所有資料即為暫存的資料，如下圖所示:

該表的欄位說明如下表所示:

注：表格中 URL 在 Windows／Linux／Mac 下通用。

填報工具欄中新增清空按鈕，點選該按鈕後，可以手動清空已暫存的資料。新增按鈕的方法：設計器菜單欄點選範本→範本Web屬性，開啟的編輯介面選擇填報頁面設定，在下拉框中點選為該範本單獨設定，選中清空按鈕，點選「」新增到頂部工具欄即可。

操作完成後清空圖示「」會在如圖2位置顯示。填報預覽時，手動清空操作如下圖所示：

注：11.0.1及之後版本，清空資料後會自動重新整理頁面，即頁面上不會再顯示暫存的資料。

5.1 暫存權限問題

問題描述：當平台未開啟範本認證時，使用者可以在未登入的情況下，直接透過 URL 存取填報範本。此時暫存資料，資料庫表 「PUBLIC.FINE_WRITE_STASH」 的 「username」 欄位為空。不同使用者暫存的資料彼此可共享查看，效果如下圖所示：

解決方案：如果想要避免上述問題，決策系統需要開啟範本認證，強制使用者登入後查看及操作範本，範本認證開啟方法參見文檔：範本認證-認證設定。

5.2 暫存無效問題

問題描述：當填報範本中第一欄為空白欄且設定為不擴展時，填報暫存會失效，如下圖所示：

解決方案：方法一為刪除空白欄；方法二為給空白欄設定儲存格擴展，如下圖所示：

5.3 自訂按鈕提交事件提交後不會自動清空暫存

問題描述：自訂按鈕中設定的提交事件，在提交後不會自動清空暫存，所以可能會出現頁面展示異常的現象，例如出現空白列，錯位等。

解決方案：在自訂提交事件的設定回呼函式裏，利用JS清空暫存，如下圖所示：

JavaScript 程式碼如下：

if (fr_submitinfo.success) {
	_g().clear(undefined, false);
	FR.Msg.toast('提交成功');
} else {
	FR.Msg.toast('提交失敗，錯誤資訊為：' + fr_submitinfo.failinfo);
}