Como editar painéis definidos pelo usuário

Para editar um painel, você precisa atender aos seguintes pré-requisitos:

Além disso, para editar um bloco específico do painel, você precisa ter acesso ao modelo em que ele se baseia.

Se você não tiver acesso a todos os modelos em que os blocos de um painel específico se baseiam, ainda poderá editar outras partes dele, como o título, as configurações e os filtros (embora não veja sugestões de filtros com base em campos de um modelo a que você não tem acesso). Além disso, é possível editar os blocos para os quais você tem acesso ao modelo.

Ao editar um painel, lembre-se das práticas recomendadas para a criação deles. Encontre informações e recomendações sobre como criar painéis eficientes na página de práticas recomendadas Considerações ao criar painéis do Looker eficientes.

Como entrar no modo de edição dos painéis

Para entrar no modo de edição, selecione Editar dashboard no menu de três pontos Ações do dashboard.

No modo de edição, você pode adicionar, mover, editar ou excluir blocos ou filtros, além de editar o título do painel.

No modo de edição, o Looker mostra uma barra de ferramentas azul na parte de cima do painel com as seguintes opções:

  • Adicionar
  • Filtros
  • Configurações
  • Layout rápido
  • Cancelar
  • Salvar

Depois de fazer pelo menos uma edição, o botão Salvar vai ficar disponível. Clique em Salvar para salvar as edições e sair do modo de edição.

Para descartar as edições, clique em Cancelar. Na caixa de diálogo Descartar alterações?, clique em Descartar para confirmar que você quer cancelar e sair do modo de edição. A caixa de diálogo Descartar alterações? também aparece se você tentar sair do painel clicando no caminho de navegação ou nas setas para frente ou para trás do navegador.

Como reorganizar e redimensionar blocos

No modo de edição, é possível mover e redimensionar blocos em um painel.

Para mover um bloco, arraste o ícone de seis pontos no canto superior esquerdo. Quando você arrasta um bloco para um novo local no painel, linhas de grade azuis aparecem para ajudar a posicionar o bloco.

Para redimensionar um bloco, arraste o canto inferior direito dele ou use a opção Redimensionar bloco no menu de três pontos Ações do bloco, no canto superior direito de cada bloco. Os tamanhos predefinidos disponíveis são os seguintes:

  • Extrapequeno: cada bloco ocupa um sexto da linha do painel.
  • Pequeno: cada bloco ocupa um quarto da linha do painel.
  • Média: cada bloco ocupa um terço da linha do painel.
  • Grande: cada bloco ocupa metade da linha do painel.
  • Extragrande: cada bloco ocupa toda a largura da linha do painel.

Somente o bloco selecionado é redimensionado. Os tamanhos dos blocos são responsivos ao tamanho do painel.

Se você quiser redimensionar um bloco para que ele fique muito curto, ocultar o título pode ajudar a deixá-lo o menor possível.

Você também pode usar a opção Mover bloco no menu de edição do bloco para movê-lo para a parte de cima ou de baixo do painel.

Tamanho do bloco e layout da grade

Quando você adiciona uma visualização usando o layout de grade a um painel, a disposição da grade pode se tornar responsiva ao tamanho do bloco do painel.

Por exemplo, você tem um bloco de painel com uma visualização que usa um layout de grade de quatro gráficos pequenos. Se você dimensionar o bloco para ser curto e largo, os gráficos pequenos vão aparecer como uma linha de quatro. Se você dimensionar o bloco como um quadrado, os gráficos pequenos serão reposicionados em duas linhas de dois. Se você dimensionar o bloco para ser estreito, mas alto, os gráficos serão reposicionados para quatro linhas de um.

Para garantir que o arranjo de grade seja responsivo, não insira um número na configuração Número de gráficos por linha da visualização. Se você inserir um valor em Número de gráficos por linha, o bloco do painel vai respeitar essa configuração, independente do tamanho ou formato dele.

Como adicionar blocos

No modo de edição, você pode adicionar blocos ou texto ao painel. Consulte a página de documentação Como criar painéis definidos pelo usuário para saber como adicionar texto e blocos.

Editar blocos

No modo de edição, o menu de três pontos Ações do bloco no canto superior direito de cada bloco mostra as opções de edição disponíveis.

Essas opções variam um pouco dependendo se você está visualizando um bloco de consulta ou um bloco vinculado a um Look.

  • Em ambos os casos, o Looker mostra as opções Editar, Ocultar título, Adicionar observação e Mover bloco.
    • Para blocos de consulta, o Looker também mostra as opções Duplicar bloco, Excluir e Visualizar.
    • Para blocos vinculados a um Look, o Looker também mostra a opção Remover Look.

