Editar painéis definidos pelo usuário

Nesta página, descrevemos a nova experiência do painel do Looker. Para saber como editar painéis legados, acesse a página de documentação Como editar painéis legados. Para determinar o tipo de painel que você está usando, compare as capturas de tela nas páginas de documentação Como visualizar painéis e Como visualizar painéis legados.

Para editar um painel, você precisa ter:

Além disso, para editar um bloco de painel específico, é necessário ter acesso ao modelo em que o bloco será baseado.

Se você não tiver acesso a todos os modelos em que os blocos de um painel específico são baseados, 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 nos campos de um modelo a que não tem acesso) e os blocos aos quais você tem acesso de modelo.

Ao editar um painel, lembre-se das práticas recomendadas de construção de painel. Veja informações e recomendações sobre a criação de painéis de desempenho no artigo Considerações ao criar painéis de desempenho do Looker na Central de Ajuda.

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

Selecione Editar painel no menu do painel:

No modo de edição, é possível adicionar, mover, editar ou excluir blocos ou filtros ou editar o título do painel.

É possível saber que você está no modo de edição pela barra de ferramentas azul na parte superior do painel.

Quando você começa a fazer edições, o botão Salvar é exibido. 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 mudanças? também será exibida se você tentar sair do painel clicando na navegação estrutural da navegação ou nas setas para frente ou para trás no navegador.

Como reorganizar e redimensionar blocos

No modo de edição, é possível mover e redimensionar blocos em um painel. Clique e arraste o ícone de seis pontos no canto superior esquerdo de um bloco para movê-lo. Quando você arrasta um bloco até um novo local no painel de controle, linhas de grade azuis aparecem para ajudar a posicionar o bloco.

Clique e arraste no canto inferior direito do bloco para redimensioná-lo.

Se você quiser redimensionar um bloco para que ele seja muito curto, ocultar o título do bloco pode tornar o bloco o mais curto possível.

Também é possível usar a opção Mover bloco no menu de edição do bloco para mover o bloco para a parte superior ou inferior do painel.

Tamanho do bloco e layout da 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, há um bloco do painel com uma visualização que usa um layout de grade de quatro gráficos pequenos. Se o tamanho do bloco for curto e largo, os gráficos menores serão exibidos em 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 o tamanho do bloco for restrito, mas 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ê digitar 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 Como criar painéis definidos pelo usuário para ver informações sobre como adicionar texto e blocos.

Edição de blocos

ou um bloco vinculado ao Look:

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 no bloco e fazendo as edições. Clique em Salvar no canto superior direito do painel para salvar suas alterações.

Também é possível editar títulos de blocos em blocos de consultas e em blocos vinculados ao visual ao editar a consulta ou a aparência subjacente de um bloco.

Editar a consulta ou a aparência de um bloco

Se você salvar edições em um visual, isso afetará todos os painéis (novos ou legados) em que ele é usado.

No modo de edição, você pode editar a consulta ou a aparência subjacente de um bloco, incluindo o título e a visualização do bloco, diretamente no painel de controle.

Clique em Editar no menu de três pontos do bloco.

Se você estiver editando um Look, o painel de edição exibe os painéis que contêm blocos vinculados a esse Look. Esses painéis serão afetados pelas mudanças. Se você estiver editando um bloco de consulta, não verá uma lista de painéis afetados no painel de edição, porque as edições afetam apenas o bloco e o painel em que você está.

Quando você está editando um bloco do painel que contém um gráfico de funil ou um gráfico de linha do tempo, os gráficos aparecem diferentes no bloco do painel e na janela de edição. Além disso, os gráficos de mapas' dicas funcionam de forma diferente quando visualizados em blocos do painel de controle. 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 exibidos. Para ocultar um título, clique em Ocultar título no menu de três pontos.

Quando o título estiver oculto, o menu de três pontos do bloco exibirá uma opção para mostrar o título do bloco.

A opção de ocultar/mostrar não aparece no menu de três pontos de blocos de texto ou blocos que usam visualizações de valor único. Para ocultar ou mostrar o título de uma única visualização de valor, clique em Editar no menu de três pontos do bloco, alterne 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, remova ou restaure o título do bloco e salve.

Adicionar uma anotação em blocos

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

Insira o texto da anotação e selecione as opções de exibição:

  1. Insira o texto da anotação a ser exibido no bloco. Você pode usar texto simples ou HTML.
  2. Selecione o local da nota. As opções estão acima da visualização, abaixo dela ou como texto passa o cursor sobre o ícone i circulado à direita do título do bloco. Para blocos com visualizações de valor único com tamanho de até 150 pixels, as anotações de título são renderizadas como texto passa o cursor, independentemente do local selecionado neste campo.
  3. Marque essa caixa para recolher a anotação por padrão. Uma nota recolhida mostra apenas a primeira linha, com reticências no final da linha. Desmarcar esta caixa mostra o texto completo da nota por padrão. Se você selecionar Ao passar o cursor sobre o ícone em Exibir local, não verá essa opção.
  4. Adicione a anotação ao bloco ou cancele-a.

