Os painéis definidos pelo usuário são criados na interface do Looker. Para comparar os painéis definidos pelo usuário e os painéis do LookML, consulte a página de documentação Comparação entre painéis definidos pelo usuário e painéis 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_contentesee_user_dashboardsdo Looker
Além disso, é necessário ter acesso aos modelos do LookML para todos os dados que você quer usar no painel.
Ao criar um dashboard, lembre-se das práticas recomendadas. 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
O botão Criar no painel de navegação esquerdo do Looker permite criar dashboards. Para criar um painel, siga estas etapas:
- Clique no botão Criar.
- Selecione o item de menu Dashboard. A janela Criar painel será aberta.
- Insira um nome para o novo painel no campo Nome.
- Navegue até a pasta em que você quer salvar o dashboard. Você também pode selecionar o ícone Criar nova pasta create_new_folder para criar uma nova pasta para o painel.
- Clique em Criar painel.
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 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:
- Navegue até uma pasta em que você quer que o painel seja localizado.
- Clique no botão Novo no canto superior direito da pasta.
Clique na opção Painel.
A janela Create Dashboard será aberta.
Insira um nome para o novo painel no campo Nome.
Clique em Criar dashboard.
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 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:
- Acesse um Look ou uma Análise.
- Clique em Salvar nas configurações do menu de ícones de engrenagem Abrir ações.
Clique em Como novo dashboard no submenu.
A janela Salvar como um novo dashboard será aberta.
No campo Título, insira um nome para o novo painel.
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.
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.
Na guia Filtros, clique para usar os filtros do Look ou da Análise como filtros do painel. Os filtros personalizados não podem se tornar filtros de painel, mas permanecem como blocos.
Clique em Salvar.
O Look ou a Análise serão salvos como um bloco de consulta no dashboard.
Como adicionar blocos e texto a um painel
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.
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.
Tipos de blocos do dashboard
É possível adicionar quatro tipos de blocos a um painel:
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, ele só será usado durante a criação do bloco. O bloco não será 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 de aparência vinculada
Os blocos vinculados a um Look são adicionados a um painel de um Look.
Um Bloco vinculado a um Look associa a consulta subjacente 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 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 visual mudar, todos os blocos vinculados a ele também vão mudar. 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 de controle têm formatação flexível e, por padrão, parecem mais 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: opção de bloco de texto preexistente 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 que são adicionados a um painel e executados de dentro de um Bloco de informações.
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 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 uma Análise para começar a criar sua consulta.
O Looker abre a janela Análise para que você crie sua consulta. Para criar uma consulta, siga estas etapas:
- No campo de título no canto superior esquerdo, digite um nome para a consulta. Esse será o nome do bloco no dashboard.
- Selecione os campos e filtros no seletor de campo.
- Configure as opções de visualização no painel Visualização.
- Depois de configurar a consulta, clique em Executar.
- Clique em Salvar para salvar a consulta como um bloco no dashboard.
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.
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 e tiver uma consulta que você queira adicionar ao dashboard, siga estas etapas:
Selecione Salvar nas Abrir açõesmenu do ícone de engrenagem configurações.
Essa ação abre uma janela Adicionar ao painel:
- No campo Título, dê um título ao bloco.
- Na lista de pastas, selecione a pasta em que o painel está.
- 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.
- Clique em Salvar no dashboard.
Uma mensagem de confirmação vai aparecer na parte de cima do recurso "Explorar" 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.
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.
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 de um visual, siga estas etapas:
- Navegue até um Look.
- No menu do ícone de engrenagem Ações de análise Configurações, selecione Salvar. Essa ação abre um submenu.
Selecione Para um painel existente no submenu.
Essa ação abre a janela Adicionar ao painel.
Quando você adiciona um bloco de consulta de um visual, ele recebe o mesmo título do nome do visual no campo Título, que pode ser editado mais tarde.
Na lista de pastas, selecione a pasta em que o dashboard está localizado.
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.
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 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 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 a 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 recursos visuais), siga estas etapas:
- Verifique se o dashboard e o Look estão na mesma pasta ou copie o Look na mesma pasta que o dashboard.
- Selecione Para um painel existente no submenu. Isso abre a janela Adicionar ao painel.
- Verifique se a pasta que contém o Look e o dashboard está selecionada.
- Selecione o painel.
- 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 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 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 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.
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: 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 que você salvar o bloco Texto ou Markdown, ele vai aparecer na parte de baixo do painel. Em seguida, mova e redimensione 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:
- Destaque o texto no bloco que você quer formatar.
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 vai aparecer quando for salvo.
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 painel.
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 as legendas são compatíveis com alguns elementos 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 texto do corpo oferece suporte a um subconjunto da linguagem de marcação Markdown. Consulte a página de documentação Como usar Markdown em blocos de Markdown para mais informações sobre qual sintaxe do Markdown é compatível com o 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. 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:
- Confira se o painel está no modo de edição.
No menu de botões Adicionar no canto superior esquerdo do painel do painel de controle, 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.
Na guia Conteúdo da janela de edição do botão, preencha os seguintes campos:
- Rótulo: esse texto vai 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 for truncado, ele poderá ser repetido no campo Descrição.
Link: é o link para onde o botão leva os espectadores.
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.
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 texto branco.
- Contorno: o botão tem um contorno e texto colorido.
- Transparente: o botão não tem contorno nem 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. A caixa de blocos do botão tem a largura total como padrão, e o alinhamento é centralizado.
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 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 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:
Verifique se o painel está no modo de edição.
No menu do botão Adicionar no canto superior esquerdo do painel do painel de controle, 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.
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 do 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.
Como adicionar filtros a um painel
As consultas que geram os Blocos do painel podem incluir filtros, mas você também pode adicionar filtros a um painel, o que pode afetar todos os Blocos ou apenas alguns deles. 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 a criação de filtros de painel padrão, acesse a página de documentação 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
Você pode acessar as configurações do painel no canto superior esquerdo dele, na barra de ferramentas azul. As configurações padrão ao criar um painel são as seguintes:
- 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, 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 ficará editável.
Depois de adicionar uma descrição, clique em Salvar para salvar a mudança.
Como melhorar o desempenho do painel usando reconhecimento agregado
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 a tabela de agregação do LookML, que aparece na opção Acessar o LookML no menu do ícone de três pontos more_vert Ações do painel. 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.