O Looker tem uma lista robusta de tipos de visualização integrados, para que você crie gráficos de várias maneiras nos seus dados. Se você precisar de um tipo de gráfico não 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 LookML para incluir visualizações personalizadas diretamente no projeto. Consulte a página de documentação do parâmetrovisualizationpara mais informações. - Instalar uma visualização do Marketplace do Looker. Com o recurso Marketplace ativado, é possível instalar os plug-ins do Looker Marketplace, incluindo tipos de visualização que podem ser adicionados à biblioteca integrada do Looker. Consulte a página de documentação Como usar o Marketplace do Looker para saber 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 Visualizations na seção Platform do menu Admin do Looker para instalar e administrar 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.
Exibição de 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 Visualizations na seção Platform 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:
- Código: 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 na página Administrador ou no parâmetro
iddela quando adiciona uma visualização usando o arquivo de manifesto do projeto LookML. - Rótulo: o nome dado ao tipo de visualização no menu do Looker. Esse valor é atribuído quando você adiciona ou edita uma visualização usando a página Administrador ou no parâmetro
labeldela quando adiciona uma visualização usando o arquivo de manifesto do projeto 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
urldela quando adiciona uma visualização usando o arquivo de manifesto do projeto LookML. - Ações: botões para editar ou excluir a configuração de visualização. Esses botões não aparecem nas 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 parâmetro
visualizationdiretamente.
Como adicionar uma nova visualização personalizada
É possível encontrar 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. Confira instruções sobre como usar a API Visualization do Looker para criar tipos de visualização nesta página do Looker no GitHub (em inglês).
Quando você souber qual visualização você quer adicionar à sua instância, selecione o botão Adicionar visualização na página Visualizações, na seção Plataforma do menu Administrador do Looker para adicionar uma visualização personalizada.
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 dela.
No campo Rótulo, insira o nome da visualização. O Looker mostra esse nome no menu de visualização em uma Análise.
No campo Main, 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 seu código de visualização personalizada usar um hash de integridade de sub-recursos (SRI) para fins de verificação, insira o hash de SRI no campo Hash de SRI. Esse campo fica em Opções avançadas. Os hosts de visualização personalizada do Looker não usam um hash SRI.
No campo Dependencies, insira os URIs de todos os 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 diversos URIs um de cada vez. O campo Dependencies pode ser encontrado em Advanced options.
Selecione Salvar.
Depois de adicionada, a visualização vai aparecer como você a rotulou no menu de visualização em uma Análise. É possível usar o novo tipo de visualização como qualquer outro tipo de visualização atual do Looker.
Para consultar visualizações personalizadas no menu de visualização, siga estas etapas:
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 será exibido na barra de menus.
Como editar uma visualização personalizada
Para editar uma visualização existente, 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 mudanças e clique em Salvar.
Como excluir uma visualização personalizada
Para excluir uma visualização, selecione o botão Delete à direita dela na página Visualizations na seção Platform do menu Admin do Looker e clique em OK na caixa de confirmação.
Excluir uma visualização a remove do Looker, mas não afeta nada no repositório de código externo dela.
Excluir uma visualização desativa todos os Looks ou dashboards com esse tipo de visualização. Você pode corrigir isso adicionando novamente a visualização excluída com o mesmo ID de visualização.