Criação de painéis definidos pelo usuário

A partir do Looker 7.18, não é possível criar painéis legados do zero. Os painéis devem ser criados usando a nova experiência do painel de controle do Looker, que é descrita nesta página.

Se o administrador do Looker tiver ativado o recurso legado Reverter para painéis legados, você poderá criar um painel e removê-lo permanentemente a um painel legado.

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

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

• O nível de acesso Gerenciar acesso, Editar para a pasta na qual você quer colocar o painel
• As permissões do Looker no save_content e no see_user_dashboards

Além disso, é preciso ter acesso aos modelos LookML para usar os dados que você quer usar no painel.

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

Criação de um painel a partir de uma pasta

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

1. Navegue até uma pasta onde você quer que o painel seja localizado.
2. Clique no botão Novo no canto superior direito da pasta.

3. Clique em Painel.

   A janela Create Dashboard será exibida:

   

4. Insira um nome para o novo painel.

5. Clique em Criar painel.

Em seguida, seu novo painel em branco será exibido. Feito isso, é possível adicionar blocos ou texto ao entrar no modo de edição. Para editar o painel, selecione Editar painel no menu do painel ou clique no botão Editar painel no centro do painel.

Como criar um painel com base em um recurso "Olhar" ou "Explorar"

Para criar um painel usando um Look ou um Explore:

1. Navegue até um visual ou uma exploração.

2. Selecione Salvar no menu.

3. Selecione o submenu Como novo painel no submenu.

   A janela Save as a new Dashboard será aberta.

   

4. Na guia Configurações do campo Título, insira um nome para o novo painel.

   O nome inserido se aplica ao bloco e ao painel de controle. 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 o título de um bloco de consulta na página de documentação Como editar painéis definidos pelo usuário. Para mudar o nome do painel, entre no modo de edição no painel.

5. Selecione a pasta em que você quer salvar o painel. É necessário ter o nível de acesso Gerenciar acesso, Editar para a pasta.

   

6. Na guia Filtros, selecione se os filtros do Look's ou Explorar' serão usados como filtros do painel. Os filtros personalizados não podem ser filtros de painel, mas permanecem como filtros de bloco.

7. Clique em Save.

   O recurso "Olhar" ou "Explorar" será salvo como um bloco de consulta no painel de controle.

Adicionar blocos e texto a um painel

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

O primeiro bloco adicionado a um painel ocupa toda a largura do painel. Os blocos adicionais adicionados são dimensionados para um terço da largura do painel e são adicionados horizontalmente abaixo do primeiro bloco. O Looker adiciona outras linhas de blocos, conforme necessário. Você pode mover e redimensionar blocos como quiser. Também é possível editar blocos após tê-los criado para ajustar os nomes dos blocos, as visualizações ou as consultas ou aparências subjacentes.

Para todos os novos blocos que forem adicionados a um painel, se eles tiverem sido criados no mesmo "Explorar" como um filtro do painel, o filtro do painel será aplicado automaticamente a esse bloco.

Pense no número e na complexidade dos blocos e de 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. Veja mais 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.

Tipos de blocos do painel de controle

É possível adicionar três tipos de blocos a um painel:

• Blocos de consultas
• Blocos com link visual

• Blocos de texto

• Texto: um novo tipo de bloco de texto do painel que tem uma experiência de edição mais intuitiva e visual.

• Markdown: opção de bloco de texto preexistente do Looker, que usa a sintaxe de Markdown para definir o estilo da saída do bloco

Blocos de consulta

Os blocos de consultas podem ser criados diretamente em um painel ou adicionados a um painel de um olhar ou de um recurso Explorar.

Um bloco de consultas é baseado em uma consulta independente, que não está vinculada a uma aparência. A consulta de um bloco de consulta pertence ao painel. Mesmo que você use um visual existente para criar um bloco de consulta, ele será usado apenas durante a criação do bloco de consulta. O bloco não será afetado por nenhuma alteração posterior nessa aparência e ainda existirá no painel de controle, mesmo se o visual for excluído.

Quando possível, use blocos de consultas para evitar a sobrecarga de pastas desnecessariamente.

Blocos com link visual

Blocos vinculados à aparência são adicionados a um painel de um Look.

