1. ベストプラクティス

推奨事項:SXAの延長

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

例えば、SXAを拡張して、SXAツールボックスやテンプレートに自分だけのカスタムレンダリングを追加したいかもしれません。このトピックでは、SXAの拡張に関するいくつかの要件と推奨事項について説明します。

SXAが管理するツリーの枝にはカスタムアイテムを入れないでください

SXAを延長する際は、カスタムアイテムをどこに保管するかを考えてください。SXAはSXAの更新時に標準のSXAセクションを上書きします。そのため、SXAが制御するツリーブランチにカスタムアイテムを配置すると、アップグレード後にインスタンスが壊れる可能性があります。以下をお勧めします:

  • カスタムモジュールをHeadless Experience Acceleratorモジュールの根の兄弟ブランチに配置します。

  • テンプレートはExperience Acceleratorフォルダーの兄弟フォルダに入れて、絶対に内側には置かないでください。

  • 同様に、レンダリング、ブランチ、メディアなど他のすべての領域に対してモジュール固有のルートアイテムを作成する必要があります。

関連トピック:

OOTB SXA項目を改変しないでください

SXAを拡張する際は、カスタム機能のために必ずSXA拡張ポイントを使用してください。例えば、カスタムデータテンプレートを作成すると良いでしょう。それが不可能で延長の正当な理由がある場合は、SXAチームに連絡して延長ポイントを作成してもらいましょう。

関連トピック:

カスタムレンダリング用のSXAモジュールを作成しましょう

カスタムレンダリングをSXAモジュール に配置し、既存のサイトに追加したり、新たに作成したサイトで即座に利用したりできます。

しなきゃいけません：

関連トピック:

ページのカスタムテンプレートはPageテンプレートを基にしてください

ページを表すカスタムテンプレートを作成する際は、Pageテンプレートをベーステンプレートとして選択する必要があります。そうでなければ、特定の機能が動作しないことがあります。

項目ID: Page:{3F8A6A5D-7B1A-4566-8CD4-0A50F3030BD8}。

アイテムパス: sitecore/Templates/Foundation/Experience Accelerator/Multisite/Content/Page。

新しいレンダリングを作る前に既存のレンダリングを使うことを検討してください

フロー チャート を見て、カスタムコンポーネントを作成するかどうか判断してください。

既存のSXAレンダリングはレンダリングバリアントを使ってカスタマイズできます。可能であれば、カスタムレンダリングを作成する前に必ずバリアントの使用を検討してください。

関連トピック:

項目にリンクするフィールドの範囲を制限する

クエリをサポートするフィールドについては、編集者が選択できる項目の範囲を制限する必要があります。

例えば、以下を使います:

  • query:$siteMedia – ファイルフィールドや画像フィールドのために。

  • query:$home – ページへのリンクフィールドに対して。

  • query:$site – サイト内の任意の項目にリンクできるフィールド。

SXAパイプラインの説明には、トークンの完全なリストとその拡張方法が含まれています。

この記事を改善するための提案がある場合は、 お知らせください!