Los paneles definidos por el usuario se crean en la IU de Looker. Para comparar y contrastar los paneles definidos por el usuario y los paneles de LookML, consulta la página de documentación Compara los paneles definidos por el usuario y los de LookML.
Para crear un panel, debes contar con lo siguiente:
- El nivel de acceso Administrar acceso, Editar de la carpeta en la que quieres colocar el panel
- Los permisos
save_contentysee_user_dashboardsde Looker
Además, debes tener acceso a los modelos de LookML para los datos que deseas usar en el 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.
Cómo crear un panel desde el botón Crear
Un botón Crear en el panel de navegación izquierdo de Looker te permite crear paneles. Para crear un panel, sigue estos pasos:
- Haz clic en el botón Crear.
- Selecciona el elemento de menú Panel. Se abrirá la ventana Crear panel.
- Ingresa un nombre para el panel nuevo en el campo Nombre.
- Navega hasta la carpeta en la que deseas guardar el panel y selecciónala. Como alternativa, puedes seleccionar el ícono Crear carpeta nueva create_new_folder para crear una carpeta nueva para el panel.
- Haz clic en Crear panel de control.
A continuación, aparecerá tu nuevo panel en blanco. Desde aquí, puedes ingresar al modo de edición para agregar tarjetas o texto. Para ingresar al modo de edición, haz clic en Editar panel en el menú Acciones del panel more_vert o haz clic en el botón Editar panel en el centro del panel.
Crea un panel a partir de una carpeta
Para crear un panel a partir de una carpeta, sigue estos pasos:
- Navega a la carpeta en la que desees que se ubique el panel.
- Haz clic en el botón New en la parte superior derecha de la carpeta.
Haz clic en la opción Panel.
Se abrirá la ventana Crear panel.
Ingresa un nombre para el panel nuevo en el campo Nombre.
Haz clic en Create Dashboard.
A continuación, aparecerá tu nuevo panel en blanco. Desde aquí, puedes ingresar al modo de edición para agregar tarjetas o texto. Para ingresar al modo de edición, haz clic en Editar panel en el menú con el ícono de tres puntos de Acciones del panel more_vert o haz clic en el botón Editar panel en el centro del panel.
Cómo crear un panel a partir de una vista o una exploración
Para crear un panel a partir de un Look o una Exploración, sigue estos pasos:
- Navega a una Vista o una Exploración.
- Haz clic en Guardar en el menú del ícono de ajustes de Explore Actions Configuración.
En el submenú, haz clic en Como panel nuevo.
Se abrirá la ventana Save as a new Dashboard.
En el campo Título, ingresa un nombre para tu panel nuevo.
El nombre que ingreses se aplicará a la tarjeta y al panel. Puedes modificar los nombres de los títulos en cualquier momento. Para cambiar el nombre de una tarjeta de consulta, consulta la subsección Cómo editar el título de una tarjeta de consulta en la página de documentación Cómo editar paneles definidos por el usuario. Para cambiar el nombre del panel, ingresa al modo de edición en el panel.
En la pestaña Configuración, haz clic en la carpeta en la que deseas guardar el panel. Debes tener el nivel de acceso Administrar acceso, Editar en la carpeta.
En la pestaña Filtros, haz clic en si quieres usar los filtros de la Vista o de Explorar como filtros para el panel. Los filtros personalizados no pueden convertirse en filtros del panel, pero permanecen como filtros de mosaicos.
Haz clic en Guardar.
La Vista o Explorar se guardarán como un mosaico de consulta en el panel.
Cómo agregar tarjetas y texto a un panel
Una vez que hayas creado un panel, el siguiente paso es agregar tarjetas y texto al panel.
La primera tarjeta que agregues a un panel ocupará todo el ancho del panel. Las tarjetas adicionales que agregues tendrán un tamaño de un tercio del ancho del panel y se agregarán horizontalmente debajo de la primera tarjeta. Looker agrega filas adicionales de tarjetas según sea necesario. Puedes mover y cambiar el tamaño de las tarjetas como quieras. También puedes editar las tarjetas una vez que las hayas creado para ajustar sus nombres, las visualizaciones o las consultas o vistas subyacentes.
En el caso de las tarjetas nuevas que se agregan a un panel, si se crearon desde la misma exploración que un filtro del panel, el filtro del panel se aplica automáticamente a esa tarjeta.
Tipos de tarjetas de panel
Puedes agregar cuatro tipos de tarjetas a un panel:
Mosaicos de consulta
Los mosaicos de consultas pueden crearse directamente dentro de un panel o agregarse a un panel desde una vista o desde una exploración.
Una tarjeta de consulta se basa en una consulta independiente, que no está vinculada a una vista. La consulta subyacente a un mosaico de consulta pertenece al panel. Incluso si usas un aspecto existente para crear una tarjeta de consulta, este se usará solo durante la creación de la tarjeta. El mosaico no se verá afectado por los cambios posteriores a esa vista y seguirá existiendo en el panel incluso si se borra la vista.
Cuando sea posible, usa tarjetas de consulta para evitar llenar tus carpetas con Looks innecesarios.
Mosaicos vinculados a la vista
Las tarjetas vinculadas a una vista se agregan a un panel desde una vista.
Una tarjeta vinculada a una vista vincula la consulta subyacente de la tarjeta a una vista. Esa vista se usa cuando se crea el mosaico y cada vez que se actualiza el panel. La vista y el panel deben estar en la misma carpeta. Si quieres agregar diseños de una carpeta diferente, primero cópialos en la misma carpeta que el panel.
Una tarjeta vinculada a la apariencia es una buena opción si deseas crear, cambiar y probar una consulta en un solo lugar, pero usarla en varios paneles. Si cambia el aspecto, también cambiarán las tarjetas vinculadas a él. Si se borra el aspecto, los paneles mostrarán un error para la tarjeta.
Mosaicos de texto
Las tarjetas de texto se construyen directamente en un panel.
Puedes usar mosaicos de texto para definir secciones visuales en un panel y agregar descripciones. Los mosaicos de texto de los paneles están diseñados para tener un formato flexible y para que, de forma predeterminada, se parezcan más a encabezados y descripciones que a mosaicos.
Existen dos tipos de tarjetas de texto, cada una de las cuales ofrece una experiencia de edición diferente, pero genera el mismo tipo de tarjeta:
- Texto: Es un mosaico de texto del panel que brinda una experiencia de edición visual.
- Markdown: Es la opción de mosaico de texto preexistente de Looker, que te permite usar algo de HTML y un subconjunto del lenguaje de marcado de Markdown para aplicar estilo al resultado de la tarjeta.
Tarjetas de extensión
Los mosaicos de extensiones son aplicaciones personalizadas llamadas extensiones que se agregan a un panel y se ejecutan desde dentro de un mosaico en el panel.
Compila mosaicos de consultas en un panel
Si estás en un panel, puedes crear una tarjeta de consulta desde allí.
Una vez que estés en el modo de edición del panel, puedes agregar una tarjeta de consulta de una de las siguientes maneras:
- Puedes hacer clic en el botón Agregar en la parte superior izquierda del panel y, luego, elegir la opción Visualization.
- Sin embargo, si el panel está en blanco, puedes seleccionar el botón Agregar en el centro del panel del panel y, luego, elegir la opción Visualización.
A continuación, Looker muestra un menú de Explorar. Elige una exploración para comenzar a crear tu consulta.
Looker abrirá la ventana Explorar para que puedas crear tu consulta. Para crear una consulta, sigue estos pasos:
- En el campo de título de la parte superior izquierda, ingresa un nombre para tu consulta. Este será el nombre de la tarjeta en el panel.
- Selecciona los campos y los filtros en el selector de campos.
- Configura tus opciones de visualización en el panel Visualization.
- Una vez que hayas configurado tu consulta, haz clic en Ejecutar.
- Haz clic en Guardar para guardar la consulta como tarjeta en tu panel.
En el caso de las tarjetas nuevas que se agregan a un panel, si se crearon desde la misma exploración que un filtro del panel, el filtro del panel se aplica automáticamente a esa tarjeta.
Cómo agregar mosaicos de consultas desde una exploración
Puedes guardar un mosaico de consulta en un panel directamente desde una Exploración. Una vez que te encuentres en una exploración y tengas una consulta que desees agregar al panel, sigue estos pasos:
Selecciona Guardar en el menú del ícono de ajustes configuración.
Esta acción abre la ventana Add to Dashboard:
- En el campo Título, asigna un título a la tarjeta.
- En la lista de carpetas, selecciona la carpeta en la que se ubica el panel.
- En la lista de paneles, selecciona el nombre del panel o escribe un nombre en la barra de búsqueda Filtrar por título… para acotar los resultados.
- Haz clic en Guardar en el panel.
Una vez que lo agregues como mosaico en un panel, aparecerá un mensaje de confirmación en la parte superior de Explorar. Si haces clic en el título del panel en el mensaje de confirmación, Looker te llevará directamente al panel en modo de edición. Desde allí, puedes mover y cambiar el tamaño de los mosaicos como desees.
Cuando se agregan mosaicos nuevos a un panel, si se crearon a partir de la misma exploración que un filtro de panel, el filtro se aplica automáticamente a ese mosaico.
Cómo agregar tarjetas desde una vista
Puedes agregar mosaicos de consultas y mosaicos vinculados a la vista a los paneles desde una vista.
Cómo agregar tarjetas de consulta desde una vista
Para agregar tarjetas de consulta desde un aspecto, sigue estos pasos:
- Navega a una vista.
- En la configuración del menú del ícono de ajustes Explorar acciones, selecciona Guardar . Esta acción abre un submenú.
Selecciona A un panel existente en el submenú.
Esta acción abre la ventana Add to Dashboard.
Cuando agregas una tarjeta de consulta desde un aspecto, se le asigna el mismo título que el nombre del aspecto en el campo Título (que se puede editar más adelante).
En la lista de carpetas, selecciona la carpeta en la que se encuentra el panel.
En la lista de paneles, selecciona el nombre del panel o escribe un nombre en la barra de búsqueda Filtrar por título… para acotar los resultados.
Haz clic en Guardar en el panel.
Las tarjetas que agregues a un panel a través de este método no estarán conectadas a la vista a partir de la que las creaste. Puedes editar los mosaicos sin afectar la vista. Puedes editar o borrar el aspecto sin afectar a las tarjetas.
Aparecerá un mensaje de confirmación en la parte superior de la Vista una vez que la hayas agregado como mosaico en un panel. Si haces clic en el título del panel en el mensaje de confirmación, Looker te llevará directamente al panel en modo de edición. Desde allí, puedes mover y cambiar el tamaño de las tarjetas como quieras.
En el caso de las tarjetas nuevas que se agregan a un panel, si la vista en la que se basaron se creó a partir de la misma exploración que un filtro del panel, el filtro del panel se aplica automáticamente a esa tarjeta.
Cómo agregar mosaicos vinculados con una vista desde una vista
Puedes guardar un mosaico vinculado con una vista en un panel directamente desde una Vista. Sin embargo, la vista y el panel deben estar en la misma carpeta.
Para agregar una tarjeta vinculada a un aspecto a un panel (consulta la sección Cómo agregar tarjetas de consulta desde un aspecto para ver imágenes), sigue estos pasos:
- Asegúrate de que el panel y la vista estén en la misma carpeta o copia la vista en la misma carpeta que el panel.
- Selecciona A un panel existente en el submenú. Se abrirá la ventana Add to Dashboard.
- Asegúrate de que esté seleccionada la carpeta que contiene el aspecto y el panel.
- Selecciona el panel.
- Haz clic en Agregar vista a panel.
Los mosaicos que agregues a un panel con este método se conectarán a la vista desde la que los creaste y tendrán el mismo título que la vista. Si editas el mosaico, la Vista y cualquier otro mosaico vinculado a ella se verán afectados. Si editas o borras la vista, los mosaicos se verán afectados.
Aparecerá un mensaje de confirmación en la parte superior del aspecto una vez que lo hayas agregado como tarjeta a un panel. Si haces clic en el título del panel en el mensaje de confirmación, Looker te llevará directamente al panel en modo de edición. Desde allí, puedes mover y cambiar el tamaño de las tarjetas como quieras.
Cuando se agrega un mosaico nuevo a un panel, si la vista en la que se basaba se creó desde la misma exploración que un filtro de panel, este se aplicará automáticamente a ese mosaico.
Cómo agregar texto
Una vez que un panel se encuentra en modo de edición, puedes agregarle mosaicos de texto haciendo clic en el botón Agregar en la esquina superior izquierda del panel.
Existen dos tipos de tarjetas de texto, cada una de las cuales ofrece una experiencia de edición diferente, pero genera el mismo tipo de tarjeta:
- Texto: Es un mosaico de texto del panel que brinda una experiencia de edición visual.
- Markdown: Es la opción de mosaico de texto preexistente de Looker, que te permite usar algo de HTML y un subconjunto del lenguaje de marcado Markdown para dar formato a la tarjeta.
Una vez que guardes el mosaico Texto o Markdown, lo verás en la parte inferior del panel. Luego, puedes mover y cambiar el tamaño de la tarjeta de texto de la misma manera que lo harías con otras tarjetas.
Cómo agregar tarjetas de texto
Los mosaicos de texto son mosaicos de texto del panel que proporcionan una experiencia de edición visual.
Para dar formato al texto de la tarjeta, sigue estos pasos:
- Destaca el texto de la tarjeta al que quieres aplicarle formato.
Haz clic en los íconos de estilo de texto en la parte superior de la tarjeta.
A medida que edites la tarjeta de texto, esta cambiará para mostrarte cómo se verá cuando la guardes.
Para guardar la tarjeta, haz clic en Guardar en el panel.
Para editar una tarjeta existente, ingresa al modo de edición, haz clic en el texto de la tarjeta para realizar los cambios y guarda el panel.
Cómo agregar tarjetas de Markdown
Los mosaicos de Markdown son mosaicos de texto del panel que se pueden formatear con HTML y Markdown.
Una vez que selecciones Markdown, aparecerá una ventana en la que podrás agregar un título, un subtítulo y un cuerpo. Estos elementos son opcionales.
Los títulos y los subtítulos admiten cierto código HTML, incluso las imágenes y los vínculos. También puedes usar código HTML en el cuerpo de los mosaicos de Markdown. Para comprender cómo Looker renderiza HTML, consulta la página de documentación sobre la limpieza de HTML.
El texto del cuerpo admite un subconjunto del lenguaje de marcado Markdown. Consulta la página de documentación Cómo usar Markdown en los mosaicos de Markdown para obtener más información sobre qué sintaxis de Markdown se admite en el texto del cuerpo.
Cómo agregar botones
La opción Botón del menú Agregar te permite agregar botones personalizados a tu panel. Puedes asignarle al botón un vínculo a una URL de Looker o a una externa. Luego, cuando un lector del panel selecciona el botón, se lo dirige a la URL.
Para agregar un botón a tu panel, sigue estos pasos:
- Asegúrate de que el panel esté en modo de edición.
Desde el menú del botón Agregar en la parte superior izquierda del panel, selecciona la opción Botón.
Aparecerá un botón nuevo en la parte superior del panel con una ventana de edición del botón abierta.
En la pestaña Contenido de la ventana de edición de botones, completa los siguientes campos:
- Etiqueta: Este texto aparecerá en el botón. El botón expande su ancho para adaptarse a la etiqueta hasta que esta alcanza el ancho de su cuadro de tarjeta. Cuando la etiqueta alcance ese límite, se truncará. Si la etiqueta se trunca, se puede repetir en el campo Descripción.
Vínculo: Es el vínculo al que lleva el botón a los usuarios.
Descripción: Esta descripción aparecerá cuando coloques el cursor sobre el botón. Si no ingresas un valor, la descripción predeterminada será el vínculo.
Abrir en una pestaña nueva del navegador: Selecciona esta opción para abrir automáticamente el vínculo en una pestaña nueva del navegador, en lugar de salir del panel. Esta opción está habilitada de forma predeterminada.
En la pestaña Design de la ventana de edición de botones, puedes personalizar la apariencia del botón:
Estilo de botón: Selecciona una de las siguientes opciones:
- Relleno: El botón tiene un fondo de color y texto blanco.
- Contorno: El botón tiene un contorno y texto de color.
- Transparente: El botón no tiene contorno ni fondo. Solo tiene texto de color.
Color: Selecciona un color de una de las colecciones de colores de Looker en la pestaña Temas o personaliza un color en la pestaña Personalizado. Luego, selecciona Guardar.
Tamaño del botón: elige Pequeño, Mediano o Grande para establecer el tamaño del texto del botón. La altura del botón se ajusta para ajustarse al texto. El tamaño predeterminado es mediano.
Alineación: Elige Izquierda, Centrar o Derecha para alinear horizontalmente el botón dentro del cuadro de mosaicos. El cuadro de tarjetas del botón tiene el ancho completo de forma predeterminada, y la alineación es centrada.
Haz clic en Guardar para guardar los cambios.
Cómo mover y cambiar el tamaño de los botones
Una vez agregado, se puede mover un botón y se puede cambiar el tamaño de su cuadro de tarjetas como con cualquier otra tarjeta.
De forma predeterminada, se coloca un botón nuevo en la parte superior de un panel dentro de un cuadro de tarjetas que se establece en el ancho completo del panel.
Cambiar el tamaño del cuadro de mosaicos de un botón puede afectar la ubicación de otros elementos del panel y el ancho de un botón. Sin embargo, solo puedes ajustar el tamaño o la altura del texto de un botón con la opción Tamaño del botón en la ventana de edición de botones.
Cómo agregar extensiones
Si tienes el rol de administrador de Looker o el permiso develop, o si se te otorgó acceso a una o más extensiones, verás la opción Extension en el menú Add. La opción Extension te permite agregar una extensión personalizada como tarjeta a tu panel.
Para agregar una extensión como tarjeta, sigue estos pasos:
Asegúrate de que el panel esté en modo de edición.
En el menú del botón Agregar, que se encuentra en la parte superior izquierda del panel del panel, selecciona la opción Extensión. Aparecerá el panel Extensiones con una lista de todas las extensiones disponibles que se pueden instalar como mosaico en tu panel.
En el panel Extensiones, en la sección de la extensión que quieras instalar, haz clic en Agregar al mosaico. La extensión seleccionada se instalará en la nueva tarjeta de tu panel.
Cómo agregar acciones de datos a tarjetas
Si tienes el permiso develop para el modelo en el que se basa una tarjeta, puedes agregar acciones de datos a ese modelo. Las acciones de datos permiten a los lectores del panel realizar tareas con otras herramientas directamente desde el mosaico del panel, como enviar un correo electrónico o establecer valores en otras aplicaciones. Estas acciones de datos aparecen en la sección Acciones del menú de desglose.
Consulta la página de documentación del parámetro action para obtener más información.
Agrega filtros de panel a un panel
Las consultas que subyacen a las tarjetas del panel pueden incluir filtros, pero también puedes agregar filtros al panel en sí, lo que puede afectar a todas las tarjetas o solo a algunas. Los filtros de paneles permiten a los usuarios limitar los resultados de un panel a solo los datos que les interesan.
Para agregar filtros de panel, debes tener al menos una tarjeta de consulta o una tarjeta vinculada a Look en el panel. Luego, puedes agregar filtros ingresando al modo de edición y seleccionando el botón Filtros filter_list en la barra de herramientas superior.
Para obtener más información sobre cómo crear filtros de panel estándar, visita la página de documentación Agrega y edita filtros de panel definidos por el usuario.
Para obtener información sobre cómo activar los filtros cruzados de los paneles, visita la página de documentación Paneles con filtros cruzados.
Configuración del panel
Puedes acceder a la configuración del panel en la parte superior izquierda del panel, en la barra de herramientas azul. La configuración predeterminada cuando creas un panel es la siguiente:
- Zona horaria: Es la zona horaria de cada mosaico.
- Ejecutar cuando finalice la carga: Habilitado
- Vista de filtros predeterminados: expandido
Consulta la página de documentación Cómo editar paneles definidos por el usuario para obtener más información sobre cómo editar estos parámetros de configuración.
Agrega una descripción a un panel
Para agregar una descripción a un panel, asegúrate de que esté en modo de edición y, luego, selecciona Mostrar detalles del panel en el menú Acciones del panel con el ícono de tres puntos more_vert.
A continuación, podrás editar el cuadro de texto Descripción.
Una vez que hayas agregado una descripción, haz clic en Guardar para guardar los cambios.
Mejora el rendimiento del panel con el conocimiento agregado
Los desarrolladores de LookML pueden mejorar el rendimiento de los paneles con la conciencia agregada. Con el conocimiento agregado, los desarrolladores pueden crear tablas agregadas en los parámetros explore de LookML, que pueden optimizar las consultas de una o más tarjetas en un panel. El primer paso es obtener el LookML de la tabla conjunta, que aparece en la opción Obtener LookML en el menú del ícono de tres puntos more_vert Acciones del panel. Para obtener más información, consulta la página de documentación del parámetro aggregate_table.
Encuentra más 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.