Compila paneles de LookML

Los desarrolladores de LookML crean los paneles de LookML y los almacenan como archivos controlados por la versión. De forma predeterminada, aparecen en la carpeta Paneles de LookML de 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 paneles de control y definidos por el usuario.

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

• see_lookml_dashboards
• develop

Además, debe tener acceso a los modelos de LookML para todos los datos que desee usar en el panel.

Crea un archivo del 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á silenciada en el IDE). Los pasos para hacerlo son los siguientes:

1. Activa el modo de desarrollo.
2. En el menú Develop, navega hasta tu proyecto.

3. Seleccione 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 del panel de LookML fuera de las carpetas de proyectos existentes. También puedes hacer clic en el menú de tres opciones de carpeta de una carpeta para crear el archivo en ella. Haz clic en Crear panel para crear el archivo del panel.

   

4. Aparecerá una ventana Create File. Dentro de la ventana, asigna un nombre al archivo del panel en el campo de escritura y selecciona Crear.

   

Edita archivos del panel de LookML

Cuando crea un archivo de panel de LookML, Looker propaga previamente el archivo con varios parámetros de panel básicos, que implementan la configuración para todo el panel. También propaga previamente el archivo con varios parámetros de elemento del panel de muestra, que se agrupan en el parámetro del 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 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 del panel dentro del IDE como desees, siempre que estés en el modo de desarrollo.

Tienes varias opciones para compilar el panel:

• Creación manual: Puede crear un panel de forma manual. Para ello, utilice los parámetros del panel y los parámetros de los elementos del panel.
• Copie un panel definido por el usuario: Puede crear una copia de un panel definido por el usuario. Para ello, borre el archivo LookML del panel prepropagado, copie el LookML del panel desde un panel definido por el usuario y péguelo en el archivo de su panel.
• Copiar el LookML del panel de los elementos: Puedes copiar el LookML del panel desde Explorar o Look y pegarlo en el archivo del panel.

Cuando crees un panel, ten en cuenta las prácticas recomendadas para la creación de paneles. Obtén información y sugerencias sobre la creación de paneles de alto rendimiento en el artículo Prácticas recomendadas para considerar la creación de paneles de alto rendimiento de Looker.

Nota: Los archivos nuevos del panel de LookML se configuran de forma predeterminada en la nueva experiencia del panel mediante la configuración automática del parámetro del panel preferred_viewer en dashboards-next. Para renderizar un nuevo panel de LookML como un panel heredado, configura preferred_viewer como dashboards.

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 compilar una consulta que quiera convertir en un elemento del 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.

2. Selecciona Get LookML para exponer el LookML.

   

3. Aparecerá la ventana Get LookML. Con el Panel seleccionado en la ventana, seleccione todo el LookML y cópielo.

   

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

• Verifica que estés en el modo de desarrollo para poder editar el archivo del panel.
• Pega el LookML debajo del parámetro elements del panel.
• Use la sangría correcta cuando pegue LookML en el archivo del panel. Si es posible, haz coincidir la sangría con los elementos existentes 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.

Cómo agregar filtros

Una vez que haya guardado los elementos del panel en el archivo de su panel, puede agregar filtros, lo que permite a los lectores del panel filtrar algunos o todos los elementos de un panel. Los filtros pueden ser útiles por muchas razones posibles, por ejemplo:

• Ajustar el período mostrado
• Ajustar la categoría de producto específica, el tipo de cliente, etc.
• Proporcionar la capacidad de tipo "búsqueda" para un cliente o cliente

Asegúrese de crear el tipo de filtro que desee. Los dos tipos son:

• Filtra aquellos elementos del panel que codificas en los elementos, que los lectores del panel no pueden cambiar.
• Filtros del panel, que los usuarios del panel pueden cambiar

Filtra hard-coded en elementos del panel

Los filtros que codifica en los elementos del panel, que los usuarios no pueden cambiar, suelen crearse automáticamente en el paso para copiar LookML en una visualización o en 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 en el 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 del panel a los elementos del panel con el parámetro de elemento del panel listen.