Editar o título de um bloco de consulta

No modo de edição, clique no título de um bloco de consulta e faça as edições. Clique em Salvar no canto superior direito do painel para salvar as mudanças.

Também é possível editar os títulos dos blocos de consulta e vinculados a um Look ao editar a consulta ou o Look de um bloco.

Editar a consulta ou o Look de um bloco

Se você salvar edições em um Look, isso vai afetar todos os painéis em que ele é usado.

No modo de edição, é possível editar a consulta ou o Look de um bloco, incluindo o título do bloco e a visualização, diretamente no painel.

Clique em Editar no menu de três pontos Ações do bloco.

Se você estiver editando uma Análise, a barra de ferramentas Editar Análise vai mostrar os painéis que contêm blocos vinculados a essa Análise. Esses painéis serão afetados pelas suas mudanças. Se você estiver editando um bloco de consulta, não vai ver uma lista de painéis afetados no painel de edição, porque suas edições afetam apenas o bloco e o painel em que você está.

Ao editar um bloco do painel que contém um gráfico de funil ou de linha do tempo, eles têm uma aparência diferente no bloco do painel e na janela de edição. Além disso, as dicas dos gráficos de mapa funcionam de maneira diferente quando visualizadas em blocos do painel. Para mais informações, acesse as páginas de documentação sobre gráfico de funil, gráfico de linha do tempo e gráfico de mapa.

Ocultar ou mostrar o título de um bloco

No modo de edição, é possível ocultar ou mostrar o título de um bloco. Por padrão, os títulos dos blocos são mostrados. Para ocultar um título, clique em Ocultar título no menu de três pontos Ações do bloco.

Se o título estiver oculto, o Looker vai mostrar a opção Mostrar título no menu de três pontos Ações do bloco.

A opção de ocultar/mostrar não aparece no menu de três pontos Ações do bloco dos blocos de texto ou dos blocos que usam visualizações de valor único. Para ocultar ou mostrar o título de uma visualização de valor único, clique em Editar no menu de três pontos Ações do bloco, ative ou desative a opção Mostrar título no menu de estilo e salve. Para ocultar ou mostrar o título de um bloco de texto, clique em Editar no menu de três pontos Ações do bloco, remova ou restaure o título e salve.

Adicionar uma nota de bloco

No modo de edição, clique no botão Adicionar observação no menu de três pontos Ações do bloco.

Insira o texto da observação e configure as seguintes opções de exibição:

  1. No campo Texto da observação, insira o texto da observação que vai aparecer no bloco. É possível usar texto simples ou HTML.
  2. No campo Local de exibição, selecione o local da observação. As opções ficam acima ou abaixo da visualização ou como texto que aparece quando os usuários mantêm os ponteiros sobre um ícone i circulado à direita do título do bloco. Para blocos que contêm visualizações de valor único com tamanho de 150 pixels de altura ou menos, as notas de título são renderizadas como texto ao passar o cursor, independente do local selecionado neste campo.
  3. Marque a caixa Reduzir observação para reduzir a observação por padrão. Uma nota recolhida mostra apenas a primeira linha, com reticências no final. Se você desmarcar essa caixa, o texto completo da observação vai aparecer por padrão. Se você selecionar Ao passar o cursor sobre o ícone em Mostrar local, essa opção não vai aparecer.
  4. Clique em Adicionar ou Cancelar para adicionar ou cancelar a observação no bloco.

A observação aparece no bloco com uma seta de recolher/expandir à esquerda. Clicar nessa seta ou em qualquer lugar da observação alterna entre as exibições recolhida e expandida.

Depois de adicionar uma observação a um bloco, o menu de três pontos Ações do bloco muda para mostrar Editar observação em vez de Adicionar observação. Clique em Editar observação para editar ou excluir sua observação.

Duplicar um bloco de consulta

No modo de edição, é possível duplicar blocos de consulta clicando em Duplicar bloco no menu de três pontos Ações do bloco:

O Looker cria uma cópia do bloco com as mesmas configurações de consulta e visualização e adiciona o novo bloco à parte de baixo do painel. Nela, você pode mover ou redimensionar o bloco, editar o título ou editar o novo bloco para ajustar a visualização ou a consulta subjacente.

Não é possível duplicar um bloco vinculado a um Look, e a opção Duplicar bloco não aparece no menu de três pontos Ações do bloco dos blocos vinculados a um Look.

Edição de texto