Um bloco vinculado ao Look Link vincula a consulta subjacente do bloco a um Look. Essa aparência é usada ao criar o bloco e toda vez que o painel é atualizado. A aparência e o painel precisam estar na mesma pasta. Se você quiser adicionar aparências de uma pasta diferente, primeiro copie a aparência para a mesma pasta do painel.

Um bloco com aparência vinculada é uma boa escolha se você quer criar, alterar e testar uma consulta em um só lugar, mas usá-la em vários painéis. Se a aparência mudar, todos os blocos vinculados a ela serão alterados. Se o Look for excluído, os painéis vão mostrar um erro para o bloco.

Blocos de texto

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

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

Criar blocos de consulta em um painel

Se você estiver em um painel, é possível criar um bloco de consultas de dentro do painel.

Quando estiver no modo de edição do painel, você poderá:

• Clique em Add no canto superior esquerdo do painel do painel e em Visualização.
• Clique no botão Adicionar no centro do painel do painel se o painel estiver em branco e clique em Visualização.

Em seguida, o Looker exibe um menu de explorações. Escolha uma ferramenta Explorar para criar sua consulta:

O Looker abre a janela Explorar para criar sua consulta:

1. Atribua um nome à sua consulta. Este será o nome do bloco no painel de controle.
2. Selecione os campos e filtros para sua consulta.
3. Configure as opções de 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 de controle.

Para todos os novos blocos que forem adicionados a um painel, se eles tiverem sido criados no mesmo "Explorar" como um filtro do painel, o filtro do painel será aplicado automaticamente a esse bloco.

Ao adicionar um bloco do painel que contém um gráfico de funil ou um gráfico de linha do tempo, você vai notar que os gráficos aparecem diferentes no bloco do painel e na janela Explorar. 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.

Adicionar blocos de consulta de uma exploração

Você pode salvar um bloco de consultas em um painel diretamente em Explorar. Quando você estiver em "Explorar" e tiver uma consulta que quer adicionar ao painel:

1. Selecione Salvar no menu de engrenagem e Em um painel existente no submenu.

   Isso abre uma janela Add to Dashboard:

   

2. Dê um título para o bloco.

3. Selecione a pasta em que o painel está localizado.

4. Selecione o painel.

5. Clique em Salvar no painel.

Uma mensagem de confirmação aparecerá na parte superior do Explorar depois que você o adicionar como um bloco em um painel de controle. Se você clicar no título do painel na mensagem de confirmação, o Looker direcionará diretamente para o painel no modo de edição. A partir daí, você pode mover e redimensionar os blocos como quiser.

Para todos os novos blocos que forem adicionados a um painel, se eles tiverem sido criados no mesmo "Explorar" como um filtro do painel, o filtro do painel será aplicado automaticamente a esse bloco.

Ao adicionar um bloco do painel que contém um gráfico de funil ou um gráfico de linha do tempo, você vai notar que os gráficos aparecem diferentes no bloco do painel e na janela Explorar. 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.

Adicionar blocos de um Look

É possível adicionar blocos de consultas e de links vinculados a painéis de um Look.

Adicionar blocos de consulta de um Look

1. Navegue até um visual ou uma exploração.
2. Selecione Salvar no menu de engrenagem. Um submenu será aberto.

3. Selecione Para um painel existente no submenu.

   Isso abre uma janela Add to Dashboard:

4. Quando você adiciona um bloco de consulta de um Look, o bloco recebe o mesmo título que o nome do Lookout (que pode ser editado depois).

5. Selecione a pasta em que o painel está localizado.

6. Selecione o painel.

7. Clique em Salvar no painel.

Os blocos que você adicionar a um painel por este método não estão conectados à aparência de onde você os criou. É possível editar os blocos sem afetar a aparência. É possível editar ou excluir o Look sem afetar os blocos.

Uma mensagem de confirmação vai aparecer na parte de cima da interface quando você a adicionar como um bloco em um painel de controle. Se você clicar no título do painel na mensagem de confirmação, o Looker direcionará diretamente para o painel no modo de edição. A partir daí, você pode mover e redimensionar os blocos como quiser.

