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 de LookML, consulta la página de documentación Compara los paneles definidos por el usuario y de LookML.
Para crear un panel, debes tener lo siguiente:
- El nivel de acceso Administrar acceso, editar para la carpeta en la que deseas colocar el panel
- Los permisos de Looker
save_contentysee_user_dashboards
Además, debes tener acceso a los modelos de LookML para cualquier dato que quieras usar en el 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.
Crea un panel a partir de una carpeta
Para crear un panel a partir de una carpeta, sigue estos pasos:
- Navega a la carpeta donde te gustaría ubicar el panel.
- Haz clic en el botón Nuevo en la parte superior derecha de la carpeta.
Haz clic en la opción Panel.
Se abrirá la ventana Crear panel.
Asígnale un nombre al panel nuevo en el campo Nombre.
Haz clic en Crear panel de control.
A continuación, aparecerá tu nuevo panel en blanco. Desde aquí, puedes agregar mosaicos o texto ingresando al modo de edición. 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.
Crea un panel a partir de una vista o una exploración
Para crear un panel a partir de una vista o una exploración, sigue estos pasos:
- Navega a una vista o una exploración.
- Haz clic en Guardar en el ícono de ajustes del menú de configuración de Explorar acciones.
Haz clic en As new Dashboard en el submenú.
Se abrirá una ventana Guardar como panel nuevo.
En el campo Título, ingresa un nombre para el panel nuevo.
El nombre que ingreses se aplicará tanto al mosaico como al panel. Puedes modificar los nombres de los títulos en cualquier momento. Para cambiar el nombre del mosaico de un mosaico de consulta, consulta la subsección Edita el título de un mosaico de consulta en la página de documentación Editing user- Búsquedas del panel. 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 y editar para la carpeta.
En la pestaña Filtros, haz clic en si quieres usar los filtros de la vista o de la exploración como filtros del panel. Los filtros personalizados no pueden convertirse en filtros del panel, pero permanecen como filtros de mosaicos.
Haz clic en Guardar.
La vista o la exploración se guardarán como un mosaico de consulta en el panel.
Cómo agregar mosaicos y texto a un panel
Una vez que hayas creado un panel, el siguiente paso es agregarle mosaicos y texto.
El primer mosaico que agregas a un panel ocupa todo el ancho de este. Los mosaicos adicionales que agregues tienen un tamaño equivalente a un tercio del ancho del panel y se agregan horizontalmente debajo del primer mosaico. Looker agrega filas adicionales de tarjetas según sea necesario. Puedes mover y cambiar el tamaño de los mosaicos como desees. También puedes editarlos una vez que los hayas creado para ajustar los nombres de los mosaicos, las visualizaciones o las consultas o las vistas subyacentes.
Si los mosaicos nuevos se agregan a un panel, si se crearon a partir de la misma exploración que un filtro de panel, este filtro se aplica automáticamente a ese mosaico.
Tipos de mosaicos de panel
Puedes agregar cuatro tipos de mosaicos a un panel:
Tarjetas de consulta
Los mosaicos de consulta se pueden crear directamente dentro de un panel o agregarse a un panel desde una vista o desde una exploración.
Un mosaico de consulta se basa en una consulta independiente, una que no está vinculada a una vista. La consulta subyacente de un mosaico de consulta pertenece al panel. Incluso si usas una vista existente para crear un mosaico de consulta, la vista solo se usa durante la creación del mosaico de la consulta. El mosaico no se verá afectado por ningún cambio posterior que se realice en esa vista y seguirá existiendo en el panel, incluso si se borra la vista.
Cuando sea posible, usa mosaicos de consultas para evitar saturar tus carpetas con vistas innecesarias.
Mosaicos vinculados a la vista
Los mosaicos vinculados a la vista se agregan a un panel desde una vista.
Una tarjeta vinculada a la vista vincula la consulta subyacente de la tarjeta a una vista. Esa vista se usa cuando se crea la tarjeta y cada vez que se actualiza el panel. La vista y el panel deben estar en la misma carpeta. Si quieres agregar vistas de otra carpeta, primero copia la vista en la misma carpeta que el panel.
Un mosaico vinculado a la vista es una buena opción si deseas crear, cambiar y probar una consulta en un solo lugar, pero usarla en varios paneles. Si la vista cambia, también cambiarán los mosaicos vinculados a ella. Si se borra la vista, los paneles mostrarán un error para la tarjeta.
Mosaicos de texto
Los mosaicos de texto se crean directamente en un panel.
Puedes usar mosaicos de texto para definir secciones visuales en un panel y agregar descripciones. Los mosaicos de texto en los paneles están diseñados para tener un formato flexible y, de forma predeterminada, para parecerse más a encabezados y descripciones que a mosaicos.
Existen dos tipos de mosaicos de texto, cada uno de los cuales ofrece una experiencia de edición diferente, pero da como resultado el mismo tipo de mosaico:
- Texto: Es un mosaico de texto del panel que proporciona una experiencia de edición visual.
- Markdown: Es la opción de mosaico de texto preexistente de Looker, que te permite usar algún HTML y un subconjunto del lenguaje de marcado Markdown para darle estilo al resultado de la tarjeta.
Mosaicos de extensiones
Los mosaicos de extensiones son aplicaciones personalizadas llamadas extensiones que se agregan a un panel y se ejecutan desde dentro de un mosaico de panel.
Creación de mosaicos de consultas en un panel
Si estás en un panel, puedes compilar un mosaico de consulta desde el panel.
Una vez que estés en el modo de edición del panel, puedes agregar un mosaico de consulta de dos maneras:
- Puedes hacer clic en el botón Agregar en la esquina superior izquierda del panel del panel y, luego, elegir la opción Visualización.
- Sin embargo, si el panel está en blanco, puede seleccionar el botón Agregar en el centro del panel y, luego, elegir la opción Visualización.
A continuación, Looker mostrará un menú de Exploraciones. 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 en la parte superior izquierda, ingresa un nombre para tu consulta. Este será el nombre del mosaico en el panel.
- Selecciona los campos y los filtros en el selector de campos.
- Configura tus opciones de visualización en el panel Visualización.
- Una vez que hayas configurado tu consulta, haz clic en Ejecutar.
- Haz clic en Guardar para guardar la consulta como un mosaico en tu panel.
Si los mosaicos nuevos se agregan a un panel, si se crearon a partir de la misma exploración que un filtro de panel, este filtro se aplica automáticamente a ese mosaico.
Agrega mosaicos de consulta desde una exploración
Puedes guardar un mosaico de consulta en un panel directamente desde Explorar. Una vez que estés en una exploración y tengas una consulta que quieras agregar al panel, sigue estos pasos:
Selecciona Guardar en la configuración del menú del ícono de ajustes de Explorar acciones.
Esta acción abre una ventana Agregar al panel:
- En el campo Title, asígnale un título a la tarjeta.
- En la lista de carpetas, selecciona la carpeta donde se encuentra el panel.
- En la lista de paneles, selecciona el nombre del panel o escribe uno 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 la exploración. 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.
Si los mosaicos nuevos se agregan a un panel, si se crearon a partir de la misma exploración que un filtro de panel, este filtro se aplica automáticamente a ese mosaico.
Cómo agregar mosaicos desde una vista
Puedes agregar mosaicos de consulta y mosaicos vinculados con la vista a los paneles desde una vista.
Agrega mosaicos de consulta desde una vista
Para agregar mosaicos de consulta desde una vista, sigue estos pasos:
- Navega a una vista.
- En la configuración del menú del ícono de ajustes de Explorar acciones, selecciona Guardar . Esta acción abre un submenú.
Selecciona A un panel existente en el submenú.
Esta acción abre una ventana Agregar al panel.
Cuando agregas un mosaico de consulta desde una vista, el mosaico recibe el mismo título que el nombre de la vista en el campo Title (que se puede editar más adelante).
En la lista de carpetas, selecciona la carpeta donde se encuentra el panel.
En la lista de paneles, selecciona el nombre del panel o escribe uno en la barra de búsqueda Filtrar por título... para acotar los resultados.
Haz clic en Guardar en el panel.
Los mosaicos que agregues a un panel con este método no se conectarán a la vista a partir de la que los creaste. Puedes editar los mosaicos sin afectar la vista. Puedes editar o borrar la vista sin afectar los mosaicos.
Una vez que la agregues como mosaico en un panel, aparecerá un mensaje de confirmación en la parte superior de la vista. 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.
Para cada mosaico nuevo que se agrega a un panel, si la vista en la que se basa se creó a partir de la misma exploración que un filtro de panel, el filtro de panel se aplica automáticamente a ese mosaico.
Cómo agregar mosaicos vinculados a una vista desde una vista
Puedes guardar un mosaico vinculado a la vista en un panel directamente desde una vista. Sin embargo, la vista y el panel deben estar en la misma carpeta.
Para agregar un mosaico vinculado a la vista a un panel (consulta la sección Cómo agregar mosaicos de consulta desde una vista para las 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á una ventana Agregar al panel.
- Asegúrate de que la carpeta que contiene la vista y el panel esté seleccionada.
- Selecciona el panel.
- Haz clic en Add Look to Dashboard.
Cualquier mosaico que agregues a un panel a través de este método se conectará a la vista a partir de la que los creaste y tendrá el mismo título que la vista. Si editas la tarjeta, se verán afectadas la vista y cualquier otra tarjeta que esté vinculada a ella. Si editas o borras la vista, los mosaicos se verán afectados.
Una vez que la agregues como mosaico en un panel, aparecerá un mensaje de confirmación en la parte superior de la vista. 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.
Para cada mosaico nuevo que se agrega a un panel, si la vista en la que se basa se creó a partir de la misma exploración que un filtro de panel, el filtro de panel se aplica automáticamente a ese mosaico.
Cómo agregar texto
Una vez que un panel esté 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 mosaicos de texto, cada uno de los cuales ofrece una experiencia de edición diferente, pero da como resultado el mismo tipo de mosaico:
- Texto: Es un mosaico de texto del panel que proporciona una experiencia de edición visual.
- Markdown: Es la opción de mosaico de texto preexistente de Looker, que te permite usar código HTML y un subconjunto del lenguaje de marcado Markdown para darle formato a la tarjeta.
Una vez que hayas guardado el mosaico de Texto o Markdown, lo verás en la parte inferior del panel. Luego, puedes mover el mosaico de texto y cambiar su tamaño como lo harías con otros mosaicos.
Cómo agregar mosaicos de texto
Los mosaicos de texto son mosaicos de texto del panel que proporcionan una experiencia de edición visual.
Para darle formato al texto de la tarjeta, sigue estos pasos:
- Destaca el texto del mosaico al que quieras aplicarle formato.
Haz clic en los íconos de estilo de texto que se encuentran en la parte superior del mosaico.
A medida que edites el mosaico de texto, cambiará para mostrarte cómo aparecerá cuando lo guardes.
Para guardar la tarjeta, haz clic en Guardar en el panel.
Para editar un mosaico existente, ingresa al modo de edición, haz clic en el texto del mosaico para realizar los cambios y guarda el panel.
Cómo agregar mosaicos de Markdown
Los mosaicos de Markdown son mosaicos de texto del panel a los que se les puede dar formato con HTML y Markdown.
Una vez que selecciones Markdown, aparecerá una ventana en la que podrás agregar un título, subtítulo y un cuerpo. Estos elementos son opcionales.
Los títulos y subtítulos admiten código HTML, como imágenes y 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 de Limpieza de HTML.
El texto del cuerpo admite un subconjunto del lenguaje de marcación Markdown. Consulta la página de documentación Cómo usar Markdown en mosaicos 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 URL externa. Luego, cuando un visualizador 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.
En el menú del botón Agregar en la parte superior izquierda del panel 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 de botones abiertos.
En la pestaña Contenido de la ventana de edición del botón, 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 mosaicos. Una vez que 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 redirige 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 se habilita de forma predeterminada.
En la pestaña Design de la ventana de edición del botón, puedes personalizar su apariencia:
Estilo del botón: Selecciona una opción:
- 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 en 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 adaptarse al texto. El tamaño predeterminado es mediano.
Alineación: Elige Izquierda, Centro o Derecha para alinear horizontalmente el botón dentro de su cuadro de mosaicos. De forma predeterminada, el cuadro de mosaico del botón tiene el ancho completo y la alineación se centra de forma predeterminada.
Haz clic en Guardar para guardar los cambios.
Cómo mover botones y cambiar su tamaño
Una vez agregado, un botón se puede mover y se puede cambiar el tamaño de su cuadro de mosaicos como con cualquier otro mosaico.
De forma predeterminada, se coloca un botón nuevo en la parte superior del panel dentro de un cuadro de mosaicos que se configura en todo el ancho 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 puede afectar el ancho de un botón. Sin embargo, solo puedes ajustar el tamaño o la altura de un botón con la opción Tamaño del botón en la ventana de edición del botón.
Agrega 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 Extensión en el menú Agregar. La opción Extension te permite agregar una extensión personalizada como mosaico a tu panel.
Para agregar una extensión como mosaico, sigue estos pasos:
Asegúrate de que el panel esté en modo de edición.
En el menú del botón Agregar 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 quieres instalar, haz clic en Agregar al mosaico. La extensión seleccionada se instalará en el nuevo mosaico de tu panel.
Cómo agregar acciones de datos a los mosaicos
Si tienes el permiso develop para el model en el que se basa una tarjeta, puedes agregar acciones de datos a ese modelo. Las acciones de datos permiten a los visualizadores del panel realizar tareas con otras herramientas directamente desde la tarjeta 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 subyacentes a los mosaicos del panel pueden incluir filtros, pero también puedes agregar filtros al panel, lo que puede afectar a todos los mosaicos o solo a algunos. Los filtros de panel permiten a los usuarios limitar los resultados de un panel solo a los datos que les interesan.
Para agregar filtros de panel, debes tener al menos un mosaico de consulta o un mosaico vinculado a la vista en el panel. Luego, para agregar filtros, ingresa al modo de edición y selecciona el botón Filtros filter_list en la barra de herramientas superior.
Si deseas obtener más información para crear filtros de panel estándares, visita la página de documentación Agrega y edita filtros de panel definidos por el usuario.
Si deseas obtener información para activar los filtros cruzados en el panel, visita la página de documentación Paneles de filtrado cruzado.
Establece la configuración del panel
Puedes acceder a la configuración del panel en la barra de herramientas azul, en la esquina superior izquierda del panel. Las opciones de configuración predeterminadas cuando creas un panel son las siguientes:
- Zona horaria: Indica la zona horaria de cada mosaico.
- Ejecutar cuando se cargue: Habilitado
- Vista de filtros predeterminados: Expandida
Consulta la página de documentación Edición de paneles definidos por el usuario para obtener más información sobre cómo editar esta configuración.
Agregar 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ú del ícono de tres puntos de Acciones del panel more_vert.
El cuadro de texto Description se volverá editable.
Cuando hayas agregado una descripción, haz clic en Guardar para guardar el cambio.
Mejorar el rendimiento del panel utilizando el reconocimiento agregado
Es posible que los desarrolladores de LookML puedan mejorar el rendimiento del panel 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. El primer paso es obtener LookML de tabla conjunta, que aparece en la opción Obtener LookML en el menú con el ícono de tres puntos more_vert de 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 buen rendimiento en la página de prácticas recomendadas Consideraciones para crear paneles de Looker de buen rendimiento.