Há dois tipos de blocos de texto, cada um com uma experiência de edição diferente, mas que resultam no mesmo tipo de bloco:

Para editar um bloco de Texto, entre no modo de edição e clique nele para fazer mudanças.

Para editar um bloco de Markdown, entre no modo de edição e selecione Editar no menu de três pontos Ações do bloco.

Opções de mover bloco

No modo de edição, você pode mover um bloco para a parte de cima, de baixo, esquerda ou direita do painel. Clique no menu de três pontos Ações do dashboard, selecione Mover bloco e escolha uma das seguintes opções:

  • Mover para o início
  • Mover para o fim
  • Mover para o lado esquerdo
  • Mover para o lado direito

O bloco vai permanecer na coluna ou linha em que está localizado. Se o bloco já estiver na parte de cima, na parte de baixo à esquerda ou na parte direita da coluna, a opção de movê-lo para esse local vai estar desativada.

Excluir um bloco

No modo de edição, é possível excluir um bloco de um painel. Selecione Excluir (para um bloco de consulta) ou Remover Look (para um bloco vinculado a um Look) no menu de três pontos Ações do bloco. Essa exclusão não pode ser desfeita.

Excluir um bloco vinculado a uma análise de um painel não afeta a análise em si.

Editar as configurações do painel

No modo de edição, clique em Configurações no canto superior esquerdo da barra de ferramentas azul para editar as configurações do painel.

Fuso horário

Essa opção só fica disponível se o administrador do Looker tiver ativado a configuração Fuso horário específico do usuário.

Selecione o fuso horário em que o painel será executado. Os leitores do painel poderão mudar temporariamente a configuração de fuso horário ao visualizar o painel.

Escolha uma das seguintes opções:

  • Fuso horário de cada bloco para executar todos os blocos no fuso horário em que foram salvos
  • Fuso horário do leitor para executar todos os blocos no fuso horário de cada leitor
  • Selecione um fuso horário específico na lista do menu suspenso para executar todos os blocos nesse fuso horário.

Executar ao carregar

Se a opção Executar ao carregar estiver ativada, os dados do painel serão carregados automaticamente quando ele for aberto pela primeira vez.

Se a opção Executar ao carregar estiver desativada, o painel não vai mostrar nenhum dado até que o ícone Recarregar dados seja clicado.

Permitir o modo de tela cheia nas visualizações

Se o administrador do Looker tiver ativado o recurso do Labs Visualizações em tela cheia, uma opção para Permitir o modo de tela cheia nas visualizações vai aparecer nas configurações do painel. Essa opção fica ativada por padrão.

Ao desativar essa opção em um painel, os leitores não poderão ver a opção Ver no menu de três pontos Ações do painel de cada bloco. Além disso, não será possível ver os blocos em tela cheia ou formatos expandidos.

Atualização automática

Pode ser interessante atualizar os dados automaticamente em uma programação regular para garantir que eles estejam atualizados. É possível definir frequências de atualização automática para um painel inteiro ou para blocos individuais. A atualização automática nunca extrai resultados do cache do Looker. Ela sempre extrai os dados do banco de dados.

Para definir a atualização automática de um painel e todos os blocos dele:

  1. Ative a opção Atualizar dashboard automaticamente.
  2. Selecione uma frequência de atualização para atualizar automaticamente o painel e todos os blocos dele.
  3. Para ajustar a frequência de cada bloco, faça isso na seção Bloco, onde cada bloco no painel é listado. Clique no menu suspenso do bloco na coluna Frequência de atualização, selecione Atualizar a cada e defina a frequência.
  4. Clique em Salvar.

Para definir a atualização automática de blocos individuais, mas não do painel:

  1. Desative a opção Atualizar painel automaticamente (se ativada anteriormente).
  2. Na coluna Frequência de atualização da seção Bloco, clique no menu suspenso de um bloco para atualizar automaticamente.
  3. Selecione Atualizar a cada.
  4. Defina a frequência.
  5. Para os blocos que não devem ser atualizados automaticamente, mantenha a configuração Não atualizar.
  6. Clique em Salvar.

As configurações de frequência aceitam números inteiros.

Os intervalos de atualização automática começam no horário do dia em que você ativa esse recurso, e o painel é atualizado no intervalo definido enquanto estiver aberto em uma guia do navegador e não estiver no modo de edição. Se o painel estiver fechado ou no modo de edição durante um horário de atualização programado, ele não será atualizado. Se o painel for fechado ou entrar no modo de edição, independentemente de estar ou não durante um horário de atualização programada, o intervalo de atualização será reiniciado assim que o painel for aberto novamente ou sair do modo de edição.

