Editar painéis definidos pelo usuário

Para editar um painel, é preciso atender aos seguintes pré-requisitos:

Além disso, para editar um bloco do dashboard específico, você precisa ter acesso ao modelo em que o bloco é baseado.

Se você não tiver acesso a todos os modelos em que os blocos de um determinado painel se baseiam, ainda será possível editar outras partes do painel, como o título, as configurações do painel, os filtros do painel (embora não sejam exibidas sugestões de filtros com base nos campos de um modelo aos quais você não tem acesso) e blocos a que você tem acesso ao modelo.

Ao editar um painel, tenha em mente as práticas recomendadas para a construção de um painel. Encontre informações e recomendações sobre como criar painéis de alto desempenho na página de práticas recomendadas Considerações ao criar painéis de alto desempenho do Looker.

Entrar no modo de edição nos painéis

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

No modo de edição, é possível 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 que você fizer pelo menos uma edição, o botão Salvar ficará disponível. Clique em Salvar para salvar suas edições e sair do modo de edição.

Para descartar as edições, clique em Cancelar. Na caixa de diálogo Descartar mudanças?, 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 quando você tenta sair do painel clicando na navegação estrutural ou nas setas de avançar ou voltar do navegador.

Como reorganizar e redimensionar blocos

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

Para mover um bloco, arraste o ícone de seis pontos no canto superior esquerdo dele. Quando você arrasta um bloco para um novo local no painel de controle, 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 pré-selecionados disponíveis são os seguintes:

  • Muito pequeno: cada bloco ocupa um sexto da linha do painel.
  • Pequeno: cada bloco ocupa um quarto da linha do painel.
  • Médio: 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 fique muito curto, ocultar o título do bloco pode ajudá-lo a torná-lo o mais curto possível.

Use a opção Mover bloco no menu de edição para movê-lo para a parte superior ou inferior do painel.

Tamanho do bloco e layout de grade

Quando você adiciona uma visualização usando o layout de grade a um painel, a organizaçã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 aparecerão 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 que ele seja estreito, porém alto, os gráficos serão reposicionados em quatro linhas de um.

Para garantir que a organização da grade seja responsiva, 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 respeitará essa configuração, independentemente do tamanho ou da forma do bloco do painel.

Adicionar blocos

No modo de edição, é possível adicionar blocos ou texto ao painel. Consulte a página de documentação Criação de painéis definidos pelo usuário para informações sobre como adicionar texto e blocos.

Blocos de edição

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 serão um pouco diferentes se você estiver visualizando ou não um bloco de consulta ou um bloco vinculado ao Looker.

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

Como editar o título de bloco de uma consulta

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

Você também pode editar os títulos dos blocos de consulta e do Look ao editar a consulta ou o Look subjacente 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 dashboards em que esse Look for usado.

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

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

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

Quando você está editando um bloco de um painel que contém um gráfico de funil ou de linha do tempo, os gráficos têm uma aparência diferente no bloco do painel do que aparecem na janela de edição. Além disso, as dicas dos gráficos de mapa funcionam de forma diferente quando exibidas nos blocos do painel. Para mais informações, acesse as páginas de documentação do gráfico de funil, do gráfico de linha do tempo e do 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 de blocos de blocos de texto ou 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 de bloco, ative 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 restabeleça o título do bloco e salve.

Adicionar uma nota de bloco

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

Digite o texto da nota e configure as seguintes opções de exibição:

  1. No campo Texto da nota, digite o texto que vai aparecer no bloco. Use texto simples ou HTML.
  2. No campo Local de exibição, selecione o local da nota. As opções estão acima da visualização, abaixo dela ou como texto que aparece quando os usuários seguram o cursor sobre um ícone i circulado à direita do título do bloco. Para blocos com visualizações de valor único dimensionadas para ter 150 pixels de altura ou menos, as notas de título são renderizadas como texto flutuante, independentemente do local selecionado nesse campo.
  3. Marque a caixa Recolher nota para que ela seja fechada por padrão. Uma nota recolhida mostra apenas a primeira linha, com reticências no final da linha. Desmarcar essa caixa exibe o texto completo da nota por padrão. Se você selecionar Ao passar o cursor sobre o ícone em Exibir local, essa opção não vai ser exibida.
  4. Clique em Adicionar ou Cancelar para adicionar ou cancelar a nota ao bloco.

A nota aparece no bloco com uma seta para recolher/expandir à esquerda dela. Ao clicar na seta ou em qualquer lugar da nota, você alterna entre as exibições recolhida e expandida.

Quando você adiciona uma nota a um bloco, o menu de três pontos Ações do bloco muda para Editar nota, em vez de Adicionar nota. Clique em Editar nota para editar ou excluir a nota.

Como 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 de 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. A partir daí, é possível mover ou redimensionar o bloco, editar o título ou editar o novo bloco para ajustar a visualização ou a consulta.

Não é possível duplicar um bloco vinculado ao Look e não haverá Duplicar bloco no menu de três pontos Ações de bloco dos blocos vinculados ao Look.

Editando texto

Há dois tipos de blocos de texto: cada um oferece uma experiência de edição diferente, mas resulta 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.

Mover opções de bloco

