Parámetros del panel

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.

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á a la carpeta Paneles de LookML.

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 heredados

• dashboards-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ón title (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ámetro description (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ámetro description (para campos).

A partir de Looker 21.20, el contenido del parámetro description aparecerá en el cuadro de texto Descripción del panel Detalles del panel de un panel de LookML.

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 elementos width, height, row y col. 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, cuando preferred_viewer se establece en dashboards-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ámetro rows y sus subparámetros elements y height. Cuando preferred_viewer se establece en dashboards-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ámetros top y left. 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 funcionan top y left, consulta la página de documentación Parámetros del gráfico de columnas para paneles de LookML. Cuando preferred_viewer se establece en dashboards-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. Cuando preferred_viewer se establece en dashboards-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 como dashboards-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 como dashboards-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 como dashboards-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ámetro filters.

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ó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 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ámetro type (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ámetro type.

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 usas type: field_filter y asocias el filtro con un campo type: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 como dashboards-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 LookML type asignados al campo en el que filtras.

S = Funciona con el tipo de datos [`string`](/looker/docs/2216/reference/param-dimension-filter-parameter-types#string)data
N

DI = Funciona con el [`distance`](/looker/docs/2216/reference/param-dimension-filter-parameter-types#distance) data type
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á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 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 de dashboard.

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