ModelDefFunção estáticaRequired
Creates and returns the data model, entities, relationships, validations and persistence.
FOUNDATIONPublished
MVC architecture in AdvPL
ModelDef() · ViewDef() · MenuDef()Organize business rules, presentation and operations in a Protheus routine with MVC.
Overview
In AdvPL Framework MVC, ModelDef defines the model and business rules, ViewDef builds the interface connected to that model, and MenuDef declares available operations. The framework supplies the controller behavior. This separation allows the model to be reused by interfaces, automated routines and integrations.
Syntax
ModelDef() · ViewDef() · MenuDef()Parameters
ViewDefFunção estáticaRequired
Creates and returns the interface, links the model and arranges forms, grids and containers.
MenuDefFunção estáticaRequired
Returns routine operations; FWMVCMenu() may generate the standard set.
Minimal MVC routine structure
#Include "TOTVS.ch"
#Include "FWMVCDef.ch"
// Same structure as the Portuguese example;
// user-facing texts can be localized.Expected result
ModelDef owns the model, ViewDef connects the interface, and MenuDef supplies operations.
- Keep business rules in the Model; the View should handle presentation and interaction.
- Use unique, stable identifiers for every component.
- FWFormStruct(1, cAlias) is for the Model and FWFormStruct(2, cAlias) is for the View.
- Use Help() for Model validation messages.
- Check the current documentation before using historical signatures or XML integrations.
- Do not use visual messages such as MsgAlert() inside the Model.
- Each MVC source should have only one ModelDef, ViewDef and MenuDef.
- Do not persist business rules directly in the View.
- The supplied PDF contains historical APIs whose support depends on the current release.