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

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

  1. 透過Experience Cloud Shell路由存取自訂servlet (例如: /ui#/aem/your/servlet/path)。
  2. 觀察頁面是否停滯在載入旋轉圖覆蓋上,即使HTML內容存在於iframe中亦然。
  3. 從瀏覽器的網路標籤複製完整的servlet URL (包括任何附加的引數)。
  4. 直接在新瀏覽器索引標籤中開啟此URL (在Unified Shell內容外)。
  5. 確認頁面沒有旋轉圖示即可成功轉譯。
  6. 略過Unified Shell,更新任何連結、書籤或導覽路徑以直接指向servlet資源路徑(例如: /content/your/site/servlet.html)。
  7. 如果AEM環境的其他部分需要Unified Shell,請將此因應措施限製為僅供自訂servlet工作流程使用。 確保使用者透過純連結或單獨的瀏覽器標籤存取servlet,而非透過AEM的頁面/內容樹導覽存取,後者會產生殼層包裹路由。
  8. (選擇性)檢閱Servlet輸出中可能依賴window.top、window.parent或類似建構的任何使用者端程式碼,因為這些在Unified Shell iframe中的行為可能會不同。

套用此因應措施後,使用者應該能夠存取自訂servlet頁面,而不會遇到停滯的載入進度環問題。

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