Parámetros del panel de LookML

Los paneles se pueden crear de dos maneras. Los paneles definidos por el usuario se crean con la IU de Looker y se describen en la página de documentación Cómo crear paneles definidos por el usuario. Los paneles también se pueden crear con LookML y se pueden modificar sus parámetros de configuración generales, como se explica en esta página.

En esta página, se describen los parámetros de los paneles de LookML que afectan a todo el panel.

Un panel de LookML también contiene elementos, que son las visualizaciones de datos, los mosaicos de texto y los botones del panel. Consulta la página Parámetros de los elementos del panel para obtener vínculos a las páginas de referencia de cada tipo de elemento individual.

Ejemplo de uso

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  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: "chosen 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

Nombre del parámetro	Descripción
dashboard	Crea un panel.
preferred_viewer	Este parámetro se ignora.
title (para el panel)	Cambia la forma en que los usuarios ven el nombre de un panel.
description (para el panel)	Agrega una descripción que se pueda ver en el panel de Detalles del panel o en una carpeta configurada en vista de lista.
enable_viz_full_screen	Define si los usuarios del panel pueden ver los mosaicos del panel en vistas de pantalla completa y expandidas.
extends	Basa el panel de LookML en otro panel de LookML.
extension	Requiere que otro panel extienda el panel.
layout	Define la forma en que el panel colocará los elementos.
rows	Comienza una sección de LookML para definir los elementos que deben ir en cada fila de un panel de layout: grid.
elements (para filas)	Define los elementos que deben incluirse en una fila de un panel de layout: grid.
height (para filas)	Define la altura de una fila para un panel de layout: grid.
tile_size	Define el tamaño de un mosaico para un panel de layout: tile.
width (para el panel)	Define el ancho del panel para un panel layout: static.
refresh (para el panel)	Establece el intervalo en el que se actualizarán automáticamente los elementos del panel.
auto_run	Determina si los paneles se ejecutan automáticamente cuando se abren o vuelven a cargar inicialmente.
Parámetros de filtro
crossfilter_enabled	Habilita o inhabilita el filtrado cruzado para un panel.
filters_bar_collapsed	Se agregó en la versión 21.16 Establece la barra de filtros del panel como contraída o expandida de forma predeterminada para un panel.
filters_location_top	Se agregó la versión 22.8 Establece la ubicación de la barra de filtros del panel como superior o derecha para un panel.
filters (para el panel)	Comienza una sección de LookML para definir filtros del panel.
name (para filtros)	Crea un filtro.
title (para filtros)	Cambia la forma en que se muestra el nombre de un filtro a los usuarios.
type (para filtros)	Determina el tipo de filtro que se usará.
default_value	Establece un valor predeterminado para un filtro.
allow_multiple_values	Limita a los usuarios a un solo valor de filtro.
required	Exige que los usuarios ingresen un valor de filtro para ejecutar el panel.
ui_config	Configura los controles de filtro que están disponibles cuando los usuarios ven un panel de LookML. Tiene los 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 el Explore 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 más específicas para los filtros del panel de field_filter según lo que el usuario ingresa para otros filtros del panel de type: field_filter.
Parámetros del panel incorporado
embed_style	Comienza una sección de LookML para definir las personalizaciones del panel incorporado.
background_color	Establece el color de fondo de un panel integrado.
show_title	Especifica si el título del panel está visible en un panel incorporado.
title_color	Establece el color del título de un panel integrado.
show_filters_bar	Especifica si la barra de filtros está visible en un panel incorporado.
tile_background_color	Establece el color de fondo de la tarjeta de un panel integrado.
tile_text_color	Establece el color del texto de la tarjeta de un panel integrado.
Parámetros de elementos
elements (para el panel)	Comienza una sección de LookML para definir elementos del panel.

dashboard

El parámetro dashboard declara un panel nuevo y especifica un nombre para él. La cantidad máxima de caracteres es 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 algo, un panel requiere que se agregue al menos un elemento con el parámetro elements.

Nota: Si cambias el valor del parámetro dashboard de un panel de LookML para un panel que se quitó de la carpeta Paneles de LookML, el panel de LookML volverá automáticamente a la carpeta Paneles de LookML.

preferred_viewer

Importante: Este parámetro se ignora.

Antes de la baja de los paneles heredados en Looker 23.6, el parámetro preferred_viewer te permitía elegir el formato para ver y descargar un panel como la experiencia de panel predeterminada de Looker o como un panel heredado.

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, como se describe en la sección title (para filtros) de esta página.

