Como criar painéis definidos pelo usuário

Os painéis definidos pelo usuário são criados na interface do Looker. Para comparar e contrastar painéis definidos pelo usuário e do LookML, consulte a página de documentação Como comparar painéis definidos pelo usuário e do LookML.

Para criar um painel, você precisa ter o seguinte:

• O nível de acesso Gerenciar acesso, editar para a pasta em que você quer colocar o painel.
• As permissões do Looker save_content e see_user_dashboards

Além disso, você precisa ter acesso aos modelos LookML para todos os dados que quiser usar no dashboard.

Ao criar 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.

Como criar um painel usando uma pasta

Para criar um painel usando uma pasta, siga estas etapas:

1. Acesse a pasta em que você quer colocar o painel.
2. Clique no botão Novo no canto superior direito da pasta.

3. Clique na opção Dashboard.

   A janela Criar painel será aberta.

4. Digite um nome para o novo painel no campo Nome.

5. Clique em Criar painel.

Em seguida, seu novo painel em branco será exibido. Aqui, é possível adicionar blocos ou texto no modo de edição. Para entrar no modo de edição, clique em Editar painel no menu do ícone de três pontos Ações do painel more_vert ou clique no botão Editar painel no centro do painel.

Como criar um dashboard usando um Look ou Explore

Para criar um painel usando um Look ou Explore, siga estas etapas:

1. Acesse um Look ou Explore.
2. Clique em Salvar no menu do ícone de engrenagem Ver ações Configurações.

3. Clique em Como novo painel no submenu.

   Isso abre a janela Save as a new Dashboard.

4. No campo Título, digite um nome para o novo painel.

   O nome inserido se aplica ao bloco e ao dashboard. Você pode modificar os nomes dos títulos a qualquer momento. Para alterar o nome do bloco de um bloco de consulta, consulte a subseção Como editar um título de bloco de consulta na página de documentação Como editar painéis definidos pelo usuário. Para alterar o nome do painel, entre no modo de edição no painel.

5. Na guia Configurações, clique na pasta em que você quer salvar seu painel. Você precisa ter o nível de acesso Gerenciar acesso, editar para a pasta.

6. Na guia Filtros, clique se você quer usar os filtros do Look ou do Explore como filtros do painel. Os filtros personalizados não podem se tornar filtros do dashboard, mas permanecem como filtros de bloco.

7. Clique em Salvar.

   O Look ou a Análise será salvo como um bloco de consulta no dashboard.

Como adicionar blocos e texto a um dashboard

Depois de criar um painel, a próxima etapa é adicionar blocos e texto a ele.

O primeiro bloco que você adicionar a um dashboard ocupa toda a largura do painel. Blocos adicionais que você adicionar são dimensionados para um terço da largura do painel e são adicionados horizontalmente sob o primeiro bloco. O Looker adiciona outras linhas de blocos conforme necessário. Você pode mover e redimensionar os blocos como quiser. Também é possível editar blocos depois de criá-los para ajustar os nomes deles, das visualizações, das consultas ou Looks subjacentes.

Para blocos novos adicionados a um dashboard, se eles foram criados a partir do mesmo Explore como um filtro de dashboard, o filtro do dashboard é aplicado automaticamente a esse bloco.

Observação: pense na quantidade e na complexidade dos blocos e em outros elementos que você adiciona a um painel. Mais elementos exigem mais recursos do navegador, o que aumenta o tempo de renderização do painel. Se a renderização se tornar um problema, considere criar vários painéis com menos elementos em cada um. Encontre mais 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.

Tipos de blocos do dashboard

Você pode adicionar quatro tipos de blocos a um dashboard:

• Blocos de consulta
• Blocos vinculados ao Look
• Blocos de texto
• Blocos de extensões

Blocos de consulta

Os blocos de consulta podem ser criados diretamente em um dashboard ou adicionados a um painel com um Look ou com um Explore.

