使用自訂Universal Editor擴充功能在AEM Sites Cloud中自動鎖定頁面

本文說明如何建立自訂Universal Editor擴充功能及已驗證的Adobe Experience Manager (AEM) Sites as a Cloud Service服務,確保頁面在作者首次變更內容後鎖定,藉此在AEM () Sites中自動鎖定頁面。

說明 description

環境

Adobe Experience Manager as a Cloud Service (所有版本)

問題/症狀

  • 組織可在首次有意變更內容後自動鎖定AEM Sites頁面,而非依賴手動鎖定或鎖定頁面開啟,以防止同時編輯衝突。
  • 頁面在第一次編輯後不會自動鎖定,需要手動動作並增加編輯衝突的風險。

原因

通用編輯器中的標準AEM頁面鎖定擴充功能不提供用於自動化或擴充功能的公用API。 支援的自動化需要自訂Universal Editor擴充功能,以及客戶擁有的AEM服務(使用檔案化API在內容變更後鎖定頁面)。

解決方法 resolution

請依照下列步驟解決問題。

  1. 建立自訂通用編輯器擴充功能。

    • 使用通用編輯器的擴充功能點,接聽第一個有意或持續的內容變更事件。 不要在開啟或選取頁面時觸發鎖定。
    • 範例(虛擬碼):
    code language-none
    editor.on('contentChanged', (event) => {
        if (!pageLocked) {
            lockPage(event.pagePath);
            pageLocked = true;
        }
    });
    
  2. 實作客戶擁有的AEM服務。

    • 在AEM中建立伺服器端OSGi服務或Sling servlet,公開端點:
    • 正在檢查目前的鎖定狀態
    • 取得頁面鎖定
    • 釋放頁面鎖定
    • 使用AEM WCM PageManager API進行鎖定和解鎖作業。 範例(Java):
    code language-none
    PageManager pageManager = resourceResolver.adaptTo(PageManager.class);
    Page page = pageManager.getPage(pagePath);
    
    if (page != null && !page.isLocked()) {
        page.lock();
    }
    
  3. 使用編輯者的身分驗證請求。

    • Universal Editor擴充功能應將目前編輯器的IMS持有人權杖轉送至AEM端點,作為授權標頭。
    • 確認已啟用AEM的Granite Bearer驗證處理常式,並將其設定為接受權杖中存在的OAuth使用者端ID。
    • AEM服務必須使用請求的ResourceResolver (例如request.getResourceResolver()),以確保將鎖定歸因於編輯器,而非服務使用者。
  4. 處理鎖定衝突與許可權。

    • 驗證頁面路徑並解析頁面。
    • 檢查頁面是否已鎖定,以及由誰鎖定。
    • 如果無法取得鎖定(例如,已由其他作者鎖定),則傳回清除回應。
    • 強制執行AEM許可權和CSRF保護。
  5. 更新編輯器狀態。

    • 成功鎖定作業後,請更新通用編輯器UI以反映新的鎖定狀態。
    • 如果頁面已由其他作者鎖定,則顯示清除訊息。
  6. 發佈前先解除鎖定頁面。

    • 作者應在發佈前手動解鎖頁面,以允許工作流程繼續進行。

若要確認,請在通用編輯器中編輯頁面,以測試擴充功能。 確認頁面在第一次內容變更後已鎖定,且只有編輯作者才能將其解鎖。

相關閱讀

通用編輯器總覽

recommendation-more-help
experience-cloud-kcs-help-kbarticles