新範本版本管理

1.1 版本

1.2 功能簡介

11.0.19 及之後版本，新增「新範本版本管理」模式，對版本管理的功能及交互進行了全面優化。本文將對「新範本版本管理」的使用進行介紹。

• 單範本版本管理：支援查看範本的所有歷史版本資訊，並進行版本管理操作，包括：新增註釋、還原、刪除/批量刪除、預覽版本。
  

• 版本中心：展示所有範本版本資訊，支援使用者查看特定範本的所有版本，以及刪除多個範本的所有歷史版本，便於管理者全面掌握範本變化並清理舊版本資料。

• 回收站：刪除的範本檔案會進入回收站內，管理者可查看已刪除的範本資訊，並支援還原已刪除範本的歷史版本或徹底刪除範本操作。

效果如下圖所示：

11.0.19 及之後版本的新工程，預設使用新範本版本管理。

從11.0.19 之前版本升級至11.0.19 及之後版本的工程：

• 若工程%FR_HOME%\webapps\webroot\WEB-INF\assets路徑下不存在vcs資料夾或歷史版本資訊，則使用新範本版本管理。

• 若工程%FR_HOME%\webapps\webroot\WEB-INF\assets資料夾下存在vcs資料夾或歷史版本資訊，則使用舊範本版本管理，同時支援更新、遷移歷史版本資料至新範本版本管理。

2.1 新舊範本版本管理功能對比

新範本版本管理與舊範本版本管理的功能對比如下表所示：

2.2 如何更新至新範本版本管理

1）點選菜單欄中「檔案>選項>版本管理」，若使用者使用了舊範本版本管理，則會出現版本管理存在更新提示，如下圖所示：

2）點選「更新」按鈕，在彈窗頁面內選擇歷史版本資料遷移方式，點選「確定」，會出現彈窗提示是否立即進行資料遷移，點選「是」，則立即遷移歷史資料至新範本版本管理，如下圖所示：

注1：為節省磁碟空間和資料遷移時間，建議選擇「保留部分版本」。

注2：遷移會佔用伺服器資源，且遷移程式中不支援取消遷移，建議在使用者使用較少的時間段內進行遷移。

注3：遷移程式為後端運作，管理者可在遷移程式中關閉版本管理介面進行其他工作，同時遷移繼續，不受影響。

設定項說明如下：

3）資料遷移完成後，會出現提示資料遷移成功，版本管理已開啟新版本，點選「進入新版本」即可，如下圖所示：

2.3 注意事項

問題描述：

在資料遷移程式中，因資料遷移失敗，導致版本管理更新失敗，報錯：資料遷移失敗原因：磁碟問題

如下圖所示：

排查方案：

1）檢查報表工程的啟動使用者是否擁有以下資料夾的讀寫權限：

• %FR_HOME%\webapps\webroot\WEB-INF

• %FR_HOME%\webapps\webroot\WEB-INF\assets

• %FR_HOME%\webapps\webroot\WEB-INF\reportlets_versions

若未開放讀寫權限，Linux 系統使用者請參考 Linux檔案權限配置 配置資料夾權限。

Windows 系統使用者請參考以下步驟配置配置資料夾權限。

• 找到對應資料夾，按滑鼠右鍵，選擇「內容>安全性>進階」，點選「新增」，如下圖所示：

• 選擇主體後，修改資料夾的基本權限，點選「確定」即可，如下圖所示：

2）檢查磁碟空間並清理不必要的檔案，如工程中是否有過大的日誌檔案，備份檔案等。

磁碟清理請參考：磁碟清理

磁碟擴容請參考：磁碟擴容

點選菜單欄「檔案>選項>版本管理」，進入「版本管理」介面，初始設定如下圖所示：

3.1 版本中心

注1：「版本中心」功能僅超級管理者可見、可用。

注2：「版本中心」介面僅展示有歷史版本的範本資訊。

管理者可在版本中心內查看範本版本資訊，包括：範本路徑、最近一次修改日期、版本佔用記憶體。

同時，支援「搜尋」、「查看範本版本」、「開啟範本」、「刪除/批量刪除歷史版本」操作，如下圖所示：

3.1.1 查看版本

點選某範本後的「查看版本」按鈕，即可查看該範本的所有歷史版本資訊，進行版本管理操作，詳情請參考本文第四節。

3.1.2 開啟範本

點選某範本後的「開啟範本」按鈕，即可開啟該範本，如下圖所示：

3.1.3 刪除歷史版本

點選「刪除」按鈕，會出現彈窗提示：確定刪除XXX的歷史版本，點選「確定」即可刪除當前範本的所有歷史版本，如下圖所示：

同時，支援批量刪除操作，勾選需要刪除歷史版本的範本，點選「刪除」按鈕，會出現彈窗提示：

確定刪除所選範本的歷史版本，點選「確定」即可刪除。如下圖所示：