Para qualquer novo bloco que for adicionado a um painel, se a aparência em que ele foi baseado tiver sido criada a partir do mesmo Explore que um filtro de painel, o filtro do painel será aplicado automaticamente a esse bloco.

Como adicionar blocos vinculados a um visual

É possível salvar um bloco com link visual em um painel diretamente de um Look. No entanto, a aparência e o painel precisam estar na mesma pasta.

Para adicionar um bloco com aparência de link a um painel (consulte a seção Como adicionar blocos de consulta de um visual para acessar recursos visuais):

1. Confira se o painel e o Look estão na mesma pasta ou copie o Look to the mesma pasta do painel.
2. Selecione Para um painel existente no submenu. Isso abre uma janela Add to Dashboard.
3. Confira se a pasta que contém a aparência e o painel está selecionada.
4. Selecione o painel.
5. Clique em Adicionar aparência ao painel.

Todos os blocos adicionados a um painel por este método são conectados à aparência da qual você as criou e têm o mesmo título da aparência. Se você editar o bloco, a aparência e os outros blocos vinculados a ela serão afetados. Se você editar ou excluir a aparência, os blocos vão ser afetados.

Uma mensagem de confirmação vai aparecer na parte de cima da interface quando você a adicionar como um bloco em um painel de controle. Se você clicar no título do painel na mensagem de confirmação, o Looker direcionará diretamente para o painel no modo de edição. A partir daí, você pode mover e redimensionar os blocos como quiser.

Para qualquer novo bloco que for adicionado a um painel, se a aparência em que ele foi baseado tiver sido criada a partir do mesmo Explore que um filtro de painel, o filtro do painel será aplicado automaticamente a esse bloco.

Ao adicionar um bloco do painel que contém um gráfico de funil ou um gráfico de linha do tempo, você pode notar que os gráficos no bloco do painel têm uma aparência diferente da aparência no gráfico. 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.

Adicionar texto

Isso abre uma janela em que é possível adicionar um título, subtítulo e corpo. Esses elementos são opcionais.

Títulos e legendas são compatíveis com parte do HTML, incluindo links e imagens. Você também pode usar HTML no corpo dos blocos de texto. No entanto, os blocos de texto convertidos de painéis originais podem não ser renderizados conforme o esperado, especialmente se o HTML estiver fazendo referência a nomes de classe em tags de elementos. Para entender como o Looker renderiza HTML, consulte a página de documentação de sanitização HTML.

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

Depois de salvar, você verá o bloco de texto na parte inferior do painel. Ele pode ser movido e redimensionado da mesma forma que você moveria e redimensionar outros blocos.

Quando um painel está no modo de edição, é possível adicionar blocos de texto clicando em Adicionar no canto superior esquerdo do painel.

Blocos de texto WYSIWYG ativados

Se o administrador do Looker tiver ativado o recurso Blocos de texto WYSIWYG do Labs, você verá duas opções de blocos de texto:

• Texto: um novo tipo de bloco de texto do Looker com uma experiência de edição intuitiva e visual. Você pode ver a tela final do bloco de texto ao editá-lo. Clique em Salvar no painel de controle para salvar seu bloco.
• Markdown: bloco de texto original do Looker que permite usar algum HTML e um subconjunto da linguagem de marcação Markdown para formatar o bloco.

Blocos de texto WYSIWYG desativados

Se o administrador do Looker não tiver ativado o recurso Blocos de texto WYSIWYG do Labs, você verá uma opção, Texto. Ao selecioná-lo, você pode usar os blocos de texto originais do Looker e formatá-los usando HTML e Markdown.

Quando você seleciona Texto, aparece uma janela para adicionar um título, um subtítulo e um corpo. Esses elementos são opcionais.

Títulos e legendas são compatíveis com parte do HTML, incluindo links e imagens. Você também pode usar HTML no corpo dos blocos de texto. No entanto, os blocos de texto convertidos de painéis originais podem não ser renderizados conforme o esperado, especialmente se o HTML estiver fazendo referência a nomes de classe em tags de elementos. Para entender como o Looker renderiza HTML, consulte a página de documentação de sanitização HTML.

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

Depois de salvar o bloco de texto, ele vai aparecer na parte de baixo do painel. É possível mover e redimensionar seu bloco de texto, assim como você moveria e redimensionar outros blocos.

