Como criar painéis definidos pelo usuário

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

Para criar um painel, você precisa ter:

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

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

Ao criar um painel, lembre-se das práticas recomendadas para a construção dele. Encontre informações e recomendações sobre como criar painéis de desempenho na página de práticas recomendadas Considerações ao criar painéis de desempenho do Looker.

Criar um painel usando o botão Criar

Um botão Criar no painel de navegação à esquerda do Looker permite criar painéis. Para criar um painel, siga estas etapas:

1. Clique no botão Criar.
2. Selecione o item de menu Painel. Isso abre a janela Criar painel.
3. Insira um nome para o novo painel no campo Nome.
4. Navegue até a pasta em que você quer salvar o dashboard e selecione-a. Também é possível selecionar o ícone Criar nova pasta create_new_folder para criar uma nova pasta para o dashboard.
5. Clique em Criar painel.

Em seguida, seu novo painel em branco será exibido. A partir daí, você pode adicionar blocos ou texto ao entrar no modo de edição. Para entrar no modo de edição, clique em Editar dashboard no menu Ações do dashboard more_vert ou no botão Editar dashboard no centro do painel.

Criar um painel em uma pasta

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

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

3. Clique na opção Painel.

   A janela Create Dashboard será aberta.

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

5. Clique em Criar dashboard.

Em seguida, o novo painel em branco vai aparecer. A partir daí, você pode adicionar blocos ou texto ao entrar no modo de edição. Para entrar no modo de edição, clique em Editar dashboard no menu do ícone de três pontos Ações do dashboard more_vert ou no botão Editar dashboard no centro do painel do dashboard.

Criar um dashboard usando um Look ou uma Análise

Para criar um dashboard com base em um Look ou uma Análise, siga estas etapas:

1. Navegue até um Look ou um Explore.
2. Clique em Salvar nas configurações do menu de ícones de engrenagem Abrir ações.

3. Clique em Como novo painel no submenu.

   Isso abre uma janela Salvar como um novo painel.

4. No campo Título, insira um nome para o novo dashboard.

   O nome que você inserir será aplicado ao bloco e ao painel. Você pode modificar os nomes dos títulos a qualquer momento. Para alterar o nome do bloco de uma 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 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 o painel. Você precisa ter o nível de acesso Gerenciar acesso, edição na pasta.

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

7. Clique em Salvar.

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

Adição de 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ê adiciona a um dashboard ocupa toda a largura do dashboard. Os blocos adicionais que você adiciona são dimensionados para um terço da largura do painel e são adicionados horizontalmente abaixo do primeiro bloco. O Looker adiciona mais 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 dos blocos, das visualizações ou das consultas ou Looks.

Se os novos Blocos adicionados a um painel forem criados na mesma Análise detalhada que um filtro de painel, o filtro será aplicado automaticamente a esse Bloco.

Observação: 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, crie vários painéis com menos elementos em cada um. Confira mais recomendações sobre como criar painéis de desempenho na página de práticas recomendadas Considerações ao criar painéis de desempenho do Looker.

Tipos de Blocos do painel

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

• Blocos de consulta
• Telas vinculadas à aparência
• Blocos de texto
• Blocos de extensão

Blocos de consulta

Os blocos de consulta podem ser criados diretamente em um dashboard ou adicionados a um dashboard a partir de um Look ou de uma Análise.

Um bloco de consulta é baseado em uma consulta independente, que não está vinculada a um Look. A consulta que é a base de um bloco de consulta pertence ao painel. Mesmo que você use um Look existente para criar um bloco de consulta, ele só será usado durante a criação do bloco. O bloco não é afetado por alterações posteriores no Look e continua no painel, mesmo que o Look seja excluído.

Sempre que possível, use blocos de consulta para evitar que as pastas fiquem bagunçadas com Looks desnecessários.

Blocos de aparência vinculada

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

Um Bloco vinculado a um Look associa a consulta subjacente do Bloco a um Look. Esse visual é usado ao criar o bloco e sempre que o painel é atualizado. O Look e o dashboard precisam estar na mesma pasta. Se quiser adicionar Looks de uma pasta diferente, primeiro copie o Look para a mesma pasta que o dashboard.

Um bloco vinculado a um visual é uma boa opção se você quiser criar, mudar e testar uma consulta em um só lugar, mas usá-la em vários painéis. Se o Look mudar, todos os blocos vinculados a ele mudarão. Se o visual 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.

