Como editar painéis definidos pelo usuário

Para editar um painel, você precisa ter os 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 em que os blocos de um painel específico se baseiam, ainda poderá editar outras partes do painel, como o título do painel, as configurações do painel, os filtros do painel (embora você não veja sugestões de filtro para filtros com base em campos em um modelo aos quais você não tem acesso) e os blocos a que você tem 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 painel.

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 vai 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 o cancelamento e sair do modo de edição. A caixa de diálogo Descartar alterações? também será exibida se você tentar sair do painel clicando na localização atual da navegação 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 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, 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, localizado no canto superior direito de cada bloco. Os tamanhos pré-selecionados 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 dashboard.
  • Médio: cada bloco ocupa um terço da linha do dashboard.
  • Grande: cada bloco ocupa metade da linha do dashboard.
  • 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 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 para mover o bloco para a parte de cima ou de baixo do dashboard.

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ê dimensionar o bloco para que seja 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 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 para 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 dashboard respeitará essa configuração, independentemente do tamanho ou da forma do bloco do dashboard.

Como adicionar blocos

No modo de edição, você pode adicionar blocos ou texto ao seu painel de controle. Consulte a página de documentação Como 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 serão um pouco diferentes se você estiver visualizando um bloco de consulta ou um bloco Look-linked.

  • 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 Visualizar.
    • 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 Look, a barra de ferramentas Editar Look exibirá os dashboards com blocos vinculados a ele. Esses painéis serão afetados pelas alterações. 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, as dicas dos gráficos de mapa funcionam de maneira diferente quando exibidas nos blocos do painel. 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 ocultar/mostrar não aparece no menu de três pontos Ações do bloco 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 do bloco, ative a chave 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 do bloco e salve.

Como 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 de três pontos 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 Display Location, 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. Desmarcar essa caixa mostra 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 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 da nota. 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 sua 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 dashboard. Depois, é possível mover ou redimensionar o bloco, editar o título dele 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

Existem dois tipos de blocos de texto, cada um oferecendo uma experiência de edição diferente, mas resulta no mesmo tipo de bloco:

Para editar um bloco Texto, acesse o modo de edição e clique nele para fazer ediçõ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.

Mover opções de blocos

No modo de edição, você pode mover um bloco para a parte superior, inferior, 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 permanecerá na coluna ou linha em que estiver 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 Look (para um bloco de Look vinculado) no menu de três pontos Ações do bloco. 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 leitores do painel poderão alterar 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 espectador para exibir 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 Labs para visualizações em tela cheia, a opção Permitir o modo de tela cheia para visualizações vai aparecer nas configurações do dashboard. Por padrão, essa opção é ativada.

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, mas 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 painel automaticamente.
  2. Selecione uma frequência de atualização para atualizar automaticamente o painel de controle e todos os seus blocos.
  3. Para ajustar a frequência de quaisquer blocos individuais, faça isso na seção Bloco, onde cada bloco no dashboard está listado. Clique no menu suspenso desse 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 que será atualizado 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 na hora do dia 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 um período 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 período 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 dashboard será atualizado no dia seguinte às 8h33 e será atualizado novamente todos os dias às 8h33. No entanto, se um dia você entrar no modo de edição às 9h02 e sair desse modo às 9h45, a partir das 9h45, a partir das 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 1 hora, use a opção Limpar o cache e a atualização 40 minutos após uma atualização automática. O painel 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 com a opção Run on load 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 começará quando você abrir, independentemente de você clicar no ícone Atualizar dados para carregar os dados inicialmente.

Atualização automática e desempenho

Atualizações frequentes de painéis, especialmente em painéis grandes, podem sobrecarregar alguns sistemas de banco de dados. É recomendável conversar com seu 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:

  • Aberta: 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 aparece no carregamento de 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 assume como padrão Expandido. Se você mudar a configuração para Recolhido, saia do modo de edição e atualize o painel para conferir a alteração.

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

  • 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 alteração.

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 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 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 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ê tem o nível de acesso Gerenciar acesso, edição em um painel, pode excluí-lo de duas maneiras:

Depois que você exclui um dashboard, 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 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.