thalysjuvenal/advpl-specialist/smartx-development

Smart X

This skill covers developing TOTVS Smart X routines: the Object -> Model -> Interface -> Launcher chain that turns a data dictionary table (SX2/SX3) into an automatically-rendered PO-UI screen without hand-written Angular components. It documents the required includes and annotations for the Model (totvs.framework.structure.model.th) and Interface (totvs.framework.structure.Interface.th) TLPP classes, the Launcher function that registers the routine in the Protheus menu, integrating existing ADVPL functions into the interface via pageActions/tableActions/events, and converting only the browse (Data View) of a legacy MVC routine to Smart X while keeping ModelDef/ViewDef/MenuDef intact.

Activate this skill when the user is creating a new Smart X routine from scratch, wiring an ADVPL function call into a Smart X page/table action, converting a legacy MVC browse to a Smart X browse, or debugging a Smart X screen/model/interface issue. It does not cover classic MVC routine development without Smart X (see advpl-code-generation, file patterns-mvc.md), nor data dictionary configuration scripts for SX2/SX3 themselves (see sx-configuration). It is also unrelated to Smart View, the TReports analytics tool whose custom business objects are covered by smartview-development -- the names are similar, the frameworks are not.

The referenced files are written in Brazilian Portuguese.