< 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 linha é útil para demonstração de um determinado dado, ou produto ao longo de um período de tempo (mês, semestre, ano…), pois permite analisar as altas e baixas desse dado no período definido.

 

A seguir, temos um vídeo feito por desenvolvedores da nossa comunidade demonstrando um exemplo de implementação do Gráfico de Linha. 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 Informativo

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

 

 

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

Nessa modalidade de gráfico, a máscara do valor não é aplicada.

 

Texto do Valor

Nessa modalidade de gráfico, o texto do valor só é ativada quando a opção de multi-linha está ativada.

 

Valor Monetário

Ao ativar essa opção, os valores exibidos nas barras e em boxes (componentes opcionais do gráfico de lista) desse gráfico terão a pontuação de centavos e milhares.

 

Valor monetário ativado	Valor monetário desativado

 

Exibir Total dos Registros

Nesta opção você fará seu gráfico contabilizar o total dos produtos conforme o seu banco de dados:

 

Total de registros ativado	Total de registros desativado

 

Exibir Legenda

Neste campo, caso ativado, o gráfico trará uma legenda de cada produto logo abaixo do gráfico, veja o exemplo:

 

Exibir legenda ativo	Exibir legenda desativado

 

Exibir nome das colunas

Neste campo, você poderá retirar ou ativar a opção das colunas no gráfico, essas colunas são parte do SQL para comparação entre elas, mostraremos o exemplo a seguir:

 

Exibir nome coluna ativado	Exibir nome coluna desativada

 

Exibir escala de valores

Este campo funcionará como background deste gráfico, do qual mostrará os valores iniciais e finais conforme os dados trazidos do banco, ele funcionará como referência para os pontos de cada gráfico, veja o exemplo:

 

Exibir escala de valores ativado	Exibir escala de valores desativado

 

Exibir linhas verticais

Com este campo habilitado, será criado uma linha vertical na parte de trás do gráfico que será uma referência para todo ponto do gráfico, veja o exemplo: 

 

Exibir linhas verticais ativado	Exibir linhas verticais desativado

 

Exibir linhas horizontais

Com este campo habilitado, será criado uma linha horizontal na parte de trás do gráfico que será uma referência para todo ponto do gráfico, veja o exemplo:

 

Exibir linhas horizontais ativado	Exibir linhas horizontais desativado

 

Multi-linha

Com este campo ativado, caso você traga do seu banco de dados mais um de uma informação, ele trará e fará uma linha para cada, se desativado ele trará apenas uma delas, como padrão a primeira linha, veja o exemplo:

 

Multi-linha ativado	Multi-linha desativado

Nota:  Quando o multi-linha está desativado e a opção "Exibir o nome das colunas" está ativada, o nome da coluna é trazido do campo "Texto do Valor".

 

Tipos Combinados:

Nessa modalidade de gráfico, os tipos combinados não são aplicados.

 

Preencher:

Com está opção ativada, o maior valor existente no gráfico irá sobrepor todos os outros gráficos, veja o exemplo:

 

Preencher ativado	Preencher desativado

 

Aplica máscara numérica?

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

Observação: a máscara numérica só será aplicada nos valores se a opção escolhida 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, criar abas para exibir os valores de cada trimestre, veja o exemplo:

 

 

Nessa seção também é possível definir qual aba será carregada aberta. 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.

Para criar uma nova aba, aperte em "Adicionar aba" conforme o exemplo abaixo:

 

 

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 linhas precisa, obrigatoriamente, de registros com o seguinte formato:

 

label	bar	value
'Notas Emitidas'	'01/18'	156
'Notas Canceladas'	'01/18'	192
'Pedidos Emitidos'	'01/18'	126

 

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!

 

Por exemplo, o gráfico abaixo utiliza a seguinte query:

select label, bar, value, from faturamento_table

 

Ou seja, recomendamos que você crie uma tabela no seu banco de dados para que seja o processo mais automático possível, caso você use o campo de SQL do PlugDash, seria como o exemplo a seguir:

Obs: usaremos dados estáticos neste exemplo, caso queira usar o campo, use as tabelas do seu banco de dados.

 

select 'Notas Emitidas' as label, '01/18' as bar, 156 as value union all
select 'Notas Emitidas' as label, '02/18' as bar, 192 as value union all
select 'Notas Emitidas' as label, '03/18' as bar, 126 as value  union all
select 'Notas Canceladas' as label, '01/18' as bar, 20 as value union all
select 'Notas Canceladas' as label, '02/18' as bar, 35 as value union all
select 'Notas Canceladas' as label, '03/18' as bar, 10 as value union all
select 'Pedidos Emitidos' as label, '01/18' as bar, 100 as value union all
select 'Pedidos Emitidos' as label, '02/18' as bar, 150 as value union all
select 'Pedidos Emitidos' as label, '03/18' as bar, 115 as value

Nota:  Você poderá usar comandos SQL como union all ou inner join para continuar seu código

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;

 

Resultado da query acima:

 

 

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

 

 

< Antes