Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNDAMENTOPublicado

Arquitectura MVC en AdvPL

ModelDef() · ViewDef() · MenuDef()

Organiza reglas de negocio, presentación y operaciones de una rutina Protheus con MVC.

MVCFrameworkModelDefViewDefMenuDefProtheus
01 · DESCRIPCIÓN GENERAL

Descripción general

En el MVC del Framework AdvPL, ModelDef define el modelo y las reglas de negocio, ViewDef construye la interfaz vinculada al modelo y MenuDef declara las operaciones disponibles. El framework proporciona el comportamiento del controlador. Esta separación permite reutilizar el modelo en interfaces, rutinas automáticas e integraciones.

02 · SINTAXIS

Sintaxis

ModelDef() · ViewDef() · MenuDef()

Parámetros

ModelDef
Função estáticaObligatorio

Crea y devuelve el modelo de datos, entidades, relaciones, validaciones y persistencia.

ViewDef
Função estáticaObligatorio

Crea y devuelve la interfaz, vincula el modelo y organiza formularios, grids y contenedores.

MenuDef
Função estáticaObligatorio

Devuelve las operaciones; FWMVCMenu() puede generar el conjunto estándar.

03 · EJEMPLO PRÁCTICO

Estructura mínima de una rutina MVC

#Include "TOTVS.ch"
#Include "FWMVCDef.ch"

// La estructura es igual a la del ejemplo en portugués;
// los textos para el usuario pueden localizarse.
Resultado esperado

ModelDef concentra el modelo, ViewDef vincula la interfaz y MenuDef proporciona las operaciones.

BUENAS PRÁCTICAS
  • Mantén las reglas de negocio en el Model; la View debe encargarse de la presentación e interacción.
  • Utiliza identificadores únicos y estables para todos los componentes.
  • FWFormStruct(1, cAlias) corresponde al Model y FWFormStruct(2, cAlias) a la View.
  • Utiliza Help() para los mensajes de validación del Model.
  • Consulta la documentación actual antes de usar firmas históricas o integraciones XML.
ERRORES COMUNES
  • No utilices mensajes visuales como MsgAlert() dentro del Model.
  • Cada fuente MVC debe tener una sola ModelDef, ViewDef y MenuDef.
  • No implementes reglas de persistencia directamente en la View.
  • El PDF proporcionado contiene APIs históricas cuyo soporte depende de la versión actual.

Contenido relacionado

REFERENCIAS
  1. TOTVS. AdvPL utilizando MVC. PDF proporcionado de 134 páginas, generado el 1 de junio de 2018; secciones y páginas indicadas en la edición portuguesa.
  2. TOTVS. Manual AdvPL utilizando MVC, versión 4.0. TDN.
  3. TOTVS. FWFormModel. TDN.
  4. TOTVS. FWFormView. TDN.
  5. TOTVS. Ejemplos MVC. TDN.
Estado
Publicado
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR