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 de informações específico, você precisa ter acesso ao modelo em que ele se baseia.

Se você não tiver acesso a todos os modelos que servem de base para os Blocos de um painel específico, ainda poderá editar outras partes do painel, como o título, as configurações, os filtros (embora não apareçam sugestões de filtro com base em campos de um modelo a que você não tem acesso) e os Blocos que têm acesso ao modelo.

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

Como entrar no modo de edição nos 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, é possível adicionar, mover, editar ou excluir blocos ou filtros, ou 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 fica 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 Discard changes? também aparece se você tentar sair do painel clicando no breadcrumb de navegação ou nas setas para frente ou para trás no navegador.

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:

  • Extra 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.
  • Extra grande: 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 seja muito curto, ocultar o título do bloco pode ajudar a torná-lo o mais curto 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 do painel com uma visualização que usa um layout de grade de quatro gráficos pequenos. Se você definir o tamanho do bloco como curto e largo, os gráficos pequenos vão aparecer como uma linha de quatro. Se você definir o tamanho do 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 em quatro linhas de um.

Para garantir que a disposiçã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 vai respeitar essa configuração, independentemente do tamanho ou da forma do bloco.

Como adicionar blocos

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

Como editar blocos

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

Essas opções são um pouco diferentes, 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 nota e Mover bloco.
    • Para os blocos de consulta, o Looker também mostra as opções Duplicate tile, Delete e View.
    • Para Blocos vinculados a um visual, o Looker também mostra a opção Remover visual.

Editar o título de um bloco de consulta

No modo de edição, você pode editar o título de um bloco de consulta clicando nele e fazendo as alteraçõ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 dos blocos vinculados a looks ao editar a consulta ou o look subjacente a um bloco.

Editar a consulta ou o visual de um bloco

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

No modo de edição, é possível editar a consulta ou o visualizações subjacentes 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 um visual, a barra de ferramentas Editar visual vai mostrar os painéis que contêm blocos vinculados a esse visual. Essas mudanças vão afetar os painéis. Se você estiver editando um bloco de consulta, não vai aparecer 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á.

Quando você edita um bloco de painel que contém um gráfico de funil ou de linha do tempo, eles aparecem de forma diferente no bloco do painel do que na janela de edição. Além disso, as ferramentas de visualização dos mapas funcionam de maneira diferente quando são exibidas nos blocos do painel. Para mais informações, acesse as páginas de documentação Gráfico de funil, Gráfico de linha do tempo e Gráfico de mapa.

Como mostrar ou ocultar 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 Ações do bloco com três pontos de blocos de texto ou 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 Ações do bloco com três pontos, 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 reinstale 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.

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

  1. No campo Texto da nota, insira o texto da nota a ser mostrado no bloco. Você pode usar texto simples ou HTML.
  2. No campo Mostrar local, selecione o local da nota. As opções ficam acima ou abaixo da visualização ou aparecem como texto quando os usuários mantêm o cursor sobre um ícone i circulado à direita do título do bloco. Para Blocos com visualizações de valor único com tamanho de 150 pixels ou menor, as notas de título são renderizadas como texto de passagem, independentemente do local selecionado neste campo.
  3. Marque a caixa Colapsar nota para que ela seja recolhida 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 nota será exibido por padrão. Se você selecionar Ao passar o cursor sobre o ícone em Exibir local, essa opção não vai aparecer.
  4. Clique em Adicionar ou Cancelar para adicionar a nota ao bloco ou cancelar.

A nota aparece no bloco com uma seta de retração/expansão à esquerda. Clique na seta ou em qualquer lugar na nota para alternar entre as exibições recolhida e aberta.

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

Duplicar um bloco de consulta

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

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. Nele, você pode mover ou redimensionar o bloco, editar o título do bloco ou editar o novo bloco para ajustar a visualização ou a consulta.

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

Editar 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 as alterações.

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

Opções de mover blocos

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

  • Mover para o início
  • Mover para a parte de baixo
  • 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, inferior esquerda ou direita da coluna, a opção de movê-lo para esse local será desativada.

Como 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 visual (para um Bloco vinculado a um visual) no menu de Ações do Bloco de três pontos. Essa exclusão não pode ser desfeita.

Excluir um Bloco vinculado a um visual de um painel não afeta o visual.

Como 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 espectadores do painel poderão mudar 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 foram salvos
  • Fuso horário do leitor para veicular 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

Executar ao carregar

Se a opção Executar no carregamento estiver ativada, os dados do painel serão carregados automaticamente quando o painel for carregado pela primeira vez.

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

Permitir o modo de tela cheia para visualizações

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

Ao desativar essa opção em um painel, os espectadores não vão conseguir acessar a opção Visualizar no menu de três pontos Ações do painel de cada bloco do painel, nem visualizar os blocos em tela cheia ou em formatos expandidos.

Autorefresh

Pode ser conveniente 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 o painel automaticamente.
  2. Selecione uma frequência de atualização para atualizar automaticamente o painel e todos os blocos.
  3. Para ajustar a frequência de cada bloco, faça isso na seção Bloco, onde cada bloco do 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 para blocos individuais, mas não para o painel:

  1. Desative a opção Atualizar o painel automaticamente (se ela estiver ativada).
  2. Na coluna Frequência de atualização da seção Módulo, clique no menu suspenso para atualizar automaticamente um módulo.
  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 em que você ativa esse recurso, e o painel é atualizado no intervalo definido, desde que 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 uma atualização programada, ele não será atualizado. Se o painel for fechado ou entrar no modo de edição, o intervalo de atualização será reiniciado assim que o painel for aberto novamente ou sair do modo de edição, mesmo que não seja durante uma atualização programada.

Por exemplo, se você definir uma atualização diária às 8h33, o painel será atualizado no dia seguinte às 8h33 e depois a cada dia às 8h33. No entanto, se você entrar no modo de edição às 9h02 e sair às 9h45, 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, ou seja, 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, e 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 independentemente de Run on load estar ativado ou desativado. 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 na abertura, independentemente de você clicar no ícone Recarregar dados para carregar os dados inicialmente.

Atualização automática e desempenho

Atualizações frequentes, especialmente em painéis grandes, podem sobrecarregar alguns sistemas de banco de dados. Recomendamos discutir essa consideração com o administrador do Looker. No mínimo, evite definir um intervalo de atualização mais curto do que o intervalo de atualização do banco de dados, porque 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 a performance. Para mostrar o 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 atualização automática.

Encontre mais informações e recomendações sobre como criar painéis de desempenho na página de práticas recomendadas Considerações ao criar painéis de 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:

  • Ampliada: 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 salvar a mudança.

A opção Visualização de filtros padrão tem como padrão Abrir. Se você mudar a configuração para Reduzida, será necessário sair do modo de edição e atualizar o painel para ver a mudança.

Os usuários que acessam o painel podem abrir e fechar a barra de filtros 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, você pode definir a opção Local dos filtros como uma das seguintes opções:

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

Clique em Salvar para salvar a mudança.

A opção Filtrar local é padronizada como Top.

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 as seguintes:

  • XS: seis blocos cabem 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: duas 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 blocos de texto, de visualização, de 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 Description 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 em um painel, poderá excluí-lo de duas maneiras:

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.