3.2 儲存自動生成版本

預設勾選：儲存自動生成版本

1）勾選「儲存自動生成版本」時，在設計器中對範本進行「儲存」操作時，會自動對範本生成一個新版本 。

同時可以進行版本管理操作，如新增註釋、還原、刪除、預覽版本等，如下圖所示：

注：每個範本，基於儲存操作，生成的版本，最多為5個（不包含老範本管理遷移保留的版本、填寫了備註的版本）

      當超過5個時，自動刪除最老版本。

2）不勾選「儲存自動生成版本」時，則關閉版本管理功能，版本管理選項灰化不可操作，如下圖所示：

3.3 每［ ］分鐘自動生成一個版本

預設勾選每［ ］分鐘自動生成一個版本，時間週期為15分鐘

勾選了「每［ ］分鐘自動生成一個版本」選項後，當開啟並編輯某張範本時，會在設定的時間週期內自動為該範本生成一個新版本，且在下一時間週期內，會刪除前一個自動生成的版本，只保留一個最新自動生成的版本。

例如，V10 為上一時間週期內自動生成的新版本，則下一時間週期內，刪除了 V20 版本，只保留了最新的自動生成版本 V11，如下圖所示：

3.4 每［ ］分鐘每個使用者同個範本最多保留一個版本

預設勾選每［ ］分鐘每個使用者同個範本最多保留一個版本，設定時間週期為 15 分鐘

1）勾選「每［ ］分鐘每個使用者同個範本最多保留一個版本」時，在規定週期內自動刪除前一個版本，只保留當前版本，如下圖所示：

2）不勾選「每［ ］分鐘每個使用者同個範本最多保留一個版本」，則每個版本都會保留，如下圖所示：

3.5 每隔［ ］自動清理一次，保留最近［ ］的資料

預設勾選該選項，且預設設定為每隔 3 個月自動清理一次，保留最近 3 個月的資料。

若勾選「每隔［ ］自動清理一次，保留最近［ ］的資料」時，在規定週期內自動清理修改日期在保留日期以外的所有範本版本資料。

選中某個範本，點選「版本管理」按鈕，即可進入版本管理介面，查看範本的所有歷史版本資訊，如最近修改日期、使用者、註釋。

同時，可進行版本管理操作，包括：新增註釋、還原、刪除/批量刪除、預覽版本。如下圖所示：

4.1 版本編輯

雙擊某版本後的「註釋」欄，即可給該版本新增備註資訊，點選「確定」，註釋新增完成，如下圖所示：

4.2 版本還原

如需將當前範本還原至某個歷史版本，點選該版本後的「還原」按鈕，會出現彈窗提示：確定還原此版本，點選「確定」即可，如下圖所示：

注：還原版本的時候，會將目前沒儲存的範本自動生成一個版本，所以無需擔心未儲存範本意外丟失的問題。

4.3 版本刪除

如需刪除某個歷史版本，點選該版本後的「刪除」按鈕，會出現彈窗提示：確定刪除該版本，點選「確定」即可刪除該歷史版本。如下圖所示：

同時，支援批量刪除歷史版本操作，勾選需要刪除的版本，點選「刪除」按鈕，會出現彈窗提示：確定刪除所選的XXX個版本，點選「確定」即可刪除。如下圖所示：

4.4 版本預覽

如需查看某個歷史版本效果，點選該版本後的「預覽」按鈕，即可查看，如下圖所示：

注：「回收站」功能僅超級管理者可見、可用。

5.1 回收站內容

刪除的範本會進入回收站內，超級管理者可進入「回收站內容」介面，可查看已刪除的範本檔案資訊，包括：範本路徑、大小、刪除日期、修改日期。

同時，可對回收站內的範本進行還原、徹底刪除操作。

5.1.1 還原範本

勾選需要還原的範本，點選「還原」按鈕，會出現彈窗提示：確定還原所選的XXX個檔案，點選「確定」，如下圖所示：

彈窗提示「所選版本還原成功」後，所選範本以及範本的歷史版本已被成功還原至原路徑下。

注1：刪除範本時，會自動為範本生成一個版本，所以還原範本後，可以在版本管理中看到新增了一個版本。

注2：還原成功後，需點選報表管理面板內的「重新整理」按鈕，才可在原路徑下看到被還原的範本。如下圖所示：

5.1.2 永久刪除範本

勾選需要刪除的範本，點選「刪除」按鈕，會出現彈窗提示：確定刪除所選的XXX個檔案，點選「確定」，即可永久刪除範本檔案，如下圖所示：

5.2 通用設定

點選「回收站>通用設定」，可設定回收站內範本檔案的儲存時間，預設30天。如下圖所示：

當系統日期 - 某範本刪除日期 > 設定的儲存天數時，該範本會被徹底刪除。