O Looker inclui uma lista robusta de tipos de visualização integrados, permitindo que você represente 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
visualization
ao arquivo de manifesto do projeto do LookML para adicionar visualizações personalizadas diretamente ao projeto do LookML. Consulte a página de documentação do parâmetrovisualization
para mais informações. - Instale uma visualização do Marketplace do Looker. Com o recurso Marketplace do Looker ativado, é possível 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 do Looker e acessada por outros usuários.
- Use a página Visualizações na seção Plataforma do menu Administrador do Looker para instalar e administrar visualizações personalizadas em JavaScript 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.
Visualizar 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 ou quando você adiciona ou edita uma visualização usando a página Administrador ou no parâmetro
id
da visualização quando você adiciona uma visualização usando o arquivo de manifesto do projeto 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
label
da visualização quando você adiciona 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
url
da visualização quando você adiciona 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
visualization
diretamente.
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 GitHub do Looker.
Depois de saber qual visualização você quer adicionar à sua instância, use a página Visualizações na seção Plataforma do menu Administrador 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.
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 personalizada usar um hash de integridade da sub-recurso (SRI) para fins de verificação, insira o hash SRI no campo Hash SRI. Esse campo pode ser encontrado 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 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 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 como você a rotulou no menu de visualização em uma Análise detalhada. Você pode usar o novo tipo de visualização como qualquer um dos tipos de visualização do Looker.
Para acessar visualizações personalizadas no menu de visualização:
Selecione o ícone de três pontos
...
na barra de menu de visualização para acessar a visualização personalizada.Quando a visualização é selecionada, o nome dela aparece na barra de menus.
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 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.