2024.04.0版的升級指示
本文介紹2024.04.0版Adobe Experience Manager Guidesas a Cloud Service的升級指示和相容性矩陣。
如需新功能和增強功能的詳細資訊，請檢視 2024.04.0版的新增功能.
如需此版本中修正的問題清單，請檢視 已修正2024.04.0版本中的問題.
相容性矩陣
本節列出2024.04.0版Experience Manager指南as a Cloud Service支援之軟體應用程式的相容性矩陣。
FrameMaker和FrameMaker Publishing Server
氧氣聯結器
知識庫範本版本
升級至2024.04.0版
升級Experience Manageras a Cloud Service的最新（最新）版本時，Experience Manager指南會自動升級。
- ui_config.json （可能已在資料夾設定檔中設定）
如果您尚未針對現有版本更早地執行Experience Manager指南，請針對as a Cloud Service執行以下步驟：
透過servlet啟用指令碼觸發的步驟
(僅限您在2023年6月as a Cloud Service發行Experience Manager指南之前發行時)
完成安裝後，您可以選擇點選觸發程式以開始翻譯工作：
POST：
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
回應：
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
在上一個回應JSON中，索引鍵 lockNodePath 儲存指向存放庫中建立的、指向已提交作業的節點的路徑。 它會在作業完成後自動刪除，然後您可以參照此節點來瞭解作業的狀態。
請等到此工作完成後，再繼續後續步驟。
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
後續處理現有內容以使用中斷連結報告的步驟
(僅限您在2023年6月as a Cloud Service發行Experience Manager指南之前發行時)
執行以下步驟後續處理現有內容並使用新的中斷連結報表：
-
（選擇性）如果系統中有超過100,000個DITA檔案，請更新
queryLimitReads和queryLimitInMemory在org.apache.jackrabbit.oak.query.QueryEngineSettingsService變更為較大的值（任何大於現有資產數的值，例如200,000），然後重新部署。-
請依照以下說明操作： 設定覆寫 安裝與設定Adobe Experience Manager Guidesas a Cloud Service一節中的以建立設定檔。
-
在設定檔案中，提供下列（屬性）詳細資料以設定
queryLimitReads和queryLimitInMemory選項：table 0-row-3 1-row-3 2-row-3 PID 屬性索引鍵 屬性值 org.apache.jackrabbit.oak.query.QueryEngineSettingsService querylimitereads 值：200000預設值： 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory 值：200000預設值： 100000
-
-
對伺服器執行POST要求（使用正確的驗證） -
http://<server>//bin/guides/reports/upgrade. -
此API會傳回jobId。 若要檢查作業的狀態，您可以傳送作業識別碼的GET要求至相同的端點 —
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(例如：http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
工作完成後，先前的GET請求會成功回應。 如果作業由於某個原因而失敗，則可以從伺服器記錄中看到失敗。
-
恢復為預設值或先前的現有值
queryLimitReads如果您已在步驟1中加以變更。
為現有內容建立索引，以使用「報表」標籤下新的尋找和取代與主題清單的步驟：
(僅限您在2023年6月as a Cloud Service發行Experience Manager指南之前發行時)
執行以下步驟來索引現有內容，並在報表標籤底下的對應層級和主題清單中使用新的尋找和取代文字：
-
對伺服器執行POST要求（使用正確的驗證） -
http://<server:port>/bin/guides/map-find/indexing. (選用：您可以傳遞地圖的特定路徑來編制索引，預設情況下，所有地圖都會編制索引|| 例如：https://<Server:port>/bin/guides/map-find/indexing?paths=<path of the MAP in repository>) -
您也可以傳遞根資料夾，為特定資料夾（及其子資料夾）的DITA map建立索引。 例如
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test。請注意，如果同時傳遞路徑引數和根引數，則只會考慮路徑引數。 -
此API會傳回jobId。 若要檢查作業的狀態，您可以傳送作業識別碼的GET要求至相同的端點 —
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}(例如：http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
工作完成後，先前的GET請求會成功回應。 如果作業由於某個原因而失敗，則可以從伺服器記錄中看到失敗。
處理問題的步驟 'fmdita rewriter' 衝突
Experience Manager指南有 自訂sling重寫程式 用於處理交叉地圖情況下產生的連結的模組（兩個不同地圖主題之間的連結）。
如果您的程式碼基底中有另一個自訂Sling重寫程式，請使用 'order' 值大於50，因為Experience Manager指南sling重寫程式使用 'order' 50. 若要覆寫此值，您需要大於50的值。 如需詳細資訊，請檢視 輸出重寫管道.
在此升級期間，由於 'order' 值從1000變更為50，您需要將現有的自訂重寫程式（如果有的話）與 fmdita-rewriter.