1. 遺跡コレクション

SXAテンプレートを追加・拡張する

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

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

テンプレートは、コンテンツ項目のプリセットスキーマであり、新しいアイテムのフィールドを毎回作成する代わりに、新しいアイテムの基礎となるものです。例えば、プロジェクトが既存のデータテンプレートに定義されていないフィールドを必要とする場合や、新しいアイテムに固有のデフォルトフィールド値や設定(例えば、デフォルトワークフロー)が必要な場合に、データテンプレートを追加したいかもしれません。

!重要事前に定義されたSXAテンプレートの _Standard valuesを変更しないことを推奨します。エクスペリエンスエディターの問題を避けるためには、自分でテンプレートを作成し、SXAテンプレートから継承するのが良いでしょう。

サイトコレクションを作成すると、SXAはプロジェクトフォルダ内にサイトコレクションのテンプレートの場所を作成します。同じフォルダ内に特定のプロジェクト用の新しいテンプレートを追加できます。カスタムテンプレートが必要なプロジェクトに取り組んでいる場合、これは便利かもしれません。プロジェクトテンプレートは以下のフォルダに追加できます: /sitecore/templates/Project/

!注Helixガイドラインの遵守を強くお勧めします。HelixはSitecore開発に関する公式ガイドラインと推奨プラクティスを提供しています。

SXAは、テンプレート名やテンプレートIDではなく、アイテムのテンプレート継承を確認することでアイテムを検証します。これにより、何も壊さずにテンプレートを作成・拡張することが可能になります。

SXAテンプレートを作成する

テンプレートを追加するには:

  1. コンテンツエディターで、サイトコレクションテンプレートフォルダ(sitecore/Templates/Project/)に移動します。例えば、新しいプロジェクトにカスタムテンプレートを追加するには、*/sitecore/templates/Project/*へ行ってください。

    !重要カスタムテンプレートをSXA制御のブランチに入れないでください。SXA SXAアップデート時に上書きしてしまうからです。例えば、Experience Acceleratorフォルダの兄弟フォルダにテンプレートを配置できますが、その中には入れません。

  2. アイテムを右クリックして「挿入新しいテンプレート」をクリックします。またはオプションセクションの****「New****Template」をクリックしてください。

  3. 新しいテンプレートの名前を入力し、ベーステンプレートを選択し、「 次へ」をクリックします。例えば、ページを表すアイテムのテンプレートはデフォルトのページテンプレートから継承する必要があります。

    !注SXA命名規則に従う必要はありませんが、特定のテンプレートの使い方を明確に定義しているため役立つかもしれません。SXAでは、アイテム作成には使えないが他のテンプレートのベーステンプレートとして機能するテンプレート名には、アンダースコアで接頭辞が付けられます。例えば: _Searchable, _Designable, _Sticky Note。

  4. 新しいテンプレートに継承させたい標準フィールドが定義されたときに追加の基本テンプレートを追加するには、テンプレートをクリックし、コンテンツ タブの 「データ 」セクションで追加したいテンプレートをダブルクリックするか、矢印で追加してください。

  5. ビルダータブの「新しいセクションを追加」フィールドで、例えば**「Data**」などの関連するデータテンプレートフィールドを追加します。

    !注テンプレート内のフィールドにデフォルト値を割り当てるには、オプションタブで「Standard values」をクリックしてください。そのテンプレートから新しいアイテムを作成するたびに、フィールドは標準値項目内の対応するフィールドの値を継承します。

  6. 変更を保存してください。

SXAテンプレートを拡張する

既存のSXAテンプレートを拡張できます。テンプレートは多くのベーステンプレートで構成されることがあります。

!注テンプレートの継承を壊さないように注意してください。テンプレートの継承構造は、テンプレートの継承タブにあるコンテンツエディターで確認できます。

既存のSXAプロジェクトテンプレートをカスタムテンプレートで拡張するには:

  1. コンテンツエディターで拡張したいテンプレートをクリックします。
  2. コンテンツタブの**「データ**」セクションで、追加したいテンプレートをダブルクリックして、矢印を使って**「選択済み**」セクションに移動します。

!注拡張したいSXAテンプレートがまだプロジェクトテンプレートフォルダに存在しない場合は、新しいプロジェクトテンプレートを作成し、ベーステンプレートフィールドで拡張したいテンプレートと追加したカスタムベーステンプレートの両方を追加するのが良いでしょう。

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