O Looker inclui uma lista robusta de tipos de visualização integrados, que permitem criar gráficos com seus 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 nativa do Looker, o Looker oferece várias maneiras de adicionar visualizações JavaScript personalizadas à sua instância do Looker:
- Adicione um parâmetro
visualizationao arquivo de manifesto do projeto do LookML para incluir visualizações personalizadas diretamente no projeto. Consulte a página de documentação do parâmetrovisualizationpara mais informações. - Instale uma visualização do Marketplace do Looker. Com o recurso Marketplace ativado, você pode instalar plug-ins do Looker Marketplace, incluindo tipos de visualização que podem ser adicionados à biblioteca de visualização integrada do Looker. Consulte a página de documentação Como usar o Marketplace do Looker para mais informações sobre como instalar plug-ins do Marketplace do Looker. Consulte a página de documentação Como desenvolver uma visualização personalizada para o Marketplace do Looker para saber como criar uma visualização que pode ser adicionada ao Marketplace e acessada por outros usuários do Looker.
- Use a página Visualizações na seção Plataforma do menu Administrador do Looker para instalar e administrar as visualizações JavaScript personalizadas do repositório de visualizações personalizadas do Looker.
Nesta página, descrevemos como adicionar visualizações JavaScript personalizadas usando a página Visualizações no painel Administrador do Looker.
Conferir uma lista de visualizações personalizadas
Para garantir a funcionalidade completa das visualizações transferidas por download, os administradores de implantações hospedadas pelo cliente precisam instalar a versão adequada do renderizador do Chromium.
A página Visualizações na seção Plataforma do menu Administrador 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, quando você adiciona ou edita uma visualização usando a página Administrador 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 atribuído 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. - Main: 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 do LookML. Para editar essas visualizações, acesse o arquivo de manifesto do projeto do LookML e edite o parâmetro
visualizationdiretamente.
Como adicionar uma nova visualização personalizada
Você encontra uma lista de blocos de visualização do Looker no Marketplace do Looker. O Looker também mantém uma biblioteca de visualizações personalizadas para uso público nesta página do Looker no GitHub (em inglês). Confira instruções sobre como usar a API Visualization do Looker para criar seus próprios tipos de visualização nesta página do Looker no GitHub (em inglês).
Quando você souber qual visualização quer adicionar à instância, selecione o botão Adicionar visualização na página Visualizações, na seção Plataforma do menu Administrador do Looker.
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.
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 da sua visualização personalizada usar um hash de integridade de sub-recursos (SRI, na sigla em inglês) para fins de verificação, insira o hash de SRI no campo Hash de SRI (em inglês). Esse campo pode ser encontrado em Opções avançadas. Os hosts de visualização personalizada do Looker não usam um hash de SRI.
No campo Dependencies, insira os URIs de outros arquivos de que o JavaScript da visualização depende e clique em Add. É possível inserir vários URIs separados por vírgulas ou adicionar vários URIs um de cada vez. O campo Dependências fica em Opções avançadas.
Selecione Salvar.
Depois que a visualização for adicionada, ela vai aparecer conforme a rotulou no menu de visualização de uma Análise. É possível usar o novo tipo de visualização como qualquer um dos atuais do Looker.
Para acessar visualizações personalizadas no menu de visualização:
Selecione o ícone de três pontos
...na barra do menu de visualização para acessar a visualização personalizada.Depois que a visualização é selecionada, o nome dela aparece na barra do menu de visualização.
Editar uma visualização personalizada
Para editar uma visualização, selecione o botão Editar à direita dela. O Looker mostra a mesma página que você usa para adicionar uma visualização (descrita em Como adicionar uma nova visualização personalizada), mas com as informações relevantes já preenchidas. Faça as alterações e clique em Salvar.
Como 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 Administrador do Looker e clique em OK na caixa de confirmação.
Ao excluir uma visualização, ela é removida do Looker, mas não afeta nada no repositório externo de códigos dela.
A exclusão de uma visualização desativa os Looks ou dashboards que usam esse tipo de visualização. É possível corrigir isso adicionando novamente a visualização excluída com o mesmo ID da visualização.