Con la localización de modelos, puedes personalizar la forma en que se muestran las etiquetas y descripciones de tu modelo según la configuración regional del usuario.
La localización no tiene que basarse en la ubicación geográfica o el idioma. Puedes usar configuraciones regionales para representar otros factores distintivos, como usuarios internos versus externos, administradores versus colaboradores individuales, y personalizar las etiquetas y descripciones según corresponda.
En esta página, se describen los pasos para localizar tu proyecto:
- Determina qué elementos se localizarán agregando etiquetas, etiquetas de grupo y descripciones a tu modelo.
- Proporciona las definiciones de localización para tu proyecto. Para ello, crea archivos de cadenas de configuración regional.
- Habilita la localización para tu proyecto. Para ello, agrega parámetros de configuración de localización al archivo de manifiesto del proyecto.
- Determina la visualización para los diferentes usuarios. Para ello, asigna usuarios a configuraciones regionales.
A menudo, la localización del modelo ocurre junto con un administrador que especifica la configuración de la localización del formato de número y del idioma de la interfaz de usuario.
Cómo localizar etiquetas y descripciones en tu modelo
Puedes localizar etiquetas, etiquetas de grupo y descripciones en tu modelo, incluidas las siguientes opciones:
labelpara campo, model, Explorar o vistalabelpara aplicaciones en el framework de extensiones de Lookergroup_labelpara Explorar ygroup_labelpara campogroup_item_labelpara el campodescriptionpara Explorar ydescriptionpara campo
También puedes crear paneles de Looker localizados en tu proyecto. Los siguientes parámetros del panel de LookML se pueden localizar:
titledescriptiontext(que es un subparámetro del parámetronotey se puede aplicar a todos los tipos de elementos del panel, además de los elementos detype: text)comparison_labelsingle_value_title
Para ver todos los campos de tu proyecto que se pueden localizar, configura el nivel de localización de tu proyecto en strict. Con este parámetro de configuración, el IDE de Looker muestra un error de validación de LookML para los elementos de LookML que pueden localizarse, pero que no tienen etiquetas, y de las cadenas del modelo de LookML que se pueden localizar, pero que no están definidas en los archivos de cadenas de configuración regional.
En el siguiente LookML de muestra, se proporcionan etiquetas para la vista flights y los campos id, country y number_of_engines. También se proporciona una descripción para el campo country.
view: flights {
label: "flight_info"
sql_table_name: flightstats.accidents ;;
dimension: id {
label: "id"
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
dimension: country {
label: "country"
description: "country_of_departure"
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 ;;
}
En los ejemplos que siguen en esta página, localizaremos estos valores en los archivos de cadenas con un nivel de localización permissive. Observa 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 cadenas de configuración regional
Los archivos de cadenas de configuración regional usan pares clave-valor para definir cómo se muestran las etiquetas y las descripciones en tu modelo para cada configuración regional. En el lado izquierdo de cada par clave-valor, se encuentra la clave de localización, que es una cadena de etiqueta o descripción de tu modelo. En el lado derecho del par clave-valor, se define cómo quieres que se muestre esa cadena en la IU de Looker.
Para cada configuración regional que quieras usar en tu proyecto, debes crear un archivo de cadenas dedicado. Crea solo un archivo de cadenas para cada configuración regional. Debes tener un archivo de cadenas 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 llamado en.strings.json en tu modelo. Cada cadena debe definirse en el archivo de cadenas de configuración regional predeterminado. De lo contrario, no se localizará.
Se usará este ejemplo de un archivo en.strings.json para todos los usuarios que tengan el valor Locale de en. En el siguiente LookML de muestra, también se especifica en como la configuración regional predeterminada, por lo que todas las strings deben definirse en este archivo para poder localizarse.
{
"flight_info": "Flights",
"id": "Identifier",
"country_of_departure": "Country of Departure",
"number_engines": "Number of Engines"
}
En la siguiente tabla, se muestra lo que vería un usuario con su configuración regional en en la tabla de datos de una exploración de Looker:
| Flights Identifier | Flights country | Flights Location | Flights Number of Engines |
|---|---|---|---|
| 493 | Congo | Kisangani, Congo | 3 |
| 2167 | Saudi Arabia | Riyadh, Saudi Arabia | 3 |
| 2657 | Austria | Vienna, Austria | 2 |
| 17992 | United States | Kansas City, MO | 2 |
| 18893 | United States | Anchorage, AK | 4 |
Ten en cuenta lo siguiente:
- En el LookML de la vista de
flightsde muestra que se mostró anteriormente, no proporcionamos ninguna etiqueta para la dimensiónlocation, por lo que Looker muestra el nombre de la dimensión en mayúsculas: “Ubicación”. - No definimos la localización para la etiqueta de “país” en nuestro archivo
en.strings.json, por lo que Looker muestra la etiqueta tal como se define en nuestro archivo de vista, sin usar mayúsculas: “país”.
Como otro ejemplo, podemos crear un archivo es_ES.strings.json que se use para todos los usuarios con un valor de Locale de es_ES:
{
"flight_info": "Vuelos",
"id": "Identificador",
"country": "País",
"country_of_departure": "País de Partida",
"number_engines": "Número de Motores"
}
En la siguiente tabla, se muestra lo que vería en Looker un usuario con su configuración regional establecida en es_ES:
| Vuelos Identificador | Vuelos country | Vuelos Location | Vuelos Número de Motores |
|---|---|---|---|
| 493 | Congo | Kisangani, Congo | 3 |
| 2167 | Saudi Arabia | Riyadh, Saudi Arabia | 3 |
| 2657 | Austria | Vienna, Austria | 2 |
| 17992 | United States | Kansas City, MO | 2 |
| 18893 | United States | Anchorage, AK | 4 |
Ten en cuenta lo siguiente:
- Al igual que en el ejemplo anterior, en la vista original con etiquetas y descripciones agregadas, no proporcionamos una etiqueta para la dimensión
location, por lo que Looker muestra el nombre de la dimensión en mayúsculas: “Ubicación”. - No definimos la localización para la etiqueta de "país" en nuestro archivo
en.strings.json, que es nuestro archivo de cadenas de configuración regional predeterminado. Por lo tanto, aunque sí definimos “country” en nuestro archivoes_ES.strings.json, Looker no localiza esta cadena y muestra la etiqueta tal como se define en nuestro archivo de vista: “country”.
Cómo agregar parámetros de configuración de localización al archivo de manifiesto de tu proyecto
Para habilitar la localización en tu proyecto, agrega el parámetro localization_settings al archivo de manifiesto de tu proyecto.
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 cadenas de configuración regional predeterminado determina qué cadenas de tu modelo se localizan. Incluso si una etiqueta o cadena de descripción se define en otro archivo de cadenas de configuración regional, si no está definida en el archivo de cadenas de configuración regional predeterminado, la IU de Looker mostrará la cadena sin localizar.
La configuración regional predeterminada de tu proyecto no debe confundirse con la configuración regional predeterminada para los usuarios de Looker. El administrador de Looker puede establecer una configuración regional predeterminada para la instancia. Si no se establece ningún valor predeterminado, Looker se establecerá de forma predeterminada en en. Si el administrador no ingresa de forma específica un valor de Configuración regional para un usuario o un grupo de usuarios al que pertenece el usuario, Looker asigna al usuario la configuración regional predeterminada de la instancia. Además, si el administrador no estableció una configuración regional de instancias predeterminada, Looker asigna al usuario la configuración regional en.
Por este motivo, a menos que estés seguro de que tu administrador de Looker configurará el valor de Locale para todos los usuarios de Looker, debes establecer el parámetro default_locale de tu proyecto en la configuración regional predeterminada de tu instancia (o en en si no se estableció ningún valor predeterminado) y definir la localización de todas las 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 el modelo permite elementos no localizados:
- Establece el nivel de localización en
strictpara exigir etiquetas localizadas en todos los modelos, exploraciones, vistas y campos de tu proyecto. El IDE de Looker mostrará un error de validación de LookML para los elementos que no tengan etiquetas y las que no estén definidas en el archivo de cadenas de configuración regional predeterminado. - Establece el nivel de localización en
permissivepara permitir elementos sin etiquetas y para habilitar las etiquetas y las descripciones que no estén definidas en el archivo de cadenas de localización predeterminado.
Incluso si quieres el nivel de localización de strict, puede resultar útil establecer el nivel de localización de tu proyecto en permissive cuando lo desarrollas para evitar errores de validación. Una vez que hayas terminado 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 los archivos de cadenas de configuración regional, podrás asignar usuarios a una configuración regional que corresponda a uno de los archivos de cadenas de configuración regional. Esto se puede hacer a nivel de la instancia, el grupo de usuarios o el 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 definidas en el archivo es_ES.strings.json, el administrador de Looker debe establecer el parámetro Configuración regional del usuario en es_ES.
Las configuraciones regionales personalizadas que creas con archivos de cadenas se pueden ingresar en el campo Configuración regional. Para ello, haz clic en el campo y escribe el nombre del archivo de la cadena 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 Usuarios.
Configuración regional para los usuarios de incorporaciones firmados
Puedes incluir el valor de configuración regional de un usuario en una URL incorporada firmada de la misma manera que cualquier otro atributo de usuario. El formato exacto que se requiere para las incorporaciones firmadas depende del lenguaje de programación que se usa para compilar la secuencia de comandos de las URLs de incorporación firmadas, pero el nombre del atributo de usuario es locale. Consulta la página de documentación sobre la Incorporación firmada para obtener más información sobre las URLs de incorporación firmadas y las herramientas para compilar tu URL de incorporación firmada.
Usa la configuración regional en variables líquidas
Como se describió anteriormente, la localización de modelos te permite personalizar la visualización de las etiquetas y descripciones de tu modelo para diferentes configuraciones regionales. Sin embargo, también puedes incluir claves de localización en Variables líquidas, que también te permiten localizar los valores de tus datos.
Por ejemplo, en nuestro archivo de cadenas de configuración regional predeterminado 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"
}
A partir de ahí, podemos usar las claves de localización domestic y international en variables Liquid 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;;
}
Los usuarios con la configuración regional en verán los siguientes resultados:
| Flights Identifier | Flights country | Flights From the US? |
|---|---|---|
| 289 | United States | Domestic |
| 400 | Canada | International |
| 493 | Congo | International |
| 936 | United States | Domestic |
Los usuarios con la configuración regional es_ES verán los siguientes resultados:
| Vuelos Identificador | Vuelos País | Vuelos ¿De Los Estados Unidos? |
|---|---|---|
| 289 | United States | Nacional |
| 400 | Canada | Internacional |
| 493 | Congo | Internacional |
| 936 | United States | Nacional |
Los usuarios con la configuración regional es_ES ven los datos "internacionales" y "nacionales" localizados en "Nacional" e "internacional", respectivamente.
También puedes usar Liquid en los filtros del panel de Looker y en los filtros de elementos del panel de Looker para localizar el valor predeterminado en un filtro. Por ejemplo, si un panel de LookML tiene una tarjeta que usa datos de este modelo localizado y hay un filtro en ese mosaico definido en LookML de la siguiente manera:
filters:
flights.from_US: "{{ _localization['domestic'] }}"
Cuando un usuario con la configuración regional en explore el mosaico del panel, se filtrará la exploración según el valor Domestic para el campo Flights From the US?, y la tabla de datos de la exploración incluirá los siguientes resultados:
| Flights Identifier | Flights country | Flights From the US? |
|---|---|---|
| 289 | United States | Domestic |
| 936 | United States | Domestic |
Cuando un usuario con la configuración regional es_ES explora ese mosaico del panel, se filtra la exploración en el valor Nacional del campo Vuelos ¿De Los Estados Unidos?, y la tabla de datos de la exploración incluirá los siguientes resultados:
| Vuelos Identificador | Vuelos País | Vuelos ¿De Los Estados Unidos? |
|---|---|---|
| 289 | United States | Nacional |
| 936 | United States | Nacional |
Comprende cómo se aplican las reglas de localización a los objetos extendidos y mejor definidos
Ten en cuenta que las reglas de localización se aplican cuando extiendes las vistas, las exploraciones o los paneles de LookML, y cuando definiste mejor las vistas o las exploraciones.
Si extendiste o perfeccionaste un objeto y luego agregaste etiquetas o descripciones nuevas, debes proporcionar definiciones de localización en los archivos de cadenas de configuración regional.
Por ejemplo, si tenemos una vista flights:
view: flights {
label: "flight_info"
sql_table_name: flightstats.accidents ;;
...
}
Luego, creamos una nueva vista que extiende la vista flights:
include: "/views/flights.view"
view: flights_enhanced {
extends: [flights]
label: "enhanced_flight_info"
}
En nuestros archivos de cadenas de configuración regional, tendríamos que definir ambas cadenas de etiquetas de vista ("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 etiquetas o descripciones nuevas.