Por exemplo, se você definir uma atualização diária às 8h33, o painel será atualizado no dia seguinte às 8h33 e, depois, todos os dias às 8h33. No entanto, se um dia você entrar no modo de edição às 9h02 e sair às 9h45, a partir desse momento, a atualização diária vai ocorrer às 9h45, começando no dia seguinte.

As opções Limpar cache e atualizar e Recarregar dados são independentes do intervalo de atualização automática. Isso significa que atualizar manualmente o painel não reinicia o intervalo de atualização automática. Por exemplo, se o intervalo de atualização automática de um painel for de uma hora, você poderá usar a opção Limpar cache e atualizar 40 minutos após uma atualização automática. O painel ainda será atualizado automaticamente 20 minutos depois (uma hora após a última atualização automática).

Da mesma forma, a atualização automática funciona independente de Executar ao carregar estar ativada ou desativada. Se a opção Executar ao carregar estiver desativada e você abrir um painel com configurações de atualização automática, o intervalo de atualização vai começar ao abrir, mesmo que você clique no ícone recarregar dados para carregar os dados inicialmente.

Atualização automática e performance

Atualizações frequentes de painéis, principalmente os grandes, podem sobrecarregar alguns sistemas de banco de dados. Recomendamos que você converse com seu administrador do Looker sobre essa consideração. No mínimo, evite definir um intervalo de atualização menor que o intervalo de atualização do banco de dados, já que não haveria novos dados para atualizar e isso acionaria consultas desnecessárias.

Da mesma forma, quando vários usuários acessam um painel com atualização automática, isso pode prejudicar o desempenho. Para mostrar seu painel em uma tela compartilhada enquanto vários usuários acessam simultaneamente, crie dois painéis idênticos e configure apenas o painel na tela compartilhada para ser atualizado automaticamente.

Encontre mais informações e recomendações sobre como criar painéis eficientes na página de práticas recomendadas Considerações ao criar painéis do Looker eficientes.

Visualização de filtros padrão

Na guia Filtros da janela Configurações, defina a opção Visualização de filtros padrão como uma das seguintes:

  • Expandida: a barra de filtro aparece no carregamento da página, e os filtros são mostrados por padrão.
  • Reduzida: a barra de filtro não aparece no carregamento da página, e os filtros ficam ocultos por padrão.

Clique em Salvar para armazenar a mudança.

A opção Visualização de filtros padrão é definida como Expandida por padrão. Se você mudar a configuração para Compactado, saia do modo de edição e atualize o painel para ver a mudança.

Os leitores do painel podem mudar temporariamente a barra de filtros entre recolhida e expandida clicando no ícone de filtros. No entanto, apenas a configuração Visualização de filtros padrão muda permanentemente o estado padrão da barra de filtros.

Local dos filtros

Na guia Filtros da janela Configurações, defina a opção Local dos filtros como uma das seguintes opções:

  • Parte de cima: a barra de filtros aparece na parte de cima do painel.
  • Direita: a barra de filtros aparece à direita do painel.

Clique em Salvar para armazenar a mudança.

A opção Filtrar local é definida como Acima por padrão.

Layout rápido

No modo de edição, clique em Layout rápido no canto superior esquerdo da barra de ferramentas azul para definir todos os blocos com o mesmo tamanho. As cinco opções de tamanho de bloco são:

  • XS: seis blocos cabem em uma linha no painel.
  • S: quatro peças cabem em uma linha no painel.
  • M: três blocos cabem em uma linha no painel.
  • L: dois blocos cabem em uma linha no painel.
  • XL: um bloco cabe em uma linha no painel.

Os tamanhos dos blocos são responsivos ao tamanho do painel. O layout rápido afeta todos os blocos, incluindo os de texto, visualização, Markdown e botões.

Como editar detalhes do painel

No modo de edição, selecione Mostrar detalhes do painel no menu de três pontos Ações do painel. A caixa de texto Descrição fica editável.

Quando terminar de editar a descrição, clique em Salvar para salvar a mudança.

Como excluir painéis

Se você tiver o nível de acesso Gerenciar acesso, editar para um painel, poderá excluí-lo de uma das duas maneiras a seguir:

Depois de excluir um painel, somente um administrador do Looker pode recuperá-lo da lixeira.

Atalhos do teclado quando os painéis estão no modo de edição

Para conferir os atalhos de teclado que podem ser usados ao editar painéis, acesse a página de documentação Atalhos de teclado no Looker.