Você pode 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 uma formatação flexível e, por padrão, têm uma aparência mais semelhante a títulos e descrições do que blocos.

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:

• Texto: um bloco de texto do painel que oferece uma experiência de edição visual.
• Markdown: a opção de bloco de texto pré-existente do Looker, que permite usar um pouco de 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, adicionados a um dashboard e executados dentro de um bloco do dashboard.

Criar blocos de consulta em um painel

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

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 do painel de informações e escolha a opção Visualização.
• No entanto, se o painel estiver em branco, selecione o botão Adicionar no centro do painel e escolha a opção Visualização.

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

O Looker abre a janela Análise para que você possa criar sua consulta. Para criar uma consulta, siga estas etapas:

1. No campo de título no canto superior esquerdo, insira um nome para sua consulta. Esse será o nome do bloco no dashboard.
2. Selecione os campos e os filtros no seletor de campos.
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 dashboard.

Para todos os novos blocos adicionados a um dashboard, se eles tiverem sido criados na mesma Análise como um filtro do dashboard, o filtro do dashboard será 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ê vai perceber que os gráficos no bloco do painel parecem diferentes em comparação com a janela "Explorar". Além disso, as ferramentas de visualização dos mapas funcionam de maneira diferente quando são 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.

Adicionar blocos de consulta de uma análise detalhada

É possível salvar um bloco de consulta em um painel diretamente de uma Explorar. Quando estiver em uma Análise detalhada e tiver uma consulta que quer adicionar ao painel, siga estas etapas:

1. Selecione Salvar no menu do ícone de engrenagem Abrir ações Configurações.

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

Observação: se o recurso New Explore & Look Saving Labs estiver ativado, uma nova experiência vai permitir que os usuários naveguem mais rapidamente pelas pastas e possam classificar 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á.
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 dashboard.

Uma mensagem de confirmação aparece na parte superior de “Explorar” depois que você o adiciona como um bloco em um dashboard. Se você clicar no título do painel na mensagem de confirmação, o Looker vai levá-lo diretamente ao painel no modo de edição. Lá, você pode mover e redimensionar os blocos como quiser.

Para todos os novos blocos adicionados a um dashboard, se eles tiverem sido criados na mesma Análise como um filtro do dashboard, o filtro do dashboard será 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ê vai perceber que os gráficos no bloco do painel parecem diferentes em comparação com a janela "Explorar". 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 do gráfico de funil, gráfico de linha do tempo e gráfico de mapa.

Adicionar blocos de um Look

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

Adicionar blocos de consulta usando um Look

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

1. Acesse um Look.
2. Nas configurações do menu de engrenagem Abrir ações, selecione Salvar . Essa ação abre um submenu.

3. Selecione Para um painel existente no submenu.

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

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

5. Na lista de pastas, selecione a pasta em que o dashboard 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 dashboard.

Os blocos adicionados a um painel usando esse método não são conectados ao Look em que foram criados. É 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 visual depois que você adicionar o bloco a um painel. Se você clicar no título do dashboard na mensagem de confirmação, o Looker vai direcionar você para o painel no modo de edição. A partir daí, é possível mover e redimensionar blocos como você quiser.

Para qualquer bloco novo adicionado a um painel, se o Look que serviu de base foi criado com base no mesmo Explore de um filtro do painel, o filtro do painel é aplicado automaticamente a esse bloco.

Como adicionar blocos vinculados ao Look usando um Look

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

Para adicionar um bloco vinculado a um visual, siga estas etapas:

1. Verifique 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 painel está selecionada.
4. Selecione o painel.
5. Clique em Adicionar Look ao dashboard.

Todos os blocos que você adicionar a um dashboard por esse método serão conectados ao Look com o qual você os criou e terão o mesmo título do Look. Se você editar o bloco, o Look e todos os outros blocos vinculados a ele 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 visual depois que você adicionar o bloco a um painel. Se você clicar no título do painel na mensagem de confirmação, o Looker vai levá-lo diretamente ao painel no modo de edição. A partir daí, é possível mover e redimensionar blocos como você quiser.

Para qualquer novo bloco adicionado a um dashboard, se o Look em que ele foi baseado tiver sido criado a partir do mesmo filtro de “Análise”, o filtro do dashboard será aplicado automaticamente a esse bloco.

