設定頁面編輯的復原

上次更新: 2023-12-07

OSGi服務 Day CQ WCM還原設定 ( com.day.cq.wcm.undo.UndoConfigService)會顯示數個屬性,這些屬性控制編輯頁面的還原和重做命令的行為。

預設設定

在標準安裝中,預設設定在 sling:OsgiConfig節點:

/libs/wcm/core/config.author/com.day.cq.wcm.undo.UndoConfig

此節點包含 cq.wcm.undo.whitelistcq.wcm.undo.blacklist 屬性,對於其他屬性,會採用預設值。

注意

必須 不會變更中的任何專案 /libs 路徑。

這是因為 /libs 下次升級執行個體時會被覆寫(當您套用hotfix或feature pack時,很可能會被覆寫)。

設定還原與重做

您可以為自己的執行個體設定這些OSGi服務屬性。

注意

使用AEM時,有數種方法可管理此類服務的組態設定;請參閱 設定OSGi 以取得詳細資訊和建議作法。

以下列出Web主控台中顯示的屬性,後面接著相對應的OSGi引數名稱,以及說明和預設值(如果適用):

  • 啟用
    ( cq.wcm.undo.enabled)

    • 說明:決定頁面作者是否可以復原和重做變更。
    • 預設Selected
    • 類型Boolean
  • 路徑
    ( cq.wcm.undo.path)

    • 說明:用於儲存二進位還原資料的存放庫路徑。 當作者變更二進位資料(例如影像)時,原始版本的資料會保留在這裡。 還原對二進位資料的變更時,此二進位還原資料會還原至頁面。
    • 預設/var/undo
    • 類型String
    注意

    依預設,只有管理員可以存取 /var/undo 節點。 作者只有獲得存取二進位還原資料的許可權後,才能對二進位內容執行還原和重做操作。

  • 最低 有效性
    ( cq.wcm.undo.validity)

    • 說明:二進位還原資料的儲存時間下限(小時)。 在此時段後,二進位資料即可刪除,以節省磁碟空間。
    • 預設10
    • 類型Integer
  • 步驟
    ( cq.wcm.undo.steps)

    • 說明:儲存在還原記錄中的頁面動作數上限。
    • 預設20
    • 類型Integer
  • 持續性
    ( cq.wcm.undo.persistence)

    • 說明:持續存在復原歷程記錄的類別。 提供兩種持續性類別:

      • CQ.undo.persistence.WindowNamePersistence:使用window.name屬性來儲存歷程記錄。
      • CQ.undo.persistence.CookiePersistance:使用Cookie保留歷史記錄。
    • 預設CQ.undo.persistence.WindowNamePersistence

    • 類型String

  • 持續性模式
    ( cq.wcm.undo.persistence.mode)

    • 說明:決定何時保留復原歷史記錄。 選取此選項可在每次編輯頁面後保留復原歷史記錄。 清除此選項後,只有在發生頁面重新載入時(例如,使用者導覽至其他頁面)才會持續存在。

      保留復原歷史記錄會使用網頁瀏覽器資源。 如果您的使用者瀏覽器對頁面編輯的反應很慢,請嘗試在頁面重新載入時保留復原歷史記錄。

    • 預設Selected

    • 類型Boolean

  • 標籤模式
    ( cq.wcm.undo.markermode)

    • 說明:指定用於表示哪些段落在復原或重做發生時受影響的視覺提示。 下列值有效:

      • flash:段落的選取指示器會暫時閃爍。
      • select:段落被選取。
    • 預設flash

    • 類型String

  • 好元件
    ( cq.wcm.undo.whitelist)

    • 說明:您希望受復原和重做命令影響的元件清單。 當元件路徑可透過還原/重做正常運作時,將其新增至此清單。 附加星號(*)以指定一組元件:

      • 下列值會指定基礎文字元件:

        foundation/components/text

      • 下列值會指定所有基礎元件:

        foundation/components/*

    • 當對不在此清單中的元件發出復原或重做命令時,會出現一則訊息,指出該命令可能不可靠。

    • 預設:屬性會填入AEM提供的許多元件。

    • 類型String[]

  • 錯誤的元件
    ( cq.wcm.undo.blacklist)

    • 說明:您不想受復原命令影響的元件和/或元件操作清單。 使用復原命令新增無法正常運作的元件和元件操作:

      • 當您不想要復原歷史記錄中的任何元件操作時,新增元件路徑,例如: collab/forum/components/post
      • 例如,當您想要從復原歷程記錄中省略該特定作業時(其他作業可正確運作),請在路徑中附加冒號(:)和作業, collab/forum/components/post:insertParagraph.
    注意

    當操作在此清單上時,它仍會新增到復原歷史記錄中。 使用者無法復原早於下列時間的操作: 錯誤的元件 操作在復原歷史記錄中。

    • 典型的操作名稱如下:

      • insertParagraph:元件會新增至頁面。
      • removeParagraph:元件已刪除。
      • moveParagraph:此段落已移至其他位置。
      • updateParagraph:段落屬性已變更。
    • 預設:屬性會填入數個元件操作。

    • 類型String[]

本頁內容