Configuración del administrador: Visualizaciones

Looker incluye una lista sólida de tipos de visualización integrados que te permiten generar gráficos de tus datos de diversas maneras. Si necesitas un tipo de gráfico que no se incluye en los tipos de visualización integrados de Looker, Looker 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 paquetes de visualización de Looker Marketplace.
  3. Usa la página Visualizaciones en la sección Plataforma del menú Administrador de Looker para instalar y administrar visualizaciones de JavaScript personalizadas desde el repositorio de visualizaciones personalizadas de Looker.

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

Cómo ver una lista de visualizaciones personalizadas

Para obtener 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:

Cómo obtener una visualización personalizada

Puedes obtener visualizaciones para personalizar y agregar a tu instancia de Looker desde una variedad de fuentes, incluidas las siguientes:

  • Looker mantiene una biblioteca de visualizaciones personalizadas para uso público en esta página de GitHub de Looker. En esta página de GitHub de Looker, puedes encontrar instrucciones para usar la API de Visualization de Looker y crear tus propios tipos de visualización.
  • Looker Marketplace independiente, en el que puedes buscar visualizaciones (llamadas "complementos") y acceder a su código fuente
  • Looker Marketplace al que se puede acceder desde tu instancia de Looker En este Marketplace, puedes explorar e instalar visualizaciones directamente en tu instancia de Looker. Consulta la página de documentación Usa Looker Marketplace para obtener más información sobre cómo instalar visualizaciones desde Looker Marketplace.

Cómo agregar una nueva visualización personalizada

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 Visualización nueva:. 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 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 fines de verificación, ingresa el hash de SRI en el campo Hash de SRI. Este campo se encuentra en Opciones avanzadas. Los hosts de visualización personalizada de Looker no usan un hash de SRI.

  5. En el campo Dependencies, ingresa los URIs de cualquier otro archivo del que dependa el JavaScript de la visualización y haz clic en Add. Puedes ingresar varios URIs separados por comas o agregarlos uno por uno. El campo Dependencies se encuentra en Advanced options.

  6. Selecciona Guardar.

Una vez que se agregue la visualización, la verás con la etiqueta que le asignaste en el menú de visualización de un Explorar. Puedes usar el nuevo tipo de visualización como cualquier otro tipo de visualización existente de Looker.

Para ver las visualizaciones personalizadas en el menú de visualizaciones, 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 visualización.

Cómo editar una visualización personalizada

Para editar una visualización existente, selecciona el botón Editar que se encuentra a la derecha de la visualización. 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 pertinente ya completada. Realiza los cambios que prefieras y, luego, haz clic en Guardar.

Cómo borrar una visualización personalizada

Para borrar una visualización, selecciona el botón Borrar 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, se quitará de Looker, pero no se afectará nada en el repositorio de código externo de la visualización.

Si borras una visualización, se inhabilitarán las vistas o los paneles que usen ese tipo de visualización. Para corregir esto, 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 el código de visualización personalizada. Para hacer un seguimiento de los errores y solucionarlos, usa los problemas de GitHub en el repositorio de la visualización personalizada o visita la Comunidad de Looker para ver publicaciones instructivas, conversaciones y sugerencias sobre las visualizaciones personalizadas.

Visualizaciones personalizadas en blanco en las exportaciones de PDF o PNG

Las visualizaciones personalizadas en descargas de PDF o PNG se renderizan en blanco en las instancias de conexiones privadas de Looker (Google Cloud Core) que no tienen acceso saliente a Internet. Este problema se produce porque el renderizador de Chromium no puede recuperar dependencias externas de JavaScript (como D3 o jQuery) que se alojan en redes de distribución de contenido (CDN) públicas cuando se restringe el acceso saliente.

Para resolver este problema, usa una de las siguientes soluciones alternativas:

  • Incluye las dependencias en tu proyecto de LookML:
    1. Descarga el archivo .js de la dependencia externa requerida.
    2. Copia y pega el código de dependencia sin procesar en la parte superior de tu archivo de visualización personalizada .js.
    3. Guarda el archivo .js incluido en tu proyecto de LookML.
    4. Actualiza el archivo manifest.lkml para que apunte al archivo local usando el parámetro file en lugar de URLs externas en dependencies o url.
    5. Implementa los cambios en producción para que Looker entregue las dependencias de forma local.
  • Configura conexiones salientes para Private Service Connect: En el caso de las instancias que usan Private Service Connect, configura conexiones salientes (de sur a norte) para permitir que la instancia llegue a servicios externos y CDN públicas.

Para obtener más información sobre la solución de problemas del renderizador, consulta Solución de problemas del renderizador de Chromium.