Um bloco de consulta é baseado em uma consulta independente, que não está vinculada a um Look. A consulta subjacente a um bloco de consulta pertence ao painel. Mesmo que você use um Look existente para criar um bloco de consulta, o Look é usado somente durante a criação do bloco da consulta. O bloco não é afetado pelas mudanças posteriores no Look e vai continuar existindo no dashboard, mesmo se o Look for excluído.

Quando possível, use blocos de consulta para evitar sobrecarregar suas pastas com Looks desnecessários.

Blocos vinculados ao Look

Os blocos vinculados ao Look são adicionados a um dashboard de um Look.

Um bloco vinculado ao Look vincula a consulta do bloco a um Look. Esse Look é usado ao criar o bloco e sempre que o dashboard é atualizado. O Look e o dashboard precisam estar na mesma pasta. Para adicionar Looks de uma pasta diferente, primeiro copie o Look na mesma pasta que o dashboard.

Um bloco vinculado ao Look é uma boa opção se você quer criar, mudar e testar uma consulta em um só lugar, mas usá-lo em vários painéis. Se o Look mudar, todos os blocos vinculados a ele também vão mudar. Se o Look for excluído, os dashboards vão mostrar um erro no bloco.

Blocos de texto

Os blocos de texto são criados diretamente em um painel.

Você pode usar blocos de texto para definir seções visuais em um dashboard e adicionar descrições. Os blocos de texto nos painéis são projetados para ter formatação flexível e, por padrão, parecer mais com títulos e descrições do que blocos.

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

• Texto: um bloco de texto do painel que oferece uma experiência de edição visual.
• Markdown: opção de bloco de texto preexistente do Looker, que permite usar algum HTML e um subconjunto da linguagem de marcação Markdown para estilizar a saída do bloco.

Blocos de extensão

Os blocos de extensão são aplicativos personalizados chamados de extensões que são adicionados a um painel e executados em um bloco do painel.

Como criar blocos de consulta em um dashboard

Se você estiver em um painel, poderá criar um bloco de consulta.

No modo de edição do painel, é possível adicionar um bloco de consulta de duas maneiras:

• Clique no botão Adicionar no canto superior esquerdo do painel e escolha a opção Visualização.
• No entanto, se o painel estiver em branco, você poderá selecionar o botão Adicionar no centro do painel e escolher a opção Visualização.

Em seguida, o Looker mostra um menu de Análises. Escolha um Explore para começar a criar sua consulta.

O Looker abre a janela Explorar para que você crie sua consulta. Para criar uma consulta, siga estas etapas:

1. No campo de título do canto superior esquerdo, digite um nome para sua consulta. Esse será o nome do bloco no dashboard.
2. Selecione os campos e filtros no seletor de campo.
3. Configure suas opções de visualização no painel Visualização.
4. Depois de configurar a consulta, clique em Executar.
5. Clique em Salvar para salvar a consulta como um bloco no seu painel.

Para blocos novos adicionados a um dashboard, se eles foram criados a partir do mesmo Explore como um filtro de dashboard, o filtro do dashboard é aplicado automaticamente a esse bloco.

Observação :ao adicionar um bloco do painel que contém um gráfico de funil ou de linha do tempo, você pode notar que os gráficos parecem diferentes no bloco do painel do que na janela "Explorar". 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.

Adicionar blocos de consulta em um Explore

Você pode salvar um bloco de consulta em um painel diretamente de Explore. Quando estiver em uma Análise e tiver uma consulta que você quer adicionar ao painel, siga estas etapas:

1. Selecione Salvar no menu do ícone de engrenagem do ícone de engrenagem das Ações de exploração Configurações.

   Essa ação abre a janela Adicionar ao painel:

Observação :se o recurso Novo recurso Explorar e Salvar Look do Labs estiver ativado, uma nova experiência vai permitir que os usuários naveguem rapidamente pelas pastas e classifiquem o conteúdo por nome, data de criação ou última atualização.

1. No campo Título, dê um título ao bloco.
2. Na lista de pastas, selecione a pasta em que o painel está localizado.
3. Na lista de painéis, selecione o nome do painel ou digite um nome na barra de pesquisa Filtrar por título... para restringir os resultados.
4. Clique em Salvar no painel.

