ドキュメントExperience Cloud KCS

AEM Formsの後方互換性とSDKの更新によるアダプティブ Forms プロキシコンポーネントへの影響

最終更新日： 2026年8月30日

Adobe Experience Manager（AEM）Formsでは、多くの場合、プロジェクトが所有するプロキシコンポーネントを使用してアダプティブFormsをカスタマイズします。 SDKの更新がこれらのカスタマイズにどのように影響するか、Adobeの下位互換性ポリシーがアダプティブ Forms コンポーネントバージョンにどのように適用されるかについて疑問が生じる可能性があります。 この問題を修正するには、サポートされているカスタマイズの方法に従い、本番環境への更新を昇格する前にすべてのプロキシコンポーネントを検証します。

説明 description

環境

Adobe Experience Manager（AEM）as a Cloud Service（すべてのバージョン）

問題/症状

  • カスタムプロキシコンポーネントまたはクライアントライブラリに影響を与えるSDKのマイナーなアップデートに関する懸念。
  • カスタムコードが影響を受けたSDKの更新後に発生した問題。
  • アダプティブ Forms コンポーネントバージョンのAdobeの互換性の保証について明確にする必要があります。

原因

Adaptive Forms コンポーネントバージョンへのマイナーまたは下位互換性のある変更は、内部または文書化されていない実装の詳細に基づいてカスタマイズされたカスタムプロキシコンポーネントに影響を与える可能性があります。 Adobeの互換性の保証は、内部構造やオーバーレイされたリソースではなく、文書化された拡張ポイントとサポートされているすぐに使用できる動作にのみ適用されます。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. プロジェクト所有プロキシコンポーネントの設定： プロジェクト所有プロキシコンポーネントを使用し、必要なAdobe アダプティブ Forms コンポーネントバージョンをsling:resourceSuperTypeで参照します。
  2. カスタムコンポーネントの変更を制限： カスタム HTLとダイアログの変更を最小限に抑えます。 文書化されたAPI、イベント、セレクター、拡張ポイントのみを使用します。
  3. プロジェクト所有のクライアントライブラリを作成：一意のカテゴリ名を持つプロジェクト所有のクライアントライブラリを個別に作成します。
  4. Adobe所有のクライアントライブラリを保護： Adobe所有の共有ランタイムベースまたは依存クライアントライブラリのオーバーレイまたは変更を避けます。
  5. カスタマイズの検証：本番環境への更新を促進する前に、下位の環境にあるすべてのカスタマイズを検証します。 SDKまたはForms コンポーネントが更新されるたびに、レンダリング、オーサリング、検証、ルール、事前入力、送信、アクセシビリティ、クライアントライブラリの読み込み、カスタム JavaScript ビヘイビアーに関するすべてのプロキシコンポーネントとカスタマイズをリグレッションテストします。
  6. SDKの更新を検証して昇格： プロジェクトがアダプティブ Forms コアコンポーネントバージョンを依存関係として管理する場合は、まず更新して下位の環境にデプロイします。 すべてのカスタムプロキシコンポーネントとクライアントライブラリが期待どおりに機能することを確認し、標準のデプロイメントプロセスを通じてアップデートをより高い環境に昇格させます。

メモ

  • 下位互換性は、サポートされているすぐに使用できる動作、文書化されたAPI、およびアダプティブ Forms コンポーネントの文書化された拡張ポイントに適用されます。
  • バグ修正と後方互換性のある機能強化は、サポートされている契約が維持されている限り、既存のコンポーネントバージョン内で提供される場合があります。
  • 新しいコンポーネントバージョンは、サポートされている動作や文書化された拡張ポイントに対する後方互換性のない変更に対してのみ導入されます。
  • HTL レンダリング、HTMLおよびDOM構造、CSS クラス、JavaScript ビヘイビアー、クライアントサイド API、検証、ルール実行、ダイアログおよびコンフィギュレーション構造、クライアントライブラリなどの実装の詳細は、サポートされている契約が維持されている場合、同じコンポーネントバージョン内で変更される場合があります。
  • コピーされたHTL、プライベート DOM構造、文書化されていないセレクター、オーバーレイされたAdobe クライアントライブラリなど、内部の実装の詳細に依存するカスタマイズは、マイナーな更新の影響を受けないままであることが保証されません。
  • Adobeで管理されている環境では、開発専用の自動アップグレードスイッチは提供されません。

関連トピックス

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