Crea un filtro de 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 del 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 strings. También puedes usar el filtro type para asociar un filtro a un campo LookML subyacente, en cuyo caso Looker seleccionará automáticamente el tipo de entrada correcto y, si el campo LookML subyacente es type: string, proporcionará sugerencias de filtros a los usuarios del panel.

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

Aplica un filtro de panel a los elementos del panel

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

Por ejemplo, puedes tener un elemento que se vea así:

- 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 restringe el elemento a pedidos aprobados (con el filtro order.status: 'approved'). El usuario no puede cambiarlo.

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

- 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 desea que los usuarios puedan ajustar la fecha o la categoría, no agregue el parámetro listen. Solo debes agregar un listen a los elementos que quieres que el usuario pueda ajustar.

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

Un filtro de panel se puede aplicar a cualquier campo (del mismo tipo de datos) en cualquier elemento determinado. 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 lo 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

Incluye el archivo del panel en un modelo

Para que tu panel sea visible en el modo de desarrollo o sea visible en producción, debe incluirse en el archivo del modelo en el que se basa el panel mediante una declaración include.

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

include: "*.dashboard.lookml"

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

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

También puedes incluir un panel específico si especificas 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 Guardar cambios 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 quieres obtener una vista previa, haz clic en la flecha hacia abajo Ver ícono de 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é satisfecho con su panel, puede publicarlo en producción, lo que permite que otros usuarios con los permisos correctos lo vean. El método para publicar el panel es el mismo que para publicar otros cambios en LookML en tu instancia y depende de la configuración de 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 del panel de navegación izquierdo. La carpeta de los paneles de LookML se distingue de otras carpetas de las siguientes maneras:

• Debes incluir un panel de LookML en al menos un archivo de modelo para que aparezca en la carpeta 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 LookML, los usuarios deben tener acceso al modelo de LookML que incluye el panel.
• Para ver un mosaico determinado en un panel de LookML, los visualizadores de 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 usuarios 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 de Paneles de LookML.

Mueve 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 el acceso al modelo de LookML en el que se incluye un panel de LookML, puedes moverlo a cualquier carpeta en la que tengas el nivel de acceso a la carpeta Administrar acceso, Editar.

Hay dos formas de mover el panel:

• En la carpeta Paneles de LookML, selecciona el panel que deseas 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 Organización y administración de contenido para obtener más información.
• En la carpeta Paneles de LookML, haga clic en el menú de tres puntos del panel, seleccione Mover desde el menú y seleccione la carpeta a la que desea mover el panel.

Si está en modo de desarrollo, no puede mover los paneles de LookML fuera de la carpeta de paneles de LookML. En su lugar, puede usar la opción Importar 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 los paneles de LookML muestra los paneles de LookML en una sección del Panel de LookML. En la sección Panel de LookML, puede 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 de un parámetro dashboard del panel de LookML, el panel de LookML volverá a la carpeta Paneles de LookML.

Visualiza el LookML para un panel de LookML existente

Si tienes el permiso see_lookml, puedes navegar al panel LookML de un panel existente. Para ello, selecciona Ir a LookML en el menú de puntos del panel de tres puntos del panel:

Si el panel de LookML tiene el estilo del panel heredado, haga clic en Ir a LookML del panel en el menú de ajustes del panel.

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

Extiende un panel de LookML

Una vez que hayas creado un panel de LookML, puedes extenderlo. Esto le permite crear un segundo panel de control basado en el original, posiblemente agregando o anulando algunos parámetros de configuración. Luego, si cambia el primer panel, el segundo heredará 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.

Mejorar el rendimiento del panel mediante el reconocimiento agregado

Los desarrolladores de LookML pueden mejorar el rendimiento del panel de LookML mediante el conocimiento agregado. Con esta función, 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 haya creado un panel de LookML y lo esté viendo, puede usar la opción Obtener tabla completa de LookML en el menú de tres puntos Acciones del panel, que es visible si tiene el permiso see_lookml:

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

Nota: En el artículo Prácticas recomendadas para compilar paneles de alto rendimiento, encontrarás más información y sugerencias sobre cómo compilar paneles de alto rendimiento.