Uma mensagem de confirmação vai aparecer na parte de cima da ferramenta "Explorar" quando ela for adicionada como um bloco em um dashboard. Quando você clica no título do painel na mensagem de confirmação, o Looker leva diretamente ao painel no modo de edição. A partir daí, você pode mover e redimensionar os blocos como quiser.

Para blocos novos adicionados a um dashboard, se eles foram criados a partir do mesmo Explore como um filtro de dashboard, o filtro do dashboard é aplicado automaticamente a esse bloco.

Observação :ao adicionar um bloco do painel que contém um gráfico de funil ou de linha do tempo, você pode notar que os gráficos parecem diferentes no bloco do painel do que na janela "Explorar". 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.

Adicionar blocos de um Look

É possível adicionar blocos de consulta e blocos vinculados ao Look aos painéis de um Look.

Adicionar blocos de consulta de um Look

Para adicionar blocos de consulta de um Look, siga estas etapas:

1. Acesse um Look.
2. Nas configurações do menu do ícone de engrenagem Explorar ações, selecione Salvar . Esta ação abre um submenu.

3. Selecione Para um painel existente no submenu.

   Essa ação abre a janela Adicionar ao painel.

4. Quando você adiciona um bloco de consulta de um Look, ele recebe o mesmo título que o nome do Look no campo Title, que pode ser editado posteriormente.

5. Na lista de pastas, selecione a pasta em que o painel está localizado.

6. Na lista de painéis, selecione o nome do painel ou digite um nome na barra de pesquisa Filtrar por título... para restringir os resultados.

7. Clique em Salvar no painel.

Os blocos adicionados a um dashboard por esse método não são conectados ao Look do qual você os criou. É possível editar os blocos sem afetar o Look. É possível editar ou excluir o Look sem afetar os blocos.

Uma mensagem de confirmação vai aparecer na parte de cima do Look quando ele for adicionado como um bloco em um dashboard. Quando você clica no título do painel na mensagem de confirmação, o Looker leva diretamente ao painel no modo de edição. A partir daí, você pode mover e redimensionar os blocos como quiser.

Para qualquer bloco novo adicionado a um dashboard, se o Look em que ele foi baseado tiver sido criado a partir do mesmo filtro do Explore, o filtro do dashboard será aplicado automaticamente ao bloco.

Como adicionar blocos vinculados ao Look de um Look

É possível salvar um bloco vinculado ao Look em um dashboard diretamente de um Look. No entanto, o Look e o dashboard precisam estar na mesma pasta.

Para adicionar um bloco vinculado ao Look a um dashboard (consulte a seção Adicionar blocos de consulta de um Look para recursos visuais), siga estas etapas:

1. Confira se o dashboard e o Look estão na mesma pasta ou copie o Look na mesma pasta que o dashboard.
2. Selecione Para um painel existente no submenu. Isso abre a janela Adicionar ao painel.
3. Verifique se a pasta que contém o Look e o dashboard está selecionada.
4. Selecione o painel.
5. Clique em Adicionar Look ao dashboard.

Todos os blocos adicionados a um dashboard usando esse método são conectados ao Look a partir do qual você os criou e têm o mesmo título do Look. Se você editar o bloco, o Look e os outros blocos vinculados a esse Look serão afetados. Se você editar ou excluir o Look, os blocos serão afetados.

Uma mensagem de confirmação vai aparecer na parte de cima do Look quando ele for adicionado como um bloco em um dashboard. Quando você clica no título do painel na mensagem de confirmação, o Looker leva diretamente ao painel no modo de edição. A partir daí, você pode mover e redimensionar os blocos como quiser.

Para qualquer bloco novo adicionado a um dashboard, se o Look em que ele foi baseado tiver sido criado a partir do mesmo filtro do Explore, o filtro do dashboard será aplicado automaticamente ao bloco.

Observação: ao adicionar um bloco do painel que contém um gráfico de funil ou de linha do tempo, você pode notar que os gráficos parecem diferentes no bloco do painel do que no Look. 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.

Adicionar texto

Quando um painel estiver no modo de edição, você pode adicionar blocos de texto clicando no botão Adicionar no canto superior esquerdo do painel.

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

