1. SXAの拡張

サイトの標準値の定義

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

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

メモ

サイト固有の標準値は、さまざまなタイプのテンプレートで使用することができます。このトピックでは、標準値がデータ ソース テンプレートおよびレンダリングでどのように機能するかについて説明します。

サイト固有の標準値は、Sitecoreインスタンスでグローバルに定義する標準値とは異なる動作をします。サイトで標準値を定義すると、その標準値はそのサイトで作成されたページにのみ適用されます。

サイトでは、標準値を定義するデータ ソース テンプレートを指定し、それらのデータ ソース テンプレートに標準値を割り当てます。データ ソースを指すレンダリングがページに追加されると、標準値が使用されます。これは、たとえば、コンテンツ作成者がそのサイトの特定のページで定型テキストを表示する場合に便利です。この例では、コンテンツ作成者は、データソーステンプレートの標準値を変更せずに、ページ上のテキストを変更できます。

後で標準値を変更すると、その変更は、レンダリングで関連付けられたデータ ソース テンプレートを使用するすべてのページで有効になります。

手記

レンダリングが使用されているページで標準値が変更されている場合、データ ソース テンプレートの標準値を変更しても、レンダリングの変更値は上書きnot 。

各サイトで標準値を定義することも、複数のサイトで標準値を定義することもできます。

このチュートリアルでは、次の方法について説明します。

  • オンプレミスインスタンスのサイト固有の標準値を有効にする

  • 標準値モジュールを有効にする

  • 個々のサイトに標準値を追加する

  • 複数のサイトに標準値を追加する

  • データ ソース テンプレートに値を割り当てる

制限

レンダリング パラメータの標準値には、次の制限が適用されます。

  • レンダリング パラメータは、ページにレンダリングを追加した時点で標準値アイテムからコピーされます。この後、ページ上のレンダリングとレンダリング パラメーターの標準値項目との間に関係はありません。標準値を変更しても、ページに既に追加されているレンダリングには影響しません。これは、変更後に追加されたレンダリングにのみ影響します。

  • レンダリング パラメーターのサイト固有の標準値は、ドラッグ アンド ドロップまたはエクスペリエンス エディターのAdd Renderingボタンを使用してレンダリングを追加する場合にのみ適用されます。レンダリング パラメータのサイト固有の標準値は、Layout Detailsダイアログを使用して追加されたレンダリングには適用されません。

オンプレミスインスタンスのサイト固有の標準値を有効にする

オンプレミスインスタンスを使用している場合、デフォルトでは、サイト固有の標準値は無効になっています。

インスタンスに対してサイト固有の標準値を有効にするには:

  • Sitecore.XA.Foundation.StandardValues.config.disabledファイルから拡張子.disabledを削除します。このファイルは、次のディレクトリにあります。

    \App_Config\Modules\SXA\Foundation.Overrides.

標準値モジュールを有効にする

サイトの標準値を定義する前に、サイトの作成中または作成後にStandard Valuesモジュールを有効にする必要があります。

サイトの作成時に標準値を有効にするには、ModulesタブでStandard Valuesチェック ボックスをオンにします。

サイトの作成後に標準値を有効にするには:

  1. サイトを右クリックし、Scriptをクリックして、Add Site Moduleをクリックします。

  2. ダイアログボックスで、「 Standard Values 」チェックボックスを選択し、「 OK」をクリックします。

    Add a module to a site

    次の手順では、標準値の項目を1つ以上のサイトに追加します。

個々のサイトに標準値を追加する

標準値は、個々のサイトで定義することができます。標準値を設定する前に、以下を指定する必要があります。

  • たとえば、レンダリングで使用されるデータ ソース テンプレート ( ImageやTextなど)

  • オプションで、レンダリングを使用する場合は、レンダリングのプロパティを指定できるレンダリングパラメータ。

データソーステンプレートとレンダリングパラメータを指定するには:

  1. コンテンツ ツリーで、サイト設定に移動します。

  2. Settingsを展開し、Standard Valuesを右クリックして、Standard Valuesをクリックします。

  3. ダイアログ ボックスのRendering Parametersタブで、使用するレンダリングを選択します。選択した内容により、レンダリングにスタイルを適用したり、さまざまなプロパティを設定したりできます。

  4. 「 Datasource Templates 」タブで、必要なデータソーステンプレートを選択し、「 OK」をクリックします。データ ソース テンプレートとレンダリング パラメーターは、DatasourcesフォルダーとRendering parametersフォルダーに追加され、整理されます。後で、データ ソース アイテムに値を割り当てます。

    Folders under Standard Values

複数のサイトに標準値を追加する

複数のサイトの標準値を定義する場合は、標準値を定義するデータ ソース テンプレートを選択し、テンプレートを追加するサイトを一覧から選択します。

標準値を複数のサイトに追加するには:

  1. 標準値を定義するテンプレートに移動します。デフォルトの場所は次のとおりです。

    • Sites -Templates/Feature/Experience Accelerator/[type of rendering]\Datasource.

    • Headless sites - Templates/Feature/Headless Experience Accelerator.

    場所は、Sitecoreインスタンスの設定方法によって異なる場合があります。

  2. データ ソース テンプレートを右クリックし、Scriptsをクリックして、Add Standard Value to sitesをクリックします。

    Add Standard Value to site dialog box

  3. ダイアログボックスで、標準値を指定するサイトを選択し、「 OK」をクリックします。選択したサイトのStandard Valuesフォルダの下に、Uncategorizedという新しいフォルダが作成され、標準値のアイテムが格納されます。

    先端

    Datasourcesフォルダが存在する場合は、管理性を高めるために、追加したばかりのテンプレートをDatasourcesフォルダに移動することを検討してください。

  4. レンダリング パラメータを複数のサイトに追加するには、レンダリング パラメータが格納されているフォルダに移動し、スクリプトを再度実行します。デフォルトの場所は次のとおりです。

    • Templates/Feature/Experience Accelerator/[type of rendering]\Datasource.

    • Templates/Feature/Headless Experience Accelerator.

    場所は、Sitecoreインスタンスの設定方法によって異なる場合があります。

データ ソース テンプレートに値を割り当てる

データ ソース テンプレートをサイトに追加した後、データ ソース テンプレートに値を割り当てる必要があります。

データソーステンプレートに値を割り当てるには:

  1. コンテンツ ツリーで、サイト設定に移動します。

  2. Settings、Standard Values、Datasourcesの順に展開します。

  3. 必要なデータソーステンプレートを選択し、データソースのタイプに応じて、1つ以上の標準値を指定します。例えば、「 Image」を選択した場合は、「 Browse 」をクリックしてメディアライブラリから画像を選択するか、パスを指定します。

  4. 必要に応じて、レンダリングにスタイルを適用したり、キャッシュ プロパティなどの他のプロパティを設定したりできます。これを行うには、Rendering Parametersフォルダーを展開し、目的のレンダリングを選択して、必要な設定を行います。

  5. 変更を保存します。

現在のサイトの下のページに関連レンダリングを追加すると、指定した標準値が自動的に挿入されます。

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