Configuración del administrador: Visualizaciones

Looker incluye una lista sólida de tipos de visualización integrados que te permiten graficar tus datos de diferentes maneras. Si necesitas un tipo de gráfico que no se incluye en los tipos de visualización nativos de Looker, la plataforma proporciona varias formas de agregar visualizaciones personalizadas de JavaScript a tu instancia de Looker:

1. Agrega un parámetro visualization al archivo de manifiesto de tu proyecto de LookML para agregar visualizaciones personalizadas directamente a tu proyecto de LookML. Consulta la página de documentación del parámetro visualization para obtener más información.
2. Instala una visualización desde Looker Marketplace. Con la función Marketplace habilitada, puedes instalar complementos de Looker Marketplace, incluidos los tipos de visualización que puedes agregar a la biblioteca de visualizaciones integrada de Looker. Consulta la página de documentación Cómo usar Looker Marketplace para obtener más información sobre cómo instalar complementos desde Looker Marketplace. Consulta la página de documentación Cómo desarrollar una visualización personalizada para Looker Marketplace para obtener información sobre cómo crear una visualización que se pueda agregar a Looker Marketplace y a la que otros usuarios de Looker puedan acceder.
3. Usa la página Visualizaciones en la sección Plataforma del menú Administrador de Looker para instalar y administrar visualizaciones personalizadas de JavaScript desde el repositorio de visualizaciones personalizadas de Looker.

En esta página, se describe cómo agregar visualizaciones personalizadas de JavaScript con la página Visualizaciones en el panel Administrador de Looker.

Nota: Para acceder a todas las páginas de administración de Looker, debes tener el rol de administrador. Si tienes un permiso que habilita solo partes del panel Administrador, como manage_schedules o manage_themes, pero no tienes el rol de administrador, es posible que Looker no muestre las páginas que se describen en este artículo en el panel Administrador. Además, el permiso see_admin otorga permiso de solo lectura a la mayoría (pero no a todas) las páginas de administrador. Consulta la descripción de see_admin para obtener más información.

Cómo ver una lista de visualizaciones personalizadas

Para garantizar la funcionalidad completa de las visualizaciones descargadas, los administradores de las implementaciones alojadas por el cliente deben asegurarse de instalar la versión adecuada del renderizador de Chromium.

En la página Visualizaciones de la sección Plataforma del menú Administrador de Looker, se enumeran todas las visualizaciones personalizadas que se agregaron a tu instancia de Looker.

La lista incluye las siguientes columnas:

• ID: Es el ID único asignado a la visualización personalizada. Este valor se asigna en el código JavaScript o cuando agregas o editas una visualización con la página Administrador, o en el parámetro id de la visualización cuando agregas una visualización con el archivo de manifiesto del proyecto de LookML.
• Etiqueta: Es el nombre que se le asigna al tipo de visualización en el menú de visualización de Looker. Este valor se asigna cuando agregas o editas una visualización con la Página de administrador, o en el parámetro label de la visualización cuando agregas una visualización con el archivo de manifiesto del proyecto de LookML.
• Main: Es el URI del código JavaScript principal de la visualización. Este valor se asigna cuando agregas o editas una visualización con la Página de administrador, o en el parámetro url de la visualización cuando agregas una visualización con el archivo de manifiesto del proyecto de LookML.
• Acciones: Son botones para editar o borrar la configuración de la visualización. Estos botones no se muestran para las visualizaciones agregadas con el archivo de manifiesto del proyecto de LookML. Para editar estas visualizaciones, ve al archivo de manifiesto del proyecto de LookML y edita el parámetro visualization directamente.

Cómo agregar una nueva visualización personalizada

Puedes encontrar una lista de los bloques de visualización de Looker en el Marketplace de Looker. Looker también mantiene una biblioteca de visualizaciones personalizadas para uso público en esta página de GitHub de Looker. Puedes encontrar instrucciones para usar la API de Visualization de Looker para crear tus propios tipos de visualizaciones en esta página de GitHub de Looker.

Una vez que sepas qué visualización deseas agregar a tu instancia, puedes usar la página Visualizaciones en la sección Plataforma del menú Administrador de Looker para agregar una visualización personalizada. Para ello, selecciona el botón Agregar visualización.

Looker muestra la página Nueva visualización:. Para agregar una visualización nueva, sigue estos pasos:

1. En el campo ID, ingresa el ID único de la visualización definido en el código JavaScript de la visualización.

2. En el campo Etiqueta, ingresa el nombre de la visualización. Looker muestra este nombre en el menú de visualización de Looker en una exploración.

3. En el campo Principal, ingresa el URI del archivo JavaScript principal de la visualización para dirigir a Looker a tu repositorio de código JavaScript.

4. Si el sitio que aloja tu código de visualización personalizado usa un hash de integridad de subrecursos (SRI) para la verificación, ingresa el hash de SRI en el campo Hash de SRI. Puedes encontrar este campo en Opciones avanzadas. Los hosts de visualización personalizados de Looker no usan un hash de SRI.

5. En el campo Dependencias, ingresa los URIs de cualquier otro archivo del que dependa el código JavaScript de la visualización y haz clic en Agregar. Puedes ingresar varios URI separados por comas o agregar varios URI uno por uno. El campo Dependencias se encuentra en Opciones avanzadas.

6. Selecciona Guardar.

Una vez que se agregue la visualización, la verás como la etiquetaste en el menú de visualización en una exploración. Puedes usar el nuevo tipo de visualización como cualquier otro tipo de visualización existente de Looker.

Para ver visualizaciones personalizadas desde el menú de visualización, sigue estos pasos:

1. Selecciona el ícono de tres puntos ... en la barra de menú de visualización para acceder a la visualización personalizada.

2. Una vez que se selecciona la visualización, su nombre aparece en la barra de menú de la visualización.

Cómo editar una visualización personalizada

Para editar una visualización existente, selecciona el botón Editar que se encuentra a su derecha. Looker muestra la misma página que usas para agregar una visualización (descrita en Cómo agregar una nueva visualización personalizada), pero con la información relevante ya completada. Realiza los cambios que desees y, luego, haz clic en Guardar.

Borra una visualización personalizada

Para borrar una visualización, selecciona el botón Borrar que se encuentra a la derecha de la visualización en la página Visualizaciones de la sección Plataforma del menú Administrador de Looker y, luego, haz clic en Aceptar en el cuadro de confirmación.

Si borras una visualización, esta se quitará de Looker, pero no afectará nada en el repositorio de código externo de la visualización.

Si borras una visualización, se inhabilitarán los aspectos o paneles que usen ese tipo de visualización. Para corregirlo, vuelve a agregar la visualización borrada con el mismo ID de visualización.

Soluciona problemas

Las visualizaciones personalizadas son un esfuerzo respaldado por la comunidad. El equipo de asistencia al cliente de Looker no soluciona problemas relacionados con las visualizaciones personalizadas ni con tu código de visualización personalizada. Para hacer un seguimiento de los errores y cerrarlos, usa los problemas de GitHub en el repositorio de la visualización personalizada o visita la Comunidad de Looker para ver publicaciones instructivos, conversaciones y sugerencias sobre visualizaciones personalizadas.