🧭 Resumo

A partir da release 23.10, o Protheus exige a definição do Tipo de Ambiente (Produção, Homologação ou Desenvolvimento) no Configurador. Já na 12.1.2410, o sistema valida se Banco de Dados e Sistema Operacional são homologados, bloqueando acesso/atualização quando não estiverem em conformidade (com exceção de SO para ambiente DESENVOLVIMENTO). Essas duas exigências evitam erros operacionais e problemas de atualização. User FunctionTDN

🎯 Aplicabilidade

• Clientes em release 23.10+ (Tipo de Ambiente obrigatório). User Function

• Clientes em 12.1.2410 (validação de plataforma ao iniciar e atualizar). TDN

✅ Pré-requisitos

• Acesso ao Configurador do Protheus.

• Permissão para editar menus/rotinas e o appserver.ini.

• Verificação das plataformas homologadas (DBAccess e Application Server) na TOTVS. TDN

🛠️ Passo a passo — Definir/alterar o Tipo de Ambiente (23.10+)

1. Abra o Configurador.

2. Se for o primeiro acesso na 23.10, informe o Tipo de Ambiente quando solicitado.

3. Precisa alterar depois? Inclua a rotina CFGA750 no Configurador.

4. Acesse o menu “Tipo de ambiente” e selecione: Produção, Homologação ou Desenvolvimento. User Function

Observação técnica: a informação é utilizada por rotinas/customizações e é persistida nos parâmetros do sistema (conforme documentação pública do tema). User Function

🧩 Passo a passo — Validar plataforma homologada (12.1.2410)

1. Conferir versões homologadas de Banco de Dados e Sistema Operacional (DBAccess/AppServer) nas páginas oficiais TOTVS.

2. Em DESENVOLVIMENTO, a validação de SO não é aplicada; nos demais tipos, é obrigatória.

3. Revise o appserver.ini → seção [DBAccess] → Database deve ser MSSQL (ex.: Database=MSSQL).

   • Valores incorretos como MSSQL7 causam falha na validação. TDN

Exemplo (trecho do appserver.ini):

[DBAccess]
Database=MSSQL
; Demais parâmetros...

TDN

🚨 Erros comuns e como resolver

• “Tipo de Ambiente não definido” ao abrir o Configurador
  → Defina o tipo no primeiro acesso ou inclua CFGA750 para ajustar depois. User Function

• Bloqueio ao iniciar/atualizar o Protheus na 12.1.2410
  → Verifique SO/BD homologados e ajuste o Database em [DBAccess] para MSSQL quando for SQL Server. TDN

❓ FAQ

Posso trocar o Tipo de Ambiente quando quiser?
Sim. Inclua a CFGA750 e altere via menu “Tipo de ambiente”. User Function

Ambiente de Desenvolvimento ignora todas as validações?
Não. Na 12.1.2410, apenas a validação de Sistema Operacional é dispensada para DESENVOLVIMENTO. Demais validações continuam. TDN

Onde vejo as versões homologadas?
Na documentação oficial do DBAccess e do Application Server (plataformas homologadas). TDN

📚 Referências

• Definição de Tipo de Ambiente – Protheus 23.10 (UserFunction): visão prática, CFGA750 e exemplos. User Function

• TOTVS TDN – Validações de Banco de Dados e Sistema Operacional (12.1.2410): regra, exceção para DEV e ajuste do Database=MSSQL. TDN

🏁 Boas práticas Mastersiga

• Mantenha Produção/Homologação/Desenvolvimento claramente separados (bases, RPOs, integrações e serviços).

• Padronize nomenclatura de serviços e parâmetros por ambiente.

• Antes de atualizar release, valide plataformas e dependências (TSS, DBAccess, AppServer).