localization_settings

用途

localization_settings: {
  localization_level: permissive
  default_locale: en
  import_locale_defs: yes | no
}
階層
localization_settings
デフォルト値
なし

定義

プロジェクトにローカライズを追加すると、ユーザーのロケールに基づいて Looker UI のラベルと説明の表示をカスタマイズしたり、LookML ダッシュボードの特定の部分をローカライズしたりできます。モデルのローカライズに関する設定については、LookML モデルのローカライズのドキュメント ページをご覧ください。

localization_settings パラメータを使用して、プロジェクトのローカライズを有効にし、プロジェクトでローカライズを処理する方法を指定します。

  • default_locale パラメータは、モデル内のどの文字列をローカライズするかを定義するデフォルトのロケール文字列ファイルを指定します。ファイル拡張子を除いた、ファイル名(大文字と小文字は区別されます)を正確に入力します。たとえば、文字列ファイルの名前が en.strings.json の場合は、default_locale: en を指定します。ロケール文字列ファイルの仕組みについては、LookML モデルのローカライズのドキュメント ページをご覧ください。
  • localization_level パラメータは、翻訳のない文字列をモデルで許可するかどうかを指定します。
    • デフォルトのロケール文字列ファイルで定義されていないラベルまたは説明に対して Looker IDE で LookML 検証エラーを返す場合は、ローカライズ レベルを strict に設定します。
    • デフォルトのローカライズストリングファイルに定義されていないラベルと説明を許可する場合は、ローカライズレベルを permissive に設定します。
  • import_locale_defs パラメータは、インポートされたプロジェクトの言語 / 地域定義をインポート プロジェクトの言語 / 地域定義と組み合わせるかどうかを指定します。
    • インポートしたプロジェクトのロケール定義をインポートするプロジェクトのロケール定義と組み合わせるには、yes に設定します。
    • インポートされたプロジェクトのロケール定義を無視するには、no(デフォルト値)に設定します。インポートするプロジェクトにロケール定義がある場合、Looker はインポートするプロジェクトのロケール定義のみを使用します。

ローカライズ設定の詳細については、LookML モデルのローカライズのドキュメント ページをご覧ください。

例

マニフェスト ファイルで、デフォルトのロケールが「en」、ローカライズに許可ポリシーが適用され、インポートしたプロジェクトのロケール定義がインポートするプロジェクトのロケール定義と結合されることを指定します。

project_name: "flights"

localization_settings: {
  default_locale: en
  localization_level: permissive
  import_locale_defs: yes
}