Configuración del administrador: Visualizaciones

Looker incluye una lista sólida de tipos de visualización integrados que te permiten representar tus datos de diversas maneras. Si necesitas un tipo de gráfico que no esté incluido en los tipos de visualización integrados de Looker, Looker proporciona varias formas de agregar visualizaciones de JavaScript personalizadas 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. Puedes encontrar instrucciones para usar la API de Visualization de Looker para crear tus propios tipos de visualización en esta página de GitHub de Looker.
  • 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. Desde este Marketplace, puedes explorar e instalar visualizaciones directamente en tu instancia de Looker. Consulta la página de documentación Cómo usar Looker Marketplace para obtener más información sobre la instalación de visualizaciones desde Looker Marketplace.

Cómo agregar una nueva visualización personalizada

Una vez que sepas qué visualización quieres 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 definida en el JavaScript de 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 al 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 Dependencias , ingresa los URIs de cualquier otro archivo del que dependa el JavaScript de visualización y haz clic en Agregar. Puedes ingresar varios URIs separados por comas o agregar varios URIs de a uno. El campo Dependencias se encuentra en Opciones avanzadas.

  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 una exploración. Puedes usar el nuevo tipo de visualización como cualquiera de los tipos de visualización existentes 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, el nombre de la visualización 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 a la derecha de la visualización. Looker muestra la misma página que usas para agregar una visualización (que se describe 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 afectará nada en el repositorio de código externo de la visualización.

Si borras una visualización, se inhabilitarán todas las Looks 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 de Looker no soluciona problemas relacionados con las visualizaciones personalizadas ni con tu código de visualización personalizado. Para hacer un seguimiento de los errores y cerrarlos, usa los problemas de GitHub en el repositorio de visualización personalizada o visita la comunidad de Looker para ver publicaciones instructivas, conversaciones y sugerencias sobre visualizaciones personalizadas.

Visualizaciones personalizadas en blanco en exportaciones de PDF o PNG

Las visualizaciones personalizadas en descargas de PDF o PNG se renderizan en blanco en instancias de conexiones privadas de Looker (Google Cloud Core) que no tienen acceso a Internet saliente. Este problema se produce porque el renderizador de Chromium no puede recuperar dependencias externas de JavaScript (como D3 o jQuery) que están alojadas 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:

  • Agrupa las dependencias en tu proyecto de LookML:
    1. Descarga el archivo .js de dependencia externa requerido.
    2. Copia y pega el código de dependencia sin procesar en la parte superior de tu archivo .js de visualización personalizada.
    3. Guarda el archivo .js agrupado en tu proyecto de LookML.
    4. Actualiza el archivo manifest.lkml para que apunte al archivo local con el file parámetro en lugar de las URLs externas en dependencies o url.
    5. Implementa los cambios en la producción para que Looker publique las dependencias de forma local.
  • Configura las conexiones salientes para Private Service Connect: En el caso de las instancias que usan Private Service Connect, configura las conexiones salientes (de salida) 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.