Procedimento SetVariavelGlobal
O procedimento SetVariavelGlobal permite definir ou atualizar o valor de uma variável global, associada ao usuário e à sessão atual. Essas variáveis podem ser utilizadas para controlar comportamentos entre diferentes cadastros, telas ou processos dentro do sistema.
Sintaxe
SetVariavelGlobal(Nome:String; Valor:String)
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
| Nome | String | Identificador da variável global. Deve ser único e utilizado posteriormente para consulta do valor armazenado. |
| Valor | String | Valor que será atribuído à variável global. |
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 verificar se essa variável global está preenchida para executar um comportamento específico, como habilitar campos, validar regras ou alterar o fluxo de processamento.
Observações
- As variáveis globais são válidas apenas durante a sessão do usuário.
- Recomenda-se utilizar nomes claros e padronizados para facilitar a manutenção e leitura do código.
- O valor armazenado é do tipo String, devendo ser tratado adequadamente quando representar valores lógicos ou numéricos.
