En esta página, se muestra cómo agregar y personalizar un elemento de panel de LookML de type: looker_boxplot con parámetros de panel de LookML en un archivo dashboard.lkml.
Para obtener información sobre cómo crear un diagrama de caja a través de la IU de Looker, consulta la página de documentación Opciones de diagramas de caja.
Ejemplo de uso
Un N indica que se requiere un valor numérico. Las comillas simples indican texto descriptivo y no deben incluirse en el código activo.
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
limit: N
filters:
view_name.field_name: 'looker filter expression'
listen:
dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]
## SERIES PARAMETERS
color_application:
collection_id: 'collection ID'
palette_id: 'palette ID'
options:
reverse: true | false
## STYLE PARAMETERS
show_view_names: true | false
## X-AXIS PARAMETERS
show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false
## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false
## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'
Definiciones de los parámetros
| Nombre del parámetro | Descripción | |
|---|---|---|
| Parámetros básicos | ||
name (para elementos) |
Crea un elemento | |
title (para elementos) |
Cambia la forma en que se muestra el nombre de un elemento a los usuarios. | |
type (para elementos) |
Determina el tipo de visualización que se usará en el elemento. | |
height (para elementos) |
Define la altura de un elemento, en unidades de tile_size, para los paneles layout: tile y layout: static |
|
width (para elementos) |
Define el ancho de un elemento, en unidades de tile_size, para los paneles layout: tile y layout: static |
|
top |
Define la posición de arriba hacia abajo de un elemento, en unidades de tile_size, para paneles layout: static |
|
left |
Define la posición de izquierda a derecha de un elemento, en unidades de tile_size, para los paneles de layout: static |
|
row |
Define la posición de arriba hacia abajo de un elemento, en unidades de filas, para los paneles layout: newspaper |
|
col |
Define la posición de izquierda a derecha de un elemento, en unidades de columnas, para los paneles de layout: newspaper |
|
refresh (para elementos) |
Establece el intervalo en el que se actualizará automáticamente el elemento | |
note |
Inicia una sección de LookML para definir una nota para un elemento. Este parámetro tiene los subparámetros text, state y display. |
|
| Parámetros de consulta | ||
model |
Define el modelo que se usará para la consulta del elemento | |
explore (para elementos) |
Define la exploración que se usará para la consulta del elemento | |
fields |
Define los campos que se usarán para la consulta del elemento. Esto se puede usar en lugar de dimensions y measures. |
|
dimensions |
Define las dimensiones que se usarán para la consulta del elemento | |
measures |
Define las mediciones que se usarán para la consulta del elemento | |
sorts |
Define las ordenaciones que se usarán para la consulta del elemento | |
limit |
Define el límite de filas que se usará para la consulta del elemento | |
filters (para elementos) |
Define los filtros que no se pueden cambiar para la consulta del elemento. | |
listen |
Define los filtros que se pueden cambiar para la consulta del elemento, si se crearon filters (para el panel) |
|
query_timezone |
Define la zona horaria que se debe usar cuando se ejecuta la consulta. | |
hidden_fields |
Especifica los campos que se usarán en la consulta, pero que se ocultarán en el gráfico | |
| Parámetros de series | ||
color_application |
Aplica una colección y una paleta de colores al gráfico | |
| Parámetros de estilo | ||
show_view_names |
Muestra u oculta los nombres de las vistas en las etiquetas de los gráficos. | |
| Parámetros del eje X | ||
show_x_axis_label |
Muestra u oculta la etiqueta del eje X. | |
x_axis_label |
Define una etiqueta personalizada para el eje X | |
show_x_axis_ticks |
Muestra valores en el eje X | |
x_axis_gridlines |
Extiende las líneas de cuadrícula desde el eje X. | |
x_axis_reversed |
Invierte la dirección del eje X | |
x_axis_zoom |
Especifica si se permite el zoom a lo largo del eje X | |
| Parámetros del eje Y | ||
show_y_axis_labels |
Muestra u oculta la etiqueta del eje Y | |
y_axis_labels |
Define una etiqueta personalizada para el eje Y | |
show_y_axis_ticks |
Muestra valores en el eje Y | |
y_axis_gridlines |
Extiende las líneas de cuadrícula desde el eje Y. | |
y_axis_min |
Define un valor mínimo para el eje Y | |
y_axis_max |
Define un valor máximo para el eje Y | |
y_axis_tick_density |
Habilita la opción para establecer una densidad de marcas personalizada del eje Y con el parámetro y_axis_tick_density_custom |
|
y_axis_tick_density_custom |
Define la densidad de las marcas del eje Y cuando y_axis_tick_density se establece en custom |
|
y_axis_reversed |
Invierte la dirección del eje Y. | |
y_axis_value_format |
Define el formato de número de los valores del eje Y | |
y_axis_zoom |
Especifica si se permite el zoom a lo largo del eje Y. Se inhabilita si x_axis_zoom: false. |
|
| Parámetros de configuración de visualización avanzada | ||
advanced_viz_config |
Acepta un fragmento de JSON de HighCharts que puede anular varios parámetros de configuración de visualización. | |
Parámetros básicos
Cuando definas un elemento de panel de LookML, debes especificar valores para, al menos, los parámetros básicos name y type. Otros parámetros básicos, como title, height y width, afectan la apariencia y la posición de un elemento en un panel.
name
En esta sección, se hace referencia al parámetro
nameque forma parte de un elemento de panel.
nametambién se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.
Cada declaración name crea un nuevo elemento de panel y le asigna un nombre.
Los nombres de los elementos deben ser únicos. A veces, se hace referencia a los nombres en el parámetro
elements
cuando usas paneles
layout: grid
o en el parámetro
group de los elementos secundarios
cuando organizas elementos en un grupo de tarjetas
(type: group).
- name: orders_by_date
title
En esta sección, se hace referencia al parámetro
titleque forma parte de un elemento de panel.
titletambién se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.
titletambién se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.
El parámetro title te permite cambiar la forma en que se mostrará el nombre de un elemento a los usuarios. Si no se especifica, el título se establece de forma predeterminada en el elemento name.
Considera el siguiente ejemplo:
- name: sales_overview
title: '1) Sales Overview'
Si usaras este formato, en lugar de que el elemento aparezca como Descripción general de las ventas, aparecería como 1) Descripción general de las ventas.
type
En esta sección, se hace referencia al parámetro
typeque forma parte de un elemento de panel.
typetambién se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.
typetambién se puede usar como parte de una unión, que se describe en la página de documentación del parámetrotype(para uniones).
typetambién se puede usar como parte de una dimensión, que se describe en la página de documentación Tipos de dimensiones, filtros y parámetros.
typetambién se puede usar como parte de una medición, que se describe en la página de documentación Tipos de mediciones.
El parámetro type determina el tipo de visualización que se usará en el elemento.
- name: element_name
type: text | looker_grid | table | single_value | looker_single_record |
looker_column | looker_bar | looker_scatter | looker_line | looker_area |
looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
looker_waterfall | looker_wordcloud | looker_boxplot | button | group
Consulta la página de documentación de type (para paneles de LookML) para obtener una descripción general de los diferentes tipos de elementos de panel de LookML.
height
En esta sección, se hace referencia al parámetro
heightque forma parte de un elemento de panel.
heighttambién se puede usar como parte de una fila del panel, que se describe en la página de documentación Parámetros del panel.
Para paneles con diseños tile o static
El parámetro height define la altura de un elemento, en unidades de tile_size (que se define en píxeles), para los paneles layout: tile y layout: static.
Por ejemplo, el siguiente código especifica tile_size: 100 y height: 4, lo que hace que el elemento orders_by_date tenga 400 píxeles de altura.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
Para paneles con diseño de newspaper
El parámetro height define la altura de un elemento, en unidades de fila, para los paneles de layout: newspaper.
Un panel con diseño de periódico tiene una altura de elemento predeterminada de 6 filas, o alrededor de 300 píxeles. La altura mínima es de 1 fila para los paneles con un parámetro preferred viewer establecido en dashboards-next. La altura mínima es de 2 filas para los paneles con un parámetro preferred viewer establecido en dashboards.
Por ejemplo, el siguiente código establece que un elemento tenga 12 filas de alto, o el doble de alto que otros elementos que se establecen en el valor predeterminado:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
En esta sección, se hace referencia al parámetro
widthque forma parte de un elemento de panel.
widthtambién se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.
El parámetro width define el ancho de un elemento, en unidades de tile_size, para los paneles layout: tile y layout: static.
Por ejemplo, el siguiente código especifica tile_size: 100 y width: 4, lo que hace que el elemento orders_by_date tenga 400 píxeles de ancho.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
El parámetro width define el ancho de un elemento, en unidades de columnas, para los paneles de layout: newspaper.
Un panel con diseño de periódico tiene un ancho predeterminado de 24 columnas.
Por ejemplo, el siguiente código establece el elemento en la mitad del ancho del panel:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
El parámetro top define la posición de arriba abajo de un elemento, en unidades de tile_size, para los paneles de layout: static.
Por ejemplo, el siguiente código especifica tile_size: 100 y top: 4, lo que posiciona el borde superior del elemento orders_by_date a 400 píxeles de la parte superior del panel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
El parámetro left define la posición de izquierda a derecha de un elemento, en unidades de tile_size, para los paneles de layout: static.
Por ejemplo, el siguiente código especifica tile_size: 100 y left: 4, lo que posiciona el borde izquierdo del elemento orders_by_date a 400 píxeles del lado izquierdo del panel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
Para los paneles layout: newspaper,
el parámetro row define la fila en la que se coloca el borde superior de un
elemento. Si el elemento se coloca dentro de un grupo de tarjetas con el parámetro group, row define la posición de la fila del elemento en relación con la parte superior del contenedor del grupo (row: 0).
Un panel comienza con la fila 0 en la parte superior. Un panel con diseño de periódico tiene una altura de elemento predeterminada de 6 filas, lo que significa que los elementos del panel en la parte superior de un panel (row: 0) ocuparían las filas de la 0 a la 5 de forma predeterminada.
Cada fila tiene 50 píxeles de alto, lo que significa que la altura predeterminada del elemento de 6 filas es de 300 píxeles.
Por ejemplo, el siguiente código establece un elemento que se colocará en la segunda fila de elementos del panel, suponiendo que los elementos se establecen en la altura predeterminada:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
Para los paneles layout: newspaper,
el parámetro col define la columna en la que se coloca el borde izquierdo del
elemento. Si el elemento se coloca dentro de un grupo de tarjetas con el parámetro group, col define la posición de la columna del elemento en relación con el borde izquierdo del contenedor del grupo (col: 0).
Los paneles se dividen en 24 columnas. Un panel comienza con la columna 0 a la izquierda del panel. Un panel con diseño de periódico tiene un ancho de elemento predeterminado de 8 columnas, lo que significa que los elementos del panel que se encuentran a la izquierda (col: 0) ocuparían las columnas de la 0 a la 7 de forma predeterminada.
Por ejemplo, el siguiente código establece que un elemento se coloque en la tercera columna de elementos del panel:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
En esta sección, se hace referencia al parámetro
refreshque forma parte de un elemento de panel.
refreshtambién se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.
El parámetro refresh permite que un elemento se vuelva a cargar automáticamente de forma periódica, lo que recupera datos actualizados. Esto suele ser útil en entornos en los que se muestra un panel de forma constante, como en la TV de una oficina. Ten en cuenta que el panel debe estar abierto en una ventana del navegador para que este parámetro tenga efecto. Este parámetro de configuración no se ejecuta en segundo plano para "precalentar" la caché del panel.
La frecuencia de actualización puede ser cualquier cantidad (sin decimales) de segundos, minutos, horas o días. Por ejemplo:
- name: orders_by_date
refresh: 2 hours
Ten cuidado cuando configures intervalos de actualización cortos. Si la consulta detrás del elemento consume muchos recursos, es posible que ciertos elementos sobrecarguen tu base de datos más de lo deseado.
note
Puedes agregar notas descriptivas a los elementos de la siguiente manera:
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note tiene los subparámetros text, state y display.
text
El subparámetro text especifica el texto que se muestra en la nota. El texto se puede localizar.
state
El subparámetro state determina si la nota se collapsed o expanded si es demasiado grande para caber en una sola fila dentro del ancho del elemento. Si eliges collapsed y la nota es demasiado larga, terminará con puntos suspensivos en los que se puede hacer clic (...) para leer la nota completa.
display
El subparámetro display determina dónde se muestra la nota en un elemento. above coloca la nota en la parte superior de un elemento, below la coloca en la parte inferior de un elemento y hover requiere que el usuario coloque el cursor sobre el elemento para ver la nota.
Parámetros de consulta
Cuando defines un elemento de panel de LookML, debes especificar valores para, al menos, los parámetros de consulta model y explore.
Los elementos de type: looker_boxplot también requieren al menos una dimensión y dos, tres o cinco de los siguientes tipos de mediciones (que se deben indicar en este orden):
- Mínimo: Es una medida que representa el valor mínimo de los datos. Esto se puede definir en LookML como una medición de
type: min. - Percentil 25: Es una medida que representa el percentil 25 o el primer cuartil. Un cuarto de los valores de tus datos es menor o igual que este valor. Esto se puede definir en LookML como una medición de
type: percentilecon el valor depercentileestablecido en25. - Mediana: Es una medida que representa la mediana o el punto medio del conjunto de datos, o el segundo cuartil. La mitad de los valores de tus datos son menores o iguales que este valor. Esto se puede definir en LookML como una medición de
type: median. - Percentil 75: Es una medida que representa el percentil 75 o el tercer cuartil. Tres cuartos de los valores de tus datos son menores o iguales que este valor. Esto se puede definir en LookML como una medición de
type: percentilecon el valor depercentileestablecido en75. - Máximo: Es una medida que representa el valor máximo. Esto se puede definir en LookML como una medición de
type: max.
Puedes usar el parámetro fields o ambos parámetros dimensions y measures para especificar las dimensiones y medidas en las que se basa un elemento de diagrama de caja. Consulta la sección Cómo crear un diagrama de caja de la página de documentación Opciones de diagramas de caja para obtener más información sobre cómo crear un diagrama de caja en la IU de Looker.
Puedes usar los otros parámetros de consulta que se describen en esta sección para controlar la forma en que se muestran los datos en un elemento de panel.
model
El parámetro model define el modelo que se usará para la consulta de elementos. Si no se especifica, se usará de forma predeterminada el modelo en el que reside el panel.
- name: orders_by_date
model: ecommerce
El parámetro model acepta constantes de LookML. Puedes definir una constante en el archivo de manifiesto de tu proyecto y, luego, usar la sintaxis "@{constant_name}" para establecer la constante como el valor de model. Usar una constante te permite definir el nombre de un modelo en un solo lugar, lo que es particularmente útil si actualizas el nombre de un modelo que usan varios elementos de panel.
Para obtener más información y un ejemplo de cómo usar constantes con paneles de LookML, consulta la página de documentación del parámetro constant.
explore
En esta sección, se hace referencia al parámetro
exploreque forma parte de un elemento de panel.
exploretambién se puede usar como parte de un modelo, que se describe en la página de documentación del parámetroexplore.
exploretambién se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.
El parámetro explore define la exploración que se usará para la consulta del elemento.
- name: orders_by_date
explore: order
El parámetro explore acepta constantes de LookML. Puedes definir una constante en el archivo de manifiesto de tu proyecto y, luego, usar la sintaxis "@{constant_name}" para establecer la constante como el valor de explore. Usar una constante te permite definir el nombre de una exploración en un solo lugar, lo que es particularmente útil si actualizas el nombre de una exploración que usan varios elementos de panel.
Para obtener más información y un ejemplo de cómo usar constantes con paneles de LookML, consulta la página de documentación del parámetro constant.
fields
El parámetro fields define los campos que se usarán para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar los campos.
## single field example
- name: orders_by_date
fields: order.order_date
## multiple fields example
- name: orders_by_date
fields: [order.order_date, order.order_count]
Si usas el parámetro fields, no necesitas usar los parámetros dimensions y measures.
dimensions
El parámetro dimensions define la dimensión o las dimensiones que se usarán para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas dimensions si la consulta no tiene ninguno.
## single dimension example
- name: orders_by_date
dimensions: order.order_date
## multiple dimension example
- name: orders_by_date
dimensions: [order.order_date, customer.name]
measures
El parámetro measures define la medición o las mediciones que se usarán para la consulta de elementos. Usa la sintaxis view_name.measure_name para especificar la medición. No incluyas measures si la consulta no tiene ninguno.
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
El parámetro sorts define el comportamiento de ordenamiento para la consulta del elemento. Enumera primero el campo de ordenamiento principal, seguido de los campos de ordenamiento secundarios. Usa la sintaxis view_name.field_name para especificar la dimensión o la medición por la que se ordenará.
Si omites el parámetro sorts, el elemento usa el orden de clasificación predeterminado de Looker. Las ordenaciones ascendentes no requieren un sufijo, mientras que las descendentes requieren el sufijo desc.
En el siguiente ejemplo, se define un solo orden:
- name: orders_by_date
sorts: order.order_date desc
En el siguiente ejemplo, se definen varias clasificaciones:
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
Si dinamizas las dimensiones, puedes ordenar los resultados de la consulta especificando el nombre de la medición, la dirección de ordenamiento y el número de índice basado en 0 de la columna de destino en la tabla de datos. Por ejemplo, el siguiente elemento ordena por la primera columna dinámica con el índice 0:
- name: orders_by_category
sorts: [orders.count desc 0]
Para ordenar por el total de la fila, especifica el índice de la columna de totales. Por ejemplo, el siguiente elemento ordena por el total de la fila con el índice 2, que representa la columna de totales para una consulta con dos columnas dinámicas:
- name: orders_by_cohort
sorts: [users.count desc 2]
limit
El parámetro limit define el límite de filas que se debe usar para la consulta de elementos. El límite se aplica a la cantidad de filas antes de que se apliquen las tablas dinámicas.
- name: orders_by_date
limit: 100
filters
En esta sección, se hace referencia al parámetro
filtersque forma parte de un elemento de panel.
filterstambién se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.
filterstambién se puede usar como parte de una medición, que se describe en la página de documentación del parámetrofilters.
El parámetro filters define los filtros no modificables que se deben usar para la consulta del elemento. Si quieres filtros que un usuario pueda cambiar en el panel, debes configurarlos con filters para paneles y, luego, aplicarlos a los elementos con listen.
La sintaxis de filters es la siguiente:
- name: element_name
filters:
orders.created_date: 2020/01/10 for 3 days
orders.status: Shipped
# You can create multiple filter statements
Cada filtro puede aceptar una expresión de filtro de Looker o una constante de valor. También puedes usar las variables de Liquid _localization o _user_attributes en la expresión de filtro para obtener valores de filtro flexibles.
listen
Los filtros de panel permiten que los usuarios definan mejor de forma interactiva los datos que se muestran en los elementos de panel. Define filtros de paneles con el parámetro filters para paneles de LookML. Luego, usa el parámetro listen para vincular los elementos del panel al filtro del panel.
La sintaxis de listen es la siguiente:
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
Agrega el parámetro listen a un elemento y, luego, proporciona el nombre del filtro seguido de dos puntos y una referencia al campo al que se debe aplicar el filtro, con la sintaxis view_name.field_name. Por ejemplo, puedes crear un filtro llamado Fecha que requiera que el usuario ingrese una fecha en el campo de filtro de la IU. Luego, puedes aplicar el valor que ingresa el usuario al elemento orders_by_date de la siguiente manera:
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
Si el filtro que se escucha se configura con el parámetro vis_filter: true, el control de filtro aparece en una barra de filtros directamente en la parte superior de esa tarjeta de visualización, en lugar de en la barra de filtros del panel superior.
Para obtener más ejemplos de cómo usar los parámetros filters y listen para aplicar filtros de panel a elementos de panel individuales, consulta Cómo compilar paneles de LookML.
query_timezone
El parámetro query_timezone especifica la zona horaria en la que se ejecutará la consulta. Las opciones de zona horaria se muestran en la página de documentación Valores para timezone. Si quieres que la consulta se ejecute con la zona horaria del visualizador, puedes asignar el valor como user_timezone.
- name: orders_by_date
query_timezone: America/Los Angeles
- name: orders_by_customer
query_timezone: user_timezone
hidden_fields
El parámetro hidden_fields indica qué campos, si los hay, se usan en la consulta, pero se ocultan en el gráfico. Los campos ocultos aparecerán en la sección de la tabla de datos de una exploración.
hidden_fields: [inventory_items.count, distribution_centers.id]
Parámetros de series
color_application
El parámetro color_application y sus subparámetros collection_id y palette_id se pueden usar para aplicar una colección y una paleta de colores específicas a un elemento de panel. Para obtener una descripción general de las colecciones de colores nativas de Looker, consulta la página de documentación Colecciones de colores.
Si tienes el ID de la colección y el ID de la paleta que quieres usar, puedes ingresarlos en los subparámetros collection_id y palette_id. Un ID de colección o de paleta puede ser un código alfanumérico o basarse en el nombre de la colección de colores. Los códigos alfanuméricos se usan para las colecciones nativas de Looker. Son específicas de la instancia y se ven de la siguiente manera:
color_application:
collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1
Las colecciones de colores personalizadas usan IDs de colecciones y paletas según el nombre de la colección de colores, que son portátiles entre instancias y se ven de la siguiente manera:
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
También puedes usar la IU para encontrar los colores, las colecciones o las paletas que quieras y generar el LookML para agregarlos a tu panel. Navega a un fragmento de contenido definido por el usuario (como una vista, un panel o una exploración) y aplica los colores, la colección o la paleta que quieras a la visualización de ese contenido con la IU. Una vez que lo hayas hecho, puedes seguir los pasos para obtener el LookML del panel, copiar el LookML que se produjo y pegarlo en la sección color_application.
De forma predeterminada, el primer color de la paleta designada se aplica a todo el elemento de diagrama de caja. El subparámetro opcional reverse cambia la aplicación al último color de la paleta.
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
options:
reverse: true
Parámetros de estilo
show_view_names
El parámetro show_view_names determina si los nombres de las vistas se muestran en las etiquetas de los gráficos, como los nombres de los ejes y de las columnas.
show_view_names: true | false
## default value: true
Parámetros del eje X
show_x_axis_label
Este parámetro determina si se muestra la etiqueta del eje X.
show_x_axis_label: true | false
## default value: true
x_axis_label
Este parámetro especifica una etiqueta para el eje X. Puedes usar este parámetro cuando show_x_axis_label se establece en true.
x_axis_label: Order Date
show_x_axis_ticks
Este parámetro determina si se muestran las etiquetas de valor en el eje X.
show_x_axis_ticks: true | false
## default value: true
x_axis_gridlines
Este parámetro determina si las líneas de cuadrícula se extienden desde el eje X.
x_axis_gridlines: true | false
## default value: false
x_axis_reversed
Este parámetro establece la dirección del eje X. Cuando x_axis_reversed se establece en false, los valores aumentan de izquierda a derecha. Cuando se establece en true, los valores disminuyen de izquierda a derecha.
x_axis_reversed: true | false
x_axis_zoom
Este parámetro especifica si los usuarios pueden acercar el eje X de la visualización. Cuando x_axis_zoom se establece en true, el zoom está disponible. Cuando x_axis_zoom se establece en false, el zoom no está disponible.
Si x_axis_zoom se establece en false, se inhabilita y_axis_zoom.
x_axis_zoom: true | false
# default value: true
Parámetros del eje Y
show_y_axis_labels
Este parámetro determina si se muestran etiquetas en el eje Y.
show_y_axis_labels: true | false
## default value: true
y_axis_labels
Este parámetro especifica una etiqueta para el eje Y. Puedes usar este parámetro cuando show_y_axis_labels se establece en true.
y_axis_labels: ['label']
show_y_axis_ticks
Este parámetro determina si se muestran los valores en el eje Y.
show_y_axis_ticks: true | false
## default value: true
y_axis_gridlines
Este parámetro determina si las líneas de cuadrícula se extienden desde el eje Y.
y_axis_gridlines: true | false
## default value: true
y_axis_min
Este parámetro define el valor mínimo para el eje Y.
y_axis_min: ['10']
## default value: true
y_axis_max
Este parámetro define el valor máximo para el eje Y.
y_axis_max: ['100']
## default value: true
y_axis_tick_density
Este parámetro habilita la opción para establecer una densidad de marcas en el eje Y. Establece y_axis_tick_density en custom para habilitar esta función y, luego, usa el parámetro y_axis_tick_density_custom para establecer la densidad.
y_axis_tick_density: default | custom
## default value: default
y_axis_tick_density_custom
Este parámetro te permite establecer la densidad de las marcas del eje Y si y_axis_tick_density se establece en custom. Acepta un número entero que representa la cantidad de marcas que deseas que aparezcan.
y_axis_tick_density_custom: 10
## default value: 5
y_axis_reversed
Este parámetro establece la dirección del eje Y. Cuando y_axis_reversed se establece en false, los valores aumentan a medida que suben por el eje. Cuando se establece en true, los valores disminuyen a medida que se desciende por el eje.
## y_axis_reversed: true | false
# default value: false
y_axis_value_format
Este parámetro especifica el formato de número de los valores del eje Y, independientemente de la dimensión o medición subyacente. El parámetro acepta el formato al estilo de Excel. Si no se especifica ningún formato, el valor se mostrará en el formato de la dimensión o medición subyacente.
El valor que especifiques para el parámetro y_axis_value_format debe estar entre comillas dobles:
y_axis_value_format: "*00#.00"
Puedes leer la guía completa de Excel sobre cómo especificar estos formatos en su documentación. Sin embargo, por el momento, Looker no admite el formato de fecha ni el de color.
Estas son algunas de las opciones de formato más comunes:
| Formato de valor | Significado |
|---|---|
# |
Número entero (123) |
*00# |
Número entero rellenado con ceros hasta 3 posiciones (001) |
0.## |
Número con hasta 2 decimales (1., 1.2 o 1.23) |
0.00 |
Número con exactamente 2 decimales (1.23) |
*00#.00 |
Número con ceros a la izquierda hasta 3 posiciones y exactamente 2 decimales (01.23) |
#,### |
Número con coma entre miles (1,234) |
#,##0.00 |
Número con coma entre miles y 2 decimales (1,234.00) |
0.000,," M" |
Número en millones con 3 decimales (1.234 M). La división por 1 millón se realiza automáticamente. |
$# |
Dólares con 0 decimales ($123) |
$0.00 |
Dólares con 2 decimales ($123.00) |
$#,##0.00 |
Dólares con coma entre miles y 2 decimales ($1,234.00) |
#% |
Porcentaje con 0 decimales (1%). La multiplicación por 100 se realiza automáticamente. |
0.00% |
Porcentaje con 2 decimales (1.00%). La multiplicación por 100 se realiza automáticamente. |
0.00\% |
Porcentaje con 2 decimales (1.00%). La multiplicación por 100 NO se realiza automáticamente. |
y_axis_zoom
Este parámetro especifica si los usuarios pueden acercar el eje Y de la visualización. Cuando y_axis_zoom se establece en true, el zoom está disponible.
Cuando y_axis_zoom se establece en false, los usuarios no pueden acercar partes más pequeñas del eje Y. Sin embargo, es posible que los usuarios puedan acercar partes más pequeñas del eje X si el parámetro x_axis_zoom se establece en true.
Si x_axis_zoom se establece en false, se inhabilita y_axis_zoom.
y_axis_zoom: true | false
# default value: true
Configuración de visualización avanzada
Los parámetros que se describen en esta sección corresponden a las anulaciones opcionales de la configuración del gráfico, que puedes aplicar a un gráfico haciendo clic en el botón Editar configuración del gráfico en la sección Trazar del editor de visualizaciones.
advanced_vis_config
Este parámetro acepta un fragmento de JSON de HighCharts que anula varios parámetros de configuración de visualización y abre nuevas funciones. Consulta la página de documentación Personaliza visualizaciones con el editor de configuración de gráficos para ver ejemplos de uso de JSON de HighCharts para lograr casos de uso comunes.
advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"
# This example changes the color to orange for any series value that is greater than or equal to 50.
# default value: null