title también se puede usar como parte de cualquier 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 title te permite cambiar la forma en que los usuarios verán 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 como 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 hiciste, en lugar de aparecer como Resumen de ventas, el panel aparecerá como 1) Resumen de 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 una exploración, como se describe en la página de documentación del parámetro description (para exploraciones).

description también se puede usar como parte de un campo, como se describe en la página de documentación del parámetro description (para campos).

El parámetro description te permite agregar una descripción a un panel de LookML.

El contenido del parámetro description aparecerá en el campo Descripción del panel Detalles del panel de un panel de LookML.

La descripción se muestra debajo del título del panel en las listas de paneles cuando se ven en una carpeta configurada en vista de lista. Si no se especifica una descripción, la lista solo muestra el título del panel.

El texto de la descripción se puede localizar.

enable_viz_full_screen

Este parámetro solo se aplica cuando un administrador de Looker habilita el parámetro de configuración Full Screen Visualizations. El parámetro de configuración Visualización en pantalla completa está habilitado de forma predeterminada.

El parámetro enable_viz_full_screen te permite establecer si los usuarios del panel pueden ver los mosaicos del panel en vistas expandidas y de pantalla completa. Es equivalente al parámetro de configuración del panel Permitir el modo de pantalla completa para las visualizaciones.

Este parámetro acepta los valores true (vistas de pantalla completa y expandida disponibles) y false (vistas de pantalla completa y expandida no disponibles). El valor predeterminado es true.

extends

Como se describe en la página de documentación Reutilización de código con extends, el parámetro extends te permite basar un panel de LookML en otro panel de LookML, y es posible que agregues o anules algunos parámetros 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 tus extensiones. Si extiendes un objeto y, luego, defines etiquetas o descripciones nuevas, debes proporcionar definiciones de localización en los archivos de cadenas de configuración regional de tu proyecto. Consulta la página de documentación Cómo localizar tu modelo de LookML para obtener más información.

extension

Como se describe en la página de documentación Reutilización de código con extends, el parámetro extension indica que otro panel debe extender el panel. Otros usuarios nunca pueden ver este panel, pero se puede usar como plantilla para crear otros paneles que sí 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 la extensión para el panel.

layout

El parámetro layout establece el método de diseño que Looker usará cuando posicione los 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 de 8 columnas de ancho y 6 filas de alto. Los elementos se pueden configurar a lo largo de esta cuadrícula, especificados por los parámetros de elementos width, height, row y col. Esta opción de diseño se usa cuando un panel definido por el usuario se convierte en un panel de LookML, además de ser el diseño predeterminado cuando se crea un panel de LookML nuevo a través del IDE de Looker. Además, newspaper y grid son los únicos diseños que admiten 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, que se basan en un conjunto de filas que defines con el parámetro rows y sus parámetros secundarios elements y height. newspaper y grid son los únicos diseños que admiten 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 que se enumeran en el archivo LookML. Cada elemento del panel debe posicionarse manualmente con los parámetros top y left. Estos parámetros se aplican a todos los tipos de elementos, y los detalles sobre su uso aparecen en las páginas de documentación de cada tipo de visualización individual. Para ver ejemplos representativos de cómo funcionan top y left, consulta la página de documentación Parámetros de gráficos de columnas para los paneles de LookML. 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 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 ocupar el espacio disponible. tile no admite la conversión de un panel de LookML a un panel definido por el usuario.

rows

En 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 incluyes 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 de elements crea una fila nueva en el panel. Todos los elementos que se colocan en una fila tendrán el mismo ancho. Por lo tanto, si colocas 2 elementos en una fila, cada uno ocupará el 50% del espacio disponible. Si colocas 4 elementos en una fila, cada uno ocupará el 25% del espacio disponible.

height

El parámetro height define la altura de una fila en píxeles. El valor predeterminado es 300.

tile_size

En los paneles de layout: tile y layout: static, la unidad que se usa para dimensionar y posicionar los elementos es el tamaño de la tarjeta. 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 del 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 sobre su uso aparecen en las páginas de documentación de 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 de gráficos de columnas para los 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 sobre los elementos de los gráficos de columnas, se proporciona un ejemplo representativo de su uso.

En el caso de 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 un tamaño determinado si defines un elemento demasiado grande o demasiados elementos en una fila. En cambio, el parámetro de configuración width ayuda a mantener el panel centrado en la pantalla. Si no estableces un ancho, el valor predeterminado es 1,200.

- 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 se vuelva a cargar automáticamente de forma periódica y, de este modo, recupere datos nuevos. 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 número (sin decimales) de segundos, minutos, horas o días. Por ejemplo:

