Quem trabalha com desenvolvimento no Protheus já deve ter passado por uma situação bastante comum: precisar saber exatamente em qual ambiente o código está sendo executado. Em projetos que envolvem customizações, integrações ou automações dentro do ERP da TOTVS, essa informação pode ser extremamente importante para garantir que determinadas rotinas sejam executadas apenas quando realmente devem.
Saber se o ambiente é de Produção, Homologação ou Desenvolvimento pode evitar diversos problemas, como disparos de integrações indevidas, execução de rotinas de teste em produção ou até mesmo inconsistências em processos automatizados. Muitas empresas possuem ambientes separados justamente para garantir segurança durante testes e validações, e identificar corretamente esse contexto dentro do código pode fazer toda a diferença.
Durante muito tempo, desenvolvedores precisaram recorrer a soluções alternativas para descobrir o ambiente em que o sistema estava rodando. Em alguns casos, eram utilizadas verificações indiretas ou tratamentos específicos dentro da lógica da aplicação. No entanto, as versões mais recentes do framework da TOTVS trouxeram uma forma muito mais simples e padronizada de obter essa informação.
A partir da LIB 20250811, o framework do Protheus passou a disponibilizar uma funcionalidade nativa que permite identificar o tipo de ambiente diretamente via código. Isso facilita bastante a vida de quem desenvolve no ecossistema TOTVS, pois elimina a necessidade de criar verificações personalizadas ou depender de parâmetros externos.
Por que identificar o ambiente dentro do Protheus é importante
Em ambientes corporativos, é comum existir mais de uma instância do sistema rodando simultaneamente. Normalmente temos um ambiente de desenvolvimento, onde novas funcionalidades são criadas e testadas, um ambiente de homologação, utilizado para validar alterações antes de colocá-las em produção, e o ambiente de produção, que é aquele utilizado no dia a dia da empresa.
Ter a capacidade de identificar o ambiente diretamente dentro do código permite criar comportamentos específicos para cada cenário. Isso ajuda a evitar que determinadas rotinas rodem em momentos inadequados ou que integrações externas sejam disparadas de forma incorreta.
Em integrações com APIs externas, por exemplo, muitas vezes é necessário utilizar endpoints diferentes para cada ambiente. Da mesma forma, rotinas que realizam testes ou cargas de dados podem ser permitidas apenas em ambientes de desenvolvimento ou homologação, mas nunca em produção.
Além disso, essa identificação também pode ser utilizada para ativar logs mais detalhados em ambientes de desenvolvimento, permitindo uma análise mais profunda durante a fase de testes, sem comprometer a performance do sistema em produção.
Função nativa do framework TOTVS para identificar o ambiente
A partir da LIB 20250811, a TOTVS introduziu uma função nativa dentro do framework que permite identificar o tipo de ambiente em que o sistema está rodando.
Isso significa que agora é possível obter essa informação diretamente pelo código, sem depender de parâmetros adicionais ou verificações externas. Essa abordagem traz mais padronização e torna o desenvolvimento muito mais limpo e previsível.
Para buscar essa informação em TLPP, basta utilizar o seguinte comando:
nType := totvs.framework.environment.type.get()
Essa função retorna um valor numérico que representa o ambiente atual do sistema.
Valores retornados pela função
Após executar o comando, o valor retornado pela variável nType indica qual é o ambiente em que o Protheus está sendo executado.
Os valores possíveis são os seguintes:
1 – Produção
2 – Homologação
3 – Desenvolvimento
Com essa informação em mãos, o desenvolvedor pode criar tratamentos específicos dentro do código conforme a necessidade do projeto.
Isso permite, por exemplo, bloquear determinadas rotinas quando o sistema estiver em produção, ou alterar comportamentos de integração quando o ambiente for de homologação.
Utilizando essa informação na prática
Na prática, essa verificação pode ser aplicada em diversas situações dentro de um projeto que envolve customizações no Protheus.
Em cenários de integração com sistemas externos, por exemplo, é comum utilizar endpoints diferentes dependendo do ambiente. Com a identificação do ambiente via código, é possível direcionar automaticamente a chamada para o endpoint correto.
Outra aplicação bastante comum está relacionada à execução de rotinas de teste. Algumas funcionalidades criadas durante o desenvolvimento podem ser utilizadas apenas para validação interna e não devem estar disponíveis em produção. Nesse caso, basta utilizar o valor retornado pela função para controlar quando a rotina pode ou não ser executada.
Também é possível utilizar essa informação para controlar níveis de log, permitindo que ambientes de desenvolvimento gerem mais detalhes para análise, enquanto ambientes de produção permanecem com registros mais enxutos para evitar impacto na performance.
Pequenos recursos que fazem diferença no desenvolvimento
Apesar de ser uma funcionalidade simples, ter uma forma oficial de identificar o ambiente diretamente no código representa um avanço importante para quem trabalha com desenvolvimento no Protheus.
Esse tipo de recurso ajuda a padronizar o desenvolvimento, evita soluções improvisadas e contribui para que os projetos fiquem mais organizados e seguros. Em ambientes corporativos, onde integrações e automações são cada vez mais comuns, pequenas melhorias como essa acabam tendo um impacto significativo na qualidade das soluções entregues.
Para quem trabalha com ADVPL, TLPP, integrações e automação dentro do Protheus, acompanhar as evoluções do framework TOTVS é essencial para aproveitar ao máximo os recursos disponíveis e desenvolver soluções cada vez mais eficientes.
