Como desenvolver uma visualização personalizada para o Marketplace do Looker

Esta página descreve como criar um tipo de visualização personalizada que pode ser adicionada ao Looker Marketplace e acessada por outros usuários do Looker. Também é possível criar uma visualização personalizada diretamente no seu projeto sem disponibilizá-la para outros clientes do Looker.

Você precisa ser membro da rede de parceiros ou cliente do Looker para enviar conteúdo ao Marketplace do Looker.

O Marketplace do Looker é um local central para encontrar, implantar e gerenciar vários tipos de conteúdo do Looker, como o Looker BlocksTM, aplicativos, visualizações e outros plug-ins.

Com o recurso Marketplace ativado, os clientes do Looker podem instalar plug-ins do Looker Marketplace, que incluem tipos de visualização para adicionar à biblioteca de visualização nativa do Looker.

Para desenvolver uma visualização personalizada e disponibilizá-la para todos os clientes do Looker no Marketplace do Looker, siga estas etapas:

1. Desenvolva uma visualização.
2. Criar um projeto do Looker para a visualização.
3. Envie o projeto do Looker para um repositório Git.
4. Testar a funcionalidade da visualização.
5. Envie sua visualização ao Looker.

Como desenvolver um tipo de visualização

Identifique um tipo de visualização que você gostaria de desenvolver. Confirme se ela ainda não está listada no Marketplace ou como uma visualização nativa do Looker.

Desenvolva sua visualização personalizada em JavaScript usando a API Looker Visualization com seu ambiente JavaScript.

Como criar um projeto do Looker para a visualização

Crie um projeto do Looker para representar sua visualização personalizada. O projeto precisa conter os seguintes arquivos:

• LICENSE file: lista as licenças com que a visualização é distribuída usando o texto:

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

• Arquivo README.md: fornece uma descrição da visualização, como ela funciona e outras informações adicionais.

• Arquivo JavaScript (.js): contém uma versão condensada do código JavaScript que você usou para produzir sua visualização. Com o Marketplace, os arquivos JS são incluídos no projeto, o que permite o controle de versões e o gerenciamento de pacotes adequados.

• Arquivo de manifesto (manifest.lkml): especifica um id (um identificador exclusivo) e um label (exibido na interface do Looker para essa visualização). Exemplo:

    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: []
    }

• Arquivo de listagem (marketplace.json): configura a listagem do Marketplace para a visualização personalizada e inclui um rótulo para mostrar como a visualização vai aparecer no Marketplace, o local do image_uri, um slogan que descreve o caso de uso da visualização e também define as constantes de campo do Marketplace que os usuários inserem durante a instalação. Exemplo:

{
  "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"
        }
    }
}

Como enviar o projeto para o Git

Hospede o LookML da sua visualização em um repositório GitHub de acesso público. Supondo que você tenha criado a visualização em um projeto do Looker, siga estas etapas para enviá-la por push a um novo repositório:

1. Crie um repositório do GitHub acessível publicamente.
2. Defina o URL do repositório do projeto do Looker como o URL do repositório do GitHub.
3. Siga os comandos do Git no Looker para validar, confirmar e implantar o código na produção.

testar a funcionalidade da visualização

Aplique a nova visualização a uma Análise ou Look apropriado na sua instância do Looker:

1. Navegue até "Olhar" ou "Explorar".
2. Se estiver em um Look, clique em Editar para editá-lo.
3. Clique no menu de três pontos no menu de tipo de visualização para abrir a lista suspensa de visualizações.
4. Selecione sua visualização personalizada.
5. Clique em Salvar para salvar a mudança no Look. Anote os painéis que podem ser afetados por essa mudança.

O Looker exige estas funções nas visualizações disponíveis no Marketplace do Looker:

Como enviar a visualização para análise

Quando a visualização estiver pronta para envio, siga as instruções em Como enviar conteúdo ao Marketplace do Looker para criar a documentação de apoio, enviar a visualização à equipe do Looker para análise e publicar a visualização no Marketplace do Looker.