Architettura di base - Tabelle vs Pagine
Analisi approfondita del pattern MVC in Business Central, differenziando il modello fisico dallo strato visivo e il suo impatto sui dati.
Per intervenire sull'ERP e creare flussi di dati efficienti, dobbiamo comprendere intimamente la rigorosa separazione che Microsoft stabilisce tra l'archiviazione dei dati (Backend) e la loro presentazione (Frontend).
Business Central opera secondo un modello molto simile al pattern MVC (Model-View-Controller). Nella nostra terminologia, parleremo del Cervello (Tabelle) e delle Finestre (Pagine).
1. Il “Cervello”: L'Oggetto Tabella (Table)
Sección titulada «1. El “Cerebro”: El Objeto Tabla (Table)»Le Tabelle rappresentano la struttura fisica e reale del database (Azure SQL). È l'unico luogo in cui le informazioni persistono. Se un dato non esiste in una Tabella, semplicemente non esiste nel sistema.
1.1. Anatomia di una Tabella
Sección titulada «1.1. Anatomía de una Tabla»In AL, una tabella non è solo un insieme di colonne; contiene molta logica di business incorporata:
- Campi (
fields): Definiscono il tipo di dato forte (Text, Code, Decimal, Date, Boolean). - Chiavi Primarie e Indici (
keys): Ottimizzano le ricerche SQL. La prima chiave (Key) definita in una tabella è automaticamente la Chiave Primaria (Clustered Index). - Trigger (
triggers): Logica che viene eseguita automaticamente a livello di database (OnInsert,OnModify,OnDelete,OnRename). - Validazioni del campo (
OnValidate): Logica che viene eseguita quando un campo specifico cambia valore. Ad esempio, cambiando il “Cod. Cliente”, il sistema cerca automaticamente il suo nome e lo compila.
1.2. Il concetto di “FlowFields” (Campi Calcolati)
Sección titulada «1.2. El concepto de “FlowFields” (Campos Calculados)»Questo è un concetto critico per l'Ingegneria dei Dati. Alcuni campi nelle tabelle NON memorizzano dati reali. Sono formule SQL dinamiche (FlowFields).
- Esempio: Il campo “Saldo” del Cliente. Non esiste nel database come un numero fisso. È un
Sumdi tutti i suoi movimenti contabili. - Impatto: I FlowFields sono letali per le prestazioni se vengono estratti massivamente senza precauzioni.
2. Le “Finestre”: L'Oggetto Pagina (Page)
Sección titulada «2. Las “Ventanas”: El Objeto Página (Page)»Le Pagine costituiscono il livello dell'Interfaccia Utente (UI). Non memorizzano dati; si “affacciano” su una tabella specifica, la leggono e renderizzano l'HTML dinamico nel browser dell'utente.
2.1. Anatomia di una Pagina
Sección titulada «2.1. Anatomía de una Página»- Layout (Design visivo): Definisce l'ordine in cui vengono mostrate le colonne, se vengono raggruppate in schede (FastTabs) e se sono modificabili o di sola lettura.
- Azioni (Bottoni): La barra multifunzione superiore (Ribbon) che consente di eseguire processi (es. “Registra Bolla”, “Stampa PDF”).
- Trigger visuali: Azioni Frontend (
OnOpenPage,OnAfterGetRecord) che alterano i colori, nascondono campi o mostrano messaggi popup.
2.2. Il Paradigma a Finestre Multiple (“One-to-Many”)
Sección titulada «2.2. El Paradigma de Múltiples Ventanas (“One-to-Many”)»Una regola d'oro nella nostra architettura è che una singola Tabella può avere infinite Pagine che puntano ad essa.
- L'origine (Tabella): Tabella 121 (
Purch. Rcpt. Line- Righe della bolla d'acquisto). - Finestra 1 (Standard): Pagina 528. Utilizzata dal dipartimento di Amministrazione, mostra 40 colonne inclusi conti contabili e dimensioni.
- Finestra 2 (Custom): Pagina 50017. Creata su misura per il personale del magazzino, che mostra solo 4 colonne (Articolo, Quantità, Magazzino e Fornitore).
Entrambe leggono e scrivono nello stesso luogo fisico. Modificare una riga nella Finestra 2 aggiorna istantaneamente ciò che si vede nella Finestra 1.
2.3. Esempio Pratico di Codice AL (Modello e Vista)
Sección titulada «2.3. Ejemplo Práctico de Código AL (Modelo y Vista)»Qui possiamo vedere il contrasto diretto nel codice AL tra la definizione fisica di un modello di dati (table) e la sua rappresentazione visiva in lista (page):
// Definición física en Azure SQL (Model)table 50100 "Portelcore Custom Table"{ Caption = 'Tabla Personalizada Portelcore'; DataClassification = CustomerContent;
fields { field(1; "Id Registro"; Code[20]) { Caption = 'Id Registro'; } field(2; Descripcion; Text[100]) { Caption = 'Descripción'; } }
keys { key(PK; "Id Registro") { Clustered = true; } }}
// Representación visual en la UI (View)page 50100 "Portelcore Custom Page"{ PageType = List; SourceTable = "Portelcore Custom Table"; Caption = 'Lista Personalizada Portelcore'; ApplicationArea = All; UsageCategory = Lists;
layout { area(content) { repeater(Group) { field("Id Registro"; Rec."Id Registro") { ApplicationArea = All; ToolTip = 'Identificador único del registro.'; } field(Descripcion; Rec.Descripcion) { ApplicationArea = All; ToolTip = 'Descripción detallada.'; } } } }}3. Impatto Architettonico per DevSecOps e Data
Sección titulada «3. Impacto Arquitectónico para DevSecOps y Data»Comprendere questa separazione detta come dobbiamo strutturare i nostri sviluppi:
- Regola di Estrazione Dati (ETL): Quando costruiamo API per Power BI, NON esporremo MAI una Pagina. Le Pagine costringono il server a eseguire trigger visuali e calcolare FlowField non necessari, saturando il thread di esecuzione e causando il classico errore “Timeout”. Dobbiamo sempre puntare direttamente alle Tabelle utilizzando oggetti
Query API. - Regola di Espansione dell'ERP: Se il business ci chiede un nuovo punto di informazione (es. aggiungere un campo “Fornitore Finale”), il nostro flusso di lavoro consterà obbligatoriamente di due passaggi separati:
- Ampliare il Cervello (tramite
tableextension). - Aprire un varco nelle Finestre (tramite
pageextension).
- Ampliare il Cervello (tramite
4. Criteri di Architettura e Buone Pratiche
Sección titulada «4. Criterios de Arquitectura y Buenas Prácticas»- ✓ Separazione Stretta: Logica di business incapsulata in oggetti
TableeCodeunit; interfaccia confinata in oggettiPage. - ✓ Rendimiento ETL: Esposizione esclusiva di oggetti
Querydi tipo API per estrazioni verso Power BI, evitando le penalizzazioni dei FlowFields di pagine. - ✓ Estensibilità: Modificazione del modello standard di Microsoft mediante estensioni disaccoppiate (
tableextensionepageextension).

