Há duas possíveis configurações de variáveis que podem ser feitas no PlugBot Nuvem. A primeira é a Variável de Código e a segunda a Variável Global.

Nesse artigo explicaremos como cada uma delas funcionam e como configurá-las.

Variável de Código

Algumas vezes temos a necessidade de alterar algo no resultado do SQL do gráfico que configuramos. Porém, concordamos que ir de gráfico em gráfico para alterar uma cláusula de busca não seria a maneira mais produtiva. 

Por esse motivo temos a configuração de variáveis!

Como criar uma variável?

Para criar uma variável, acesse a aba Variáveis no menu lateral e clique no botão Adicionar.

Com isso, o seguinte formulário será apresentado:

Para criar a variável, preencha os campos do formulário, conforme as regras de cada um:

• Nome: Campo referente ao nome das variáveis. Para evitar possíveis problemas, recomendamos que utilize as boas práticas de declaração de variáveis:
  • Não iniciar o nome com número;
  • Não utilizar caracteres especiais (letras com acentuação, espaço...) com exceção desses 3: $ - _
  • Exemplos: $VariavelExemplo / variavel-exemplo / variavel_exemplo / variavelExemplo
• Observação: Campo referente a observação, descrição do que a variável está fazendo (max 120 caracteres).
• Expressão da Variável: Campo que receberá o SQL que deseja armazenar dentro da variável.

Nesse exemplo  a seguir criei 3 variáveis, varSemana (dados dos últimos 7 dias), varMes (dados dos últimos 30 dias), varAno (dados dos últimos 12 meses)

Nesse exemplo utilizei um banco MySQL, a sintaxe varia conforme o banco, mas nesse caso minhas variáveis ficaram com os seguintes valores:

varSemana:

BETWEEN CURDATE() - INTERVAL 7 DAY AND CURDATE()

varMes:

BETWEEN CURDATE() - INTERVAL 1 MONTH AND CURDATE()

varAno:

BETWEEN CURDATE() - INTERVAL 1 YEAR AND CURDATE()

Utilizando a variável no SQL

Para utilizar a variável no SQL, precisaremos usar Chaves Duplas, como uma Interpolação de Variáveis. Ou seja, a variável será substituída pelo valor dela. Segue abaixo um exemplo de como ficaria o SQL com a variável:

 

SQL Atual COM a variável:

SELECT descricao AS label, valor AS value, barra AS bar FROM line WHERE DATA {{varMes}}

SQL Equivalente SEM a variável:

SELECT descricao AS label, valor AS value, barra AS bar FROM line 
WHERE DATA BETWEEN CURDATE() - INTERVAL 1 MONTH AND CURDATE()

As variáveis podem ser utilizadas tanto nos gráficos configurados na Biblioteca de Gráficos quanto nos gráficos configurados individualmente.

Nesse artigo demos o exemplo de como você pode utilizá-las em cláusulas WHERE para filtro dos dados. Desse modo, caso queira alterar o gráfico para que ele passe a trazer os dados dos últimos 90 dias ao invés dos últimos 30, basta alterar o valor da variável, que todos os gráficos configurados com a variável serão alterados.

Variável Global

Para criarmos uma variável global, primeiramente precisamos clicar no botão "Adicionar" na aba "Configuração de controle de visualização". 

 

Ao clicar no campo Adicionar uma 2 campos de seleção serão apresentados. O primeiro é referente a propriedade do gráfico que será filtrada, e o segundo é referente à variável global que será utilizada de parâmetro na filtragem.

As variáveis são:

• Nome do Usuário: Valor originado do Nome do usuário, configurados na aba Usuários
• Email do Usuário: Valor originado do E-mail do usuário, configurado na aba Usuários
• Documento do Usuário: Valor originado do campo Departamento do usuário, também configurado na aba Usuários.
• CPF/CNPJ da Empresa: Valor originado da configuração na aba Empresas. Esse campo pode ser utilizado em um cenário onde um SQL retorna diversos dados de várias empresas e o CPF/CNPJ é retornado como alguma propriedade no gráfico, permitindo que o mesmo SQL seja utilizado em diversas empresas, onde cada uma terá a visualização de seus dados.
• Nome da Empresa: Valor originado da configuração na aba Empresas. Esse campo pode ser utilizado em um cenário similar ao do CPF/CNPJ, porém o filtro é feito pelo Nome.

Nesse exemplo, selecionei a propriedade label do meu gráfico para filtrar os dados, que possuem os valores Julio, Jorge e Amanda. 

Na minha configuração de usuários, tenho 3 usuários, que também possuem os nomes idêntico ao label do gráfico:

Com esse filtro, quando o usuário Julio acessar o aplicativo ele verá apenas os dados dele. E a mesma regra serve para os demais usuários.