O Looker inclui uma lista robusta de tipos de visualização integrados, permitindo que você crie gráficos de dados de várias maneiras. Se você precisar de um tipo de gráfico que não esteja incluído nos tipos de visualização integrados do Looker, há várias maneiras de adicionar visualizações personalizadas do JavaScript à sua instância do Looker:
- Adicione um parâmetro
visualizationao arquivo de manifesto do seu projeto LookML para adicionar visualizações personalizadas diretamente ao seu projeto LookML. Consulte a página de documentação do parâmetrovisualizationpara mais informações. - Instale uma visualização no Marketplace do Looker. Com o recurso Marketplace ativado, você pode instalar pacotes de visualização do Marketplace do Looker.
- Use a página Visualizações na seção Plataforma do menu Admin do Looker para instalar e administrar visualizações personalizadas do JavaScript no repositório de visualizações personalizadas do Looker.
Esta página descreve como adicionar visualizações personalizadas do JavaScript usando a página Visualizações no painel Admin do Looker.
Conferir uma lista de visualizações personalizadas
Para ter acesso a todas as funcionalidades das visualizações baixadas, os administradores de implantações hospedadas pelo cliente precisam instalar a versão apropriada do renderizador do Chromium.
A página Visualizações na seção Plataforma do menu Admin do Looker lista todas as visualizações personalizadas que foram adicionadas à sua instância do Looker.
A lista inclui as seguintes colunas:
- ID: o ID exclusivo atribuído à visualização personalizada. Esse valor é atribuído no código JavaScript ou quando você adiciona ou edita uma visualização usando a página Admin ou no parâmetro
idda visualização ao adicionar uma visualização usando o arquivo de manifesto do projeto do LookML. - Rótulo: o nome dado ao tipo de visualização no menu de visualização do Looker. Esse valor é atribuído quando você adiciona ou edita uma visualização usando a página Administrador ou no parâmetro
labelda visualização ao adicionar uma visualização usando o arquivo de manifesto do projeto do LookML. - Principal: o URI do código JavaScript principal da visualização. Esse valor é atribuído quando você adiciona ou edita uma visualização usando a página Administrador ou no parâmetro
urlda visualização ao adicionar uma visualização usando o arquivo de manifesto do projeto do LookML. - Ações: botões para editar ou excluir a configuração da visualização. Esses botões não são mostrados para visualizações adicionadas usando o arquivo de manifesto do projeto LookML. Para editar essas visualizações, acesse o arquivo de manifesto do projeto LookML e edite o
visualizationparâmetro diretamente.
Origem de uma visualização personalizada
Você pode receber visualizações para personalizar e adicionar à sua instância do Looker de várias fontes, incluindo as seguintes:
- O Looker mantém uma biblioteca de visualizações personalizadas para uso público nesta página do GitHub do Looker. Você pode encontrar instruções para usar a API Visualization do Looker para criar seus próprios tipos de visualização nesta página do GitHub do Looker.
- O Marketplace do Looker independente, em que você pode procurar visualizações (chamadas de plug-ins) e acessar o código-fonte delas.
- O Marketplace do Looker, que pode ser acessado na sua instância do Looker. Nesse Marketplace, você pode navegar e instalar visualizações diretamente na sua instância do Looker. Consulte a página de documentação Como usar o Marketplace do Looker para mais informações sobre como instalar visualizações no Marketplace do Looker.
Adicionar uma nova visualização personalizada
Depois de saber qual visualização você quer adicionar à sua instância, use a página Visualizações na seção Plataforma do menu Admin do Looker para adicionar uma visualização personalizada selecionando o botão Adicionar visualização.
O Looker mostra a página Nova visualização. Para adicionar uma nova visualização, siga estas etapas:
No campo ID, insira o ID exclusivo da visualização definida no JavaScript de visualização.
No campo Rótulo, insira o nome da visualização. O Looker mostra esse nome no menu de visualização do Looker em uma análise.
No campo Principal, insira o URI do arquivo JavaScript principal da visualização para direcionar o Looker ao repositório de código JavaScript.
Se o site que hospeda o código de visualização personalizado usa um hash de integridade de sub-recurso (SRI) para fins de verificação, insira o hash de SRI no campo Hash de SRI. Esse campo pode ser encontrado em Opções avançadas. Os hosts de visualização personalizados do Looker não usam um hash de SRI.
No campo Dependências , insira os URIs de outros arquivos dos quais o JavaScript de visualização depende e clique em Adicionar. É possível inserir vários URIs separados por vírgulas ou adicionar vários URIs de uma só vez. O campo Dependências pode ser encontrado em Opções avançadas.
Selecione Salvar.
Depois que a visualização for adicionada, ela vai aparecer com o rótulo que você definiu no menu de visualização em uma análise. Você pode usar o novo tipo de visualização como qualquer um dos tipos de visualização atuais do Looker.
Para conferir visualizações personalizadas no menu de visualização:
Selecione o ícone de três pontos
...na barra de menus de visualização para acessar a visualização personalizada.Depois que a visualização for selecionada, o nome dela vai aparecer na barra de menus de visualização.
Editar uma visualização personalizada
Para editar uma visualização atual, selecione o botão Editar à direita da visualização. O Looker mostra a mesma página usada para adicionar uma visualização (descrita em Adicionar uma nova visualização personalizada), mas com as informações relevantes já preenchidas. Faça as mudanças preferidas e clique em Salvar.
Excluir uma visualização personalizada
Para excluir uma visualização, selecione o botão Excluir à direita da visualização na página Visualizações na seção Plataforma do menu Admin do Looker e clique em OK na caixa de confirmação.
A exclusão de uma visualização a remove do Looker, mas não afeta nada no repositório de código externo da visualização.
A exclusão de uma visualização desativa todas as aparências ou painéis que usam esse tipo de visualização. Você pode corrigir isso adicionando a visualização excluída com o mesmo ID de visualização.
Solução de problemas
As visualizações personalizadas são um esforço com suporte da comunidade. A equipe de suporte do Looker não resolve problemas relacionados a visualizações personalizadas ou ao código de visualização personalizado. Para rastrear e corrigir bugs, use os problemas do GitHub no repositório de visualização personalizado ou acesse a Comunidade do Looker para conferir postagens explicativas, conversas e dicas sobre visualizações personalizadas.