Documentação

16 Gráfico

Este tipo de página permite criar gráficos de pizza, rosca, barras e linha. Para criar um gráfico é necessário criar um formulário com os filtros que serão aplicados na consulta ao banco de dados. É possível agrupar dados e aplicar diferentes fórmulas de totalização: soma, média, contagem, dentre outras. Como exemplo de gráficos podemos citar: vendas por estado, vendas por vendedor, faturamento por mês, dentre outros.

Gráficos

16.1 Criação

Para criar um gráfico, deve ser utilizada a opção “Nova página”, e em seguida, selecionar "Gráfico". Após, será aberto um diálogo com informações necessárias para a criação. Para criar um gráfico, deve-se informar respectivamente:

  1. A base de dados desejada.

  2. A tabela que o documento buscará as informações.

  3. O módulo em que a página ficará agrupada.

  4. Informar se a página será pública. Páginas públicas são acessíveis para usuários não logados na aplicação. '

  5. O nome que será exibido no menu da aplicação referente a página.

  6. O nome da classe controladora do documento.

  7. Tipo de apresentação da página, normal segue o modelo tradicional já window é uma janela projetada sobre a página que a invocou.

  8. Informar se a página aparecerá no menu da aplicação.

16.2 Utilização

A interface para criação de um "Gráfico", exibirá ao topo um formulário de filtro contendo os campos da tabela sobre a qual o gráfico está sendo construído, e na parte central da tela, uma visualização rápida do próprio gráfico, que por padrão é exibido no formato pizza.

16.3 Filtros de campos

Ao trabalhar com gráficos, o usuário poderá filtrá-lo com base nos campos do formulário de filtro localizado na parte superior da tela. Neste formulário, o desenvolvedor pode acrescentar novos campos de filtro. Para cada campo, será necessário configurar a maneira que o mesmo será utilizado como filtro. Para tal, é necessário clicar sobre o campo, e em seguida acessar a aba "Filtros". Os filtros mais simples são do tipo "Comparação direta", que permite comparar uma coluna do banco com o campo selecionado do formulário. Um exemplo seria filtrar por tipo de venda em um relatório de vendas, sendo que existe um campo para o tipo de venda naquela tabela. O filtro do tipo subconsulta, permite comparar o campo do formulário com um campo relacionado da tabela exibida no relatório. Um exemplo seria uma datagrid de vendas que deve ser filtrada pelo estado do cliente. Neste caso, bastaria acrescentar uma combo de estados no formulário e preencher "Coluna do banco de dados" com o campo que representa o estado do cliente relacionado com a venda, por meio do relacionamento entre campos (venda→cliente → cidade→ estado→id). Assim, o filtro é estabelecido entre o estado selecionado no formulário, e o estado do cliente vinculado àquela venda.

16.4 Filtros de carregamento

Enquanto que os campos do formulário sobre o gráfico permitem o usuário realizar uma filtragem dinâmica em tempo de execução sobre o gráfico, existe também a pré-filtragem do gráfico em lote, que permite estabelecer filtros "fixos", executados independentemente dos filtros do usuário. Para definir estes filtros, basta clicar sobre o ícone chamado "filtros" à direita da visualização do gráfico. Nesta aba, podem ser realizados filtros de "comparação direta" entre uma coluna do banco de dados, e um valor de filtro (que pode ser fixo ou uma variável de seção). Variáveis de seção contém informações do usuário logado e também podem ser utilizadas como filtro. Já o filtro do tipo "subconsulta" permite estabelecer um filtro entre um campo relacionado à tabela em questão e um valor (que pode ser fixo ou variável de seção).

Um exemplo seria um gráfico de vendas em que é necessário ter um pré-filtro fixo pelo estado do cliente da venda. Nesse caso, bastaria localizar o estado do cliente por meio de um campo relacionado (venda→ cliente→ cidade→estado→id), e estabelecer um filtro de igualdade com o valor "RS", que seria digitado no "Valor do filtro". Assim, somente vendas de clientes do estado "RS" seriam exibidas. O usuário também pode fazer filtros usando variáveis de seção. Ao clicar em "Adicionar filtro" vários filtros desse tipo podem ser adicionados.

16.5 Propriedades do gráfico

Os gráficos gerados pelo Adianti Builder são altamente customizáveis, para alterar seu tipo, tamanha, etc basta acessar suas configurações clicando no ícone de engrenagem no canto do exemplo de gráfico.

Propriedades dos gráficos

Propriedade Valor
Tipo do gráfico Qual representação gráfica o gráfico terá. Opções: pizza, barras, linha e rosca.
Título Título do gráfico que aparecerá em seu canto superior esquerdo.
Largura Tamanho do gráfico na tela, pode-se escolher entre duas escalas pixels e percentual.
Altura Altura do gráfico na tela.
Campo de agrupamento 1 (textual) Pizza/Donut: Campo que contém a informação textual que dará o nome da fatia no gráfico. Barras/Linhas Campo que contém a informação textual de primeiro nível que dará nome à barra/ponto no gráfico.
Opção de extração do campo de agrupamento 1 Extrai informações de tempo de campos de data do banco de dados.Exemplo extrair o nome do mês de uma data.
Campo de agrupamento 2 (textual) Pizza/Donut não se aplica. Barras/Linhas Campo que contém a informação textual de segundo nível que dará nome à barra/ponto no gráfico.
Opção de extração do campo de agrupamento 2 Extrai informações de tempo de campos de data do banco de dados.Exemplo extrair o nome do mês de uma data.
Totalizador Função matemática que será aplicada no campo númerico do gráfico.
Campo numérico Campo numérico que representará o valor da fatia no gráfico para pizza e donuts e representará a barra e ponto para barras e linhas respectivamente.
Separador de decimal (campo numérico) Valor que irá separar a parte decimal do campo numérico.
Separador de milhar (campo numérico) Valor que irá separar os milhares do campo numérico.
Precisão (campo numérico) Número de casas decimais do campo numérico.
Prefixo (campo numérico) Valor que será exibido antes do valor do campo numérico, exemplo R$.
Sufixo (campo numérico) Valor que será exibido depois do valor do campo numérico, exemplo a palavra horas depois do valor.
Ordenado por Campo agrupador que ordenará as colunas.
Direção da ordenação Ascendente e descendente.