Desarrolla una visualización personalizada para Looker Marketplace

En esta página, se describe cómo crear un tipo de visualización personalizada que se pueda agregar a Looker Marketplace y que otros usuarios de Looker puedan acceder a él. También puedes crear una visualización personalizada directamente en tu proyecto sin ponerla a disposición de otros clientes de Looker.

Ten en cuenta que debes ser miembro de la Red de socios de Looker o cliente de Looker para enviar contenido a Looker Marketplace.

Looker Marketplace es una ubicación central para encontrar, implementar y administrar muchos tipos de contenido de Looker, como Looker BlocksTM, aplicaciones, visualizaciones y otros complementos.

Con la función Marketplace de Looker habilitada, los clientes de Looker pueden instalar complementos de Looker Marketplace, que incluyen tipos de visualización para agregar a la biblioteca de visualización nativa de Looker.

Si quieres desarrollar una visualización personalizada y ponerla a disposición de todos los clientes de Looker a través de Looker Marketplace, sigue estos pasos:

1. Desarrolla una visualización.
2. Crea un proyecto de Looker para la visualización.
3. Envía el proyecto de Looker a un repositorio de Git.
4. Prueba la funcionalidad de la visualización.
5. Envía tu visualización a Looker.

Desarrollar un tipo de visualización

Identifica un tipo de visualización que te gustaría desarrollar. Confirma que esta visualización no aparezca en Marketplace ni como visualización nativa de Looker.

Desarrolla tu visualización personalizada en JavaScript mediante la API de visualización de Looker con tu entorno de JavaScript.

Cómo crear un proyecto de Looker para la visualización

Crea un proyecto de Looker para representar tu visualización personalizada. El proyecto debe contener los siguientes archivos:

• Archivo LICENSE: Enumera las licencias con las que se distribuye la visualización mediante el siguiente texto:

  This Looker visualization is distributed with the following license:...

• Archivo README.md: Proporciona una descripción de tu visualización, cómo funciona y cualquier información adicional.

• Archivo JavaScript (.js): Contiene una versión condensada del código JavaScript que usaste para producir tu visualización. Con Marketplace, los archivos JS se incluyen en el proyecto, lo que permite un control de versiones y una administración de paquetes adecuados.

• Archivo de manifiesto (manifest.lkml): Especifica un id (un identificador único) y un label (que se muestra en la IU de Looker para esta visualización). Por ejemplo:

    constant: vis_id {
        value: "default_id"
        export: override_optional
    }
    constant: vis_label {
        value: "default_label"
        export: override_optional
    }
    visualization: {
        id: "@{vis_id}"
        label: "@{vis_label}"
        file: "my_local.js"
        sri_hash: "my_sri_hash"
        dependencies: []
    }

• Archivo de ficha (marketplace.json): Configura la ficha de Marketplace para la visualización personalizada y, además, incluye una etiqueta de cómo aparecerá la visualización en Marketplace, la ubicación del image_uri, un eslogan que describe el caso de uso de la visualización y también define las constantes de campo de Marketplace que los usuarios ingresan durante la instalación. Por ejemplo:

{
  "label": "Gauge Visualization",
  "category_label": "plug-ins",
  "branding": {
    "image_uri": "https://marketplace-api.looker.com/visualization-screenshots/gauge_icon.png",
    "tagline": "Use the Gauge visualization to display a measure and progress to a goal."
  },
   "constants": {
        "vis_label": {
            "label": "Visualization Label",
            "description": "This label will appear in the visualization selector in the Looker Explore UI."
        },
        "vis_id": {
            "label": "Visualization Id",
            "description": "This must be a unique ID across all visualizations.",
            "value_constraint": "visualization"
        }
    }
}

Envía el proyecto a Git

Aloja tu LookML de visualización en un repositorio de GitHub de acceso público. Si creaste la visualización en un proyecto de Looker, sigue estos pasos para enviarla a un repositorio nuevo:

1. Crea un repositorio de GitHub de acceso público.
2. Establece la URL del repositorio de tu proyecto de Looker en la URL de tu repositorio de GitHub.
3. Sigue las indicaciones de Git en Looker para validar, confirmar e implementar tu código en la producción.

Probar la funcionalidad de la visualización

Prueba la nueva visualización aplicándola en una exploración o vista adecuada en tu instancia de Looker:

1. Navega a la Vista o Exploración.
2. Si estás en una vista, haz clic en Editar para modificarla.
3. Haz clic en el menú de tres puntos en el menú de tipo de visualización para abrir la lista desplegable de visualizaciones.
4. Selecciona tu visualización personalizada.
5. Haz clic en Guardar para guardar el cambio en la vista. Ten en cuenta los paneles que podrían verse afectados por este cambio.

Looker requiere las siguientes funciones en las visualizaciones disponibles en Looker Marketplace:

Envía la visualización para su revisión

Una vez que tu visualización esté lista para enviarla, sigue las instrucciones en Cómo enviar contenido a Looker Marketplace y crea documentación de respaldo para tu visualización, envíala al equipo de Looker para que la revise y publícala en Looker Marketplace.