• Texto: um bloco de texto do painel que oferece uma experiência de edição visual.
• Markdown: opção de bloco de texto preexistente do Looker, que permite usar algum HTML e um subconjunto da linguagem de marcação Markdown para formatar o bloco.

Depois de salvar o bloco Text ou Markdown, ele vai aparecer na parte de baixo do painel. Você pode mover e redimensionar o bloco de texto da mesma forma que moveria e redimensionaria outros blocos.

Adicionar blocos de texto

Blocos de texto são blocos de texto de painéis que oferecem uma experiência de edição visual.

Para formatar o texto do bloco, siga estas etapas:

1. Destaque o texto no bloco que você quer formatar.

2. Clique nos ícones de estilo de texto na parte de cima do bloco.

   Conforme você edita o bloco de texto, ele muda para mostrar como ele vai aparecer quando for salvo.

3. Para salvar o bloco, clique em Salvar no painel.

Para editar um bloco existente, entre no modo de edição, clique no texto do bloco para fazer alterações e salve o painel.

Como adicionar blocos Markdown

Blocos de Markdown são blocos de texto de painel que podem ser formatados usando HTML e Markdown.

Depois que você selecionar Markdown, será exibida uma janela onde é possível adicionar um título, subtítulo e corpo. Esses elementos são opcionais.

Os títulos e subtítulos são compatíveis com HTML, incluindo links e imagens. Também é possível usar HTML nos corpos de blocos de Markdown. Para entender como o Looker renderiza HTML, consulte a página de documentação sobre Limpeza de HTML.

O corpo do texto é compatível com um subconjunto da linguagem de marcação Markdown. Consulte a página de documentação Como usar Markdown em blocos Markdown para ver mais informações sobre qual sintaxe Markdown é compatível com o corpo do texto.

Adicionar botões

Com a opção Botão no menu Adicionar, você adiciona botões personalizados ao painel. É possível atribuir ao botão um link a um URL do Looker ou a um URL externo. Então, quando um leitor do painel selecionar o botão, ele será levado para o URL.

Para adicionar um botão ao painel, siga estas etapas:

1. Verifique se o painel está no modo de edição.

2. No menu do botão Adicionar no canto superior esquerdo do painel, selecione a opção Botão.

   Um novo botão aparece na parte superior do painel com uma janela de edição de botão aberto.

   

3. Na guia Conteúdo da janela de edição do botão, preencha os seguintes campos:

   • Rótulo: esse texto aparecerá no botão. O botão se expande para acomodar o rótulo até que ele atinja a largura da caixa de blocos. Quando o rótulo atingir esse limite, ele será truncado. Se o rótulo estiver truncado, ele poderá ser repetido no campo Descrição.

   • Link: é o link para onde o botão direciona os espectadores.

     Observação: em uma experiência incorporada, os links para os painéis precisam conter embed/ no URL do link.

   • Descrição: aparece quando você passa o cursor sobre o botão. Se você não digitar um valor, o padrão da descrição será o link.

   • Abrir em uma nova guia do navegador: selecione essa opção para abrir automaticamente o link em uma nova guia do navegador, em vez de sair do painel. Por padrão, essa opção é ativada.

4. Na guia Design da janela de edição do botão, é possível personalizar a aparência do botão:

   • Estilo do botão: selecione uma opção:

     • Preenchido: o botão tem um plano de fundo colorido e texto branco.
     • Contornado: o botão tem contorno e texto colorido.
     • Transparente: o botão não tem contorno ou plano de fundo. Ter apenas texto colorido.

   • Color: selecione uma cor de uma das coleções de cores do Looker na guia Themes ou personalize uma cor na guia Custom. Em seguida, selecione Salvar.

   • Tamanho do botão: escolha Pequeno, Médio ou Grande para definir o tamanho do texto do botão. A altura do botão se ajusta ao texto. O tamanho padrão é médio.

   • Alinhamento: escolha Esquerda, Centro ou Direita para alinhar horizontalmente o botão dentro da caixa de blocos. A caixa de bloco do botão tem a largura total como padrão e o alinhamento é centralizado.

