Skip to main content

Variáveis de ambiente

 

Nessa tela de variáveis de ambiente você definirá informações (variáveis globais) que ficarão disponíveis em diversas partes do seu sistema.

Suponha que você queira que a Data de Nascimento do usuário logado esteja disponível para acesso via Javascript nos seus formulários ou você quer usar essa informação em algum parâmetro de entrada de uma Query, em relatórios ou dashboards.

Para isso basta criar uma variável do tipo "SQL Simples (Valor único)"; defina o nome para a variável, nesse caso, utilize "dataNascimento"; marque como SIM a opção "Essa é uma Informação relacionada ao usuário logado, essa informação muda para cada usuário e será carregada no momento do login do usuário".

No botão "Query", defina a query Sql para buscar a Data de Nascimento do usuário logado. Exemplo da query:

select top 1 usu_dt_nasc from tbl_usuario where id = @usuarioLogadoId

Agora salveSalve e pronto. A partir de agora essa variável estará disponível em todo o seu ambiente. Para recuperar os valores da variável veja os itens mais abaixo.

Importante: os valores das variáveis de ambiente, ficam em cache, esse cache é renovado a cada 1 hora. Assim melhora a performance e evita excessos de consultas ao banco de dados.  O cache é automaticamente renovado quando o usuário faz login e quando no formulário de criação da Variável de Ambiente você clica em "salvar".

 

Para recuperar os valores da variável de ambiente

Seguindo o exemplo acima, suponhamos que você queira agora recuperar o valor via Javascript.

A forma correta seria via:

Em Javascript

Utilize a função abaixo, ela retornará o valor caso exista.

GetEnvironmentVariable("dataNascimento")

 

Em uma Query SQL

Utilize o nome da variávle como parametro de sua Query, como no exemplo abaixo.

select usu_nome  from tbl_usuario where usu_dt_nasc = @dataNascimento