文件Experience Cloud KCS

AEM Forms回溯相容性和SDK更新對Adaptive Forms Proxy元件的影響

最後更新： 2026年8月27日

在Adobe Experience Manager (AEM) Forms中，組織經常會使用專案擁有的Proxy元件來自訂Adaptive Forms。 關於SDK更新如何影響這些自訂，以及Adobe的回溯相容性原則如何套用至最適化Forms元件版本，可能會出現一些問題。 若要修正此問題，請遵循支援的自訂實務並驗證所有Proxy元件，然後再將更新提升至生產環境。

說明 description

環境

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

問題/症狀

  • 擔心小幅度的SDK更新會影響自訂Proxy元件或使用者端程式庫。
  • SDK更新後發現自訂程式碼受到影響的問題。
  • 需要澄清最適化Adobe元件版本的Forms相容性保證。

原因

如果自訂依賴內部或無檔案的實作詳細資料，對最適化Forms元件版本進行微幅或回溯相容變更，可能會影響自訂Proxy元件。 Adobe的相容性保證僅適用於已記錄的擴充功能點和支援的現成行為，不適用於內部結構或覆蓋的資源。

解決方法 resolution

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

  1. 設定專案擁有的Proxy元件：使用專案擁有的Proxy元件，sling:resourceSuperType會參照必要的Adobe Adaptive Forms元件版本。
  2. 限制自訂元件變更：將自訂HTL和對話方塊變更最小化。 僅使用已記錄的API、事件、選取器和擴充功能點。
  3. 建立專案擁有的使用者端資料庫：建立具有唯一類別名稱的個別專案擁有的使用者端資料庫。
  4. 保護Adobe擁有的使用者端資料庫：避免覆蓋或修改Adobe擁有的共用執行階段基底或相依的使用者端資料庫。
  5. 驗證自訂：在將更新提升至生產環境之前，請先驗證較低層環境中的所有自訂。 在每個SDK或Forms元件更新後，回歸測試轉譯、製作、驗證、規則、預填、提交、協助工具、使用者端程式庫載入和自訂JavaScript行為的所有代理主機元件和自訂。
  6. 驗證和提升SDK更新：如果專案管理最適化Forms核心元件版本為相依性，請先更新並將其部署至較低環境。 確認所有自訂Proxy元件和使用者端程式庫都如預期般運作，然後透過您的標準部署程式將更新升級至更高的環境。

附註

  • 回溯相容性適用於支援的現成行為、記錄的API，以及記錄的Adaptive Forms元件擴充點。
  • 錯誤修正和向後相容的增強功能可在現有元件版本中提供，前提是維護支援的合約。
  • 只有對受支援的行為或記錄的擴充點進行回溯不相容的變更時，才會採用新的元件版本。
  • 實作詳細資訊，例如HTL轉譯、HTML和DOM結構、CSS類別、JavaScript行為、使用者端API、驗證、規則執行、對話方塊和設定結構，以及使用者端程式庫，在相同元件版本中可能會變更，前提是維護支援的合約。
  • 相依於內部實作詳細資訊的自訂（例如複製的HTL、私人DOM結構、未記錄的選取器或覆蓋的Adobe使用者端資料庫）未必不會受到次要更新的影響。
  • Adobe管理的環境不提供單獨的僅開發自動升級交換器。

相關閱讀

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