Cómo localizar su modelo de LookML

La localización de modelos suele ocurrir junto con la localización de formatos de número y la selección de idioma de la interfaz de usuario. Para obtener más información sobre estos temas, consulta las páginas de documentación sobre localización del formato de números e idiomas de interfaz de usuario admitidos.

Con la localización de modelos, puedes personalizar la forma en que se muestran las etiquetas y descripciones del modelo de acuerdo con la configuración regional del usuario.

No es necesario que la localización se base en la ubicación geográfica o el idioma. Puedes usar configuraciones regionales para representar otros factores distintivos, como usuarios internos o externos, o administradores y colaboradores individuales, y personalizar tus etiquetas y descripciones según corresponda.

Actualmente, la localización de modelos no es compatible con la importación de proyectos.

En esta página, se describen los pasos para localizar tu proyecto:

Para obtener más información sobre la localización de la interfaz de usuario de Looker o la localización del formato de número, consulta las páginas Documentación Idiomas admitidos en la interfaz de usuario y Localiza el formato de número.

Usa elementos localizados en tus archivos de modelo

Puede localizar etiquetas, etiquetas de grupo y descripciones en su modelo, incluidas las siguientes:

No se admite la localización para dimension_group. En su lugar, usa group_label y group_item_label para crear tu propio conjunto de dimensiones que se puedan localizar.

También puedes crear paneles de LookML localizados en tu proyecto. Los siguientes parámetros del panel de LookML se pueden localizar:

Para ver todos los campos del proyecto que pueden localizarse, puedes establecer el nivel de localización en strict. Con esta configuración, el IDE de Looker muestra un error de validación de LookML para cualquier elemento de LookML que se pueda localizar, pero que no tenga etiquetas, y para cualquier string del modelo LookML que se pueda localizar, pero que no esté definida en los archivos de strings de configuración regional.

Este es un ejemplo de un archivo de vista con algunas etiquetas y descripciones:

view: flights {
  label: "flight_info"
  sql_table_name: flightstats.accidents ;;

  dimension: id {
    label: "id"
    primary_key: yes
    type: number
    sql: ${TABLE}.id ;;
  }

  dimension: air_carrier {
    label: "airline"
    type: string
    sql: ${TABLE}.air_carrier ;;
  }

  dimension: country {
    label: "country"

    type: string
    map_layer_name: countries
    sql: ${TABLE}.country ;;
  }

  dimension: number_of_engines {
    label: "number_of_engines"
    type: string
    sql: ${TABLE}.number_of_engines ;;
  }

  dimension: location {
    type: string
    sql: ${TABLE}.location ;;
  }

Localizaremos estos valores en los archivos de strings con un nivel de localización permissive. Ten en cuenta que la dimensión location no tiene una etiqueta, por lo que podemos demostrar cómo se muestra una dimensión sin localización.

Cómo crear archivos de strings de configuración regional

Los archivos de strings de configuración regional usan pares clave-valor para definir la manera en que se muestran las etiquetas y descripciones en tu modelo para cada configuración regional. A la izquierda de cada par clave-valor se encuentra la clave de localización, que es una etiqueta o string de descripción de tu modelo. En el lado derecho del par clave-valor, puede definir cómo desea que se muestre esa string en la IU de Looker.

Para cada configuración regional que quieras para tu proyecto, crea un archivo de strings dedicado. Debes crear un solo archivo de strings para cada configuración regional del proyecto. Debe haber un archivo de strings cuyo nombre coincida con la configuración regional predeterminada. Por ejemplo, si especificaste default_locale: en en el archivo de manifiesto de tu proyecto, debes tener un archivo en tu modelo llamado en.strings.json. Cada string se debe definir en el archivo de strings de configuración regional default; de lo contrario, no se localizará.

No es necesario que la localización del modelo se base en la ubicación geográfica o el idioma. Sin embargo, si usas la localización de modelos y también deseas usar el panel y la interfaz de usuario de visualización localizados de Looker, debes hacer coincidir el título del archivo de strings con los códigos de configuración regional admitidos de Looker.

Este es un archivo en.strings.json de ejemplo que se usará para todos los usuarios con el valor Locale de en. En este ejemplo, en también se especifica como nuestra configuración regional predeterminada, por lo que todas las strings deben definirse en este archivo para poder localizarse.

{
  "flight_info": "Flights",
  "id": "Identifier",
  "airline": "Air Carrier",
  "country_of_departure": "Country of Departure",
  "number_engines": "Number of Engines"
}

Esto es lo que un usuario en vería en Looker:

Ten en cuenta lo siguiente:

  • En el archivo de vista anterior, no proporcionamos una etiqueta para la dimensión location, por lo que Looker muestra el nombre de la dimensión, en mayúsculas: "Location".
  • No definimos la localización para la etiqueta "country" en nuestro archivo en.strings.json, por lo que Looker la muestra como se define en nuestro archivo de vista, sin mayúsculas: "country".

Como otro ejemplo, podemos crear un archivo es_ES.strings.json que se use para todos los usuarios con un valor Locale de es_ES:

{
  "flight_info": "Vuelos",
  "id": "Identificador",
  "airline": "Aerolínea",
  "country": "País",
  "country_of_departure": "País de Partida",
  "number_engines": "Número de Motores"
}

Esto es lo que un usuario es_ES vería en Looker:

Ten en cuenta lo siguiente:

  • Al igual que en el ejemplo anterior, en el archivo de vista anterior, no proporcionamos una etiqueta para la dimensión location, por lo que Looker muestra el nombre de la dimensión, en mayúsculas: "Location".
  • No definimos la localización para la etiqueta "country" en nuestro archivo en.strings.json, que es nuestro archivo de strings de configuración regional predeterminado. Por lo tanto, aunque sí definimos "country" en nuestro archivo es_ES.strings.json, Looker no localiza esta string y muestra la etiqueta como se define en nuestro archivo de vista: "country".

Cómo agregar la configuración de localización al archivo de manifiesto de tu proyecto

A fin de habilitar la localización para tu proyecto, agrega el parámetro localization_settings al archivo de manifiesto del proyecto.

Si tu proyecto aún no tiene un archivo de manifiesto, puedes crear uno con el ícono + ubicado en la parte superior del navegador de archivos del IDE de Looker.

En el archivo de manifiesto, agrega la configuración de localización. Por ejemplo:

localization_settings: {
  default_locale: en
  localization_level: permissive
}

default_locale

El parámetro default_locale especifica el nombre del archivo de strings de configuración regional predeterminado en tu proyecto.

El archivo de strings de configuración regional predeterminado determina qué strings del modelo están localizadas. Incluso si se define una etiqueta o una string de descripción en otro archivo de strings de configuración regional, si no se define en el archivo de strings de configuración regional default, la IU de Looker mostrará la string no localizada. Consulta esta sección para obtener más información sobre la configuración de archivos de strings de configuración regional.

La configuración regional predeterminada de tu proyecto no debe confundirse con la configuración regional predeterminada para los usuarios de Looker. Tu administrador de Looker puede establecer una configuración regional predeterminada para tu instancia. Si no se configura ningún valor predeterminado, Looker se configurará de forma predeterminada como en. Si el administrador no ingresa específicamente un valor de Configuración regional para un usuario o un grupo de usuarios al que pertenece el usuario, Looker la asigna a la configuración regional predeterminada de la instancia. Además, si el administrador no estableció una configuración regional de la instancia predeterminada, Looker asigna al usuario a la configuración regional en.

Por este motivo, a menos que sepas con certeza que tu administrador de Looker configurará el valor de la configuración regional para todos los usuarios de Looker, debes establecer el parámetro default_locale de tu proyecto en la configuración regional predeterminada para tu instancia (o en si no se configuró ningún valor predeterminado) y definir la localización para todas tus etiquetas y descripciones en el archivo .strings.json de esa configuración regional.

localization_level

El nivel de localización de tu proyecto especifica si se permiten elementos no localizados en tu modelo:

  • Establecer el nivel de localización en strict a fin de requerir etiquetas localizadas para todos los modelos, las exploraciones, las vistas y los campos de tu proyecto. El IDE de Looker mostrará un error de validación de LookML para cualquiera de estos elementos que no tengan etiquetas y para todas las etiquetas y descripciones que no estén definidas en el archivo de strings de configuración regional predeterminado.
  • Establece el nivel de localización en permissive para permitir elementos sin etiquetas y etiquetas y descripciones que no están definidas en el archivo de strings de localización predeterminado.

Incluso si quieres el nivel de localización strict, puede resultarte útil configurar el nivel de localización de tu proyecto en permissive cuando estés desarrollando tu proyecto para evitar errores de validación. Cuando termines de localizar todas las etiquetas y descripciones, puedes establecer el nivel de localización en strict para ver los errores.

Cómo asignar usuarios a una configuración regional

Una vez que hayas configurado tus archivos de strings de configuración regional, puedes asignar usuarios a una configuración regional correspondiente a uno de los archivos de strings de configuración regional. Esto se puede hacer a nivel de la instancia, del grupo de usuarios o del usuario individual mediante el campo Configuración regional o el atributo de usuario locale.

Por ejemplo, si quieres que un usuario vea las etiquetas y descripciones descritas en el archivo es_ES.strings.json, tu administrador de Looker debe establecer la configuración Configuración regional del usuario en es_ES:

Para incluir configuraciones regionales personalizadas con archivos de strings en el campo Configuración regional, haga clic en el campo y escriba el nombre del archivo de strings en lugar de seleccionar una configuración regional integrada en el menú desplegable. Para obtener más información, consulta la página de documentación de Usuarios.

Cuando una configuración regional no se establezca para los usuarios a nivel individual o del grupo de usuarios, Looker asignará a los usuarios a la configuración regional de la instancia. Sin embargo, si no se configura ningún archivo .strings para la configuración regional de la instancia, la localización del modelo no funcionará para esos usuarios. Por ese motivo, se debe configurar un archivo .strings para la configuración regional predeterminada de cada instancia. Puedes obtener más información en las secciones default_locale o Cómo crear archivos de strings de configuración regional.

Cómo establecer la configuración regional para los usuarios incorporados en el SSO

Puedes incluir el valor de configuración regional del usuario en una URL de incorporación de SSO, como cualquier otro atributo de usuario. El formato exacto requerido para las incorporaciones de SSO depende del lenguaje de programación que se use en la compilación de la secuencia de comandos de la URL de incorporación de SSO, pero el nombre del atributo de usuario es locale. Consulta la página de documentación sobre el inicio de sesión único (SSO) a fin de obtener más información sobre las URLs y herramientas de SSO para crear tu URL de incorporación de SSO.

Cómo usar la configuración regional en las variables líquidas

Como se describió anteriormente, la localización de modelos le permite personalizar la visualización de las etiquetas y descripciones de su modelo para diferentes configuraciones regionales. Sin embargo, también puede incluir claves de localización en Variables líquidas, que también le permiten localizar sus valores de datos.

Por ejemplo, en nuestro archivo predeterminado de strings de configuración regional llamado en.strings.json, podemos crear las claves de localización domestic y international con las siguientes entradas:

{
  "domestic": "Domestic",
  "international": "International"
}

Luego, en nuestro archivo es_ES.strings.json, podemos proporcionar versiones en español de estas claves de localización: 

{
  "domestic": "Nacional",
  "international": "Internacional"
}

Desde allí, podemos usar las claves de localización domestic y international en las variables líquidas para localizar el resultado de una dimensión:

dimension: from_US {
    label: "from_us"
    type: string
    sql: CASE
         WHEN ${TABLE}.country = 'United States' THEN '{{ _localization['domestic'] }}'
         ELSE '{{ _localization['international'] }}'
         END;;
  }

Esto es lo que ven nuestros usuarios con la configuración regional en:

Esto es lo que nuestros usuarios con la configuración regional de es_ES ven:

También puedes usar los filtros Líquido en los filtros panel y elemento del panel para localizar el valor predeterminado en un filtro. Por ejemplo, si un panel de LookML tiene un mosaico de la exploración de arriba y hay un filtro en ese mosaico definido de la siguiente manera:

filters:
  flights.from_US: "{{ _localization['domestic'] }}"

A continuación, se muestra lo que verán los usuarios con la configuración regional en cuando exploren desde esa tarjeta en el panel:

Y esto es lo que verán los usuarios con la configuración regional es_ES cuando exploren desde esa tarjeta en el panel:

Comprende cómo se aplican las reglas de localización a los objetos extendidos y mejor definidos

Tenga en cuenta que las reglas de localización se aplican cuando extende las vistas, las exploraciones o los paneles de LookML, y cuando define mejor las vistas o exploraciones.

Si extendiste o definiste mejor un objeto y, luego, agregaste etiquetas o descripciones nuevas, debes proporcionar definiciones de localización en los archivos de strings de configuración regional.

Por ejemplo, si tenemos una vista flights:


view: flights {
  label: "flight_info"
  sql_table_name: flightstats.accidents ;;
  ...
}

Luego, creamos una vista nueva que extienda la vista flights:

include: "/views/flights.view"

view: flights_enhanced {
  extends: [flights]
  label: "enhanced_flight_info"
}

En nuestros archivos de strings de configuración regional, deberemos definir ambas strings de etiquetas de vistas ("flight_info" y "enhanced_flight_info"). Si el nivel de localización del proyecto se establece en strict, no podremos confirmar ninguna actualización hasta que definamos las nuevas etiquetas o descripciones.