Configurações de administrador - Visualizações

O Looker inclui uma lista robusta de tipos de visualização nativos, permitindo criar gráficos com 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:

1. Adicionar um parâmetro visualization ao arquivo de manifesto do seu projeto LookML para adicionar visualizações personalizadas diretamente ao seu projeto LookML. Consulte a página de documentação do parâmetro visualization para mais informações.
2. Instalar uma visualização do Looker Marketplace. Com o recurso Marketplace do Looker ativado, você pode instalar plug-ins do Looker Marketplace, incluindo tipos de visualização que podem ser adicionados à biblioteca de visualização nativa do Looker. Consulte a página de documentação Como usar o Looker Marketplace para mais informações sobre como instalar plug-ins do Looker Marketplace. Consulte a página da documentação Como desenvolver uma visualização personalizada para o Looker Marketplace para mais informações sobre como criar uma visualização que possa ser adicionada ao Looker 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 visualizações de JavaScript personalizadas 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.

As visualizações personalizadas são um esforço de apoio da comunidade. A equipe de suporte do Looker não resolve problemas relacionados a visualizações personalizadas ou seu código de visualização personalizada. Para rastrear e encerrar bugs, use problemas do GitHub no repositório de visualização personalizada ou os Fóruns da comunidade ou a Central de Ajuda do Looker para ver instruções, conversas e dicas sobre visualizações personalizadas.

As visualizações compatíveis estão disponíveis para download por meio do Looker Marketplace.

Como ver uma lista de visualizações personalizadas

Para garantir a funcionalidade total das visualizações transferidas por download, os administradores de implantações hospedadas pelo cliente precisam instalar a versão apropriada 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 por meio de um dos métodos descritos acima:

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 de 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 são exibidos 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.

Adicionar uma nova visualização personalizada

Veja uma lista de Blocos do Viz 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 do GitHub (em inglês). Veja 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).

Depois de saber qual visualização você quer adicionar à instância, use a página Visualizações para adicionar uma visualização personalizada. Para isso, clique no botão Adicionar visualização no canto superior esquerdo da página.

O Looker mostra a página Nova visualização::

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

2. No campo Rótulo, insira o nome da visualização a ser exibida no menu de visualização do Looker. Por exemplo, veja como o Looker mostra uma visualização personalizada chamada "Sankey":

   

   • Clique no ícone de três pontos ... na barra de menus de visualização para acessar a visualização personalizada.
   • Depois que a visualização é selecionada, o nome dela aparece na barra de menus.

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

4. Se o site que hospeda seu código de visualização personalizado usar um hash de integridade de sub-recurso (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 SRI.

5. No campo Dependencies, insira os URIs de outros arquivos de que o JavaScript de visualização depende e clique em Adicionar. É possível incluir vários URIs separados por vírgulas ou adicionar vários URIs um de cada vez. O campo Dependencies está disponível em Opções avançadas.

6. Clique em Save.

Assim que a visualização for adicionada, ela será exibida da forma como você a rotulou no menu de visualização de um Explorar. É possível usar o novo tipo de visualização como qualquer outro do Looker.

Editar uma visualização personalizada

Para editar uma visualização existente, clique no botão Edit à direita da visualização. O Looker mostra a mesma página usada para adicionar uma visualização (descrita acima), 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, clique no botão Excluir à direita da visualização e clique em OK na caixa de confirmação. Isso remove a visualização do Looker, mas não afeta nada no repositório de códigos externos da visualização.

A exclusão de uma visualização desativa as visualizações ou os painéis que usam esse tipo de visualização. Para corrigir isso, adicione novamente a visualização excluída com o mesmo ID.