AdvPL GuiaEntenda o que é AdvPL, como ela se encaixa no Protheus e avance por uma sequência organizada de lições — do primeiro fonte às arquiteturas mais completas.
Ver a trilha completa →AdvPL — Advanced Protheus Language — é uma linguagem desenvolvida para o ecossistema Protheus. Sua origem está ligada ao padrão xBase e à necessidade de preservar e evoluir aplicações empresariais construídas pela Microsiga.
A linguagem suporta programação procedural, orientação a objetos e eventos. Os fontes são compilados para o repositório da aplicação e executados pelo AppServer. No desenvolvimento atual, o Visual Studio Code com a extensão TOTVS Developer Studio é uma das ferramentas utilizadas.
Conhecer uma linguagem não é apenas memorizar sua sintaxe. É entender o problema que ela resolve, o ambiente onde vive, como transforma fontes em execução e quais decisões permite expressar. Em AdvPL, esses pontos estão profundamente ligados ao Protheus.
AdvPL foi criada para desenvolver e adaptar aplicações empresariais no ecossistema Protheus. É usada em regras de negócio, processamentos, acesso a dados, relatórios, interfaces, pontos de entrada e integrações. Aprender AdvPL envolve também compreender a arquitetura e os contratos do Protheus.
A linguagem combina programação procedural, orientação a objetos e programação orientada a eventos. Uma solução pode ser organizada em funções, usar classes e métodos ou reagir a ações da interface. A escolha depende do framework, da responsabilidade da rotina e da versão do ambiente.
A herança xBase aparece em palavras reservadas, expressões, comandos e convenções. Um fonte pode conter includes, funções de usuário, variáveis, condições, repetições, chamadas e retornos. A sintaxe é a forma; o essencial é como esses elementos expressam o fluxo e as regras de negócio.
Caracteres, números, datas, lógicos, arrays, blocos de código e objetos aparecem com frequência. AdvPL admite tipagem dinâmica e declarações de tipo. Os escopos Local, Static, Private e Public determinam visibilidade e duração; compreendê-los evita efeitos colaterais e erros silenciosos.
O fonte não é executado diretamente como um script. Ele é compilado com includes compatíveis, incorporado ao repositório e executado pelo AppServer. Configuração, release, RPO, bibliotecas e permissões fazem parte do caminho entre escrever e executar o código.
Nem tudo que um programa AdvPL chama pertence ao núcleo da linguagem. Existem palavras e operadores da linguagem, funções da plataforma, classes do Framework e APIs de módulos. Distinguir essas camadas ajuda a localizar documentação, includes, dependências e compatibilidade.
Muitas rotinas operam sobre aliases, tabelas, dicionários, parâmetros, transações e sessões do Protheus. Outras constroem interfaces ou consomem serviços. O comportamento pode depender do contexto, da empresa e filial, do usuário, do módulo e do release.
AdvPL oferece integração profunda com o ERP e continuidade histórica. Código legado, escopos dinâmicos, dependências de versão e APIs específicas exigem disciplina. Declarações explícitas, preservação de áreas, validação de retornos, tratamento de erros e testes no release suportado são práticas essenciais.
A trilha oficial agora reúne 52 aulas, organizadas do nível fundamental ao avançado, com progresso, exercícios, revisões direcionadas e projetos.
Uma rotina simples já mostra elementos importantes: include, função de usuário, variável local, chamada de função e retorno.
Ao executar a função pelo ambiente apropriado, o usuário recebe uma mensagem. O exemplo usa uma variável em português, seguindo o idioma desta página.
#Include "TOTVS.ch"\n\nUser Function OlaAdvPL()\n Local cMensagem := "Olá, AdvPL!"\n\n MsgInfo(cMensagem, "Primeiro programa")\nReturnO arquivo-fonte é escrito e compilado contra as includes compatíveis com o ambiente. O resultado é armazenado no repositório e executado pelo AppServer. Recursos, permissões, bibliotecas e comportamento dependem da versão do Protheus utilizada.
Fontes diferentes registram marcos distintos: Silva (2004, p. 11) situa em 1994 o início da evolução da linguagem, enquanto Stal (2010, p. 136) registra 1999 como lançamento do ADVPL. Esses registros podem representar etapas diferentes do processo.
Ler o artigo histórico →© 2026 Usina.BR. Todos os direitos reservados. TOTVS, Protheus, Microsiga e seus respectivos logotipos são marcas de seus titulares. O AdvPL Guia é independente e utiliza citações limitadas, atribuídas e justificadas por finalidade educativa. Consulte os Termos de Uso. Termos de Uso
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.