Cómo compilar paneles de LookML

Los desarrolladores de LookML crean los paneles de LookML y los almacenan como archivos con control de versiones. 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 Comparación de paneles definidos por el usuario y paneles 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 desees usar en el panel.

Cómo crear un archivo de panel de LookML

Para compilar un panel de LookML, comienza por crear un archivo de panel, que tiene la extensión .dashboard.lookml (aunque la .lookml parte de la extensión es silenciosa dentro del IDE). Para ello, sigue estos pasos:

1. Activa el Modo de desarrollo.
2. En el menú Desarrollar, 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 de una carpeta para crear el archivo dentro de la carpeta. Haz clic en Crear panel para crear el archivo del panel.

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

Cómo editar archivos de panel de LookML

Cuando creas un archivo de panel de LookML, Looker lo completa previamente con varios parámetros básicos del panel, que implementan la configuración para todo el panel. También completa previamente 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 la apariencia de los mosaicos, el texto y los botones del panel. Un archivo .dashboard.lookml recién creado contiene LookML del panel similar a este:

- 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 en el IDE siempre que estés en el Modo de desarrollo.

Tienes varias opciones para compilar tu panel:

• Creación manual: Puedes compilar un panel de forma manual con parámetros de panel y parámetros de elementos de panel.
• Copia un panel definido por el usuario: Para crear una copia de un panel definido por el usuario, borra el LookML del panel completado previamente del archivo, copia el LookML del panel de un panel definido por el usuario y pégalo en el archivo del panel.
• Copia el LookML del panel de los elementos: Puedes copiar el LookML del panel de una exploración o una vista y pegarlo en el archivo del panel.

Cuando crees un panel, ten en cuenta las prácticas recomendadas para la construcción de paneles. Encontrarás información y recomendaciones sobre la creación de paneles de alto rendimiento en la página Prácticas recomendadas para crear paneles de Looker de alto rendimiento Consideraciones al crear paneles de Looker de alto rendimiento.

Cómo agregar una visualización a un panel de LookML existente

La forma más sencilla de agregar una visualización a un panel de LookML existente es usar la página Explorar para compilar una consulta que deseas 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 engranaje Acciones de exploración de la exploración.

2. Selecciona Visualizar LookML para exponer el LookML.

   

3. Aparecerá una ventana Visualizar LookML. Con Panel seleccionado en la ventana, selecciona todo el LookML y cópialo.

   

Desde aquí, pega el LookML en tu 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 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 los elementos existentes que ya están en el archivo del panel.

Puedes ajustar los parámetros de LookML como desees con los parámetros que se describen 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, es posible que desees agregar filtros, que permiten a los usuarios del panel filtrar algunos o todos los elementos de un panel. Los filtros pueden ser útiles por muchos motivos posibles, por ejemplo:

• 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 capacidad de tipo "búsqueda" para un cliente

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

• Filtros que codificas de forma rígida en los elementos del panel, que los usuarios del panel no pueden cambiar
• Filtros del panel, que los usuarios del panel pueden cambiar

Filtros codificados de forma rígida en los elementos del panel

Los filtros que codificas de forma rígida en los elementos del panel, que los usuarios no pueden cambiar, suelen crearse automáticamente en el paso de LookML de copia para una visualización o para un panel. En un panel de LookML, esos filtros usan el parámetro de 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 usuarios refinar de forma interactiva los datos que se muestran en los elementos del panel. Para crear un filtro del panel, sigue estos pasos:

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

Cómo crear un filtro del panel

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

Para crear un filtro del panel con el que los usuarios puedan interactuar, agrega un parámetro filters al archivo del 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: 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: Un filtro de campo que permite a los usuarios filtrar por categoría de producto. Este filtro genera de forma dinámica opciones que se basan en el campo category.name dentro del modelo de LookML especificado (ecommerce) y la exploración (product).

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.

Cómo aplicar un filtro del panel a los elementos del panel

Una vez que hayas creado un filtro del panel, puedes aplicarlo a elementos individuales del panel con el parámetro listen. El uso del parámetro listen de esta manera permite que los elementos vinculados se actualicen de forma dinámica según 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 área:

- 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 la cantidad 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 un filtro aplicado, orders.status: 'approved'. Este filtro está fijo dentro del elemento y los usuarios 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 usuario del panel interactúe 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 usuarios del panel proporcionen información al filtro.

