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 do Looker
save_contentesee_user_dashboards
Além disso, é necessário ter acesso aos modelos do LookML para todos os dados que você quer usar no painel.
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.
Criação de 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 a janela Criar painel.
- Insira um nome para o novo painel no campo Nome.
- Navegue até a pasta em que você quer salvar o dashboard e selecione-a. 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 painel a partir de uma pasta, siga estas etapas:
- Navegue até uma pasta em que você quer que o dashboard seja localizado.
- Clique no botão New 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, 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 painel com base em um Look ou uma Análise detalhada
Para criar um painel a partir de um Look ou uma Exploração, 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 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 que você inserir será aplicado 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 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, Editar para a 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 é salvo como um bloco de consulta no painel.
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 blocos adicionais que você adicionar terão o tamanho de um terço da largura do painel e serã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 dos 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.
Tipos de Blocos do 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 um visual ou de uma análise detalhada.
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 mudanças 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 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 visual é usado ao criar o bloco e sempre que o painel é atualizado. O Look e o painel precisam estar na mesma pasta. Se você quiser adicionar Looks de uma pasta diferente, copie o Look para a mesma pasta do painel.
Um bloco vinculado a um visual é uma boa opção se você quiser criar, mudar e testar uma consulta em um só lugar, mas usar 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 foram 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: 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ê 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ê 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 painel.
- Selecione os campos e os 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.
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
Você pode salvar um bloco de consulta em um painel diretamente de uma Exploração. Quando estiver em uma Análise detalhada e tiver uma consulta que quer adicionar ao painel, siga estas etapas:
Selecione Salvar no menu do ícone de engrenagem Abrir ações Configurações.
Essa ação abre a 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. Lá, você pode mover e redimensionar os blocos como 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 de um Look
Para adicionar blocos de consulta de um visual, siga estas etapas:
- Acesse 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 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.
Os blocos adicionados a um painel usando esse método não são conectados ao Look em que foram criados. Você pode editar os blocos sem afetar o Look. Você pode editar ou excluir o visual sem afetar os blocos.
Uma mensagem de confirmação vai aparecer na parte de cima do visual depois que você o adicionar como um bloco em 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. Lá, você pode mover e redimensionar os blocos como quiser.
Para qualquer bloco novo adicionado a um painel, se o Look que serviu de base foi criado com base no mesmo recurso "Explorar" que um filtro do painel, o filtro é aplicado automaticamente ao bloco.
Como adicionar blocos vinculados a um Look
É possível salvar um bloco vinculado a um Look em um painel diretamente de um Look. No entanto, o Look e o painel precisam estar na mesma pasta.
Para adicionar um bloco vinculado a um visual, 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 Para um painel existente no submenu. Isso abre a janela Adicionar ao painel.
- Verifique se a pasta que contém o Look e o painel está selecionada.
- Selecione o painel.
- Clique em Adicionar Look ao dashboard.
Os blocos adicionados a um painel 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 vai aparecer na parte de cima do visual depois que você o adicionar como um bloco em 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. Lá, você pode mover e redimensionar os blocos como 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 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 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 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 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 as legendas são compatíveis com alguns códigos HTML, incluindo links e imagens. Você também pode usar alguns códigos HTML nos corpos 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.
Como adicionar botões
A opção Botão no menu Adicionar permite adicionar botões personalizados ao seu 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:
- Verifique 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 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 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á 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 do botão:
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. 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, 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 para caber no texto. O tamanho padrão é médio.
Alinhamento: escolha Esquerda, Centralizar 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.
Mover e redimensionar botões
Depois de adicionado, um botão pode ser movido e a caixa do bloco pode ser redimensionada, assim como qualquer outro bloco.
Por padrão, um novo botão é colocado na parte de cima de um painel em uma caixa de blocos que é 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.
Como 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. Com a opção Extensão, você pode 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" vai aparecer, listando todas as extensões disponíveis que podem ser instaladas como um bloco no 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 de interesse.
Para adicionar filtros ao painel, é necessário ter pelo menos um bloco de consulta ou um bloco vinculado a um look no painel. Em seguida, adicione filtros entrando no modo de edição e selecionando o botão Filtros filter_list na barra de ferramentas de cima.
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 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. As configurações padrão ao criar um painel são as seguintes:
- Fuso horário: o fuso horário de cada bloco
- Run on load: 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 mudança.
Como melhorar a performance do painel usando a consciência agregada
Os desenvolvedores do LookML podem melhorar a performance do painel usando o awareness 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 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.
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.