- dashboard: sales_overview
  refresh: 2 hours

Ten cuidado al configurar intervalos de actualización cortos. Dado que los paneles pueden contener muchas consultas, algunas de las cuales pueden consumir muchos recursos, ciertos paneles pueden sobrecargar tu base de datos.

auto_run

El parámetro auto_run determina si un panel se ejecutará cuando se abra o vuelva a cargar inicialmente. El valor predeterminado es true. Cuando este parámetro se establece en false, 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 del parámetro de configuración 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 recargas no deseadas cuando un usuario pausa la aplicación durante un cambio de filtro o quiere cambiar varios filtros al mismo tiempo.

crossfilter_enabled

El parámetro crossfilter_enabled te permite activar o desactivar los filtros cruzados para un panel. Cuando este parámetro se establece en true, los usuarios del panel pueden crear filtros cruzados en el panel haciendo clic en ciertos puntos de datos.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

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. Cuando este parámetro se establece en true, la barra de filtros se contrae de forma predeterminada. Los usuarios del panel pueden expandir la barra de filtros haciendo clic en el ícono de filtros. El parámetro de configuración predeterminado es false.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

El parámetro filters_location_top te permite colocar la barra de filtros del panel en la parte superior o a la derecha de un panel. 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 parámetro de configuración predeterminado es true.

- dashboard: sales_data
  filters_location_top: false

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 métrica, como se describe en la página de documentación del parámetro filters.

El parámetro filters inicia la sección de LookML en la que defines los filtros del panel. Los filtros aparecen en la parte superior del panel y permiten a los usuarios cambiar los datos que respaldan los elementos del panel.

Para que un filtro afecte a un elemento, este debe configurarse para "escuchar" ese filtro con el parámetro listen. Este parámetro se aplica a todos los tipos de elementos, excepto type: text y type: button. Para ver un ejemplo representativo de cómo funciona listen, consulta la página de documentación Parámetros de gráficos de columnas para paneles de LookML.

Nota: En el caso de los elementos del panel que usan el parámetro merged_queries, cada consulta de origen puede escuchar uno o más filtros del panel. Dentro de una definición de consulta combinada, puedes usar el parámetro listen para definir la lógica de filtro de cada consulta de origen de forma independiente, independientemente de la cantidad de consultas de origen en tu elemento de resultados combinados. Si una búsqueda no tiene un parámetro listen, no se verá afectada por ningún filtro del panel.

Cuando se aplican filtros a un elemento de esta manera, es importante que el tipo de filtro coincida con el tipo de dimensión o medida que está a la espera del filtro (consulta Cómo compilar paneles de LookML para obtener más detalles). Los filtros tienen el siguiente formato:

filters:
- name: filter_name
  title: "chosen 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 nuevo filtro del panel y le asigna un nombre. Se hará referencia al nombre en el parámetro listen de los elementos que deberían verse afectados por el filtro. El parámetro listen se aplica a todos los tipos de elementos, excepto a type: text, y los detalles sobre su uso aparecen en las páginas de documentación de cada tipo de visualización individual. Para ver un ejemplo representativo de cómo funciona listen, consulta la página de documentación Parámetros de gráficos 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ón title (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 de gráficos de columnas para los paneles de LookML, se proporciona un ejemplo representativo de su uso.

El parámetro title te permite cambiar la forma en que aparecerá el nombre de un filtro para los usuarios en la parte superior de un panel. Si no se especifica, el título se establece de forma predeterminada como el nombre del filtro.

Considera el siguiente ejemplo:

filters:
- name: order_date
  title: "Order Date(s)"

Si lo hiciste, en lugar de aparecer como Fecha del pedido, el filtro 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, como se describe en la página de documentación del parámetro type (para paneles de LookML).

type también se puede usar como parte de una unión, como se describe en la página de documentación del parámetro type.

type también se puede usar como parte de una dimensión, como se describe en la página de documentación Tipos de dimensiones, filtros y parámetros.

type también se puede usar como parte de una medida, como se describe en la página de documentación Tipos de medidas.

El parámetro type especifica el tipo de entrada que se colocará en el filtro. Si bien se puede escribir cualquier tipo de entrada (como una fecha) en el filtro type: string_filter, ser más específico proporciona un widget de filtro más personalizado para el usuario. Existen 4 tipos de filtros:

• field_filter: En general, debería ser tu opción predeterminada cuando puedas especificar una dimensión o una medida subyacente. Si usas type: field_filter y asocias el filtro con un campo type:string, el filtro sugerirá posibles valores.
• number_filter: Permite que el usuario ingrese un valor o una expresión numérica o entera.
• date_filter: Permite que el usuario ingrese un valor o una expresión de fecha.
• string_filter: Permite que el usuario ingrese texto de formato libre.