Se puede aplicar un filtro del panel 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: orders.created_date), mientras que otro la aplica 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 forma 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.

Cómo incluir el archivo del panel en un modelo

Para que tu panel sea visible en la vista previa en el Modo de desarrollo o en producción, debe incluirse en el archivo de modelo en el que se basa el panel con una instrucción 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 si especificas su nombre de archivo:

include: "my_dashboard.dashboard.lookml"

Cómo guardar, obtener una vista previa y publicar el panel de LookML

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

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 correspondiente 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 Ver acciones del archivo y selecciona Ver panel.

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

Una vez que estés satisfecho con tu panel, puedes 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 versiones 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 la navegación izquierda. La carpeta Paneles de LookML es única de otras carpetas de varias 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 cualquier mosaico determinado dentro de un panel de LookML, los usuarios 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 cualquier 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 Paneles de LookML.
• En Modo de producción, la lista de la carpeta Paneles de LookML está paginada (30 paneles por página). En el Modo de desarrollo, todos los paneles de LookML están en una sola página.
• Cada panel de LookML se ordena en la carpeta Paneles de LookML según el nombre del panel de LookML que se define en el código del panel de LookML, en lugar del título del panel de LookML. Como resultado, es posible que los paneles no aparezcan ordenados alfabéticamente por título.

Cómo mover paneles de LookML fuera de la carpeta Paneles de LookML

Si tienes los see_lookml_dashboards y develop permisos de Looker, 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 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 Cómo organizar y administrar 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 selecciona la carpeta a la que deseas mover el panel.

Si estás en el Modo de desarrollo, no puedes mover los paneles de LookML fuera de la carpeta Paneles de LookML. En cambio, puedes 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 paneles de LookML muestra los paneles de LookML en una sección 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 un tablero. Sin embargo, a diferencia de los paneles definidos por el usuario, los paneles de LookML no se pueden cambiar de nombre ni mover a la papelera desde una carpeta.

Cuando se mueve un panel de LookML fuera de la carpeta Paneles de LookML, hereda los controles de acceso de la carpeta de destino. Para ver un panel de LookML en otra carpeta, los usuarios (incluidos los usuarios incorporados) deben tener el permiso see_looks o see_user_dashboards, además de acceso a la carpeta de destino y al modelo de LookML del panel. Los usuarios que solo tienen el permiso see_lookml_dashboards no pueden ver los paneles de LookML que se movieron fuera de la carpeta Paneles de LookML.

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.

Cómo ver el LookML de un panel de LookML existente

Si tienes el permiso see_lookml, puedes navegar al LookML del panel para un panel de LookML existente. Para ello, selecciona 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.

Cómo extender 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, y es posible que agregues o anules 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 la extensión para obtener más información.

Cómo agregar agentes del panel a paneles de LookML

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Puedes configurar agentes de datos del panel de Conversational Analytics para tus paneles de LookML. Los agentes del panel permiten a los usuarios hacer preguntas sobre los datos del panel en lenguaje natural con una interfaz de chat conversacional.

Para configurar un agente del panel para un panel de LookML, haz lo siguiente:

1. Define un agente del panel en un archivo de LookML con el parámetro agent con is_dashboard_agent: yes y tus instructions personalizadas.
2. En tu archivo .dashboard.lookml, asocia el agente con el panel de LookML con el parámetro default_dashboard_agent. Controla el acceso al chat con el enabled_dashboard_agent parámetro. Por ejemplo:

- dashboard: sales_overview
  title: "Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

Puedes probar las instrucciones y el comportamiento del agente en Modo de desarrollo antes de implementarlos en producción. Para obtener detalles completos sobre la configuración, la prueba y la administración de agentes del panel de LookML, consulta la página de documentación Crea y administra agentes de datos para paneles de LookML.

Cómo mejorar el rendimiento del panel con el reconocimiento de agregaciones

Los desarrolladores de LookML pueden mejorar el rendimiento del panel de LookML con el reconocimiento de agregaciones. Con el reconocimiento de agregaciones, los desarrolladores pueden crear tablas de agregaciones 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 estés viendo un panel de LookML, puedes usar la opción Obtener LookML de la tabla de datos agregados en el menú de tres puntos Acciones del panel, que es 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: Encontrarás más información y recomendaciones sobre la creación de paneles de alto rendimiento en la página Prácticas recomendadas para crear paneles de Looker de alto rendimiento.