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

概要

SXA ソリューションの新しいページ テンプレートを作成します。

テンプレートは、新しいアイテムの特定のフィールドを毎回再作成する代わりに、新しいアイテムのベースとして使用されるコンテンツ アイテムのプリセット スキーマです。たとえば、プロジェクトで既存のデータ テンプレートで定義されていないフィールドが必要な場合や、新しいアイテムで一意のデフォルト フィールド値またはデフォルト設定 (デフォルト ワークフローなど) が必要な場合に、データ テンプレートを追加することができます。

重要

事前定義された SXA テンプレートの _Standard values は変更しないことをお勧めします。エクスペリエンス エディターの問題を回避するには、独自のテンプレートを作成して SXA テンプレートから継承することをお勧めします。

テナントを作成したら、SXA はテナント テンプレートの場所を プロジェクト フォルダーに設定します。同じフォルダーに特定のプロジェクトの新しいテンプレートを追加できます。これは、カスタム テンプレートを必要とするプロジェクトで作業している場合に便利です。プロジェクト テンプレートは /sitecore/テンプレート/プロジェクト/ に追加できます。

注記

Helix ガイドラインに遵守することを強くお勧めします。Helix は、Sitecore 開発のための一連の公式ガイドラインと推奨プラクティスを提供します。

SXA は、テンプレート名やテンプレート ID の代わりに、アイテムのテンプレート継承をチェックすることでアイテムを検証します。これにより、何も壊さずにテンプレートを作成および/または拡張することができます。

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

  1. コンテンツ エディターで、テナント テンプレート フォルダー (sitecore/テンプレート/プロジェクト/) に移動します。たとえば、カスタム テンプレートを新しいプロジェクトに追加するには、sitecore/テンプレート/プロジェクト/<projectname>に移動します。

    重要

    SXA が SXA 更新中にこれらを上書きするため、カスタム テンプレートを SXA 制御ブランチに配置しないでください。たとえば、エクスペリエンス アクセラレーター フォルダーの兄弟フォルダーにテンプレートを配置できますが、その中には配置されません。

  2. アイテムを右クリックして、[挿入]、[新しいテンプレート] をクリックします。または、[オプション] セクションの [新規]、[テンプレート] をクリックします。

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

    注記

    SXA 命名規則に従う必要はありませんが、特定のテンプレートの使用方法を明確に定義するため、役立つ場合があります。SXA では、アイテムの作成には使用できないが、他のテンプレートのベース テンプレートとして機能できるテンプレート名には、アンダースコアがプレフィックスとして付けられています。例: _Searchable, _Designable, _Sticky Note

  4. 新しいテンプレートに継承させたい標準フィールドを定義する際に、ベース テンプレートをテンプレートに追加するには、テンプレートをクリックし、[コンテンツ] タブの [データ] セクションで、追加するテンプレートをダブルクリックするか、矢印を使用して追加します。

  5. [ビルダー] タブの [新しいフィールド セクションを追加] フィールドで、[データ] など関連するデータ テンプレート フィールドを追加します。次に例を示します。

    注記

    テンプレートの [オプション] タブのフィールドにデフォルト値を割り当てるには、[標準値] をクリックします。そのテンプレートから新しいアイテムが作成されるたびに、このフィールドは標準値アイテムの対応するフィールドから値を継承します。

  6. 変更を保存します。

既存の SXA テンプレートを拡張できます。テンプレートは、複数のベース テンプレートで構成できます。

注記

テンプレートの継承を壊さないよう注意する必要があります。コンテンツ エディターのテンプレートの [継承] タブでテンプレートの継承構造を確認できます。

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

  1. コンテンツ エディターで、拡張するテンプレートを選択します。

  2. [コンテンツ] タブの [データ] セクションで、追加するテンプレートをダブルクリックし、矢印を使用して [選択済み] セクションに移動します。

注記

拡張したい SXA テンプレートがプロジェクト テンプレートフォルダーにまだ存在しない場合は、新しいプロジェクト テンプレートを作成し、[ベース テンプレート] フィールドを使用して、拡張するテンプレートと、追加したカスタム ベース テンプレートを追加することをお勧めします。