Compilación de paneles en LookML

Los desarrolladores de LookML crean los paneles de LookML y se almacenan como archivos con control de versión. De forma predeterminada, aparecen en la carpeta Paneles de LookML en tu instancia de Looker.

Para comparar y contrastar los paneles de LookML y los paneles definidos por el usuario, consulta la página de documentación Compara los paneles definidos por el usuario y los de LookML.

Para crear un panel de LookML, debes tener los siguientes permisos de Looker:

• see_lookml_dashboards
• develop

Además, debes tener acceso a los modelos de LookML para cualquier dato que quieras usar en el panel.

Crea un archivo de panel de LookML

Para compilar un panel de LookML, primero crea un archivo de panel que tenga la extensión .dashboard.lookml (aunque la parte .lookml de la extensión esté silenciosa dentro del IDE). Los pasos para hacerlo son los siguientes:

1. Activa el Modo de desarrollo.
2. En el menú Develop, navega a tu proyecto.
3. Selecciona el ícono de signo más Agregar archivo o carpeta en la parte superior del panel del navegador de archivos en el IDE de Looker para crear un archivo de panel de LookML fuera de las carpetas de proyectos existentes. También puedes hacer clic en el menú de tres puntos Opciones de carpeta de una carpeta para crear el archivo dentro de la carpeta. Haz clic en Crear panel para crear el archivo de panel.

1. Aparecerá la ventana Crear archivo. En la ventana, asigna un nombre al archivo del panel en el campo de escritura y selecciona el botón Crear.

Edita los archivos de panel de LookML

Cuando creas un archivo de panel de LookML, Looker prepropaga el archivo con varios parámetros de panel básicos, que implementan la configuración para todo el panel. También prepropaga el archivo con varios parámetros de elementos de panel de muestra, que se agrupan en el parámetro de panel elements, y que definen la función y el aspecto de los mosaicos, el texto y los botones del panel. Un archivo .dashboard.lookml recién creado contiene un panel de LookML similar al siguiente:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Puedes editar el archivo de panel dentro del IDE siempre que estés en Modo de desarrollo.

Tienes varias opciones para crear tu panel:

• Creación manual: Puedes crear un panel de forma manual usando parámetros de panel y de elementos de panel.
• Copiar un panel definido por el usuario: Para crear una copia de un panel definido por el usuario, puedes borrar el LookML del panel prepropagado del archivo, copiar LookML del panel de un panel definido por el usuario y pegarlo en el archivo de tu panel.
• Copiar LookML del panel de elementos: Puedes copiar el LookML del panel desde Explorar o Look y pegarlo en el archivo de tu panel.

Cuando crees un panel, ten en cuenta las prácticas recomendadas para crear un panel. Obtén información y recomendaciones sobre la creación de paneles de alto rendimiento en la página de prácticas recomendadas Consideraciones para compilar paneles de Looker de buen rendimiento.

Agrega una visualización a un panel de LookML existente

La forma más fácil de agregar una visualización a un panel de LookML existente es usar la página Explorar para crear una consulta que quieras convertir en un elemento de panel:

1. Una vez que hayas creado la consulta y la visualización que quieres agregar a un panel, haz clic en el menú de ajustes Explorar acciones de Explorar.

2. Selecciona Obtener LookML para exponer LookML.

   

3. Aparecerá la ventana Get LookML. Con Dashboard seleccionado en la ventana, selecciona todo el LookML y cópialo.

   

Desde aquí, pega el LookML en el archivo de LookML de tu panel. Cuando edites el archivo de LookML del panel, asegúrate de hacer lo siguiente:

• Verifica que estés en Modo de desarrollo para poder editar el archivo de panel.
• Pega el LookML debajo del parámetro elements del panel.
• Usa la sangría correcta cuando pegues LookML en el archivo del panel. Si es posible, haz coincidir la sangría con los elementos existentes que ya están en el archivo del panel.

Si lo deseas, puedes ajustar los parámetros de LookML con los parámetros descritos en las páginas de documentación para cada tipo de elemento individual.

Agrega filtros

Una vez que haya guardado los elementos del panel en su archivo de panel, es posible que desee agregar filtros para permitir que los visualizadores filtren algunos o todos los elementos de un panel. Los filtros pueden ser útiles por muchas razones, por ejemplo:

• Ajusta el período que se muestra
• Ajustar la categoría de producto específica, el tipo de cliente, etc. que se muestra
• Proporcionar una función de tipo de "búsqueda" para un cliente

Asegúrate de crear el tipo de filtro que deseas. Los dos tipos son los siguientes:

• Filtros que codifiques en los elementos del panel, que los visualizadores del panel no pueden modificar
• Filtros del panel, qué visualizadores del panel pueden cambiar

Filtra hard-coded en los elementos del panel

