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, edição 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 dashboard, lembre-se das práticas recomendadas. 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 criar um painel com o botão Criar

O botão Criar no painel de navegação esquerdo do Looker permite criar dashboards. Para criar um painel, siga estas etapas:

1. Clique no botão Criar.
2. Selecione o item de menu Dashboard. A janela Criar painel será aberta.
3. Insira um nome para o novo painel no campo Nome.
4. Navegue até a pasta em que você quer salvar o dashboard. 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 daqui, você pode adicionar blocos ou texto entrando 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 clique no botão Editar dashboard no centro do painel.

Como criar um painel usando uma pasta

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

1. Acesse a pasta em que você quer que o painel esteja.
2. Clique no botão Novo 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, seu novo painel em branco será exibido. A partir daqui, você pode adicionar blocos ou texto entrando 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 clique no botão Editar dashboard no centro do painel.

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 ícone de engrenagem Abrir ações.

3. Clique em Como novo dashboard no submenu.

   A janela Salvar como um novo dashboard será aberta.

4. No campo Título, insira 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 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 dashboard, a próxima etapa é adicionar blocos e texto ao dashboard.

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 linhas de blocos conforme necessário. Você pode mover e redimensionar blocos como quiser. Também é possível editar blocos depois de criá-los para ajustar os nomes dos blocos, das visualizações, das consultas ou dos Looks.

Para todos os novos blocos adicionados a um dashboard, se eles tiverem sido criados a partir da mesma Análise como um filtro do dashboard, o filtro do dashboard é aplicado automaticamente a esse bloco.

Observação :pense no número e na complexidade dos blocos e outros elementos que você adiciona a um dashboard. 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. Confira mais recomendações sobre como criar painéis de alta performance na página Considerações ao criar painéis de alta performance no Looker.

Tipos de blocos do dashboard

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

• Blocos de consulta
• Blocos vinculados de Look
• 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 subjacente a um bloco de consulta pertence ao dashboard. Mesmo que você use um Look existente para criar um bloco de consulta, o Look é usado somente durante a criação do bloco de consulta. O bloco não é afetado por mudanças posteriores no Look e ainda existirá 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 de Look

Os blocos vinculados ao Look são adicionados a um dashboard usando 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. Se quiser adicionar Looks de uma pasta diferente, primeiro copie o Look para a mesma pasta que o dashboard.

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

Blocos de texto

Os blocos de texto são construídos 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 de controle têm formatação flexível e, por padrão, parecem mais títulos e descrições do que blocos.

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

Como criar blocos de consulta em um painel

Se você está em um painel, pode criar um bloco de consulta a partir do painel.

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ê pode 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 uma Análise 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 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 dashboard.

Para todos os novos blocos adicionados a um dashboard, se eles tiverem sido criados a partir da mesma Análise como um filtro do 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 no bloco do painel parecem diferentes em comparação com a janela "Explorar". 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.

Como adicionar blocos de consultas de uma Análise

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

1. Selecione Salvar nas Abrir açõesmenu do ícone de engrenagem configurações.

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

Observação: se o recurso Novo recurso Explorar e salvar Look estiver ativado, uma nova experiência vai permitir que os usuários naveguem rapidamente pelas pastas e possam classificar o conteúdo atual 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 dashboard 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 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 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 todos os novos blocos adicionados a um dashboard, se eles tiverem sido criados a partir da mesma Análise como um filtro do 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 no bloco do painel parecem diferentes em comparação com a janela "Explorar". 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.

Adicionar blocos de um Look

Você pode adicionar blocos de consulta e blocos vinculados ao Look aos dashboards a partir de um Look.

Adicionar blocos de consulta usando um Look

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

1. Navegue até 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 dashboard por esse método não estão conectados ao Look criado. É 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 aparece na parte superior do Look assim que você o adiciona como um bloco em um dashboard. 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 novo bloco adicionado a um dashboard, se o Look em que ele foi baseado foi criado a partir do mesmo filtro de “Análise”, o filtro do dashboard é 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 de Look vinculado a um dashboard (consulte a seção Adicionar blocos de consulta de um Look para elementos visuais), 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 dashboard 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 esse Look serão afetados. Se você editar ou excluir o Look, os blocos serão afetados.

Uma mensagem de confirmação aparece na parte superior do Look assim que você o adiciona como um bloco em um dashboard. 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 novo bloco adicionado a um dashboard, se o Look em que ele foi baseado foi criado a partir do mesmo filtro de “Análise”, o filtro do dashboard é 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 são diferentes do Look. 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.

Adicionando texto

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

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 que você 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.

Como 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 superior 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.

Como adicionar blocos Markdown

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

Depois de selecionar Marcação, você verá 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. 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 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 o Markdown em blocos Markdown para mais informações sobre qual sintaxe Markdown é compatível no corpo do texto.

Como adicionar botões

Com a opção Botão no menu Adicionar, é possível incluir botões personalizados no painel. É possível atribuir ao botão um link para um URL do Looker ou externo. Então, quando um visualizador do painel seleciona o botão, ele é levado para o URL.

Para adicionar um botão ao seu 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, selecione a opção Botão.

   Um novo botão aparece na parte superior do painel com uma janela de edição de botões 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 incorporada, os links para 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 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. 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 dele:

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

     • Preenchido: o botão tem um plano de fundo colorido e um texto branco.
     • Contornado: o botão tem 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 para caber no texto. O tamanho padrão é médio.

   • Alinhamento: escolha Esquerda, Centro ou Direita para alinhar o botão horizontalmente na caixa do bloco. O padrão da caixa de bloco do botão é de largura total, e o alinhamento padrão é 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.

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

Adicionar extensões

Se você tiver o papel 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. 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 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 seu painel.

Como adicionar ações de dados a blocos

Se você tiver a permissão develop para o model em que um bloco é baseado, poderá adicionar ações de dados a ele. Com as ações de dados, os leitores de painéis podem realizar tarefas com outras ferramentas diretamente no bloco do dashboard, 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 de cruzamento de filtros.

Como definir as configurações do painel

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

• Fuso horário: o fuso 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.

Adicionar uma descrição a um dashboard

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 Ações do painel more_vert.

A caixa de texto Descrição ficará editável.

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

Como melhorar o desempenho do painel usando reconhecimento agregado

Os desenvolvedores do LookML podem melhorar o desempenho do dashboard usando o reconhecimento agregado. Com o reconhecimento agregado, os desenvolvedores podem criar tabelas agregadas nos parâmetros explore do LookML, o que pode otimizar consultas para um ou mais blocos em um dashboard. 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.

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