Crie um painel a partir de uma tabela publicada

~30 minutos · uma tabela publicada, um gráfico, um painel compartilhado

Você tem uma tabela limpa publicada a partir de um fluxo de trabalho. Este tutorial a transforma em algo que as pessoas conseguem ler de relance: um gráfico, depois um painel construído em torno dele e, por fim, o painel compartilhado com as pessoas certas. Não é preciso SQL para colocar um primeiro gráfico na tela — você aponta, clica e consulta.

Se você seguiu Carregue, transforme e publique dados, a tabela sales_final que você publicou lá é exatamente o ponto de partida que este tutorial pressupõe. Qualquer tabela publicada funciona igualmente bem.

O que você vai construir

Um único painel com dois gráficos sobre uma tabela publicada — um Big Number mostrando a receita total e um gráfico de barras detalhando a receita por uma coluna de agrupamento — formatado, salvo e visível para seu espaço de trabalho.

Uma tabela publicada segue até se tornar um painel compartilhado.

Pré-requisitos

• Um espaço de trabalho do PlaidCloud e um projeto que você possa abrir.
• Uma tabela publicada nesse projeto. Se você não tiver uma, siga primeiro Carregue, transforme e publique dados ou publique qualquer tabela existente — clique com o botão direito nela na guia Tabelas e escolha Set Published Table Reporting Name. Veja Publicação de tabelas.
• Nada a instalar na área Painéis — sua conta de painel é criada para você na primeira vez que você abrir um painel pelo PlaidCloud.

Somente tabelas publicadas chegam aos painéis. Um painel lê uma tabela pelo nome de relatório publicado, não pelo nome interno da tabela. Se sua tabela não aparecer como dataset mais adiante, a causa usual é que ela nunca foi publicada ou foi publicada com um nome que você não reconhece — confira a coluna Publicado como na guia Tabelas.

Etapa 1: abra a área Painéis

1. No seu projeto no PlaidCloud, abra a área Painéis.
2. Na primeira vez, sua conta de painel é configurada automaticamente — não há nada a criar manualmente. O que você pode ver decorre da sua participação no espaço de trabalho e dos seus grupos de segurança.
3. Sua tabela publicada agora está disponível como um dataset, porque pertence a um projeto ao qual você tem acesso.

Para saber como a visibilidade dos painéis se relaciona com a participação no espaço de trabalho, veja Uso de painéis.

Etapa 2: prepare o dataset

Antes de criar gráficos, diga ao painel como cada coluna deve se comportar. Essa é uma configuração única por tabela que faz o explorador de apontar e clicar funcionar bem.

1. Clique no ícone de edição do seu dataset.
2. Abra a guia List Columns.
3. Para cada coluna, defina as funções que se aplicam e, em seguida, Salvar:

Configuração	Ative quando
Groupable	Você vai querer detalhar as métricas por este campo (região, produto, mês)
Filterable	Você vai querer filtrar por este campo
Soma / Mínimo / Máximo	É uma medida numérica que você vai totalizar ou resumir
Count Distinct	Você vai contar os valores exclusivos deste campo
Is temporal	É um campo de data ou hora

Marque sua coluna de data como temporal. Os filtros baseados em tempo e os controles “Since / Until” do explorador só funcionam em uma coluna marcada como Is temporal. É a configuração mais fácil de esquecer.

Etapa 3: crie seu primeiro gráfico

Comece no explorador, que abre como uma Table View simples, e transforme-o em um Big Number para a receita total.

Use sua própria coluna de medida. Este tutorial cria gráficos de uma coluna revenue, mas o pré-requisito é apenas “qualquer tabela publicada” — sempre que você vir revenue, substitua pela coluna numérica que você realmente quer totalizar (amount, sales, quantity e assim por diante).

1. Clique no dataset para abri-lo. Por padrão, você obtém uma Table View.
2. Na seção de métricas, adicione a medida desejada — para um total acumulado, digite-a e escolha sua coluna somada (por exemplo, um SUM de revenue) ou use COUNT(*) para contar linhas.
3. Adicione os campos de Agrupar por pelos quais você quer detalhar o número. Para um único número de destaque, deixe Agrupar por vazio.
4. Clique em Consulta para executá-la e ver o resultado.
5. Role até Chart Options (ou o seletor de tipo de visualização) e mude o tipo de gráfico para Big Number. Os gráficos podem ser Table, Big Number, Bar Chart e mais — cada um exibe o mesmo resultado consultado de uma forma diferente.
6. Clique em Consulta novamente para redesenhar.

Agora crie um segundo gráfico que detalha a mesma medida:

1. Inicie uma nova exploração no mesmo dataset.
2. Mantenha o SUM de revenue como métrica e adicione um Agrupar por em uma coluna agrupável, como region ou product.
3. Defina o tipo de gráfico como Bar Chart e clique em Consulta.
4. Se você quiser apenas as primeiras linhas, abra Opções e defina um Limite de linhas — por exemplo, 10 para um gráfico de barras com os dez primeiros.

