使用自訂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
請依照下列步驟解決問題。
-
建立自訂通用編輯器擴充功能。
- 使用通用編輯器的擴充功能點,接聽第一個有意或持續的內容變更事件。 不要在開啟或選取頁面時觸發鎖定。
- 範例(虛擬碼):
code language-none editor.on('contentChanged', (event) => { if (!pageLocked) { lockPage(event.pagePath); pageLocked = true; } }); -
實作客戶擁有的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(); } -
使用編輯者的身分驗證請求。
- Universal Editor擴充功能應將目前編輯器的IMS持有人權杖轉送至AEM端點,作為授權標頭。
- 確認已啟用AEM的Granite Bearer驗證處理常式,並將其設定為接受權杖中存在的OAuth使用者端ID。
- AEM服務必須使用請求的ResourceResolver (例如request.getResourceResolver()),以確保將鎖定歸因於編輯器,而非服務使用者。
-
處理鎖定衝突與許可權。
- 驗證頁面路徑並解析頁面。
- 檢查頁面是否已鎖定,以及由誰鎖定。
- 如果無法取得鎖定(例如,已由其他作者鎖定),則傳回清除回應。
- 強制執行AEM許可權和CSRF保護。
-
更新編輯器狀態。
- 成功鎖定作業後,請更新通用編輯器UI以反映新的鎖定狀態。
- 如果頁面已由其他作者鎖定,則顯示清除訊息。
-
發佈前先解除鎖定頁面。
- 作者應在發佈前手動解鎖頁面,以允許工作流程繼續進行。
若要確認,請在通用編輯器中編輯頁面,以測試擴充功能。 確認頁面在第一次內容變更後已鎖定,且只有編輯作者才能將其解鎖。
experience-cloud-kcs-help-kbarticles