field_filter

Sugiere opciones para elegir y cambia su presentación a los usuarios según el campo subyacente que especifiques.

Este debe ser tu tipo de filtro predeterminado en situaciones en las que quieras hacer sugerencias a los usuarios mientras interactúan con el filtro. La dimensión desde 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.

Es posible que las sugerencias no funcionen si el campo proviene de una tabla derivada, si se usa sql_always_where en Explorar o si el campo es una métrica.

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 un valor o una expresión de número entero.

filters:
- name: order_value
  type: number_filter

date_filter

No hace sugerencias, permite que el usuario ingrese un valor o una expresión de fecha.

filters:
- name: order_date
  type: date_filter

string_filter

No hace sugerencias y permite que el usuario ingrese texto de 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úrate de que el valor predeterminado coincida con el tipo de filtro que se usa. 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 Expresiones de filtro de Looker, se describe este tema con más detalle.

Cuando usas los parámetros default_value y ui_config, las expresiones de filtro deben ser compatibles con el valor que se le asigna al subparámetro type de ui_config y los tipos de datos que admiten el valor type.

También puedes usar las variables de Liquid _localization y _user_attributes para obtener valores de filtro 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. 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 solo pueden seleccionar un valor de filtro.

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 exigir que los usuarios proporcionen un valor para el filtro si desean ejecutar el panel. De forma predeterminada, los filtros no requieren valores. Si se deja en blanco un filtro que no requiere un valor, los datos simplemente no se restringen según el campo del filtro. Si se deja en blanco un filtro que requiere un valor, no se ejecutará el panel.

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

El subparámetro ui_config de filters te permite configurar los parámetros del filtro para un panel de LookML. Estos parámetros de configuración incluyen los tipos de controles de filtros que se usan, la ubicación de los controles de filtros 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

Consulta la página de documentación Cómo agregar y editar filtros del panel definidos por el usuario para obtener más información sobre cómo configurar filtros con la IU.

type

El parámetro secundario type de ui_config te permite especificar los tipos de controles de filtro que se muestran.

Según el valor que ingreses para type, los controles de filtro pueden ser de selección única o múltiple.

Los valores que admite type dependen del objeto de datos LookML type que se asigna al campo por el que filtras.

STR = Compatible con el tipo de datos string	DIST = Compatible con el tipo de datos distance
NUM = Compatible con el tipo de datos number y las medidas numéricas	DUR = Compatible con el tipo de datos duration
TIER = Compatible con el tipo de datos tier	F&H = Compatible con la mayoría de los tipos de datos de fecha y hora
ZIP = Compatible con el tipo de datos zipcode	LOC = Compatible con el tipo de datos location
S/N = Compatible con el tipo de datos yesno	PAR = Compatible con el parámetro 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.	STR NUM TIER ZIP Y/N DIST DUR
checkboxes	El filtro muestra casillas de verificación, una para cada valor especificado con el parámetro options.	STR NUM TIER ZIP Y/N DIST DUR
tag_list	El filtro muestra un menú desplegable con cada valor posible especificado con el parámetro options.	STR NUM TIER ZIP DIST DUR
range_slider	En el caso de 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 para el filtro, y el rango predeterminado se puede especificar con el parámetro default_value.	NUM DIST DUR
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.	STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons	El filtro muestra botones de selección, con un botón para cualquier valor y un botón para cada valor especificado con el parámetro options.	STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu	El filtro muestra un menú desplegable en el que se indica cada valor posible especificado con el parámetro options. El menú desplegable también ofrece a los usuarios la opción de seleccionar Cualquier valor.	STR NUM TIER ZIP Y/N DIST DUR PAR
slider	En el caso de los campos numéricos, el filtro muestra un control deslizante que permite a los usuarios elegir un filtro deslizando el control entre los valores mínimos y máximos posibles, que se especifican con el parámetro options.	NUM DIST DUR
Fechas y horarios
day_picker	El filtro permite a los usuarios elegir una fecha específica para filtrar.	D&T: El control de un solo día se puede usar con la mayoría de los períodos y los tipos basados en el tiempo, pero los usuarios solo pueden seleccionar fechas únicas con este tipo de control.
day_range_picker	El filtro permite a los usuarios seleccionar una fecha de inicio y una fecha de finalización para filtrar un período.	D&T El control de período se puede usar con la mayoría de los períodos y los tipos basados en el tiempo, pero los lectores solo pueden seleccionar períodos con este tipo de control.
date_time_range_input	El filtro permite al usuario filtrar por un rango de fechas y horas.	F. y H. El control de rango de fecha y hora se puede usar con la mayoría de los tipos basados en el tiempo, y los usuarios deben seleccionar las opciones de fecha y hora con este tipo de control.
relative_timeframes	El filtro permite que el usuario filtre por un intervalo de fechas personalizado o elija entre los ajustes predeterminados de períodos, como Hoy, Últimos 7 días o Últimos 90 días.	D&T El control de período se puede usar con la mayoría de los períodos y los 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 o filtros de coincidencias avanzadas. Consulta la sección Uso de controles avanzados en esta página para obtener más información sobre los controles avanzados.	STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

