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 está incluído nos tipos de visualização nativa do Looker, ele oferece várias maneiras de adicionar visualizações personalizadas em JavaScript à sua instância:
- Adicione um parâmetro
visualizationao 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âmetrovisualizationpara mais informações. - Instale uma visualização do Marketplace do Looker. Com o recurso Marketplace ativado, é possível instalar plug-ins do Marketplace do Looker, 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.
Esta página descreve 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 salvas, 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
idda 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
labelda visualização quando você adiciona uma visualização usando o arquivo de manifesto do projeto do LookML. - Principal: o URI do código principal do JavaScript 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 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
visualizationdiretamente.
Como adicionar uma nova visualização personalizada
Confira uma lista dos 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 GitHub. 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 da 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 apontar o Looker para seu 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, na sigla em inglês) 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 Dependências, insira os URIs de todos os outros arquivos de que o JavaScript da 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 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 menu.
Como 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 mudanças 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.
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 todos os Looks ou painéis que usam esse tipo de visualização. Para corrigir isso, adicione a visualização excluída com o mesmo ID.
Solução de problemas
As visualizações personalizadas são um esforço coletivo. A equipe de suporte do Looker não resolve problemas relacionados a visualizações personalizadas ou ao código delas. Para acompanhar e corrigir bugs, use os problemas do GitHub no repositório da visualização personalizada ou acesse a Comunidade do Looker para conferir posts com instruções, conversas e dicas sobre visualizações personalizadas.