No modo de edição, é possível mover um bloco para o lado superior, inferior, esquerdo ou direito do painel. Clique no menu de três pontos Ações do painel, selecione Mover bloco e 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 no topo, no canto inferior esquerdo ou no lado direito da coluna, a opção de movê-lo para esse ponto 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 ao Look) no menu de três pontos Ações do bloco. Essa exclusão não pode ser desfeita.

Excluir um bloco vinculado ao Look de um dashboard não afeta o Look subjacente.

Editar 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ó vai estar 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 seu painel será executado. Os leitores do painel poderão alterar temporariamente a configuração do fuso horário ao acessar 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 eles foram salvos.
  • Fuso horário do espectador para executar todos os blocos no fuso horário de cada espectador.
  • Selecione um fuso horário específico da lista no 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 carregado pela primeira vez.

Se a opção Executar ao carregar estiver desativada, o painel não exibirá dados até que o ícone Atualizar dados seja clicado.

Permitir o modo de tela cheia nas visualizações

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

Desativar essa opção em um painel impede que os leitores do painel vejam a opção Visualizar no menu de três pontos Ações do painel de cada bloco do painel, e os blocos não vão aparecer em tela cheia ou formatos expandidos.

Atualização automática

Pode ser interessante atualizar os dados automaticamente em um cronograma regular para garantir que estejam atualizados. Você pode definir frequências de atualização automática para um dashboard inteiro ou para blocos individuais. A atualização automática nunca extrai resultados do cache do Looker. Ela sempre extrai 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 painel 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 qualquer bloco individual, faça isso na seção Bloco, em que cada bloco no painel está 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 para blocos individuais, mas não para o 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 atualização automática.
  3. Selecione Atualizar a cada.
  4. Defina a frequência.
  5. Para os blocos que você não quer atualizar automaticamente, mantenha a configuração Não atualiza.
  6. Clique em Salvar.

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

Os intervalos de atualização automática começam na hora do dia em que você ativa esse recurso e o painel é atualizado no intervalo definido, desde que o painel esteja aberto em uma guia do navegador e não esteja no modo de edição. Se o painel estiver fechado ou no modo de edição durante o horário 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 programado, o intervalo de atualização será reiniciado assim que o painel for aberto novamente ou sair do modo de edição.

Por exemplo, se forem 8h33, quando você definir uma atualização diária, o painel será atualizado no dia seguinte às 8h33 e será atualizado novamente todos os dias seguintes às 8h33. No entanto, se um dia você entrar no modo de edição às 9h02 e sair do modo de edição às 9h45, a atualização diária será feita a partir de 9h45, a partir de então às 9h45.

As opções Limpar o cache e atualizar e Atualizar dados são independentes do intervalo de atualização automática. Isso significa que a atualização manual do 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, será possível usar a opção Limpar o cache e a atualização 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 a opção Executar ao carregar estar ativada ou desativada. Se a opção Executar no carregamento estiver desativada e você abrir um painel com configurações de atualização automática, o intervalo de atualização será iniciado ao abrir, mesmo que você não clique no ícone Atualizar dados para carregar os dados inicialmente.

Atualização automática e desempenho

Atualizações frequentes do painel, especialmente em painéis grandes, podem colocar uma pressão significativa em alguns sistemas de banco de dados. Recomendamos que você converse sobre esse assunto com seu administrador do Looker. No mínimo, evite definir um intervalo de atualização menor do que 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 impedir o desempenho. Para exibir seu painel em uma tela compartilhada enquanto vários usuários o acessam simultaneamente, crie dois painéis idênticos e configure apenas o painel na tela compartilhada para que ele seja atualizado automaticamente.

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

Visualização de filtros padrão

Na guia Filtros da janela Configurações, é possível definir a opção Visualização de filtros padrão como uma das seguintes opções:

  • Expandido: a barra de filtro é exibida no carregamento da página e os filtros são exibidos por padrão.
  • Recolhida: a barra de filtro não é exibida no carregamento da página e os filtros ficam ocultos por padrão.

Clique em Salvar para salvar a alteração.

A opção Visualização de filtros padrão é Expandida por padrão. Se você alterar a configuração para Recolhido, precisará sair do modo de edição e atualizar o painel para ver a mudança.

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

Local dos filtros

Na guia Filtros da janela Configurações, é possível definir a opção Local dos filtros como uma das seguintes opções:

  • Superior: a barra de filtro aparece na parte superior do painel.
  • Direita: a barra de filtro aparece à direita do painel.

Clique em Salvar para salvar a alteração.

A opção Filtrar local tem o padrão Superior.

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 do bloco são as seguintes:

  • XS: seis blocos se encaixam em uma linha no painel.
  • S: quatro blocos se encaixam em uma linha no painel.
  • M: três blocos se encaixam em uma linha no painel.
  • L: dois blocos se encaixam 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 blocos de texto, de visualização, blocos de Markdown e botões.

Editando detalhes do dashboard

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 se torna editável.

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

Como excluir painéis

Se você tiver o nível de acesso Gerenciar acesso, editar em um painel, poderá excluí-lo de duas maneiras:

Quando você exclui um painel, apenas um administrador do Looker pode recuperá-lo da lixeira.

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

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