< Antes

Nota : Para criar ou editar gráficos, é necessário que o serviço do PlugBot esteja iniciado.

 

Após ter feito a configuração inicial do PlugBot , clique no ícone do PlugBot na bandeja e em seguida clique em "Abrir PlugBot_8088"

 

 

No painel de controle do PlugBot clique na aba "PlugDash" na barra lateral.

 

Nota: Um gráfico sempre é apresentado em um  grupo, então, caso não exista nenhum grupo ainda, leia   Como criar um grupo? antes de continuar.

 

Utilidade

O gráfico de Barra Vertical é utilizado para ilustrar comparações de dados, onde o eixo horizontal representa a categoria desse dado, e o eixo vertical representa o valor do mesmo. É muito útil para verificar, em quantidade, a manipulação dos produtos ao longo de um período.

 

A seguir, temos um vídeo feito por desenvolvedores da nossa comunidade demonstrando um exemplo de implementação do Gráfico de Barras Verticais. Como esse e os demais vídeos dos outros gráficos não foram feitos pela equipe do PlugMobile, eles não seguem um padrão, mas ainda sim achamos interessante compartilhar aqui para auxilia-lo na configuração de seus gráficos.

 

 

Configurando Gráfico de Barra Vertical

Selecione o grupo que o gráfico de Barra vertical deverá ser exibido. Clique em "Novo gráfico" e em seguida selecione o tipo "Barra vertical"

 

 

Após selecionar o tipo do gráfico, um formulário será exibido:

 

 

Tempo de sincronização

O tempo de sincronização define de quanto em quanto tempo o PlugBot deve enviar novas informações da fonte de dados para a Nuvem PlugMobile.

Existem dois campos para definir esse tempo. O primeiro campo é para  horas e o segundo campo para os  minutos. Na imagem acima, o PlugBot sincronizará as informações desse gráfico de 10 em 10 minutos.

 

Depart. permitido

O campo de departamento permitido controla quais departamentos conseguirão visualizar esse gráfico. 

Os departamentos informados nesse campo devem ser os mesmos presentes na tabela mapeada para os usuários do PlugMobile.

Por exemplo, se os departamentos na sua tabela são do tipo  inteiro, informe os números que representam seus departamentos - se os departamentos na sua tabela são  string, informe os textos que representam seus departamentos - exatamente como na tabela mapeada.

Assim, apenas os usuários que pertencem aos departamentos informados, conseguirão visualizar o gráfico.

Se nenhum departamento for informado, os usuários de qualquer departamento conseguirão visualizar o gráfico.

 

Tema

O tema define o esquema de cores que o gráfico será exibido.

 

 

Título e Subtítulo

Esses dois campos serão exibidos no topo do gráfico.

 

 

Máscara do valor / Texto do valor

Esses dois campos não modificam o gráfico de barras verticais.

 

Exibir total dos Registros

Quando a opção de exibir total dos registros está habilitada, o gráfico mostrará abaixo das barras, boxes com os valores obtidos através da query SQL da aba atual.

 

Exibir total dos registros: sim	Exibir total dos registros: não

 

Valor Monetário

Ao ativar essa opção, os valores exibidos em boxes (componentes opcionais do gráfico de Barra vertical) desse gráfico, assim como os valores exibidos na parte inferior do mesmo, terão a pontuação de centavos e milhares.

 

Valor monetário: Sim	Valor monetário: Não

 

Exibir legenda

Quando essa opção está ativada, as legendas são exibidas abaixo das barras verticais.

 

 

Legenda com listagem

Essa opção define se o gráfico deve exibir uma legenda maior, na parte inferior do gráfico, com mais detalhes além das cores - como valores, porcentagem e o rótulo do valor

 

Legenda com listagem: Sim	Legenda com listagem: Não

 

Exibir nomes das colunas

Quando essa opção está ativada, cada coluna exibe seu nome abaixo das barras.

 

Exibir nome das colunas: Sim	Exibir nome das colunas: Não

 

Exibir escala de valores

Quando essa opção está ativada, na parte esquerda do gráfico é exibida uma escala para visualização dos valores do gráfico.

 

Exibir escala de valores: Sim	Exibir escala de valores: Não

 

Exibir linhas verticais / Exibir linhas horizontais

Esses dois campos exibem ou ocultam linhas que ficam no gráfico delimitando valores e colunas.

Servem para melhorar a visualização da escala de valores do gráfico, assim como a divisão entre as colunas do mesmo:

 

 