5. Clique em Salvar.

Como mover e redimensionar botões

Depois de adicionado, um botão pode ser movido e a caixa do bloco pode ser redimensionada como qualquer outro bloco.

Por padrão, um novo botão é colocado na parte de cima do painel, em uma caixa de bloco definida na largura total do painel.

Redimensionar a caixa de bloco de um botão pode afetar a colocação de outros elementos do dashboard e a largura de um botão. No entanto, só é possível ajustar o tamanho ou a altura do texto de um botão com a opção Tamanho do botão na janela de edição.

Adicionar extensões

Se você tiver a função de administrador do Looker ou a permissão develop, ou se tiver recebido acesso a uma ou mais extensões, a opção Extensão vai aparecer no menu Adicionar. A opção Extensão permite adicionar uma extensão personalizada como um bloco ao seu painel.

Para adicionar uma extensão como um bloco, siga estas etapas:

1. Verifique se o painel está no modo de edição.

2. No menu do botão Adicionar no canto superior esquerdo do painel, selecione a opção Extensão. O painel “Extensões” será exibido, listando todas as extensões disponíveis que podem ser instaladas como um bloco no seu painel.

   

3. No painel Extensões, na seção da extensão que você quer instalar, clique em Adicionar ao bloco. A extensão selecionada será instalada no novo bloco no painel de controle.

Adicionar ações de dados a blocos

Se você tiver a permissão develop para o model em que um bloco se baseia, poderá adicionar ações de dados a ele. As ações de dados permitem que os visualizadores do painel executem tarefas com outras ferramentas diretamente no bloco do painel, como enviar um e-mail ou definir valores em outros aplicativos. Essas ações de dados aparecem na seção Ações do menu de detalhamento.

Consulte a página de documentação do parâmetro action para mais informações.

Como adicionar filtros a um painel

As consultas subjacentes aos blocos do dashboard podem incluir filtros, mas você também pode adicionar filtros ao próprio painel. Isso pode afetar todos os blocos ou apenas os blocos selecionados. Com os filtros do painel, os usuários podem restringir os resultados apenas aos dados em que têm interesse.

Para adicionar filtros do dashboard, é preciso ter pelo menos um bloco de consulta ou bloco vinculado ao Look no dashboard. Para adicionar filtros, entre no modo de edição e selecione o botão Filtros filter_list na barra de ferramentas de cima.

Para saber mais sobre como criar filtros de painel padrão, acesse a página de documentação Como adicionar e editar filtros de painel definidos pelo usuário.

Para saber como ativar o cruzamento de filtros nos painéis, acesse a página de documentação Painéis de cruzamento de filtros.

Como definir as configurações do painel

Você pode acessar as configurações do painel no canto superior esquerdo do painel na barra de ferramentas azul. As configurações padrão quando você cria um painel são as seguintes:

• Fuso horário: o fuso horário de cada bloco.
• Executar ao carregar: ativado
• Visualização com filtros padrão: expandida

Consulte a página de documentação Como editar painéis definidos pelo usuário para mais informações sobre como editar essas configurações.

Como adicionar uma descrição a um painel

Para adicionar uma descrição a um painel, verifique se ele está no modo de edição e selecione Mostrar detalhes do painel no menu do ícone de três pontos Ações do painel more_vert.

A caixa de texto Descrição poderá ser editada.

Depois de adicionar uma descrição, clique em Salvar para salvar a alteração.

Como melhorar a performance do painel usando o reconhecimento agregado

Os desenvolvedores do LookML podem melhorar a performance do dashboard usando o reconhecimento agregado. Com o reconhecimento agregado, os desenvolvedores podem criar tabelas agregadas nos parâmetros explore do LookML, que podem otimizar consultas para um ou mais blocos em um dashboard. A primeira etapa é acessar a tabela de agregação do LookML, que aparece abaixo da opção Acessar LookML no menu do ícone de três pontos more_vert das Ações do painel. Para mais informações, consulte a página de documentação do parâmetro aggregate_table.

Encontre outras 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.