Como adicionar botões

Com a opção Botão, você pode adicionar botões personalizados ao seu painel de controle. Você atribui ao botão um link para um URL do Looker ou um URL externo. Quando um visualizador do painel seleciona o botão, eles são direcionados para o URL.

Para adicionar um botão ao painel:

1. Verifique se o painel está no modo de edição.
2. Selecione Botão no menu.

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

   

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

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

   • Link: é o link que o usuário acessa com o botão.

     Em uma experiência incorporada, os links para painéis precisam conter embed/ no URL do link.

   • Descrição: essa descrição aparece quando você passa o cursor sobre o botão. Se você não inserir um valor, a descrição será definida como padrão do 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. Essa opção fica ativada por padrão.

5. 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 um texto branco.
     • Delineado: o botão tem um contorno e um texto colorido.
     • Transparente: o botão não tem contorno ou plano de fundo. Ela tem apenas texto colorido.

   • Cor: selecione uma cor de uma das coleções de cores do Looker na guia Temas ou personalize uma cor na guia Personalizado. 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. O padrão da caixa de blocos do botão é a largura total, e o alinhamento do padrão é centralizado.

6. Clique em Salvar.

Como mover e redimensionar botões

Depois de adicionado, o botão pode ser movido, e a caixa de blocos pode ser redimensionada da mesma forma que qualquer outro bloco.

Por padrão, um novo botão é colocado na parte superior de um painel em uma caixa de blocos definida com a largura total dele.

O redimensionamento de um bloco de bloco de botões pode afetar o posicionamento de outros elementos do painel 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 do botão.

Adicionar ações de dados a blocos

Se você tiver a permissão develop para o modelo em que um bloco se baseia, pode adicionar ações de dados a esse modelo. As ações de dados permitem que os visualizadores do painel executem tarefas com outras ferramentas diretamente do bloco, como enviar um e-mail ou definir valores em outros aplicativos.

No exemplo acima, o campo Phone tem uma ação do Twilio. Ao clicar no número de telefone e selecionar a ação do Twilio, um pop-up do Twilio solicita que você digite uma mensagem. Em seguida, o Twilio envia essa mensagem para o número de telefone.

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 de painéis podem incluir filtros, mas também é possível adicionar filtros a um painel, o que pode afetar todos os blocos ou selecionar apenas blocos. Os filtros do painel permitem que os usuários restrinjam os resultados de um painel apenas aos dados de interesse.

Para adicionar filtros do painel, você precisa ter pelo menos um bloco de consulta ou de link vinculado ao painel. Para adicionar filtros, entre no modo de edição e selecione Filtros na barra de ferramentas superior:

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 mais sobre a ativação de vários filtros no painel, acesse a página de documentação Painéis de filtragem cruzada.

Ajustar as configurações do painel

As configurações do painel podem ser acessadas no canto superior esquerdo do painel da barra de ferramentas azul. As configurações padrão ao criar um painel são:

• Fuso horário: cada fuso horário do bloco
• Executar no carregamento: ativado
• Visualização de 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.

Adicionar uma descrição a um painel

Para adicionar uma descrição a um painel, confira se ele está no modo de edição e selecione Mostrar detalhes do painel no menu de três pontos do painel. A caixa de texto Descrição se tornará editável.

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

Revertendo para um painel legado

Se o administrador do Looker tiver ativado o recurso legado Reverter para painéis legados, você poderá redefinir permanentemente um painel recém-criado a um painel legado depois que ele for criado.

Se o administrador do Looker não tiver ativado o recurso legado Reverter para painéis legados, você poderá reverter temporariamente um painel recém-criado a um painel legado removendo o -next do URL do painel.

Como melhorar o desempenho do painel usando o reconhecimento agregado

Os desenvolvedores do LookML podem melhorar o desempenho do painel usando o reconhecimento agregado. Com o reconhecimento agregado, os desenvolvedores podem criar tabelas agregadas com os parâmetros explore do LookML, o que pode otimizar as consultas para um ou mais blocos em um painel. O primeiro passo é criar a tabela agregada LookML, que aparece na opção Get LookML no menu de três pontos do painel. Para mais informações, consulte a página de documentação do parâmetro aggregate_table.

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.