1. SXAの拡張

サイトの標準値を定義する

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

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

!注サイト固有の標準値を異なる種類のテンプレートで使用できます。このトピックでは、標準値がデータソースのテンプレートやレンダリングでどのように機能するかを説明します。

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

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

後で標準値を変更すると、レンダリングが関連するデータソーステンプレートを使用しているすべてのページにその変更が適用されます。

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

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

このウォークスルーでは、以下の方法を説明します:

  • オンプレミスインスタンスのサイト固有標準値を有効にする
  • 標準値モジュールを有効にする
  • 各サイトの下に標準値を追加してください
  • 複数のサイトに標準値を追加
  • データソーステンプレートに値を割り当てる

制限

レンダリングパラメータの標準値には以下の制限があります:

  • レンダリングパラメータは、ページにレンダリングを追加する時点で標準値項目からコピーされます。その後は、ページ上のレンダリングとレンダリングパラメータの標準値項目の間には関係がありません。標準値を変更しても、すでにページに追加されたレンダリングには影響しません。これは変更後に追加されたレンダリングのみに影響します。
  • レンダリングパラメータのサイト固有の標準値は、ドラッグ&ドロップやエクスペリエンスエディターの 「レンダリング追加 」ボタンでレンダリングを追加する場合にのみ適用されます。レイアウト 詳細 ダイアログで追加されたレンダリングには、サイト固有の標準レンダリングパラメータは適用されません。

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

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

インスタンスのサイト固有の標準値を有効にするために:

  • Sitecore.XA.Foundation.StandardValues.config.disabledファイルの拡張子.disabledを削除してください。ファイルは以下のディレクトリにあります:

    \App_Config\モジュール\SXA\Foundation.オーバーライド

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

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

サイト作成時に標準値を有効にするには、モジュール タブで「 標準値 」チェックボックスを選択してください。

サイト作成後に標準値を有効化するために:

  1. サイトを右クリックし、「 スクリプト」をクリックし、「 サイトモジュールを追加」をクリックします。

  2. ダイアログボックスで「 標準値 」チェックボックスを選び、OKをクリックします。

    Add a module to a site

    次のステップは、標準的な価値のある項目を1つ以上のサイトに追加することです。

各サイトの下に標準値を追加してください

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

  • 例えば、レンダリングで使用されるデータソーステンプレート、例えば ImageText
  • オプションでレンダリングを使いたい場合は、レンダリングのプロパティを指定するレンダリングパラメータを使えます。

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

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

  2. 設定を展開し、右クリックで「Standard Values」をクリックし、「Standard Values」をクリックします。

  3. ダイアログボックスの 「レンダリングパラメータ 」タブで、使いたいレンダリングを選択します。選択したレンダリングからスタイリングを適用したり、さまざまなプロパティを設定したりできます。

  4. Datasource Templatesタブで、希望するデータソーステンプレートを選択し、OKをクリックします。データソースのテンプレートとレンダリングパラメータはDatasourcesRendering parametersフォルダに追加・整理されます。後で、データソースの項目に値を割り当てます。

    Folders under Standard Values

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

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

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

  1. 標準値を定義したいテンプレートに移動してください。デフォルトの場所は以下の通りです:

    • サイト - テンプレート/機能/エクスペリエンスアクセラレーター/[レンダリングの種類]\Datasource
    • ヘッドレスサイト - Templates/Feature/Headless Experience Accelerator

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

  2. データソースのテンプレートを右クリックし、「 **スクリプト」**をクリックし、「 サイトに標準値を追加」をクリックします。

    Add Standard Value to site dialog box
  3. ダイアログボックスで、標準値を指定したいサイトを選択し、OKをクリックします。選択したサイトのStandard Valuesフォルダの下に、Uncategorizedという新しいフォルダが作成され、標準値項目が保持されます。

    headless-site-sv-uncategorized-folder.png

    !ヒントもしDatasourcesフォルダが存在するなら、管理しやすくするために、追加したテンプレートをDatasourcesフォルダに移すことを検討してください。

  4. 複数のサイトにレンダリングパラメータを追加するには、レンダリングパラメータが入っているフォルダに移動し、再度スクリプトを実行してください。デフォルトの場所は以下の通りです:

    • テンプレート/フィーチャー/エクスペリエンスアクセラレーター/[レンダリングの種類]\Datasource
    • Templates/Feature/Headless Experience Accelerator.

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

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

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

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

  1. コンテンツツリーでサイト設定に移動します。
  2. 設定を展開し、標準値を展開し、その後データソースを展開します。
  3. 希望するデータソーステンプレートを選択し、データソースの種類に応じて1つ以上の標準値を指定します。例えば 、画像を選択し、その後「 ブラウズ 」をクリックしてメディアライブラリから画像を選択するか、パスを指定します。
  4. オプションとして、レンダリングにスタイリングを適用したり、キャッシュプロパティなど他のプロパティを設定することもできます。これを行うには、 Rendering Parameters フォルダを展開し、興味のあるレンダリングを選択し、必要な設定を行ってください。
  5. 変更を保存してください。

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

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