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 cualquier dato que quieras 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.
Crea un panel con 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 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ú 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 te gustaría 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 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 Save en el menú settings del ícono de ajustes de Explore Actions.
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 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-define dashboard. 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 donde deseas guardar tu 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.
Agrega mosaicos y texto a un panel
Una vez que hayas creado un panel, el siguiente paso es agregar mosaicos y texto al panel.
El primer mosaico que agregas a un panel ocupa todo el ancho del panel. Los mosaicos adicionales que agregues tendrán un tamaño de un tercio del ancho del panel y se agregarán horizontalmente debajo del primer mosaico. Looker agrega filas adicionales de mosaicos según sea necesario. Puedes mover los mosaicos y cambiar su tamaño como desees. También puedes editar las tarjetas una vez que las hayas creado para ajustar sus nombres, las visualizaciones o las consultas o vistas subyacentes.
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.
Tipos de mosaicos de panel
Puedes agregar cuatro tipos de mosaicos a un panel:
Mosaicos de consulta
Los mosaicos de consultas 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 que no está vinculada a una vista. La consulta subyacente a 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 de la tarjeta de consulta. 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 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.
Un mosaico vinculado a una Vista vincula la consulta subyacente del mosaico 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 vistas de una carpeta diferente, primero copia la vista en la misma carpeta que el panel.
Un mosaico vinculado a Vista es una buena opción si quieres crear, cambiar y probar una consulta en un solo lugar, pero usarla en varios paneles. Si la Vista cambia, los mosaicos vinculados a ella cambiarán. Si se borra la Vista, los paneles muestran un error del mosaico.
Mosaicos de texto
Los mosaicos de texto se crean directamente dentro de 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.
Hay 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 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 un mosaico de consulta desde él.
Una vez que estés en el modo de edición del panel, puedes agregar un mosaico de consulta de una de estas dos 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 y, luego, elegir la opción Visualización.
A continuación, Looker muestra un menú de Exploraciones. Elige una exploración para comenzar a crear tu consulta.
Looker abre 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 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 Visualization.
- 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.
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 mosaicos de consultas desde una exploración
Puedes guardar una tarjeta 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ú de configuración del ícono de ajustes de Explorar acciones.
Esta acción abre la ventana Add to Dashboard:
- En el campo Título, ingresa un título para tu mosaico.
- 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 uno en la barra de búsqueda Filtrar por título... para reducir 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.
Agrega mosaicos desde una vista
Puedes agregar mosaicos de consultas y mosaicos vinculados a la vista a los paneles desde una vista.
Agrega mosaicos de consultas desde una vista
Para agregar mosaicos de consulta de una vista, 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 un mosaico de consulta desde una vista, se le asigna el mismo título que el nombre de la vista en el campo Título (que se puede editar más adelante).
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 uno en la barra de búsqueda Filtrar por título... para reducir los resultados.
Haz clic en Guardar en el panel.
Los mosaicos que agregues a un panel con este método no estarán conectados a la vista desde la que los creaste. Puedes editar los mosaicos sin afectar la vista. Puedes editar o borrar la vista sin afectar los mosaicos.
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 los mosaicos como desees.
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 mosaicos vinculados con 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 un mosaico vinculado con una Vista a un panel (consulta la sección Agrega mosaicos de consulta desde una Vista para ver elementos visuales), 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 la carpeta que contiene la vista y el panel esté seleccionada.
- 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 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 los mosaicos como desees.
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.
Agregando 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.
Hay 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 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 del mosaico de texto del mismo modo en que 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 dar formato al texto de la tarjeta, sigue estos pasos:
- Destaca el texto en el mosaico 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 el mosaico de texto, cambiará para mostrarte cómo se verá cuando lo guardes.
Para guardar tu mosaico, 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.
Agregar mosaicos 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 es compatible con un subconjunto del lenguaje de marcado de 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 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 alcance el ancho de su cuadro de mosaicos. Cuando la etiqueta alcance ese límite, se truncará. Si la etiqueta está truncada, 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 se mostrará cuando coloques el cursor sobre el botón. Si no ingresas un valor, la descripción predeterminada usará 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 del botón, puedes personalizar su aspecto:
Estilo del botón: Selecciona una opción:
- Completado: 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. De forma predeterminada, el cuadro de mosaicos del botón es de ancho completo, mientras que la alineación está centrada de forma predeterminada.
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 el botón y cambiar el tamaño del cuadro de mosaico como se hace con cualquier otro mosaico.
De forma predeterminada, se coloca un botón nuevo en la parte superior del panel, dentro de un cuadro de mosaico 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 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 Extensión en el menú Agregar. La opción Extensión te permite agregar una extensión personalizada como mosaico 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.
Desde el menú del botón Agregar en la parte superior izquierda 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 el nuevo mosaico de tu panel.
Cómo agregar acciones de datos a tarjetas
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 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 los mosaicos del panel pueden incluir filtros, pero también puedes agregarlos a un panel, lo que puede afectar a todos los mosaicos o solo a algunos seleccionados. 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 un mosaico vinculado con la vista 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.
Si quieres obtener más información para compilar filtros de panel estándar, visita la página de documentación Agrega y edita filtros de panel definidos por el usuario.
Si quieres obtener más información para activar los filtros cruzados del 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 esquina 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 al cargar: Habilitado
- Vista de filtros predeterminados: Expandida
Consulta la página de documentación Edita paneles definidos por el usuario para obtener más información sobre cómo editar esta 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 reconocimiento agregado
Los desarrolladores de LookML pueden mejorar el rendimiento del panel con el conocimiento agregado. Con el reconocimiento agregado, los desarrolladores pueden crear tablas agregadas bajo 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 Get LookML en el menú del í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 alto rendimiento en la página de prácticas recomendadas Consideraciones para compilar paneles de Looker de buen rendimiento.