Função GetVariavelGlobal
A função GetVariavelGlobal permite recuperar o valor de uma variável global previamente definida para o usuário e sessão atual. É utilizada para consultar estados, flags ou informações temporárias que influenciam regras de negócio e fluxos do sistema.
Sintaxe
GetVariavelGlobal(Nome:String)
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
| Nome | String | Identificador da variável global cujo valor será recuperado. |
Exemplo
Considere um cenário em que exista um cadastro de documentos vinculados a uma Ordem de Serviço. Durante a inclusão de um documento, é definida a variável global OrdemServicoVinculada, indicando que há uma Ordem de Serviço associada:
SetVariavelGlobal('OrdemServicoVinculada', 'S')
Posteriormente, em outro cadastro — como Contas a Receber ou Faturamento — o sistema pode consultar essa variável para determinar um comportamento específico:
if GetVariavelGlobal('OrdemServicoVinculada') = 'S' then
// Executa regras específicas
end if
Nesse caso, o valor retornado pela função é utilizado para habilitar campos, validar regras de negócio ou alterar o fluxo de processamento.
Observações
- As variáveis globais são válidas apenas durante a sessão do usuário.
- Caso a variável não tenha sido definida, o retorno será uma String vazia.
- Recomenda-se utilizar nomes claros e padronizados para facilitar a manutenção e leitura do código.
- O valor retornado é do tipo String, devendo ser tratado adequadamente quando representar valores lógicos ou numéricos.