A anotação aparece no bloco com uma seta de recolhimento/expansão à esquerda. Clicar nessa seta ou em qualquer lugar na nota alterna entre as telas recolhidas e expandidas.

Quando você adiciona uma nota a um bloco, o menu de três pontos do bloco é alterado para exibir a opção Editar nota em vez de Adicionar nota. Clique em Editar nota para editar ou excluir a nota.

Mover um bloco para a parte superior ou inferior do painel

No modo de edição, é possível mover um bloco para a parte superior ou inferior do painel.

O bloco permanecerá na coluna em que ele está localizado no momento. Se o bloco já estiver na parte superior ou inferior da coluna, a opção de movê-lo para esse local será desativada.

Como duplicar um bloco de consulta

No modo de edição, é possível duplicar blocos de consultas clicando em Bloco de cópias no menu 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 inferior do painel. A partir daí, é 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 subjacente.

Não é possível duplicar um bloco com link visual e não verá o Bloco duplicado no menu de três pontos de blocos vinculados ao Look.

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 aparência (para um bloco vinculado ao Look) no menu de três pontos do bloco. Essa exclusão não pode ser desfeita.

Excluir um bloco vinculado a um painel não afeta a aparência subjacente.

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:

Fuso horário

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

Selecione o fuso horário em que o painel será executado. Os visualizadores do painel podem alterar temporariamente a configuração de fuso horário ao visualizar o painel.

Escolha uma das seguintes opções:

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

Executar no carregamento

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 no carregamento estiver desativada, o painel não exibirá dados até que o ícone Atualizar dados seja clicado.

Atualizar automaticamente

Atualize os dados regularmente de acordo com 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 busca 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 automaticamente o painel.
  2. Selecione uma frequência de atualização para atualizar automaticamente o painel e todos os blocos.
  3. Para ajustar a frequência de qualquer bloco individual, faça isso na seção Bloco em que cada bloco do painel de controle 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 de controle:

  1. Desative a opção Atualizar automaticamente o painel se ele tiver sido ativado.
  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. Nos blocos que você não quiser atualizar automaticamente, mantenha a configuração Não é atualizada.
  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 em que você ativa este recurso, e o painel é atualizado no intervalo que você definiu, desde que o painel esteja aberto em uma guia do navegador e não esteja no modo de edição. Se o painel for fechado ou estiver 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, independente de estar ou não durante um tempo 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 for 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 à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 partir da hora seguinte, a atualização diária acontecerá às 5h45

As opções Limpar cache e atualizar e Atualizar dados são independentes do intervalo de atualização automática, o que significa que a atualização manual do painel não reinicia o intervalo de atualização automática. Por exemplo, se um intervalo de atualização automática do 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 independente de a opção Executar no carregamento 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 começará após a abertura, independentemente de você clicar no ícone Atualizar dados para carregar os dados inicialmente.

Atualização automática e desempenho

Atualizações frequentes no painel, especialmente em painéis grandes, podem sobrecarregar significativamente alguns sistemas de banco de dados. Se você quiser, fale sobre essa questão com seu administrador do Looker. No mínimo, evite 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, quando vários usuários acessam um painel com atualização automática, isso também pode afetar 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 somente o painel na tela compartilhada para fazer a atualização automaticamente.

Veja mais informações e recomendações sobre como criar painéis de desempenho no artigo Considerações ao criar painéis de desempenho do Looker na Central de Ajuda.

Visualização de filtros padrão

Na guia Filtros da janela Configurações, você pode definir a opção Visualização de filtros padrão para uma das seguintes opções:

  • Expandida: a barra de filtros é mostrada no carregamento de 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 as alterações.

A opção Visualização de filtros padrão assume como padrão Expandido. Se você mudar a configuração para Recolhida, precisará 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 entre recolhido e expandido clicando no ícone de filtros. No entanto, somente a configuração Visualização de filtros padrão muda permanentemente o estado padrão da barra de filtro.

Filtrar local

Você poderá usar esse recurso se o administrador do Looker tiver ativado o recurso Configuração de localização do filtro do painel no Labs.

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

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

Clique em Salvar para salvar as alterações.

A opção Filtrar local assume o padrão como padrão.

Editar detalhes do painel

No modo de edição, selecione Mostrar detalhes do painel no menu de três pontos do painel. A caixa de texto Descrição torna-se 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 que você exclui 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 ver os atalhos de teclado que você pode usar ao editar painéis, acesse a página de documentação Atalhos de teclado do Looker (em inglês).