推奨事項: SXAの拡張
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
たとえば、SXAを拡張して、独自のカスタム レンダリングをSXAツールボックスまたはテンプレートに追加できます。このトピックでは、SXAを拡張するためのいくつかの要件と推奨事項について説明します。
SXAが制御するツリーのブランチにカスタム アイテムを配置しないでください
SXAを拡張するときは、カスタム アイテムをどこに保存するかを考えてください。SXAは、SXAの更新中に標準のSXAセクションを上書きします。そのため、SXAによって制御されるツリーの枝にカスタム アイテムを配置すると、アップグレード後にインスタンスが壊れる可能性があります。次のことをお勧めします。
-
カスタムモジュールは、Headless Experience Acceleratorモジュールルートの兄弟であるブランチに配置します。
-
テンプレートは、Experience Acceleratorフォルダの兄弟であるフォルダに配置し、決して内部に配置しないでください。
-
同様に、レンダリング、ブランチ、メディアなど、他のすべての領域に対してモジュール固有のルートアイテムを作成する必要があります。
関連トピック:
OOTB SXAアイテムを変更しないでください
SXAを拡張する場合は、カスタム機能に常にSXA拡張ポイントを使用します。たとえば 、カスタムデータテンプレートを作成します。これが不可能で、延長の正当な理由がある場合は、SXAチームに連絡して拡張ポイントを作成してください。
関連トピック:
カスタム レンダリング用のSXAモジュールを作成する
カスタム レンダリングをSXAモジュール に配置して、既存のサイトに追加したり、新しく作成したサイトですぐに使用したりできます。
しなきゃいけません：
-
コンポーネントのデータ ソース定義を含めます (またはOOTB SXAデータ ソースを再利用します)。
-
データソースのサイト相対クエリを定義します。
関連トピック:
ページのカスタムテンプレートは、ページテンプレートに基づいて作成します
ページを表すカスタムテンプレートを作成する場合は、Pageテンプレートを基本テンプレートとして選択する必要があります。そうしないと、特定の機能が動作しない可能性があります。
アイテムID: Page:{3F8A6A5D-7B1A-4566-8CD4-0A50F3030BD8}。
アイテムパス: sitecore/Templates/Foundation/Experience Accelerator/Multisite/Content/Page。
新しいレンダリングを作成する前に、既存のレンダリングの使用を検討してください
フローチャートを確認して、カスタムコンポーネントを作成する必要があるかどうかを判断してください。
レンダリング バリアントを使用して、既存のSXAレンダリングをカスタマイズできます。可能であれば、カスタム レンダリングを作成する前に、常にバリアントの使用を検討してください。
関連トピック:
アイテムにリンクするフィールドの範囲を制限する
クエリをサポートするフィールドの場合、編集者が選択できるアイテムの範囲を制限する必要があります。
たとえば、次のようにします。
-
query:$siteMedia – ファイルまたは画像フィールドの場合。
-
query:$home – ページにリンクするフィールドの場合。
-
query:$site – サイト内の任意のアイテムにリンクできるフィールドの場合。
SXAパイプラインの説明には、トークンの完全なリストとトークンの拡張方法が含まれています。