セットアップ

言語フォールバックの構成

Version:

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

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

Sitecoreソリューションによっては、言語フォールバック設定にいくつかの調整を加えることができます。

言語フォールバックと検索インデックス

ソリューションがSitecoreのコンテンツ検索 (アイテムバケット) に依存しており、言語フォールバックを使用する場合は、アイテムレベルまたはフィールドレベルのフォールバックを処理するために特定の検索インデックスを設定する必要があります。

これを行うには、次の手順を実行します。

関連する検索インデックスの対応するxml子要素の内部値をtrueに設定して、関連するフォールバックモードを有効にします。

<index id="sitecore_master_index" …>
…
   <enableItemLanguageFallback>true</enableItemLanguageFallback>
   <enableFieldLanguageFallback>true</enableFieldLanguageFallback>
…
</index>

影響を受けるインデックスの完全な再構築を実行します。

メモ

設定ファイルにこれらの要素が含まれていない場合は、Sitecore.ContentSearch.Lucene.Index.Master.configファイルを適用方法の例として使用します。

フォールバック言語のフィールドのバージョンがない場合、インデックスにはデータは追加されません。ただし、この場合、SitecoreデータAPIはフォールバックフィールド値を持つアイテムを返すため、これらのアイテムにバージョンの存在を強制する必要があります。

Sitecore.LanguageFallback.configファイルの設定

Sitecore.LanguageFallback.configファイルでは、次の設定を変更できます。

DefaultCacheSize言語フォールバック・フィールドの値を格納するデフォルトのキャッシュ・サイズを決定します。デフォルト値は20MBです。

    <!--  CACHING - LANGUAGE FALLBACK FIELD VALUES - DEFAULT CACHE SIZE
    Determines the default size of the cache that stores the language fallback field values.
           Specify the value in bytes or append the value with KB, MB or GB.
              Default value: 20MB.
    -->
      <setting name="Caching.LanguageFallbackFieldValues.DefaultCacheSize" value="20MB" />

データベースごとに異なるキャッシュサイズが必要な場合は、次のコードサンプルを使用できます。このサンプルは、構成ファイルで入手できます。

    <!-- EXAMPLE: Override the size of languageFallbackFieldValues cache per database -->
    <!--
    <databases>
      <database id="master">
        <cacheSizes hint="setting">
          <languageFallbackFieldValues>20MB</languageFallbackFieldValues>
        </cacheSizes>
      </database>
      <database id="web">
        <cacheSizes hint="setting">
          <languageFallbackFieldValues>20MB</languageFallbackFieldValues>
        </cacheSizes>
      </database>
    </databases>
    -->

AllowVaryFallbackSettingsPerLanguageを使用すると、同じフィールドに対して異なるフォールバック設定を異なる言語で設定できます。

デフォルト値はfalseです。この機能を有効にすると、パフォーマンスが大幅に低下します。

     <!--  LANGUAGE FIELD FALLBACK - ALLOW VARY FALLBACK SETTINGS PER LANGUAGE
              If set to 'true', then values from both versioned 'Enable Language Fallback' and shared 'Enable Shared Language Fallback' checkbox fields
              on the field definition item are used to determine whether language fallback functionality should be enabled for the corresponding field.
              It allows you to have different fallback settings for the same field in different content languages.
              Example: when 'en-CA' tries to fallback to 'en', the checkbox field will be retrieved from the field definition item in 'en-CA',
              thus such version should exist. If retrieved value is 'false', then the 'Enable Shared Language Fallback' checkbox field is used.
              Note: enabling this feature has negative impact on performance.
              If set to 'false', only the shared 'Enable Shared Language Fallback' checkbox field on the field definition item is used to determine whether
              language fallback functionality should be enabled for the corresponding field.
              Default value: false.
      -->
      <setting name="LanguageFieldFallback.AllowVaryFallbackSettingsPerLanguage" value="false" />

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