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 dashboard específico, é preciso 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 determinado painel, ainda será possível 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, tenha em mente as práticas recomendadas para a construção de painéis. Encontre informações e recomendações sobre a criação de dashboards de alta performance na página Considerações ao criar painéis de alta performance no Looker.

Como entrar no modo de edição em 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 e 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 dashboard 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 suas 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 vai aparecer se você tentar sair do painel clicando na localização atual da navegação ou nas setas de avançar ou voltar do 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 são exibidas para ajudar a posicioná-lo.

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 dashboard.
  • Pequeno: cada bloco ocupa um quarto da linha do painel.
  • Médio: cada bloco ocupa um terço da linha do dashboard.
  • Grande: cada bloco ocupa metade da linha do painel.
  • Extragrande: cada bloco ocupa toda a largura da linha do dashboard.

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

Se você quiser que um bloco seja muito curto, ocultar o título dele 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 de grade

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

Por exemplo, você tem um bloco de dashboard com uma visualização que usa um layout de grade com 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ê dimensionar o bloco como um quadrado, os gráficos pequenos são reposicionados em duas linhas de dois. Se você dimensionar o bloco para que seja estreito, mas alto, os gráficos serão reposicionados em quatro linhas de uma.

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 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 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 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 ao Look, o Looker também mostra a opção Remover Look.

Como editar o título de um bloco de consulta

No modo de edição, é possível editar o título de um bloco de consultas clicando nele e fazendo suas edições. Clique em Salvar no canto superior direito do painel para salvar as alterações.

Você também pode editar títulos de blocos para os blocos de consulta e Look-linked ao editar a consulta ou o Look subjacente de um bloco.

Editar a consulta ou o Look de um bloco

Se você salvar as edições em um Look, isso vai afetar todos os dashboards em que ele for usado.

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

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 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ê se encontra.

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

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

  1. No campo Texto da nota, digite o texto que será mostrado no bloco. Você pode usar texto simples ou HTML.
  2. No campo Mostrar local, 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 mantêm o cursor sobre um ícone i dentro de um círculo à direita do título do bloco. Para blocos contendo 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 fechar a nota por padrão. Uma nota recolhida mostra apenas a primeira linha, com reticências no final da linha. 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 será exibida.
  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 nessa seta ou em qualquer lugar da nota para alternar entre as exibições recolhidas e expandidas.

Depois que você adiciona uma nota a um bloco, o menu de três pontos Ações do bloco muda e mostra 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 consultas 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. 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 do Look-linked nem encontrar a opção Duplicar bloco no menu de três pontos Ações do bloco dos blocos vinculados ao Look.

Editando 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 três pontos Ações do bloco.

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 superior, inferior esquerda ou direita da coluna, a opção de movê-lo para esse local estará 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 do Look de um dashboard não afeta o Look subjacente.

Como 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á gerado. 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 espectador para executar todos os blocos no fuso horário de cada espectador
  • 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 o painel 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 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.

Desativar essa opção em um painel impede que a opção Ver apareça no menu de três pontos Ações do painel de cada bloco do painel. Além disso, os usuários não vão ter acesso aos blocos do dashboard 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. Você pode definir frequências de atualização automática para um painel de controle 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 painel automaticamente (se ativada anteriormente).
  2. Na coluna Frequência de atualização da seção Título, clique no menu suspenso para atualizar automaticamente um bloco.
  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 será iniciado quando você clicar 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 sobrecarregar alguns sistemas de banco de dados. Converse com o administrador do Looker sobre isso. Evite, no mínimo, definir um intervalo de atualização menor do 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, o desempenho pode ser prejudicado quando vários usuários acessam um painel com atualização automática. Para exibir seu painel em uma tela compartilhada enquanto vários usuários o acessam ao mesmo tempo, é possível criar dois painéis idênticos e configurar apenas o painel na tela compartilhada para ser atualizado automaticamente.

Confira mais informações e recomendações sobre como criar painéis de alta performance na página Considerações ao criar painéis de alta performance no 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.
  • Recolhida: a barra de filtro não aparece no carregamento de 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 assume como padrão Expandido. 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 do painel podem alternar temporariamente a barra de filtro do modo recolhido para expandido 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, é possível definir a opção Local dos filtros como uma das seguintes opções:

  • Parte 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 mudança.

A opção Local do filtro assume como padrão Topo.

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 cabem em uma linha no painel.
  • M: três blocos se encaixam 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 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 alteração.

Como excluir painéis

Se você tem o nível de acesso Gerenciar acesso, edição em um painel, pode 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.