Compilación de paneles de LookML

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

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

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

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 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. O bien, haz clic en el menú de tres puntos Opciones de carpeta para crear el archivo dentro de la carpeta. Haz clic en Crear panel para crear el archivo del panel.

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

Edita los archivos del 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 del 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 LookML de panel 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 como desees, siempre y cuando estés en Development Mode.

Tienes varias opciones para compilar tu panel:

  • Creación manual: Puedes crear un panel de forma manual con parámetros de panel y parámetros de elementos del panel.
  • Copiar un panel definido por el usuario: Para crear una copia de un panel definido por el usuario, borra el panel de LookML prepropagado del archivo, copia el LookML del panel de un panel definido por el usuario y pégalo en el archivo del panel.
  • Copiar LookML del panel de elementos: Puedes copiar el LookML del panel desde una Explorar o una Vista y pegarlo en el archivo del panel.

Cuando crees un panel, ten en cuenta las prácticas recomendadas para la creación del panel. Encuentra información y recomendaciones sobre cómo compilar paneles de buen rendimiento en la página de prácticas recomendadas sobre consideraciones para compilar paneles de rendimiento de Looker.

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 deseas agregar a un panel, haz clic en el menú de ajustes Explorar acciones de la exploración.
  2. Selecciona Obtener LookML para exponer LookML.

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

    En la parte superior de la ventana Get LookML, aparecen las pestañas Panel, Tabla conjunta y LookML de la tabla derivada.

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

  • Verifica que estés en Modo de desarrollo para poder editar el archivo de panel.
  • Pega LookML en el 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 elementos existentes que ya se encuentren en el archivo de panel.

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

Agrega filtros

Una vez que hayas guardado los elementos del panel en el archivo del panel, puedes agregar filtros que permitan a los visualizadores del panel filtrar algunos o todos los elementos de un panel. Los filtros pueden ser útiles por muchos motivos posibles, como los siguientes:

  • Cómo ajustar 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 "búsqueda" para un cliente

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

  • Filtros que codificas en los elementos del panel, que los visualizadores del panel no pueden cambiar
  • Filtros del panel, que los visualizadores del panel pueden cambiar

Filtros hard-coded en 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 copia de LookML para una visualización o para 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

Puedes crear filtros de panel que un usuario pueda cambiar en dos pasos:

  1. Crea el filtro del panel con el parámetro del panel filters y sus subparámetros.
  2. Aplica el filtro para el panel a los elementos del panel con el parámetro de elementos del panel listen.

Crea un filtro para el panel

El primer paso es crear los filtros con los que interactúan los usuarios. Para ello, agrega una sección filters al archivo del panel, que se verá de la siguiente manera:

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  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

Las distintas opciones y parámetros para estos filtros se describen con más detalle en la página de documentación Parámetros de panel. Uno de los aspectos más importantes que debes tener en cuenta es qué tipo de entrada esperas de tus usuarios. Puedes asignar un type al filtro, lo que hará que acepte un tipo específico de entrada, como números, fechas o cadenas. También puedes usar el filtro type para asociar un filtro con un campo de LookML subyacente, en cuyo caso Looker seleccionará automáticamente el tipo de entrada correcto y, si el campo de LookML subyacente es type: string, proporcionará sugerencias de filtros a los visualizadores del panel.

Como se describe en la página de documentación de Parámetros de panel, 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.

Aplicación de un filtro de panel a los elementos del panel

Una vez que hayas creado un filtro de panel, deberás aplicarlo a los elementos adecuados con el parámetro listen. La idea es que el elemento “escucha” uno o más filtros para la entrada del usuario y luego se ajuste en consecuencia. Este parámetro se aplica a todos los tipos de elementos, excepto type: text y type: button, y los detalles sobre su uso aparecen en las páginas de documentación de cada tipo de visualización individual. Si deseas ver un ejemplo representativo de cómo funciona listen, consulta Parámetros del gráfico de áreas para paneles de LookML.

Por ejemplo, puedes tener un elemento que se vea de la siguiente manera:

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

Puedes ver que este elemento ya tiene un parámetro filters que lo restringe a los pedidos aprobados (mediante el filtro order.status: 'approved'). El usuario no puede cambiarlo.

Supongamos que quieres que el usuario pueda filtrar este elemento con los filtros del panel creados anteriormente en este ejemplo. Para ello, agrega un parámetro listen como el siguiente:

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

Si no deseas que los usuarios puedan ajustar la fecha o la categoría, simplemente no agregues el parámetro listen. Solo debes agregar una listen a los elementos que deseas que el usuario pueda ajustar.

Verás que la sintaxis listen funciona escribiendo primero el nombre del filtro que creaste y, luego, escribiendo el nombre del campo al que quieres aplicar la entrada del usuario.

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: order.created_date), mientras que otro la aplica a la fecha de envío del pedido (date: order.ship_date):

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

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

Incluir el archivo de panel en un modelo

Para que tu panel sea visible en una vista previa en Modo de desarrollo o visible en producción, debe incluirse en el archivo de 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, sigue estos pasos:

  1. Para guardar el archivo .dashboard.lookml, haz clic en el botón Save Changes (Guardar cambios) en la esquina superior derecha del archivo.
  2. Incluye el panel en el archivo del modelo relevante y guarda los cambios en ese archivo.
  3. En el archivo .dashboard.lookml del que deseas obtener una vista previa, haz clic en el ícono de flecha hacia abajo See file actions y selecciona View Dashboard.

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 para que otros usuarios con los permisos correctos puedan verlo. El método para publicar el panel es el mismo que publicar otros cambios en LookML en tu instancia y depende de los parámetros de 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 Looker se encuentra en la carpeta Carpetas, en el panel de navegación izquierdo. La carpeta Paneles de LookML es única de las demás 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 dentro de la carpeta Paneles de Looker, los usuarios deben tener acceso al modelo de LookML que incluye el panel.
  • Para ver cualquier mosaico dentro de un panel de LookML, los visualizadores del panel deben tener acceso al modelo de LookML en el que se basa.
  • 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 cualquier mosaico dentro de un panel, los visualizadores 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 Looker.

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 para la que tengas el nivel de acceso de la carpeta Administrar acceso, Editar.

Existen dos maneras de mover el panel:

  • En la carpeta Paneles de Looker, 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 deseas mover el panel. Consulta la página de documentación Organizar y administrar contenido para obtener más información.
  • En la carpeta Paneles de Looker, haz clic en el menú de tres puntos del panel, selecciona Mover en el menú y elige la carpeta a la que deseas 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 Importar (Import) para copiar el panel de LookML como un panel definido por el usuario en otra carpeta.

Una carpeta que contiene los paneles definidos por el usuario y los de LookML muestra los paneles de LookML en una sección del Panel de LookML. Desde la sección Panel de LookML, puedes mover un panel de LookML a otra carpeta o fijar un panel de LookML a un tablero. Sin embargo, a diferencia de los paneles definidos por el usuario, los paneles de LookML no se pueden cambiar de nombre ni se pueden 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 volverá automáticamente a la carpeta paneles de LookML.

Visualiza LookML de un panel de LookML existente

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

Cuando seleccionas Ir a LookML, Looker navega al archivo del panel en el que se define el panel de LookML.

Amplía un panel de LookML

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

Mejorar el rendimiento del panel utilizando el reconocimiento agregado

Es posible que los desarrolladores de LookML puedan mejorar el rendimiento del panel de LookML con el reconocimiento agregado. Con el reconocimiento agregado, los desarrolladores pueden crear tablas agregadas en 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 se puede ver si tienes el permiso see_lookml.

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