Nota: as linhas horizontais são melhor visualizadas quando a opção "Exibir escala de valores" também está ativada.

 

Tipos combinados

Essa opção permite que o gráfico de barras possua mais um tipo de gráfico exibido junto a ele.

Por exemplo, na query a seguir, o gráfico de barras verticais será exibido normalmente e junto a ele um gráfico de linha para visualizar mais uma informação simultaneamente:

 

select 'Meta Faturamento|color:cyan|type:line' label, bar,  6000 value from tb_barra_vertical union all
select label, bar, value from tb_barra_vertical

 

Se essa opção estiver desabilitada, o gráfico exibirá somente colunas, não permitindo outros tipos de gráfico.

 

Tipos combinados: Sim	Tipos combinados: Não

 

Preencher

Quando o gráfico de barras exibe também o gráfico de linhas (Tipos combinados ativado), esse gráfico de linhas pode ser preenchido até a base ou mostrar somente a linha

 

Preencher: Sim	Preencher: Não

 

Aplica máscara numérica?

 

Esse campo permite que seja aplicada uma máscara numérica nos valores exibidos pelas tooltips (hovers) e pela legenda com listagem do gráfico.

Observação: a máscara numérica só será aplicada nos valores se a opção escolhido no campo valor monetário for "Não". Caso contrário, mesmo que tenha sido escolhida a opção "Sim" para o campo aplicar máscara numérica?, a prioridade será dada para aplicar a pontuação de centavos e milhares para os valores.

 

Casas decimais

Quando o gráfico de barras permite o uso de máscara numérica (escolhida a opção "sim" no campo Aplicar máscara numérica? ), o campo casas decimais possibilita definir a quantidade de casas decimais que os valores terão após a conversão feita pela máscara. No caso da figura abaixo, foi escolhido o valor "4" para que fossem exibidas 4 casas decimais após o ponto.

 

Aplicar máscara: Sim	Aplicar máscara: Não

 

Aba

As abas permitem que você exiba mais de um conjunto de dados no mesmo gráfico.

Cada aba recebe um comando SQL para obter os dados que devem ser exibidos.

Por exemplo, exibir em uma aba, o total vendido e as metas do 1º trimestre, e na segunda aba, do 2º trimestre.

 

 

Nessa seção é possível definir qual aba será exibida primeiro.

Para definir uma aba como principal, basta clicar no campo em que você definiu o nome da mesma, e confirmar que o contorno do campo ficará mais escuro que o contorno das outras abas.

 

SQL Aba

O campo SQL da aba deve receber uma query válida para o PlugBot fazer a leitura dos dados que o gráfico necessita para ser exibido.

O gráfico de Barra vertical precisa, obrigatoriamente, de um registro com o seguinte formato:

 

label	bar	value
Faturados	01/jan	3801
Faturados	02/jan	5200
Emitidos	01/jan	8800

 

Caso você esteja integrando com o banco AccessDB, a palavra "value" é reservada e não poderá ser usada no comando SQL.

Para que você faça a integração normalmente, você pode substituir a propriedade "value" pela propriedade "valor" no retorno dos seus dados e o gráfico funcionará sem problemas!

 

Especificamente no gráfico de barras verticais, você poderá definir a cor das colunas e o tipo do gráfico utilizando parâmetros na query SQL.

Para definir tipo linha e cor azul você pode concatenar o apelido do valor (alias) com os parâmetros da seguinte forma:

Exemplo MySQL > SELECT concat(label, '|type:line|color:blue') label, bar, value FROM tb_barra_vertical

Por exemplo, o gráfico abaixo tem tipos combinados utiliza a seguinte query no MySQL:

select concat(label, '|type:line|color:cyan') label, bar, value from tb_barra_vertical where label = 'META' and bar in ('ABR', 'MAI', 'JUN') union all
select concat(label, '|color:rgba(0, 150, 148, 0.8)') label, bar, value from tb_barra_vertical where label = 'VENDIDO' and bar in ('ABR', 'MAI', 'JUN');

 

Resultado da query acima:

 

 

Nota: Você pode escrever a suas queries SQL utilizando  aliases para cumprir com os requerimentos dos gráficos, porém, recomendamos a utilização de  views no banco de dados para tornar as queries do PlugDash mais simples e rápidas.

Nota: Em FIREBIRD é necessário que os apelidos / aliases estejam entre aspas, por exemplo:                 select 'exemplo' as "label", 50 as "value", 'jan' as "bar" from rdb$database;

 

Após preencher as informações do formulário, clique em "Salvar gráfico".

 

 

 

< Antes