Los filtros que codificas en los elementos del panel (que los usuarios no pueden cambiar) suelen crearse automáticamente en el paso de copiar LookML para una visualización o un panel. En un panel de LookML, esos filtros usan el parámetro del elemento del panel filters y se ven de la siguiente manera:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Filtros del panel

Los filtros del panel permiten a los visualizadores definir mejor de forma interactiva los datos que se muestran en los elementos del panel. Para crear un filtro para paneles, sigue estos pasos:

1. Crea el filtro del panel con el parámetro filters en tu archivo de panel de LookML.
2. Aplica el filtro a elementos individuales del panel con el parámetro listen.

Crea un filtro para el panel

El parámetro filters te permite crear varios tipos de filtros interactivos para tu panel.

Para crear un filtro para panel con el que los usuarios puedan interactuar, agrega un parámetro filters a tu archivo de panel. Por ejemplo, el siguiente código de muestra crea un panel de LookML que tiene los filtros date y category_name:

- dashboard: dashboard_name
  title: Dashboard Title
  layout: newspaper
  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

El código del ejemplo anterior crea los siguientes filtros:

• date: Es un filtro de fecha que permite a los usuarios seleccionar un período. El valor predeterminado se establece en los últimos 30 días.
• category_name: Es un filtro de campo que permite a los usuarios filtrar por categoría de productos. Este filtro genera de forma dinámica opciones que se basan en el campo category.name dentro del modelo de LookML (ecommerce) y de Explorar (product) especificados.

Nota: Solo los filtros con type: field_filter usan los parámetros explore y field. Si incluyes los parámetros explore y field con cualquier otro tipo de filtro, obtendrás errores de validación de LookML.

Aplicar un filtro de panel a los elementos del panel

Una vez que hayas creado un filtro para el panel, puedes aplicarlo a elementos individuales del panel con el parámetro listen. Usar el parámetro listen de esta manera permite que los elementos vinculados se actualicen de forma dinámica en función de la selección del usuario en el filtro.

Nota: El parámetro listen es compatible con todos los tipos de elementos, excepto type: text y type: button.

Por ejemplo, considera el siguiente código de LookML de muestra para un elemento de gráfico de áreas:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'

El gráfico approved_orders_by_day muestra el recuento de pedidos aprobados por día, ya que la consulta se basa en la dimensión orders_created_date y la medida orders.count, y tiene aplicado un filtro, orders.status: 'approved'. Este filtro se fija dentro del elemento y los visualizadores del panel no pueden modificarlo.

Para permitir que los usuarios filtren el gráfico approved_orders_by_day con el filtro date y el filtro category_name del ejemplo anterior, agrega el parámetro listen al elemento del panel.

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'
  listen:
    category_name: category.name
    date: orders.created_date

Cuando un visualizador de panel interactúa con el filtro category_name o el filtro date, el gráfico approved_orders_by_day se actualizará automáticamente para reflejar los resultados filtrados.

El parámetro listen usa la sintaxis filter_name: field_name. En el ejemplo anterior, category_name y date son los nombres de los filtros, y category.name y orders.created_date son los campos que se usarán para permitir que los visualizadores del panel proporcionen entradas al filtro.

Un filtro de panel se puede aplicar a cualquier campo (del mismo tipo de datos) de cualquier elemento. Por ejemplo, un elemento puede aplicar la entrada de un usuario a la fecha de creación del pedido (date: orders.created_date), mientras que otro la puede aplicar a la fecha de envío del pedido (date: orders.ship_date):

- name: element_one
  # lots of other element parameters here
  listen:
    date: orders.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: orders.ship_date

Nota: Para los elementos del panel que usan el parámetro merged_queries, cada consulta de origen puede escuchar uno o más filtros del panel. Puedes definir la lógica de filtro para cada consulta de origen de manera independiente, sin importar la cantidad de consultas de origen en tu elemento de resultados combinados. Si una consulta no tiene un parámetro listen, no se verá afectada por ningún filtro del panel.

Incluye el archivo de panel en un modelo

Para que tu panel sea visible para la vista previa en Modo de desarrollo o visible en producción, debe incluirse en el archivo del modelo en el que se basa el panel mediante una sentencia include.

Una práctica común es incluir todos los paneles de LookML en un modelo con un comodín:

include: "*.dashboard.lookml"

o, si tus paneles de LookML aparecen dentro de una carpeta en el IDE, usa la ruta de acceso a su ubicación

 include: "/path/*.dashboard.lookml"

También puedes incluir un panel específico especificando su nombre de archivo:

include: "my_dashboard.dashboard.lookml"

Guarda, obtén una vista previa y publica el panel de LookML

Para obtener una vista previa del panel, haz lo siguiente:

1. Guarda el archivo .dashboard.lookml haciendo clic en el botón Save Changes en la esquina superior derecha del archivo.
2. Incluye el panel en el archivo de modelo relevante y guarda los cambios en ese archivo.
3. En el archivo .dashboard.lookml del que quieras obtener una vista previa, haz clic en el ícono de la flecha hacia abajo Ver acciones del archivo y selecciona Ver panel.

