AdvPL GuíaComprende qué es AdvPL, cómo se integra en Protheus y avanza por lecciones organizadas — desde el primer fuente hasta arquitecturas más completas.
Ver la ruta completa →AdvPL — Advanced Protheus Language — es un lenguaje desarrollado para el ecosistema Protheus. Su origen está relacionado con el estándar xBase y con la necesidad de conservar y evolucionar aplicaciones empresariales creadas por Microsiga.
El lenguaje admite programación procedimental, orientación a objetos y eventos. Los fuentes se compilan en el repositorio de la aplicación y AppServer los ejecuta. En el desarrollo actual, Visual Studio Code con la extensión TOTVS Developer Studio es una de las herramientas utilizadas.
Conocer un lenguaje no consiste solo en memorizar su sintaxis. Significa entender qué problemas resuelve, en qué entorno vive, cómo transforma fuentes en ejecución y qué ideas permite expresar. En AdvPL, estas preguntas están estrechamente relacionadas con Protheus.
AdvPL fue creado para desarrollar y adaptar aplicaciones empresariales en el ecosistema Protheus. Se utiliza en reglas de negocio, procesos, acceso a datos, informes, interfaces, puntos de entrada e integraciones. Aprender AdvPL también implica comprender la arquitectura y los contratos de Protheus.
El lenguaje combina programación procedimental, orientación a objetos y eventos. Una solución puede organizarse en funciones, utilizar clases y métodos o reaccionar a acciones de la interfaz. El paradigma adecuado depende del framework, de la responsabilidad y de la versión.
La herencia xBase aparece en palabras reservadas, expresiones, comandos y convenciones. Un fuente puede contener includes, funciones de usuario, variables, condiciones, repeticiones, llamadas y retornos. La sintaxis es la forma; lo esencial es cómo expresa el flujo y las reglas de negocio.
Caracteres, números, fechas, valores lógicos, arrays, bloques de código y objetos son frecuentes. AdvPL admite tipado dinámico y declaraciones de tipo. Los ámbitos Local, Static, Private y Public controlan visibilidad y duración; comprenderlos evita efectos secundarios y errores silenciosos.
El fuente no se ejecuta directamente como un script. Se compila con includes compatibles, se incorpora al repositorio y AppServer lo ejecuta. Configuración, release, RPO, bibliotecas y permisos forman parte del camino entre escribir y ejecutar el código.
No todo lo que llama un programa AdvPL pertenece al núcleo del lenguaje. Existen palabras y operadores del lenguaje, funciones de la plataforma, clases del Framework y API de módulos. Distinguir estas capas facilita localizar documentación, includes, dependencias y compatibilidad.
Muchas rutinas operan con alias, tablas, diccionarios, parámetros, transacciones y sesiones de Protheus. Otras construyen interfaces o consumen servicios. El comportamiento puede depender del contexto, empresa y sucursal, usuario, módulo y release.
AdvPL ofrece integración profunda con el ERP y continuidad histórica. El código heredado, los ámbitos dinámicos, las dependencias de versión y las API específicas exigen disciplina. Son esenciales las declaraciones explícitas, la conservación de áreas, la validación de retornos, el tratamiento de errores y las pruebas.
La ruta oficial reúne ahora 52 lecciones, organizadas desde el nivel fundamental hasta el avanzado, con progreso, ejercicios, revisiones dirigidas y proyectos.
Una rutina sencilla ya muestra elementos importantes: include, función de usuario, variable local, llamada a función y retorno.
Al ejecutar la función en el entorno adecuado, el usuario recibe un mensaje. El ejemplo utiliza una variable en español, de acuerdo con el idioma de la página.
#Include "TOTVS.ch"\n\nUser Function HolaAdvPL()\n Local cMensaje := "¡Hola, AdvPL!"\n\n MsgInfo(cMensaje, "Primer programa")\nReturnEl archivo fuente se escribe y compila con includes compatibles con el entorno. El resultado se almacena en el repositorio y AppServer lo ejecuta. Los recursos, permisos, bibliotecas y comportamientos dependen de la versión de Protheus utilizada.
Las fuentes registran hitos diferentes: Silva (2004, p. 11) sitúa en 1994 el inicio de la evolución del lenguaje, mientras Stal (2010, p. 136) registra 1999 como lanzamiento de ADVPL. Pueden representar etapas distintas del mismo proceso.
Leer el artículo histórico →Desarrollado con Usina Docs · Alpha
© 2026 Usina.BR. Todos los derechos reservados. TOTVS, Protheus, Microsiga y sus respectivos logotipos son marcas de sus titulares. Guía AdvPL es independiente y utiliza citas limitadas, atribuidas y justificadas por fines educativos. Consulta los Términos de Uso. Términos de Uso
Comentarios
Todavía no hay comentarios aprobados.
Inicia sesión con Google o Microsoft para comentar.