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 painéis do LookML, consulte a página de documentação Comparação entre 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_contentesee_user_dashboards
Além disso, você precisa ter acesso aos modelos do LookML para todos os dados que quiser usar no painel.
Ao criar um painel, siga as práticas recomendadas para a construção deles. Encontre informações e recomendações sobre como criar painéis eficientes na página de práticas recomendadas Considerações ao criar painéis do Looker eficientes.
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:
- Clique no botão Criar.
- Selecione o item de menu Painel. Isso abre uma janela Criar painel.
- Insira um nome para o novo painel no campo Nome.
- Navegue até a pasta em que você quer salvar o painel e selecione-a. Se preferir, selecione o ícone Criar nova pasta create_new_folder para criar uma pasta para o painel.
- Clique em Criar painel.
Em seguida, seu novo painel em branco aparece. Nesse local, 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 no botão Editar dashboard no centro do painel.
Como criar um painel com base em uma pasta
Para criar um painel com base em uma pasta, siga estas etapas:
- Navegue até uma pasta onde você quer que o painel fique.
- Clique no botão Novo no canto superior direito da pasta.
Clique na opção Painel.
A janela Criar painel será aberta.
Insira um nome para o novo painel no campo Nome.
Clique em Criar dashboard.
Em seguida, seu novo painel em branco aparece. Nesse local, 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 de três pontos more_vert do ícone Ações do dashboard ou no botão Editar dashboard no centro do painel.
Criar um painel com base em uma análise detalhada ou um Look
Para criar um painel com base em uma Análise detalhada ou uma Exploração, siga estas etapas:
- Acesse um Look ou uma Análise.
- Clique em Salvar no menu de ícone de engrenagem configurações Análise detalhada.
Clique em Como novo painel no submenu.
Isso abre uma janela Salvar como um novo painel.
No campo Título, insira um nome para o novo painel.
O nome inserido se aplica ao bloco e ao painel. É possível modificar os nomes dos títulos a qualquer momento. Para mudar o nome de um bloco de consulta, consulte a subseção Editar o título de um bloco de consulta na página de documentação Editar painéis definidos pelo usuário. Para mudar o nome do painel, entre no modo de edição.
Na guia Configurações, clique na pasta em que você quer salvar o painel. Você precisa ter o nível de acesso Gerenciar acesso, Editar para a pasta.
Na guia Filtros, clique para usar os filtros da análise detalhada ou da análise como filtros do painel. Os filtros personalizados não podem se tornar filtros de painel, mas permanecem como filtros de bloco.
Clique em Salvar.
O Look ou a Análise de dados será salvo 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 adicionado a um painel ocupa toda a largura dele. Os outros blocos adicionados têm um terço da largura do painel e são colocados horizontalmente abaixo do primeiro bloco. O Looker adiciona mais linhas de blocos conforme necessário. Você pode mover e redimensionar os blocos como quiser. Você também pode editar os blocos depois de criados para ajustar os nomes, as visualizações ou as consultas ou Looks subjacentes.
Para todos os novos blocos adicionados a um painel, se eles foram criados na mesma análise detalhada que um filtro do painel, o filtro será aplicado automaticamente ao bloco.
Tipos de blocos de painel
É possível adicionar quatro tipos de blocos a um painel:
Blocos de consulta
Os blocos de consulta podem ser criados diretamente em um painel ou adicionados a um painel de uma análise detalhada 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 embasa um bloco de consulta pertence ao painel. Mesmo que você use um Look para criar um bloco de consulta, ele será usado apenas durante a criação do bloco. O bloco não é afetado por mudanças posteriores no Look e continua no painel mesmo que o Look seja excluído.
Quando possível, use blocos de consulta para evitar o acúmulo de Looks desnecessários nas pastas.
Blocos vinculados ao Look
Os blocos vinculados a um Look são adicionados a um dashboard de um Look.
Um bloco vinculado a um Look vincula a consulta subjacente do bloco a um Look. Essa análise detalhada é usada ao criar o bloco e sempre que o painel é atualizado. O Look e o painel precisam estar na mesma pasta. Se quiser adicionar Looks de outra pasta, primeiro copie o Look para a mesma pasta do painel.
Um bloco vinculado a uma análise é 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 também vão mudar. Se o Look for excluído, os painéis vão mostrar um erro no 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 foram projetados para ter formatação flexível e, por padrão, se parecem mais com cabeçalhos e descrições do que com 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 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 extensões, que são adicionados a um painel e executados em um bloco do painel.
Como criar blocos de consulta em um painel
Se você estiver em um painel, poderá criar um bloco de consulta dentro dele.
No modo de edição do painel, você pode 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, 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 detalhadas. Escolha um Explore para começar a criar sua consulta.
O Looker abre a janela Análise para você criar sua consulta. Para criar uma consulta, siga estas etapas:
- No campo de título no canto superior esquerdo, digite um nome para sua consulta. Esse será o nome do bloco no painel.
- Selecione os campos e filtros no seletor de campos.
- 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 painel.
Para todos os novos blocos adicionados a um painel, se eles foram criados na mesma análise detalhada que um filtro do painel, o filtro será aplicado automaticamente ao bloco.
Adicionar blocos de consulta de uma análise detalhada
É possível salvar um bloco de consulta em um dashboard diretamente de uma Análise de dados. Depois de abrir uma análise detalhada e ter uma consulta que você quer adicionar ao painel, siga estas etapas:
Selecione Salvar no menu do ícone de engrenagem Ações de análise configurações.
Essa ação abre uma janela Adicionar ao painel:
- No campo Título, dê um nome ao bloco.
- Na lista de pastas, selecione aquela em que o painel está localizado.
- Na lista de painéis, selecione o nome de um deles 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 aparece na parte de cima da página "Analisar" depois que você a adiciona como um bloco em um painel. Se você clicar no título do painel na mensagem de confirmação, o Looker vai direcionar você diretamente para o painel no modo de edição. Em seguida, mova e redimensione os blocos como quiser.
Para todos os novos blocos adicionados a um painel, se eles foram criados na mesma análise detalhada que um filtro do painel, o filtro será aplicado automaticamente ao bloco.
Adicionar blocos de um Look
É possível adicionar blocos de consulta e blocos vinculados a um Look aos dashboards de um Look.
Adicionar blocos de consulta de um Look
Para adicionar blocos de consulta de um Look, siga estas etapas:
- Navegue até um Look.
- No menu de ícone de engrenagem Ações de análise configurações, selecione Salvar . Essa ação abre um submenu.
Selecione Em um painel existente no submenu.
Essa ação abre uma janela Adicionar ao painel.
Quando você adiciona um bloco de consulta de um Look, ele recebe o mesmo título do nome do Look no campo Título, que pode ser editado depois.
Na lista de pastas, selecione aquela em que o painel está localizado.
Na lista de painéis, selecione o nome de um deles 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 painel usando esse método não ficam conectados ao Look em que foram criados. Você pode editar os blocos sem afetar o Look. Você pode editar ou excluir o Look sem afetar os blocos.
Uma mensagem de confirmação aparece na parte de cima da análise detalhada depois que ela é adicionada como um bloco a um painel. Se você clicar no título do painel na mensagem de confirmação, o Looker vai direcionar você diretamente para o painel no modo de edição. Em seguida, mova e redimensione os blocos como quiser.
Para cada novo bloco adicionado a um dashboard, se o Look em que ele se baseou foi criado no mesmo Explore que um filtro do dashboard, o filtro será aplicado automaticamente ao bloco.
Adicionar blocos vinculados a um Look
É possível salvar um título vinculado a um Look em um dashboard diretamente de um Look. No entanto, o Look e o painel precisam estar na mesma pasta.
Para adicionar um bloco vinculado a um Look a um painel (consulte a seção Como adicionar blocos de consulta de um Look para ver recursos visuais), siga estas etapas:
- Verifique se o dashboard e o Look estão na mesma pasta ou copie o Look para a mesma pasta do dashboard.
- Selecione Em um painel existente no submenu. Uma janela Adicionar ao painel será aberta.
- Verifique se a pasta que contém a análise e o painel está selecionada.
- Selecione o painel.
- Clique em Adicionar Look ao dashboard.
Todos os blocos adicionados a um dashboard usando esse método são conectados ao Look em que foram criados e têm o mesmo título. 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 de cima da análise detalhada depois que ela é adicionada como um bloco a um painel. Se você clicar no título do painel na mensagem de confirmação, o Looker vai direcionar você diretamente para o painel no modo de edição. Em seguida, mova e redimensione os blocos como quiser.
Para cada novo bloco adicionado a um dashboard, se o Look em que ele se baseou foi criado no mesmo Explore que um filtro do dashboard, o filtro será aplicado automaticamente ao bloco.
Adicionar texto
Quando um painel está no modo de edição, é possível adicionar blocos de texto clicando no botão Adicionar na parte superior esquerda 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 de 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 faria com outros blocos.
Adicionar blocos de texto
Os blocos 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 de cima 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 mudanças e salve o painel.
Adicionar blocos de Markdown
Os blocos 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 um corpo. Esses elementos são opcionais.
Os títulos e subtítulos aceitam alguns códigos HTML, incluindo links e imagens. Também é possível usar HTML nos corpos dos blocos Markdown. Para entender como o Looker renderiza HTML, consulte a página de documentação Limpeza de HTML.
O texto do corpo é compatível com um subconjunto da linguagem de marcação Markdown. Consulte a página de documentação Como usar Markdown em blocos do Markdown para mais informações sobre qual sintaxe do Markdown é compatível com o texto do corpo.
Adicionar botões
A opção Botão no menu Adicionar permite adicionar botões personalizados ao painel. Você pode atribuir ao botão um link para um URL do Looker ou externo. Quando um leitor do painel seleciona o botão, ele é direcionado ao URL.
Para adicionar um botão ao painel, siga estas etapas:
- Verifique se o painel está no modo de edição.
No menu do botão Adicionar, na parte superior esquerda 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.
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 aumenta a largura para acomodar o rótulo até que ele alcance a largura da caixa de bloco. 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á definida como 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. Essa opção fica 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.
- Contornado: o botão tem um contorno e texto colorido.
- Transparente: o botão não tem contorno nem plano de fundo. Ela 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, clique em 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 para caber no texto. O tamanho padrão é médio.
Alinhamento: escolha Esquerda, Centro ou Direita para alinhar horizontalmente o botão na caixa do bloco. A caixa de bloco do botão tem largura total por padrão, e o alinhamento é centralizado.
Clique em Salvar.
Mover e redimensionar botões
Depois de adicionado, um botão pode ser movido e a caixa de bloco dele pode ser redimensionada como qualquer outro bloco.
Por padrão, um novo botão é colocado na parte de cima de um painel em uma caixa de bloco definida como a largura total do painel.
Redimensionar a caixa de um botão pode afetar o posicionamento de outros elementos do painel e a largura do 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.
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. Com a opção Extensão, você pode adicionar uma extensão personalizada como um bloco ao 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, 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.
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.
Adicionar ações de dados aos blocos
Se você tiver a permissão develop para o modelo em que um bloco se baseia, 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 do 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 de parâmetros do action para mais informações.
Adicionar filtros a um painel
As consultas que embasam os blocos do painel podem incluir filtros, mas também é possível adicionar filtros a um painel, o que pode afetar todos os blocos ou apenas alguns deles. Com os filtros do painel, os usuários podem restringir os resultados a apenas os dados de interesse.
Para adicionar filtros de painel, é necessário ter pelo menos um bloco de consulta ou vinculado a uma análise do Looker no painel. Em seguida, adicione 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 Adicionar e editar filtros de painel definidos pelo usuário.
Para saber como ativar os cruzamentos de filtros de painel, acesse a página de documentação Painéis de cruzamento de filtros.
Como configurar as configurações do painel
Acesse as configurações do painel na parte superior esquerda da barra de ferramentas azul. As configurações padrão ao criar um painel são as seguintes:
- Fuso horário: fuso horário de cada bloco
- Executar ao carregar: ativado
- Visualização de filtros padrão: expandida
Consulte a página de documentação 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 de ícone de três pontos Ações do painel more_vert.
A caixa de texto Descrição vai ficar editável.
Depois de adicionar uma descrição, clique em Salvar para salvar a mudança.
Como melhorar a performance do painel usando a percepção de agregação
Os desenvolvedores do LookML podem melhorar a performance do painel usando a consciência de agregação. Com o reconhecimento de agregação, os desenvolvedores podem criar tabelas de agregação nos parâmetros explore do LookML, que otimizam 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 Receber LookML no menu de í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.
Encontre outras informações e recomendações sobre como criar painéis eficientes na página de práticas recomendadas Considerações ao criar painéis eficientes do Looker.