Puedes realizar más cambios en tu archivo .dashboard.lookml, guardarlos y volver a obtener una vista previa del panel.

Una vez que estés conforme con tu panel, puedes publicarlo en producción, lo que permitirá que otros usuarios con los permisos correctos lo vean. El método para publicar el panel es el mismo que publicar otros cambios en LookML en tu instancia y depende de la configuración del control de versión de tu instancia de Looker.

Carpeta de paneles de LookML

Una vez publicados, los paneles de LookML se guardan en la carpeta Paneles de LookML de forma predeterminada. La carpeta Paneles de LookML se encuentra en la carpeta Carpetas en el panel de navegación izquierdo. La carpeta Paneles de LookML es única respecto de otras carpetas por los siguientes motivos:

• Debes incluir un panel de LookML en al menos un archivo de modelo para que aparezca en la carpeta de paneles de LookML.
• Para ver la carpeta Paneles de LookML, los usuarios deben tener el permiso see_lookml_dashboards.
• Para ver los paneles en la carpeta Paneles de LookML, los usuarios deben tener acceso al modelo de LookML que incluye el panel.
• Para ver cualquier mosaico en un panel de LookML, los visualizadores del panel deben tener acceso al modelo de LookML en el que se basa el mosaico.
• Para editar un panel en la carpeta Paneles de LookML, debes tener el permiso develop en el modelo que incluye el panel de LookML.
• Para Explorar desde aquí en un mosaico determinado dentro de un panel, los lectores del panel deben tener el permiso explore para el modelo en el que se basa el mosaico.
• No puedes crear una carpeta dentro de la carpeta Paneles de LookML.

Mover los paneles de LookML fuera de la carpeta de paneles de LookML

Si tienes los permisos de Looker see_lookml_dashboards y develop, así como acceso al modelo de LookML en el que se incluye un panel de LookML, puedes mover un panel de LookML a cualquier carpeta en la que tengas el nivel de acceso Administrar acceso, Editar.

Hay dos formas de mover el panel:

• En la carpeta Paneles de LookML, selecciona el panel que quieres mover, haz clic en el botón Mover en la parte superior de la sección de paneles y selecciona la carpeta a la que quieres mover el panel. Consulta la página de documentación Organiza y administra contenido para obtener más información.
• En la carpeta Paneles de LookML, haz clic en el menú de tres puntos del panel, selecciona Mover en el menú y elige la carpeta a la que quieres mover el panel.

Si estás en Modo de desarrollo, no puedes mover los paneles de LookML fuera de la carpeta Paneles de LookML. En su lugar, puedes usar la opción Import para copiar el panel de LookML como un panel definido por el usuario en otra carpeta.

Una carpeta que contiene paneles definidos por el usuario y paneles de LookML muestra los paneles de LookML en una sección del Panel de LookML. En la sección Panel de LookML, puedes mover un panel de LookML a otra carpeta o fijar un panel de LookML a una pizarra. Sin embargo, a diferencia de los paneles definidos por el usuario, los paneles de LookML no se pueden renombrar ni mover a la papelera desde una carpeta.

Si se cambia el valor del parámetro dashboard de un panel de LookML, el panel de LookML regresará automáticamente a la carpeta Paneles de LookML.

Visualiza LookML en un panel de LookML existente

Si tienes el permiso see_lookml, puedes navegar al panel de LookML en uno existente seleccionando Ir a LookML en el menú de tres puntos Acciones del panel de un panel:

Cuando seleccionas Go to LookML, Looker navega al archivo del panel en el que está definido el panel de LookML.

Extiende un panel de LookML

Una vez que hayas creado un panel de LookML, puedes extender el panel. Esto te permite crear un segundo panel basado en el original, posiblemente agregando o anulando algunos parámetros de configuración. Luego, si cambias el primer panel, el segundo hereda esos cambios automáticamente (a menos que se anulen en el segundo panel). Consulta la página de documentación Cómo reutilizar código con extensiones para obtener más información.

Mejora el rendimiento del panel con reconocimiento agregado

Los desarrolladores de LookML pueden mejorar el rendimiento del panel de LookML con el conocimiento agregado. Con el reconocimiento agregado, los desarrolladores pueden crear tablas agregadas bajo los parámetros explore de LookML, que pueden optimizar las consultas para uno o más mosaicos en un panel.

Una vez que hayas creado y visualizado un panel de LookML, puedes usar la opción Obtener LookML de tabla conjunta en el menú de tres puntos Acciones del panel, que está visible si tienes el permiso see_lookml.

Para obtener más información, consulta la página de documentación del parámetro aggregate_table.

Nota: Encuentra más información y recomendaciones sobre la creación de paneles de alto rendimiento en la página de prácticas recomendadas de Consideraciones para compilar paneles de Looker de buen rendimiento.