O Looker inclui uma lista robusta de tipos de visualização incorporados, o que lhe permite representar os seus dados em gráficos de várias formas. Se precisar de um tipo de gráfico que não esteja incluído nos tipos de visualização incorporados do Looker, o Looker oferece várias formas de adicionar visualizações JavaScript personalizadas à sua instância do Looker:
- Adicione um parâmetro
visualization
ao ficheiro de manifesto do seu projeto LookML para adicionar visualizações personalizadas diretamente ao projeto LookML. Consulte a página de documentação do parâmetrovisualization
para mais informações. - Instale uma visualização a partir do Looker Marketplace. Com a funcionalidade Marketplace ativada, pode instalar pacotes de visualização do mercado do Looker.
- Use a página Visualizações na secção Plataforma do menu Administração do Looker para instalar e administrar visualizações de JavaScript personalizadas a partir do repositório de visualizações personalizadas do Looker.
Esta página descreve como adicionar visualizações JavaScript personalizadas através da página Visualizações no painel Administração do Looker.
Ver uma lista de visualizações personalizadas
Para obter a funcionalidade completa das visualizações transferidas, os administradores das implementações alojadas pelo cliente devem certificar-se de que instalam a versão adequada do renderizador do Chromium.
A página Visualizações na secção Plataforma do menu Administração do Looker apresenta 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. Este valor é atribuído no código JavaScript ou quando adiciona ou edita uma visualização através da página Administração, ou no parâmetro
id
da visualização quando adiciona uma visualização através do ficheiro de manifesto do projeto LookML. - Etiqueta: o nome atribuído ao tipo de visualização no menu de visualização do Looker. Este valor é atribuído quando adiciona ou edita uma visualização através da página Administração ou no parâmetro
label
da visualização quando adiciona uma visualização através do ficheiro de manifesto do projeto LookML. - Principal: o URI do código JavaScript principal da visualização. Este valor é atribuído quando adiciona ou edita uma visualização através da página Administração ou no parâmetro
url
da visualização quando adiciona uma visualização através do ficheiro de manifesto do projeto LookML. - Ações: botões para editar ou eliminar a configuração de visualização. Estes botões não são apresentados para visualizações adicionadas através do ficheiro do manifesto do projeto LookML. Para editar estas visualizações, aceda ao ficheiro de manifesto do projeto LookML e edite o parâmetro
visualization
diretamente.
Obter uma visualização personalizada
Pode obter visualizações para personalizar e adicionar à sua instância do Looker a partir de várias origens, incluindo as seguintes:
- O Looker mantém uma biblioteca de visualizações personalizadas para utilização pública nesta página do GitHub do Looker. Pode encontrar instruções para usar a API Visualization do Looker para criar os seus próprios tipos de visualização nesta página do GitHub do Looker.
- O mercado do Looker autónomo, onde pode procurar visualizações, denominadas "plug-ins", e aceder ao respetivo código-fonte.
- O mercado do Looker acessível a partir da sua instância do Looker. Neste mercado, pode procurar e instalar visualizações diretamente na sua instância do Looker. Consulte a página de documentação Usar o mercado do Looker para mais informações sobre a instalação de visualizações a partir do mercado do Looker.
Adicionar uma nova visualização personalizada
Depois de saber que visualização quer adicionar à sua instância, pode usar a página Visualizações na secção Plataforma do menu Administração do Looker para adicionar uma visualização personalizada selecionando o botão Adicionar visualização.
O Looker apresenta a página Nova visualização:. Para adicionar uma nova visualização, siga estes passos:
No campo ID, introduza o ID exclusivo da visualização definido no JavaScript de visualização.
No campo Etiqueta, introduza o nome da visualização. O Looker apresenta este nome no menu de visualização do Looker num Explorar.
No campo Principal, introduza o URI do ficheiro JavaScript principal da visualização para direcionar o Looker para o seu repositório de código JavaScript.
Se o site que aloja o seu código de visualização personalizado usar um hash de integridade de subrecursos (SRI) para fins de validação, introduza o hash de SRI no campo Hash de SRI. Pode encontrar este campo em Opções avançadas. Os anfitriões de visualização personalizados do Looker não usam um hash SRI.
No campo Dependências, introduza os URIs de quaisquer outros ficheiros dos quais o JavaScript de visualização dependa e clique em Adicionar. Pode introduzir vários URIs separados por vírgulas ou adicioná-los um de cada vez. Pode encontrar o campo Dependencies em Advanced options (Opções avançadas).
Selecione Guardar.
Depois de adicionar a visualização, vê-la-á com a etiqueta que lhe atribuiu no menu de visualização de uma análise detalhada. Pode usar o novo tipo de visualização como qualquer um dos tipos de visualização existentes 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 aceder à visualização personalizada.Depois de selecionar a visualização, o nome da visualização aparece na barra de menus de visualização.
Editar uma visualização personalizada
Para editar uma visualização existente, selecione o botão Editar à direita da visualização. O Looker apresenta a mesma página que 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 preferenciais e, de seguida, clique em Guardar.
Eliminar uma visualização personalizada
Para eliminar uma visualização, selecione o botão Eliminar à direita da visualização na página Visualizações na secção Plataforma do menu Administração do Looker e, de seguida, clique em OK na caixa de confirmação.
A eliminação de uma visualização remove-a do Looker, mas não afeta nada no repositório de código externo da visualização.
A eliminação de uma visualização desativa todos os Looks ou painéis de controlo que usam esse tipo de visualização. Pode corrigir esta situação adicionando novamente a visualização eliminada com o mesmo ID de visualização.
Resolução de problemas
As visualizações personalizadas são um esforço suportado pela comunidade. A equipa de apoio técnico do Looker não resolve problemas relacionados com visualizações personalizadas nem com o código de visualização personalizada. Para monitorizar e resolver erros, use os problemas do GitHub no repositório da visualização personalizada ou visite a comunidade do Looker para ver publicações de instruções, conversas e sugestões sobre visualizações personalizadas.