Prefira a formatação na exibição a alterar os dados. Você pode arredondar ou reformatar valores de duas maneiras: transformá-los na tabela ou formatá-los na exibição. Formatar na exibição é a escolha comum — os valores subjacentes mantêm a precisão total e todo visualizador vê um número limpo. Esse é o próximo passo.

Etapa 4: formate os números

As medidas brutas chegam sem formatação. Corrija isso no gráfico, não nos dados.

• Big Number: edite o gráfico, abra a guia Customize e defina Number Format.
• Tabela: edite o gráfico, abra a guia Customize, selecione uma coluna numérica (exibida com um #) em Customize Column e defina seu D3 Format.

O padrão é Adaptive formatting, que se ajusta aos valores. Para fixar um formato, escolha um na lista suspensa ou digite uma string de formato D3:

Formato	Entrada	Exibe
,d	12345.67	12,346
$,d	12345.67	$12,346
$,.2f	12345.67	$12,345.67
,.2%	13.215	1,321.50%

A gramática completa de formatos — símbolos de moeda, preenchimento, precisão, prefixos do SI — está em Formatação de números e outros tipos de dados.

Arredondando para um dólar inteiro? Use ,d ou $,d, não ,.0f. A forma ,.0f é uma fonte conhecida de formatação de números quebrada; ,d (decimal, arredondado para inteiro) é a maneira confiável de eliminar as casas decimais.

Etapa 5: adicione uma medida calculada (opcional)

Se o número que você quer não é uma coluna simples — uma razão, um percentual de margem, uma soma condicional —, escreva-o como uma métrica. As métricas e colunas calculadas são escritas em SQL no estilo PostgreSQL no dataset.

SUM("revenue") / (COUNT(*) + 0.00001)

O + 0.00001 evita uma divisão por zero quando um grupo não tem linhas. Para mais padrões — lógica CASE, COALESCE para nulos, somas condicionais — veja Exemplos de métricas e Exemplos de colunas calculadas.

Etapa 6: monte o painel

Um painel é um layout de gráficos salvos. Associe cada gráfico que você criou ao mesmo painel para que eles fiquem juntos.

1. Abra Edit Chart no seu Big Number.
2. Na seção Painéis, digite o nome do painel em que ele deve aparecer. Se o painel ainda não existir, é aqui que você lhe dá um nome.
3. Salve e repita para seu gráfico de barras, apontando-o para o mesmo painel.
4. Abra o painel para ver os dois gráficos. No modo de edição do próprio painel, você pode organizar os blocos, redimensioná-los e adicionar filtros.

Para ver todas as opções de layout, filtro e interação, veja Conhecendo os painéis.

Etapa 7: compartilhe

Quem vê o painel decorre primeiro do acesso ao PlaidCloud e, depois, de quaisquer funções do serviço de painéis por cima.

• Por padrão, ele fica visível para as pessoas do projeto. A lista de painéis no PlaidCloud mostra os painéis publicados que pertencem a projetos aos quais uma pessoa tem acesso — então qualquer pessoa que consiga abrir o projeto encontra seu painel, sem nenhuma etapa extra.
• Adicione proprietários de gráficos ao longo do caminho. Ao salvar um gráfico, adicione todas as pessoas que precisam dele aos Proprietários do gráfico — caso contrário, um colega pode receber um erro “requires the datasource… permission” em um gráfico ao qual não tem acesso. Adicionar proprietários ao salvar é mais fácil do que ajustar o acesso depois.
• Restrinja a funções específicas somente se precisar. Um painel pode ser limitado a determinadas funções no serviço de painéis, definidas nas propriedades do próprio painel. Um painel restrito fica oculto na lista para quem não tem uma função correspondente — então, se você restringir um, avise as pessoas que devem tê-lo. O acesso ao projeto no PlaidCloud continua valendo por cima: uma concessão de função nunca libera um painel de um projeto que a pessoa não consegue acessar.

Veja Uso de painéis para as regras de visibilidade completas.

Mantendo o painel atualizado

Você não atualiza painéis manualmente. Quando um fluxo de trabalho republica a tabela por trás de um gráfico, todos os gráficos que a leem descartam seus resultados em cache, e a próxima pessoa que abrir o painel vê os números novos.

Um painel que parece desatualizado quase nunca é o cache. Se os números parecerem antigos depois de uma execução de fluxo de trabalho, verifique o fluxo de trabalho — se a execução terminou e republicou a tabela esperada —, não o cache. Republique também com o mesmo nome publicado: os gráficos ficam vinculados a um nome, então uma tabela reconstruída com um novo nome deixa os gráficos antigos apontando para dados antigos.

Se algum dia você precisar forçar a atualização, abra o menu ao lado de Edit dashboard e escolha Force refresh dashboard. Os detalhes completos, incluindo por quanto tempo os resultados são mantidos, estão em Cache de painéis.

Para onde ir em seguida

• Conhecendo os painéis — tipos de gráfico, layout, filtros e solução de problemas
• Exemplos de métricas e Exemplos de colunas calculadas — padrões de SQL para medidas personalizadas
• Formatação de números e outros tipos de dados — a referência completa de formatos D3
• Cache de painéis — como funcionam a atualização e o tempo de vida do cache
• Carregue, transforme e publique dados — o tutorial que produz a tabela publicada da qual este começa