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 está incluído nos tipos de visualização integrados do Looker, há várias maneiras de adicionar visualizações personalizadas em JavaScript à sua instância do Looker:
- Adicione um parâmetro
visualization
ao arquivo de manifesto do projeto LookML para adicionar visualizações personalizadas diretamente ao projeto. Consulte a página de documentação de parâmetros dovisualization
para mais informações. - Instale uma visualização do Looker Marketplace. Com o recurso Marketplace ativado, é possível instalar pacotes de visualização do Marketplace do Looker.
- 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 personalizadas em JavaScript usando a página Visualizações no painel Administrador do Looker.
Como visualizar 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 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 ao adicionar 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 ao adicionar 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
url
da visualização ao adicionar 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 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 parâmetro
visualization
diretamente.
Como criar uma visualização personalizada
É possível obter visualizações para personalizar e adicionar à sua instância do Looker de várias fontes, incluindo:
- O Looker mantém uma biblioteca de visualizações personalizadas para uso público nesta página do GitHub do Looker. Nesta página do GitHub do Looker, você encontra instruções para usar a API Visualization do Looker e criar seus próprios tipos de visualização.
- O Marketplace independente do Looker, onde você pode procurar visualizações (chamadas de "plug-ins") e acessar o código-fonte delas.
- O Marketplace do Looker acessível na sua instância do Looker. Nesse Marketplace, é possível navegar e instalar visualizações diretamente na sua instância do Looker. Consulte a página de documentação Como usar o Looker Marketplace para mais informações sobre como instalar visualizações do Looker Marketplace.
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 Administrador do Looker para adicionar uma visualização personalizada. Para isso, selecione 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 definido no JavaScript dela.
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 seu código de visualização personalizada usar um hash de integridade de subrecurso (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 personalizada do Looker não usam um hash SRI.
No campo Dependências, insira os URIs de outros arquivos de que o JavaScript de visualização depende e clique em Adicionar. É possível inserir vários URIs separados por vírgulas ou adicionar um de cada 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ê deu no menu de visualização de uma análise detalhada. Você pode usar o novo tipo de visualização como qualquer um dos tipos de visualização atuais do Looker.
Para ver 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.Depois que a visualização é selecionada, o nome dela aparece na barra de menus.
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 desejadas e clique em Salvar.
Como excluir uma visualização personalizada
Para excluir uma visualização, selecione o botão Excluir à direita dela na página Visualizações, na seção Plataforma do menu Administrador do Looker. Em seguida, 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 dela.
A exclusão de uma visualização desativa todas as análises ou painéis que usam esse tipo de visualização. Para corrigir isso, adicione de volta a visualização excluída com o mesmo ID.
Solução de problemas
As visualizações personalizadas são um esforço apoiado pela comunidade. A equipe de suporte do Looker não resolve problemas relacionados a visualizações personalizadas ou ao código delas. Para rastrear e corrigir bugs, use os problemas do GitHub no repositório da visualização personalizada ou acesse a Comunidade do Looker para conferir postagens de instruções, conversas e dicas sobre visualizações personalizadas.