AEM作者自訂servlet頁面卡在Experience Cloud殼層中的載入旋轉圖上
瞭解如何解決透過AEM Shell iframe存取時,Experience Cloud Author中的自訂servlet頁面停滯在載入進度環上的問題。
說明 description
從AEM Author存取自訂servlet或HTML頁面時,該頁面會在Experience Cloud Shell iframe中載入。 在此案例中,頁面似乎卡在載入微調覆蓋上,即使HTML內容存在於iframe中亦然。 啟用Unified Shell時,此問題可跨多位使用者重現,並且servlet程式碼最近沒有變更。 其他URL引數(例如_mr和shell_domain)會自動附加。 直接在新瀏覽器索引標籤中開啟相同的servlet URL (在Unified Shell內容外)時,頁面會正確轉譯而不會出現旋轉圖示。 停用Unified Shell或透過直接資源路徑存取servlet也可讓頁面如預期般呈現。
環境
- Adobe Experience Manager (AEM)作者
- AEM as a Cloud Service (AEMaaCS)和內部部署
症狀
- 透過Experience Cloud殼層iframe存取時,自訂servlet頁面會隱藏在載入旋轉圖覆蓋圖中。
- HTML內容存在於iframe中,但不可見。
- 直接存取servlet URL (在Shell外部)如預期般運作。
原因
Experience Cloud Unified Shell預期來自載入頁面的內容就緒訊號會關閉旋轉圖覆蓋。 未載入標準AEM編輯器架構JavaScript的自訂servlet回應不會傳送此訊號,導致微調器無限期保留。 直接存取servlet (在Shell外部)可避免此問題。
解決方法 resolution
請依照下列步驟解決問題:
- 透過Experience Cloud Shell路由存取自訂servlet (例如:
/ui#/aem/your/servlet/path)。 - 觀察頁面是否停滯在載入旋轉圖覆蓋上,即使HTML內容存在於iframe中亦然。
- 從瀏覽器的網路標籤複製完整的servlet URL (包括任何附加的引數)。
- 直接在新瀏覽器索引標籤中開啟此URL (在Unified Shell內容外)。
- 確認頁面沒有旋轉圖示即可成功轉譯。
- 略過Unified Shell,更新任何連結、書籤或導覽路徑以直接指向servlet資源路徑(例如:
/content/your/site/servlet.html)。 - 如果AEM環境的其他部分需要Unified Shell,請將此因應措施限製為僅供自訂servlet工作流程使用。 確保使用者透過純連結或單獨的瀏覽器標籤存取servlet,而非透過AEM的頁面/內容樹導覽存取,後者會產生殼層包裹路由。
- (選擇性)檢閱Servlet輸出中可能依賴
window.top、window.parent或類似建構的任何使用者端程式碼,因為這些在Unified Shell iframe中的行為可能會不同。
套用此因應措施後,使用者應該能夠存取自訂servlet頁面,而不會遇到停滯的載入進度環問題。
recommendation-more-help
experience-cloud-kcs-help-kbarticles