填報暫存

1.1 應用場景

填報暫存可以将填寫内容保存起來，當離開或者刷新了頁面，再次進入時，會顯示之前填寫的資料。

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

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

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

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

1.2 功能邏輯

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

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

• 會根據登入帳號來保存暫存資料。

• 不支援暫存圖片和檔案元件上傳的檔案，不支援行動端，不支援帶有圖表的範本。

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

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);}