Nota: 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 yesno, que se interpreta como un tipo de datos yesno y, por lo tanto, admite los valores que admite el tipo yesno, y el período hour_of_day, que se interpreta como un tipo de datos number y, por lo tanto, admite los valores que admite el tipo number.

display

Puedes usar el parámetro secundario display de ui_config para establecer la posición de un filtro del panel. Puedes posicionar un filtro asignando uno de los siguientes valores a display:

• inline: El filtro se muestra directamente en la barra superior del panel.
• popover: En la barra superior del panel, aparece un valor de resumen. Haz clic en el valor para ver el filtro completo.
• overflow: En la barra superior del panel, aparece un botón Más con un indicador numérico de la cantidad de filtros de desbordamiento que hay. Los usuarios pueden hacer clic en el botón para ver los filtros de desbordamiento 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 de display que no es válido para ese type, el filtro se mostrará como inline o popover, según cuál sea válido. Para obtener más información, consulta la página de documentación Cómo agregar y editar filtros del panel definidos por el usuario.

Para obtener información sobre cómo posicionar los filtros del panel con la IU, consulta 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 del filtro del panel cuando los usuarios ven un panel de LookML. Si no especificas ningún valor para options, Looker extraerá los primeros valores de la base de datos.

Por ejemplo, puedes establecer San Francisco, New York y Tokyo como los 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 está establecido 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 del 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, como se describe en la página de documentación del parámetro explore.

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 del 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 del que el filtro extraerá sugerencias. El parámetro field especifica qué campo deseas usar. Es importante usar el nombre del campo con el 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

En el caso de los filtros del panel de type: field_filter, puedes reducir las sugerencias del filtro en función de lo que el usuario ingresa para 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. Los valores que se seleccionen para el filtro Order ID tendrán valores users.state asociados, y esos valores serán valores sugeridos para el filtro State. Consulta la página de documentación Cómo agregar y editar 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 personalizas la apariencia de un panel incorporado. embed_style y sus parámetros asociados solo se admiten en los paneles integrados y se ignoran si el panel no está integrado.

Después de realizar cambios en embed_style, debes implementar tu LookML en producción para ver la configuración de embed_style reflejada en el panel de LookML integrado.

Para los siguientes atributos del panel integrado que especifican un color, el valor del color puede ser una cadena hexadecimal como #2ca6cd o una cadena de color con nombre de CSS como mediumblue.

Las personalizaciones de los paneles integrados 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 integrado.

embed_style:
  background_color: "#ffffff"

show_title

Especifica si el título del panel integrado es visible para los usuarios.

embed_style:
  show_title: false

title_color

Establece el color del título de un panel integrado.

embed_style:
  title_color: "#008000"

show_filters_bar

Especifica si los filtros del panel integrado son visibles para los usuarios.

Este parámetro solo afecta la apariencia 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 de control de acceso a datos seguros, consulta la página de documentación Administración de permisos y control de acceso.

embed_style:
  show_filters_bar: true

tile_background_color

Establece el color de fondo de todas las tarjetas en un panel integrado.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

Establece el color del texto en todas las tarjetas de un panel integrado.

embed_style:
  tile_text_color: "crimson"

elements

En esta sección, se hace referencia al parámetro elements que forma parte de un dashboard.

elements también se puede usar como parte de una fila del panel, como se describe en la sección elements para filas de 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 de los elementos del panel.

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

Piensa en la cantidad y la complejidad de los elementos que agregas a un panel de LookML. Cuantos más elementos haya, más recursos del navegador se necesitarán, lo que aumentará el tiempo de renderización del panel. Del mismo modo, los elementos que renderizan grandes cantidades de datos pueden afectar el rendimiento del panel. Si el renderizado se convierte en un problema, considera reducir la complejidad de las consultas de los elementos del panel o crear varios paneles con menos elementos.