Widgets

Conceito

O cadastro de Gráfico define, de forma reutilizável, a fonte de dados e a aparência de um gráfico que poderá ser exibido em um ou mais itens de um Dashboard. É neste cadastro que fica a consulta SQL responsável por buscar os dados, além de todas as configurações visuais: tipo de gráfico, cores, fontes, legendas e formatação dos valores.

O que é

A tela de cadastro de Gráfico é dividida em duas abas principais: Geral e Expressão SQL. Dentro da aba Geral existem ainda duas sub-abas: Campo X (aparência do eixo/rótulo e da barra ou linha) e Colunas (os valores exibidos no gráfico). Um mesmo Gráfico, dependendo do Tipo escolhido, também pode ser exibido como um card de indicador em vez de um gráfico tradicional.

Para que serve

Quando compreendemos a funcionalidade do cadastro de Gráfico, conseguimos criar visualizações próprias para acompanhar qualquer informação do sistema, sem depender de um relatório específico, e reaproveitar essa mesma visualização em quantos dashboards forem necessários.

Quais os benefícios e/ou ganhos de uso

Ao centralizar em um único cadastro a consulta e a aparência de um gráfico, diferentes dashboards podem reaproveitar a mesma visualização sem retrabalho, garantindo que todos que a utilizam enxerguem a informação da mesma forma. Isso também facilita ajustes futuros: ao alterar o gráfico uma única vez, a mudança se reflete em todos os dashboards que o utilizam.

Exemplos

Um Gráfico pode ser criado, por exemplo, para exibir em barras verticais o total vendido por vendedor, em linha a evolução de um indicador ao longo de um período, ou em pizza a participação de cada categoria em um total. O mesmo cadastro, se configurado como Indicador, pode ser reaproveitado para mostrar apenas um número em destaque, como o total de pedidos em aberto.

Cadastro

O cadastro de Gráfico é organizado nas abas Geral, Campo X, Colunas e Expressão SQL, conforme aparecem na tela.

Geral

• Nome: Nome interno do gráfico.
• Título: Título exibido no gráfico.
• Tamanho Fonte Título: Tamanho da fonte utilizada no título.
• Tipo de Gráfico: Define o formato de exibição (veja tabela de tipos abaixo).
• Exibir o Título: Define se o título do gráfico é exibido.
• Exibir valores: Define se os valores são exibidos junto aos elementos do gráfico.
• Data/Hora: Data e horário da última alteração. Preenchido automaticamente pelo sistema.

Tipo de Gráfico	Descrição
Barra Horizontal	Exibe os valores em barras dispostas horizontalmente.
Barra Vertical	Exibe os valores em barras dispostas verticalmente (colunas).
Linha	Exibe os valores como uma série contínua, indicada para visualizar tendências ao longo de um período.
Pizza	Exibe os valores como percentual de participação em relação ao total.

Campo X

• Campo X: Nome da coluna, retornada pela Expressão SQL, utilizada como rótulo/categoria (eixo horizontal).
• Tamanho da Fonte: Tamanho da fonte utilizado nos rótulos do eixo.
• Posição da Legenda: Define onde a legenda é exibida (Superior, Esquerda, Direita, Inferior ou Dentro do gráfico).
• Cor da Barra ou Linha: Cor principal utilizada no gráfico.
• Cor do Fundo da Barra: Cor de fundo (trilho) desenhada atrás da barra ou linha.
• Arredondamento inicial da barra de fundo / Arredondamento inicial da barra: Controlam o arredondamento no início da barra e do seu fundo.
• Arredondamento final da barra de fundo / Arredondamento final da barra: Controlam o arredondamento no final da barra e do seu fundo.
• Exibir o fundo da barra: Define se o fundo/trilho da barra é exibido.

Colunas Cada linha desta grade representa um valor exibido no gráfico:

• Sequência: Ordem da coluna de valores.
• Legenda: Texto de legenda associado a esse valor/série.
• Campo Valor: Nome da coluna, retornada pela Expressão SQL, utilizada como valor numérico.
• Cor da Fonte do Valor / Cor da Fonte do Valor (alternativa): Cores utilizadas no texto do valor, sendo a segunda aplicada quando o valor é exibido sobre um fundo colorido (dentro da barra ou fatia).
• Formato: Máscara de formatação numérica aplicada ao valor (ex.: separador de milhar, casas decimais).

Expressão SQL Aba onde é escrita a consulta SQL responsável por buscar os dados do gráfico. O resultado dessa consulta deve conter uma coluna com o mesmo nome informado em Campo X (o rótulo) e uma coluna com o mesmo nome informado em Campo Valor, em Colunas.

Como Configurar um Gráfico

Esta seção resume, o que precisa ser feito para deixar um Gráfico pronto para uso em um Dashboard.

1. Na aba Expressão SQL, escreva a consulta que retorna os dados desejados. O resultado precisa ter uma coluna para servir de rótulo/categoria e uma coluna com o valor numérico.
2. Na aba Geral, informe Nome, Título e escolha o Tipo de Gráfico.
3. Na guia Campo X, informe o nome da coluna de rótulo (igual ao nome retornado pela consulta) e configure a aparência: cores, arredondamento, fundo e posição da legenda.
4. Na guia Colunas, cadastre a coluna de valor, informando o nome da coluna de valor (igual ao retornado pela consulta), a legenda, a cor e o formato.
5. Salve o cadastro. O Gráfico já pode ser selecionado no campo Gráfico de um Item do Dashboard.

Ponto de atenção

• Os nomes informados em Campo X e em Campo Valor precisam ser exatamente iguais aos nomes das colunas retornadas pela Expressão SQL, ou o gráfico não exibirá dados.

Conclusão

O cadastro de Gráfico é o responsável por definir, em um único lugar, tanto a origem dos dados (a Expressão SQL) quanto a forma como eles são apresentados visualmente. Por ser independente do Dashboard em si, um mesmo Gráfico pode ser reaproveitado em diferentes dashboards, facilitando a manutenção e garantindo consistência visual entre eles.

Sugestão de Leitura

Assuntos Relacionados

Dashboard

Indicadores