Los paneles se pueden crear de dos maneras. Los paneles definidos por el usuario se crean a través de la IU de Looker y se describen en la página de documentación Crea paneles definidos por el usuario. Los paneles también se pueden crear con LookML y modificar su configuración general como se explica en esta página.
Un panel tiene varias opciones de configuración que se aplican a todo el panel, que se describen aquí. También contendrá un grupo de visualizaciones de datos, denominadas elementos. La apariencia de estos elementos se describe en las páginas de documentación de cada tipo de elemento.
Ejemplo de uso
- dashboard: dashboard_name
preferred_viewer: dashboards | dashboards-next
title: "desired dashboard title"
description: "desired dashboard description"
extends: name_of_dashboard_being_extended
extension: required
layout: tile | static | grid | newspaper
rows:
- elements: [element_name, element_name, ...]
height: N
tile_size: N
width: N
refresh: N (seconds | minutes | hours | days)
auto_run: true | false
# DASHBOARD FILTER PARAMETERS
crossfilter_enabled: true | false
filters_bar_collapsed: true | false
filters_location_top: true | false
filters:
- name: filter_name
title: "desired filter title"
type: field_filter | number_filter | date_filter | string_filter
model: model_name
explore: explore_name
field: view_name.field_name
default_value: Looker filter expression
allow_multiple_values: true | false
required: true | false
ui_config:
type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
relative_timeframes | advanced
display: inline | popover | overflow
options:
min: N
max: N
- value options
listens_to_filters:
- filter_name
field: view_name.field_name
# EMBEDDED DASHBOARD PARAMETERS
embed_style:
background_color: "css_color"
show_title: true | false
title_color: "css_color"
show_filters_bar: true | false
tile_background_color: "css_color"
tile_text_color: "css_color"
# ELEMENTS PARAMETERS
elements:
# One or more element declarations
Definiciones de los parámetros
Los parámetros con la etiqueta UNSUPPORTED BY LEGACY solo se aplican cuando un panel se renderiza mediante la experiencia predeterminada del panel, ya sea mediante preferred_viewer: dashboards-next
o convirtiendo un panel heredado de LookML en un panel definido por el usuario y, luego, actualizando el panel definido por el usuario.
Nombre del parámetro | Descripción |
---|---|
dashboard |
Crea un panel. |
preferred_viewer |
Elige renderizar un panel como panel o panel heredado. |
title (para el panel) |
Cambia la forma en que se muestra el nombre del panel a los usuarios. |
description (para el panel) |
Agrega una descripción del marcador de posición que se usará si el panel se convierte en un panel definido por el usuario. |
extends |
Base el panel de LookML en otro. |
extension |
Exigir que otro panel extienda el panel |
layout |
Define la forma en que el panel colocará elementos. |
rows |
Inicia una sección de LookML para definir los elementos que deben incluirse en cada fila de un panel layout: grid . |
elements (para filas) |
Define los elementos que se deben incluir en una fila del panel de un layout: grid . |
height (para filas) |
Define la altura de una fila para un panel layout: grid . |
tile_size |
Define el tamaño de una tarjeta para un panel layout: tile . |
width (para el panel) |
Define el ancho del panel para un panel layout: static . |
refresh (para el panel) |
Establezca el intervalo de actualización de los elementos del panel. |
auto_run |
Determina si los paneles se ejecutan automáticamente cuando se abren o se vuelven a cargar inicialmente. |
Parámetros de filtro | |
crossfilter_enabled |
NO ES COMPATIBLE CON LAS LEYES: Habilita o inhabilita el filtrado para un panel que también use preferred_viewer: dashboards-next . |
filters_bar_collapsed |
ADDED 21.16
UNSUPPORTED BY LEGACY Establezca la barra de filtros del panel como predeterminada contraída o expandida para un panel que también usa preferred_viewer: dashboards-next . |
filters_location_top |
ADDED 22.8
UNSUPPORTED BY LEGACY Establezca la ubicación de la barra de filtros del panel en arriba o derecha para un panel que también use preferred_viewer: dashboards-next . |
filters (para el panel) |
Inicia una sección de LookML para definir filtros del panel. |
name (para filtros) |
Crear un filtro |
title (para filtros) |
Cambia la forma en que se muestra un nombre de filtro a los usuarios. |
type (para filtros) |
Determine el tipo de filtro que se utilizará. |
default_value |
Establece un valor predeterminado para un filtro, si lo deseas. |
allow_multiple_values |
Limita los usuarios a un solo valor de filtro. |
required |
Exigir que los usuarios ingresen un valor de filtro para ejecutar el panel |
ui_config |
UNSUPPORTED BY LEGACY Configura los controles de filtros que están disponibles cuando los usuarios ven un panel de LookML que se renderiza en la nueva experiencia del panel, con preferred_viewer configurado como dashboards-next (no un panel heredado, con preferred_viewer configurado como dashboards ). Tiene subparámetros type , display y options . |
model (para filtros) |
Especifica el modelo que contiene el campo subyacente de un filtro type: field_filter . |
explore (para filtros) |
Especifica la exploración que contiene el campo subyacente de un filtro type: field_filter . |
field |
Especifica el campo subyacente de un filtro type: field_filter . |
listens_to_filters |
Sugerencias limitadas para los filtros del panel de field_filter en función de lo que el usuario ingresa en otros filtros del panel de type: field_filter .
|
Parámetros incorporados del panel | |
embed_style |
Inicia una sección de LookML para definir las personalizaciones incorporadas del panel. |
background_color |
Establece un color de fondo para un panel incorporado. |
show_title |
Especifica si el título del panel es visible en un panel incorporado. |
title_color |
Establece el color del título de un panel incorporado. |
show_filters_bar |
Especifica si la barra de filtros está visible en un panel incorporado. |
tile_background_color |
Establece el color de fondo del mosaico de un panel incorporado. |
tile_text_color |
Establece el color del texto de mosaico de un panel incorporado. |
Parámetros del elemento | |
elements (para el panel) |
Inicia una sección de LookML para definir los elementos del panel. |
dashboard
El parámetro dashboard
declara un nuevo panel y especifica un nombre para el panel. La cantidad máxima de caracteres es de 255, y los caracteres permitidos son letras (A-Z), números (0-9), guiones (-) y guiones bajos (_). Por lo general, se recomienda colocar cada panel de LookML en su propio archivo de LookML, pero es posible declarar varios paneles en un solo archivo.
- dashboard: sales_overview
Para mostrar cualquier información, un panel requiere que se agregue al menos un elemento mediante el parámetro elements
.
preferred_viewer
El parámetro preferred_viewer
te permite elegir el formato para ver y descargar un panel. Acepta los siguientes valores:
dashboards
: El procesador basado en AngularJS para paneles heredadosdashboards-next
: El procesador basado en React para la experiencia predeterminada del panel
Los paneles de LookML con preferred_viewer: dashboards
que se convierten en paneles definidos por el usuario se pueden renderizar mediante la nueva experiencia. Para ello, actualiza el panel definido por el usuario.
title
(para el panel)
En esta sección, se hace referencia al parámetro
title
que forma parte de un panel.
title
también se puede usar como parte de un filtro del panel, que se describe en la seccióntitle
(para filtros) de esta página.
title
también se puede usar como parte de cualquier elemento del panel. Puedes encontrar un ejemplo representativo de su uso en la página de documentación de los elementos del gráfico de columnas.
El parámetro title
te permite cambiar cómo aparecerá el nombre de un panel en las carpetas y en la parte superior del panel. Si no se especifica, el título se establece de forma predeterminada en el nombre del panel. El texto del título se puede localizar.
Considera el siguiente ejemplo:
- dashboard: sales_overview
title: "1) Sales Overview"
Si lo hiciera, en lugar de que el panel aparezca como Descripción general de las ventas, aparecerá como 1) Descripción general de las ventas.
description
(para el panel)
En esta sección, se hace referencia al parámetro
description
que forma parte de un panel.
description
también se puede usar como parte de Explorar, como se describe en la página de documentación del parámetrodescription
(para Explorar).
description
también se puede usar como parte de un campo, como se describe en la página de documentación del parámetrodescription
(para campos).
El parámetro description
te permite agregar una descripción a un panel de LookML.
La descripción se muestra debajo del título del panel en las listas de paneles cuando se visualizan en una carpeta. Si no se especifica una descripción, la lista muestra solo el título del panel.
El texto descriptivo puede localizarse.
extends
Como se describe en la página de documentación Reutilización de códigos con extensiones, el parámetro extends
te permite basar un panel de LookML en otro panel de LookML, lo que posiblemente agregue o anule algunas opciones de configuración. El parámetro extends
acepta el nombre de otro panel de LookML.
Cuando extiendas un objeto, ten en cuenta que las reglas de localización también se aplican a las extensiones. Si extiendes un objeto y luego defines etiquetas o descripciones nuevas, debes proporcionar definiciones de localización en los archivos de strings de configuración regional del proyecto. Consulta la página de documentación Localiza tu modelo de LookML para obtener más información.
extension
Como se describe en esta página, el parámetro extension
indica que el panel debe extenderse por otro panel. Este panel nunca está visible para otros usuarios, pero se puede utilizar como una plantilla para crear otros paneles que sean visibles para otros usuarios. El parámetro extension
solo acepta el valor required
. Si no se incluye el parámetro extension
, no se requiere una extensión para el panel.
layout
El parámetro layout
establece el método de diseño que Looker usará cuando posicionará elementos del panel. Acepta los siguientes valores:
newspaper
: Los elementos del panel aparecerán en una cuadrícula de 24 columnas. El tamaño predeterminado de un elemento es un ancho de 8 columnas y un alto de 6 filas. Los elementos se pueden configurar a lo largo de esta cuadrícula, especificados por los parámetros de elementoswidth
,height
,row
ycol
. Esta opción de diseño se usa cuando se convierte un panel definido por el usuario en un panel de LookML, además de ser el diseño predeterminado cuando se crea un panel nuevo de LookML a través del IDE de Looker. Además, cuandopreferred_viewer
se establece endashboards-next
,newspaper
es el único diseño que admite la conversión de un panel de LookML a un panel definido por el usuario.grid
: Los elementos del panel aparecerán con anchos dinámicos en función de un conjunto de filas que defina con el parámetrorows
y sus subparámetroselements
yheight
. Cuandopreferred_viewer
se establece endashboards-next
,grid
no admite la conversión de un panel de LookML a un panel definido por el usuario.static
: Los elementos del panel aparecerán en el orden en el que se enumeran en el archivo LookML. Cada elemento del panel se debe colocar de forma manual mediante los parámetrostop
yleft
. Estos parámetros se aplican a todos los tipos de elementos, y los detalles sobre el uso se muestran en las páginas de documentación de cada tipo de visualización individual. Para ver ejemplos representativos de cómo funcionantop
yleft
, consulta la página de documentación Parámetros del gráfico de columnas para paneles de LookML. Cuandopreferred_viewer
se establece endashboards-next
,static
no admite la conversión de un panel de LookML a un panel definido por el usuario.tile
: Los elementos del panel aparecerán en el orden en el que se enumeran en el archivo LookML. El ancho del panel es dinámico y se basa en el ancho del navegador. Los elementos del panel se posicionarán de forma dinámica dentro del navegador para llenar el espacio disponible. Cuandopreferred_viewer
se establece endashboards-next
,tile
no admite la conversión de un panel de LookML a un panel definido por el usuario.
rows
Para los paneles de layout: grid
, el parámetro rows
inicia la sección de LookML en la que defines qué elementos deben ir en qué filas, así como la altura de cada fila. Dentro de cada fila, cada elemento tiene el mismo ancho. Si no enumeras un elemento en esta sección, no aparecerá en el panel.
- dashboard: sales_overview
layout: grid
rows:
- elements: [element_name, element_name, ...]
height: 200
- elements: [element_name, element_name, ...]
height: 300
elements
El parámetro elements
toma una lista de nombres de elementos del panel, separados por comas. Cada declaración elements
crea una fila nueva en el panel. Todos los elementos que se coloquen en una fila tendrán el mismo ancho. Por lo tanto, si ubica 2 elementos seguidos, cada uno ocupará el 50% del espacio disponible. Si coloca 4 elementos en una fila, cada uno ocupará el 25% del espacio disponible, y así sucesivamente.
height
El parámetro height
define la altura de una fila en píxeles. El valor predeterminado es 300.
tile_size
Para los paneles de layout: tile
y layout: static
, la unidad que se usa para determinar el tamaño y la posición de los elementos es el tamaño del mosaico. Tú defines tile_size
en píxeles y el valor predeterminado es 160. Por ejemplo:
- dashboard: sales_overview
layout: tile
tile_size: 100
En esta situación, un elemento de panel con height: 5
y width: 3
tendrá 500 píxeles de alto y 300 píxeles de ancho. Los parámetros height
y width
se aplican a todos los tipos de elementos, y los detalles acerca de su uso aparecen en las páginas de documentación para cada tipo de visualización individual. Para ver un ejemplo representativo de cómo funcionan height
y width
, consulta la página de documentación Parámetros del gráfico de columnas para paneles de LookML.
width
En esta sección, se hace referencia al parámetro
width
que forma parte de un panel.
width
también se puede usar como parte de un elemento del panel. En la página de documentación de los elementos del gráfico de columnas, se proporciona un ejemplo representativo de su uso.
Para los paneles de layout: static
, el parámetro width
define el ancho total del panel que planeas usar en píxeles. El parámetro width
no restringirá el panel a cierto tamaño si defines un elemento demasiado grande o demasiados elementos en una fila. En su lugar, la configuración width
ayuda a mantener el panel centrado en la pantalla. Si no estableces un ancho, el valor predeterminado será 1200.
- dashboard: sales_overview
layout: static
width: 800
refresh
En esta sección, se hace referencia al parámetro
refresh
que forma parte de un panel.
refresh
también se puede usar como parte de un elemento del panel. En la página de documentación de los elementos del gráfico de columnas, se proporciona un ejemplo representativo de su uso.
El parámetro refresh
permite que un panel vuelva a cargarse automáticamente de forma periódica, por lo que se recuperan los datos nuevos. Esto suele ser útil en entornos en los que el panel de control se muestra constantemente, por ejemplo, en la televisión de una oficina. Ten en cuenta que, para que este parámetro tenga efecto, el panel debe estar abierto en una ventana del navegador. Esta configuración no se ejecuta en segundo plano para “precalentar” la caché del panel.
La frecuencia de actualización puede ser cualquier número (sin decimales) de segundos, minutos, horas o días. Por ejemplo:
- dashboard: sales_overview
refresh: 2 hours
Ten cuidado cuando configures intervalos cortos de actualización. Debido a que los paneles pueden contener muchas consultas, algunas de las cuales pueden requerir una gran cantidad de recursos, ciertos paneles pueden agotar la base de datos más de lo deseado.
auto_run
El parámetro auto_run
determina si un panel se ejecutará o no cuando se abra o se vuelva a cargar. El valor predeterminado es verdadero. Si el parámetro se establece como falso, los usuarios deberán presionar el botón Ejecutar para cargar el panel. Por ejemplo, un panel como este se ejecutará automáticamente cuando se abra:
- dashboard: sales_overview
auto_run: true
Independientemente de la configuración de auto_run
, los usuarios siempre deben hacer clic en el botón Ejecutar después de cambiar los valores del filtro. Esto ayuda a evitar las recargas no deseadas cuando un usuario pausa durante un cambio de filtro o quiere modificar varios filtros al mismo tiempo.
crossfilter_enabled
Este parámetro solo se aplica a los paneles de LookML que se procesan con la experiencia predeterminada del panel de Looker si configuras el parámetro
preferred_viewer
comodashboards-next
.
El parámetro crossfilter_enabled
te permite activar o desactivar los filtros cruzados para un panel que también usa preferred_viewer: dashboards-next
. Cuando este parámetro se establece en true
, los usuarios del panel pueden crear filtros cruzados en el panel si hacen clic en ciertos datos.
- dashboard: sales_data
preferred_viewer: dashboards-next
crossfilter_enabled: true
crossfilter_enabled
no tendrá efecto en los paneles de LookML que usen preferred_viewer: dashboards
. Sin embargo, si un panel de LookML que usa crossfilter_enabled
y preferred_viewer: dashboards
se convierte en un panel definido por el usuario y se actualiza, crossfilter_enabled
tendrá efecto en el panel actualizado.
filters_bar_collapsed
Este parámetro solo se aplica a los paneles de LookML que se procesan con la experiencia predeterminada del panel de Looker si configuras el parámetro
preferred_viewer
comodashboards-next
.
El parámetro filters_bar_collapsed
te permite establecer la barra de filtros del panel como contraída o expandida de forma predeterminada para un panel que también usa preferred_viewer: dashboards-next
. Cuando este parámetro se establece en true
, la barra de filtros se contrae de forma predeterminada. Los visitantes del panel pueden expandir la barra de filtros haciendo clic en el ícono de filtros. El valor predeterminado de esta configuración es false
.
- dashboard: sales_data
preferred_viewer: dashboards-next
filters_bar_collapsed: true
filters_bar_collapsed
no tendrá efecto en los paneles de LookML que usen preferred_viewer: dashboards
. Sin embargo, si un panel de LookML que usa filters_bar_collapsed
y preferred_viewer: dashboards
se convierte en un panel definido por el usuario y se actualiza, filters_bar_collapsed
tendrá efecto en el panel actualizado.
filters_location_top
Este parámetro solo se aplica a los paneles de LookML que se procesan con la experiencia predeterminada del panel de Looker si configuras el parámetro
preferred_viewer
comodashboards-next
.
El parámetro filters_location_top
te permite colocar la barra de filtros del panel en la parte superior o la derecha de un panel que también use preferred_viewer: dashboards-next
. Cuando este parámetro se establece en true
, la barra de filtros aparece en la parte superior del panel. Cuando se establece en false
, la barra de filtros aparece a la derecha del panel. El valor predeterminado de esta configuración es true
.
- dashboard: sales_data
preferred_viewer: dashboards-next
filters_location_top: false
filters_location_top
no tendrá efecto en los paneles de LookML que usen preferred_viewer: dashboards
. Sin embargo, si un panel de LookML que usa filters_location_top
y preferred_viewer: dashboards
se convierte en un panel definido por el usuario y se actualiza, filters_location_top
tendrá efecto en el panel actualizado.
filters
En esta sección, se hace referencia al parámetro
filters
que forma parte de un panel.
filters
también se puede usar como parte de un elemento del panel. En la página de documentación de los elementos del gráfico de columnas, se proporciona un ejemplo representativo de su uso.
filters
también se puede usar como parte de una medida, que se describe en la página de documentación del parámetrofilters
.
El parámetro filters
inicia la sección de LookML en la que se definen los filtros del panel. Los filtros aparecen en la parte superior del panel y permiten a los usuarios cambiar los datos que se encuentran detrás de los elementos del panel.
Para que un filtro afecte a un elemento, este debe configurarse en "escuchar" ese filtro mediante el parámetro listen
. Este parámetro se aplica a todos los tipos de elementos, además de type: text
, y los detalles de su uso se muestran en las páginas de documentación de cada tipo de visualización individual. Si deseas obtener un ejemplo representativo de cómo funciona listen
, consulta la página de documentación de Parámetros del gráfico de columnas para paneles de LookML.
Cuando se aplican filtros a un elemento de esta manera, es importante que el filtro type
coincida con el tipo de medición o dimensión que escucha el filtro (para obtener más información, consulta Cómo crear paneles de LookML). Los filtros tienen el siguiente formato:
filters:
- name: filter_name
title: "desired filter title"
type: field_filter | number_filter | date_filter | string_filter
model: model_name
explore: explore_name
field: view_name.field_name
default_value: Looker filter expression
allow_multiple_values: true | false
required: true | false
listens_to_filters:
- filter_name
field: view_name.field_name
name
En esta sección, se hace referencia al parámetro
name
que forma parte de un filtro del panel.
name
también se puede usar como parte de un elemento del panel. En la página de documentación de los elementos del gráfico de columnas, se proporciona un ejemplo representativo de su uso.
Cada declaración name
crea un filtro de panel nuevo y le asigna un nombre. Se hará referencia al nombre en el parámetro listen
de los elementos que se verán afectados por el filtro. El parámetro listen
se aplica a todos los tipos de elementos, además de type: text
, y se muestran detalles de su uso en las páginas de documentación de cada tipo de visualización individual. Si deseas obtener un ejemplo representativo de cómo funciona listen
, consulta la página de documentación de Parámetros del gráfico de columnas para paneles de LookML.
filters:
- name: order_date
title
(para filtros)
En esta sección, se hace referencia al parámetro
title
que forma parte de un filtro del panel.
title
también se puede usar como parte de un panel, como se describe en la seccióntitle
(para el panel) de esta página.
title
también se puede usar como parte de un elemento del panel. En la página de documentación Parámetros del gráfico de columnas para paneles de LookML, se proporciona un ejemplo representativo de su uso.
El parámetro title
te permite cambiar la forma en que los usuarios verán un nombre de filtro en la parte superior de un panel. Si no se especifica, el título se establece de forma predeterminada con el nombre del filtro.
Considera el siguiente ejemplo:
filters:
- name: order_date
title: "Order Date(s)"
Si hiciste esto, en lugar de que el filtro aparezca como Fecha del pedido, aparecerá como Fechas del pedido.
type
En esta sección, se hace referencia al parámetro
type
que forma parte de un filtro del panel.
type
también se puede usar como parte de un elemento del panel, descrito en la página de documentación del parámetrotype
(para paneles de LookML).
type
también se puede usar como parte de una unión, que se describe en la página de documentación del parámetro de parámetrotype
.
type
también se puede usar como parte de una dimensión, que se describe en la página de documentación Dimensión, filtro y tipos de parámetros.
type
también se puede usar como parte de una medida, que se describe en la página de documentación Tipos de medición.
El parámetro type
especifica el tipo de entrada que se colocará en el filtro. Si bien cualquier tipo de entrada (como una fecha) podría escribirse en el filtro type: string_filter
, ser más específico proporciona un widget de filtro más personalizado al usuario. Los 4 tipos de filtro son los siguientes:
field_filter
: Por lo general, debería ser su opción predeterminada cuando puede especificar una dimensión o medición subyacente. Si usastype: field_filter
y asocias el filtro con un campotype:string
, el filtro sugerirá posibles valores de filtro.number_filter
: Permite que el usuario ingrese una expresión o un valor de número o número entero.date_filter
: Permite que el usuario ingrese una expresión o un valor de fecha.string_filter
: Permite que el usuario ingrese texto de formato libre.
field_filter
Sugiere opciones para elegir, cambia su presentación a los usuarios según el campo subyacente que especifique.
Este debería ser el tipo de filtro recomendado en los casos en que quiera hacer sugerencias a los usuarios mientras interactúan con el filtro. La dimensión de la que se extraerán las sugerencias se define con los parámetros explore
y field
, y debe ser un campo de type: string
para generar sugerencias de filtros.
Ten en cuenta que las sugerencias pueden no funcionar si el campo proviene de una tabla derivada, si se usa sql_always_where
en Explorar o si el campo es una medida.
filters:
- name: order_date
type: field_filter
explore: orders
field: orders.order_date # must be of the form view_name.dimension_name
number_filter
No hace sugerencias, permite que el usuario ingrese una expresión o un valor de número entero/número.
filters:
- name: order_value
type: number_filter
date_filter
No hace sugerencias, permite que el usuario ingrese una expresión o un valor de fecha.
filters:
- name: order_date
type: date_filter
string_filter
No realiza sugerencias y permite que el usuario ingrese texto en formato libre.
filters:
- name: customer_name
type: string_filter
default_value
El parámetro default_value
te permite especificar un valor predeterminado para usar en un filtro. Este valor puede ser útil para los usuarios, ya que sugiere un punto de partida razonable.
Asegúrese de que el valor predeterminado coincida con el tipo de filtro que se utiliza. Por ejemplo:
filters:
- name: order_value
type: number_filter
default_value: "50 to 100"
- name: order_date
type: date_filter
default_value: "last 30 days"
- name: customer_name
type: string_filter
default_value: "John Doe"
Puedes usar expresiones de filtro para crear valores predeterminados. En la página de documentación de expresiones de filtro de Looker, se describe con más detalle.
Cuando usas los parámetros default_value
y ui_config
, las expresiones de filtro deben ser compatibles con el valor otorgado al type
subparámetro de ui_config
y los tipos de datos que admiten el valor type
.
También puedes usar las variables líquidas _localization
y _user_attributes
para valores de filtros predeterminados flexibles.
allow_multiple_values
El parámetro allow_multiple_values
te permite controlar si los usuarios pueden seleccionar un solo valor de filtro o varios valores de filtro. Cuando este parámetro se establece en true
(el valor predeterminado), los usuarios pueden seleccionar varios valores para el filtro. Cuando este parámetro se establece en false
, los usuarios pueden seleccionar solo un valor de filtro.
Para los paneles de LookML que usan la experiencia heredada, con un preferred_viewer
establecido en dashboards
, allow_multiple_values
se puede aplicar a los filtros de cualquier type
.
Por ejemplo:
filters:
- name: Order ID
title: Order ID
type: field_filter
allow_multiple_values: true
required: false
model: thelookstore
explore: orders
field: orders.id
required
El parámetro required
te permite solicitar que los usuarios proporcionen un valor para el filtro a fin de ejecutar el panel. De forma predeterminada, los filtros no requieren valores. Si un filtro no requiere un valor y se deja en blanco, los datos simplemente no están restringidos por el campo de filtro. Si un filtro requiere un valor y se deja en blanco, el panel no se ejecutará.
filters:
- name: State
title: State
type: field_filter
required: true
ui_config
Este parámetro solo se aplica a los paneles de LookML que se procesan con la experiencia predeterminada del panel de Looker si configuras el parámetro
preferred_viewer
comodashboards-next
.
El subparámetro ui_config
de filters
le permite establecer la configuración del filtro que se aplica cuando un panel de LookML se ve como un panel (no cuando un panel de LookML se ve como un panel heredado). Para ello, establezca el parámetro preferred_viewer
en dashboards-next
. Esta configuración incluye los tipos de controles de filtro que se usaron, la posición de los controles de filtro y los valores de filtro posibles.
Por ejemplo:
filters:
- name: City
title: City
type: field_filter
default_value: San Francisco
allow_multiple_values: true
required: false
ui_config:
type: button_group
display: inline
options:
- San Francisco
- New York
- Tokyo
model: thelook
explore: order_items
field: users.city
La configuración que especifiques con el subparámetro ui_config
no tendrá efecto en los paneles de LookML con preferred_viewer: dashboards
. Sin embargo, si un panel de LookML que usa ui_config
y preferred_viewer: dashboards
se convierte en un panel definido por el usuario y se actualiza, ui_config
tendrá efecto en el panel actualizado.
Consulta la página de documentación Cómo agregar y editar filtros de panel definidos por el usuario para obtener más información sobre cómo configurar filtros con la IU.
type
El subparámetro type
de ui_config
te permite especificar los tipos de controles de filtro que se muestran cuando los usuarios ven un panel de LookML como un panel (no como un panel heredado).
Según el valor que ingrese para type
, los controles de filtros pueden ser una sola selección o varias.
Los valores que admite
type
dependen de los datos de LookMLtype
asignados al campo en el que filtras.
N
DU = Works with the [`duration`](/looker/docs/2216/reference/param/data-parameter-type-parameter-parameter)
Valor | Descripción | Tipos de datos admitidos |
---|---|---|
Selección múltiple | ||
button_group | El filtro muestra un grupo de botones, con un botón para cada valor especificado con el parámetro options . | DN T ZC YN DI DU |
checkboxes | El filtro muestra las casillas de verificación, con una casilla de verificación para cada valor especificado con el parámetro options . | DN T ZC YN DI DU |
tag_list | El filtro muestra una lista desplegable para cada valor posible especificado con el parámetro options . | S N T ZC DI DU |
range_slider | Para los campos numéricos, el filtro muestra un control deslizante que permite a los usuarios establecer un rango de números como el valor del filtro. Los subparámetros min y max de options se usan para especificar los valores mínimos y máximos posibles del filtro, y el rango predeterminado se puede especificar con el parámetro default_value . | N DI DU |
Selección única | ||
button_toggles | El filtro muestra un grupo de botones, con un botón para cada valor especificado con el parámetro options . | S N T ZC YN DI DU P |
radio_buttons | El filtro muestra los botones de selección, con un botón para cualquier valor y un botón para cada valor especificado con el parámetro options . | S N T ZC YN DI DU P |
dropdown_menu | El filtro muestra un menú desplegable que enumera cada valor posible especificado mediante el parámetro options . El menú desplegable también les ofrece a los usuarios la opción de seleccionar Cualquier valor. | S N T ZC YN DI DU P |
slider | Para los campos numéricos, el filtro muestra un control deslizante que permite a los usuarios elegir un filtro deslizándose entre los valores mínimos y máximos posibles, que se especifican con el parámetro options . | N DI DU |
Fechas | ||
day_picker | El filtro les permite a los usuarios elegir una fecha específica para filtrar. | DT* El control de un solo día se puede usar con la mayoría de los períodos y tipos basados en el tiempo, pero los usuarios solo pueden seleccionar fechas únicas con este tipo de control. |
day_range_picker | El filtro les permite a los usuarios seleccionar una fecha de inicio y una de finalización para filtrar por un período. | DT* Se puede usar el control de período con la mayoría de los períodos y tipos basados en la hora, pero los usuarios solo pueden seleccionar períodos con este tipo de control. |
date_time_range_input | El filtro le permite al usuario filtrar en un rango de fechas y horas. | DT* El control de intervalo de fechas y horas se puede usar con la mayoría de los tipos basados en la hora, y los usuarios deben seleccionar ambas opciones con este tipo de control. |
relative_timeframes | El filtro le permite al usuario filtrar en un período personalizado o elegir entre ajustes predeterminados de período de tiempo, como Hoy, Últimos 7 días, Últimos 90 días, etcétera. | DT* Se puede usar el control del período con la mayoría de los períodos y tipos basados en el tiempo, pero los usuarios no pueden seleccionar opciones de tiempo con este tipo de control. |
Otro | ||
advanced | El filtro presenta opciones para aplicar uno o más filtros de filtros o concordancias avanzadas. Consulta la sección Cómo usar controles avanzados en esta página para obtener más información sobre los controles avanzados. | C N T ZC YN DT DI DU L P |
*Nota sobre los datos de fecha y hora: Algunos períodos y tipos basados en el tiempo se interpretan como diferentes tipos de datos cuando Looker crea opciones de control para ellos. Dos ejemplos son el período de yesno , que se interpreta como un tipo de datos yesno y, por lo tanto, admite los valores compatibles con el tipo yesno ; y el período de tiempo de hour_of_day , que se interpreta como un tipo de datos de number y, por lo tanto, admite los valores que admite el tipo number . |
display
Puedes usar el subparámetro display
de ui_config
para establecer la posición de un filtro del panel. Puedes colocar un filtro si asignas uno de los siguientes valores a display
:
inline
: El filtro se muestra directamente en la barra superior del panel.popover
: Un valor de resumen aparece en la barra superior del panel; haz clic en el valor para ver el filtro completo.overflow
: Aparece un botón Más en la barra superior del panel con un indicador numérico de cuántos filtros ampliados hay, los usuarios pueden hacer clic en el botón para ver los filtros ampliados y sus valores.
Algunos tipos de filtros solo se pueden mostrar de ciertas maneras. Por ejemplo, los filtros de type: day_picker
solo se pueden mostrar como inline
o overflow
. Si le asignas a un filtro un valor display
que no es válido para ese type
, el filtro se mostrará como inline
o popover
, lo que sea válido. Para obtener más información, consulta la página de documentación Cómo agregar y editar los filtros del panel definidos por el usuario.
Para obtener información sobre cómo posicionar los filtros del panel con la IU, consulte la página de documentación Cómo agregar y editar filtros definidos por el usuario.
options
El subparámetro opcional options
de ui_config
te permite especificar los valores que un usuario puede elegir para actualizar temporalmente los valores de filtro del panel cuando los usuarios ven un panel de LookML como panel (no un panel heredado). Si no especificas ningún valor para options
, Looker extrae los primeros valores de la base de datos.
Por ejemplo, puedes establecer San Francisco
, New York
y Tokyo
como valores posibles para un filtro en el campo users.city
de la siguiente manera:
ui_config:
type: button_group
display: inline
options:
- San Francisco
- New York
- Tokyo
Si el subparámetro type
de ui_config
se establece en range_slider
o slider
, puedes usar los subparámetros min
y max
de options
:
min
: establece el valor mínimo posible para un filtro.max
: Establece el valor máximo posible para un filtro.
Por ejemplo:
ui_config:
type: range_slider
display: inline
options:
min: 0
max: 500
model
Para los filtros del panel de type: field_filter
, debes definir un modelo desde el que el filtro extraerá sugerencias. El parámetro model
especifica qué modelo contiene el campo que deseas usar.
filters:
- name: State
title: State
type: field_filter
default_value: California
model: thelookstore
explore: users
field: users.state
explore
En esta sección, se hace referencia al parámetro
explore
que forma parte de un filtro del panel.
explore
también se puede usar como parte de un modelo, que se describe en la página de documentación del parámetroexplore
.
explore
también se puede usar como parte de un elemento del panel. En la página de documentación de los elementos del gráfico de columnas, se proporciona un ejemplo representativo de su uso.
Para los filtros del panel de type: field_filter
, debes definir un campo desde el que el filtro extraerá sugerencias. El parámetro explore
especifica qué Explorar contiene el campo que deseas usar.
filters:
- name: order_date
type: field_filter
explore: orders
field: orders.order_date
field
Para los filtros del panel de type: field_filter
, debes definir un campo desde el que el filtro extraerá sugerencias. El parámetro field
especifica qué campo quieres usar. Es importante usar el nombre de campo de alcance completo. En otras palabras, usa view_name.field_name
, no solo field_name
.
filters:
- name: order_date
type: field_filter
explore: orders
field: orders.order_date
listens_to_filters
Para los filtros del panel de type: field_filter
, puedes acotar las sugerencias del filtro en función de lo que el usuario ingresa en otro filtro de type: field_filter
.
En el siguiente ejemplo, las sugerencias proporcionadas para el filtro State
se basarán en los valores del filtro Order ID
. Cualquier valor seleccionado para el filtro Order ID
tendrá valores users.state
asociados, y esos valores se sugerirán para el filtro State
. Consulta la página de documentación Cómo agregar y editar los filtros del panel definidos por el usuario para obtener más información.
filters:
- name: State
title: State
type: field_filter
model: thelookstore
explore: users
listens_to_filters:
- Order ID
field: users.state
embed_style
El parámetro embed_style
inicia la sección de LookML en la que puedes personalizar el aspecto de un panel incorporado. embed_style
y sus parámetros asociados solo son compatibles con paneles incorporados y se ignoran si el panel no está incorporado.
Después de realizar los cambios en embed_style
, debes implementar tu LookML para la producción a fin de que tu configuración de embed_style
se refleje en el panel incorporado de LookML.
Para los siguientes atributos del panel incorporado que especifican un color, el valor del color puede ser una string hexadecimal, como #2ca6cd
, o una string de color con nombre de CSS, como mediumblue
.
Las personalizaciones de panel incorporadas tienen el siguiente formato:
embed_style:
background_color: "css_color"
show_title: true | false
title_color: "css_color"
show_filters_bar: true | false
tile_background_color: "css_color"
tile_text_color: "css_color"
background_color
Establece el color del fondo de un panel incorporado.
embed_style:
background_color: "#ffffff"
show_title
Especifica si los usuarios pueden ver el título del panel incorporado.
embed_style:
show_title: false
title_color
Establece el color del título de un panel incorporado.
embed_style:
title_color: "#008000"
show_filters_bar
Especifica si los usuarios pueden ver los filtros del panel incorporado.
Este parámetro solo afecta la apariencia estética del panel, no la capacidad del usuario para acceder a los datos. Ocultar la barra de filtros NO impide que los usuarios cambien los filtros por otros medios. Para obtener información sobre cómo configurar políticas seguras de control de acceso a los datos, consulta la página de documentación Control de acceso y administración de permisos.
embed_style:
show_filters_bar: true
tile_background_color
Establece el color del fondo de todos los mosaicos en un panel incorporado.
embed_style:
tile_background_color: "lightyellow"
tile_text_color
Establece el color del texto en todos los mosaicos de un panel incorporado.
embed_style:
tile_text_color: "crimson"
elements
En esta sección, se hace referencia al parámetro
elements
que forma parte dedashboard
.
elements
también se puede usar como parte de una fila del panel, descrita en la secciónelements
para filas en esta página.
El parámetro elements
inicia la sección de LookML en la que defines los elementos que conformarán un panel. Hay muchos parámetros que pueden definir la apariencia de un elemento del panel. Se describen con más detalle en la página Parámetros del elemento del panel.
- dashboard: sales_overview
layout: tile
elements:
- name: order_count
type: single_value
model: ecommerce
explore: orders
measures: [orders.count]
Piense en la cantidad y la complejidad de los elementos que agrega a un panel de LookML. Más elementos requieren más recursos del navegador, lo que aumenta el tiempo de procesamiento del panel. Del mismo modo, los elementos que renderizan grandes cantidades de datos pueden afectar el rendimiento del panel. Si el procesamiento se convierte en un problema, considera simplificar los elementos o crear varios paneles con menos elementos.