Observação: ao adicionar um bloco do dashboard que contém um gráfico de funil ou de linha do tempo, é possível notar que os gráficos no bloco do dashboard parecem diferentes do Look. 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 do gráfico de funil, gráfico de linha do tempo e gráfico de mapa.

Adicionando texto

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

Existem dois tipos de blocos de texto, cada um oferecendo 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: a opção de bloco de texto pré-existente do Looker, que permite usar um pouco de HTML e um subconjunto da linguagem de marcação Markdown para formatar o bloco.

Depois de salvar o bloco Texto ou Markdown, ele vai aparecer na parte de baixo do painel. É possível mover e redimensionar o bloco de texto da mesma forma que você move e redimensiona outros blocos.

Adicionar blocos de texto

Os blocos de texto são blocos de texto do painel 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.

   À medida que 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, entre no modo de edição, clique no texto do bloco para fazer as alterações e salve o dashboard.

Adicionar blocos Markdown

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

Depois de selecionar Markdown, uma janela vai aparecer para você adicionar um título, um subtítulo e o corpo. Esses elementos são opcionais.

Os títulos e subtítulos são compatíveis com HTML, incluindo links e imagens. Você também pode usar HTML na estrutura dos blocos Markdown. Para entender como o Looker renderiza HTML, consulte a página de documentação Sanitização 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 o Markdown em blocos Markdown para mais informações sobre qual sintaxe Markdown é compatível no corpo do texto.

Adicionar botões

A opção Botão no menu Adicionar permite adicionar botões personalizados ao painel. É possível atribuir um link do Looker ou um URL externo ao botão. Em seguida, quando um usuário do painel seleciona o botão, ele é direcionado para o URL.

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

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

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

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

   

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

   • Etiqueta: esse texto aparecerá no botão. O botão expande a largura 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 integrada, 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á padronizada para o link.

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

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

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

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

   • Cor: selecione uma cor em 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 é ajustada de acordo com o texto. O tamanho padrão é médio.

   • Alinhamento: escolha Esquerda, Centro ou Direita para alinhar o botão horizontalmente na caixa do bloco. A caixa de blocos 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 superior do painel, dentro de uma caixa de bloco definida com a largura total do painel.

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

Adicionar extensões

Se você tiver a função de administrador do Looker ou a permissão develop ou se tiver 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 do painel, selecione a opção Extensão. O painel "Extensões" vai aparecer, 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 seu painel.

Como adicionar ações de dados aos blocos

Se você tiver a permissão develop para o modelo em que um bloco é baseado, poderá adicionar ações de dados a ele. Com as ações de dados, os visualizadores do painel podem realizar 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.

Adicionar filtros de painel a um dashboard

As consultas subjacentes aos blocos do dashboard podem incluir filtros, mas também é possível adicionar filtros ao próprio painel, o que pode afetar todos os blocos ou apenas selecionar blocos. Os filtros de painel permitem que os usuários restrinjam os resultados de um painel apenas aos dados nos quais estão interessados.

Para adicionar filtros do dashboard, é necessário ter pelo menos um bloco de consulta ou um bloco vinculado ao Look no dashboard. Em seguida, você pode adicionar filtros entrando no modo de edição e selecionando o botão Filtros filter_list 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 como ativar os filtros cruzados do painel, acesse a página de documentação Painéis com filtros cruzados.

Como configurar as configurações do painel

Você pode acessar as configurações do painel no canto superior esquerdo dele, na barra de ferramentas azul. Estas são as configurações padrão ao criar um painel:

• Fuso horário: o fuso horário de cada bloco
• Executar ao carregar: 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.

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 Description vai ficar editável.

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

Como melhorar a performance do painel usando a consciência agregada

Os desenvolvedores do LookML podem melhorar o desempenho do dashboard usando o reconhecimento agregado. Com a consciência agregada, os desenvolvedores podem criar tabelas agregadas nos parâmetros explore do LookML, que podem otimizar consultas para um ou mais blocos em um painel. A primeira etapa é acessar o LookML da tabela de agregação, que aparece na opção Acessar o LookML no menu do ícone de três pontos Ações do dashboard more_vert. 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 desempenho na página de práticas recomendadas Considerações ao criar painéis de desempenho do Looker.