Configurações de administrador: visualizações

O Looker inclui uma lista robusta de tipos de visualização integrados, o que permite criar gráficos com seus dados de várias maneiras. Se você precisa de um tipo de gráfico que não está 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:

  1. Adicione um parâmetro visualization ao arquivo de manifesto do projeto do LookML para incluir visualizações personalizadas diretamente no projeto. Consulte a página de documentação do parâmetro visualization para mais informações.
  2. Instale uma visualização do Marketplace do Looker. Com o recurso Marketplace 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 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.
  3. 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.

Como ver uma lista de visualizações personalizadas

Para garantir a funcionalidade completa das visualizações obtidas 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:

Como adicionar uma nova visualização personalizada

Você pode 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 (em inglês). Confira instruções sobre como usar a API de visualização 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:

  1. No campo ID, insira o ID exclusivo da visualização definida no JavaScript.

  2. 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.

  3. No campo Principal, insira o URI do arquivo JavaScript principal da visualização para direcionar o Looker ao repositório de código JavaScript.

  4. 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. 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.

  5. No campo Dependencies, insira os URIs de 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 um de cada vez. O campo Dependências fica em Opções avançadas.

  6. Selecione Salvar.

Depois de adicionar a visualização, ela vai aparecer conforme a nomeou 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:

  1. Selecione o ícone de três pontos ... na barra do menu "Visualização" para acessar a visualização personalizada.

  2. 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.

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 seu código de visualização personalizada. Para rastrear e resolver bugs, use os problemas do GitHub no repositório da visualização personalizada ou acesse a Comunidade Looker (em inglês) e confira postagens de instruções, conversas e dicas sobre visualizações personalizadas.