Ir al contenido

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.

0letture

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.

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 Sum di tutti i suoi movimenti contabili.
  • Impatto: I FlowFields sono letali per le prestazioni se vengono estratti massivamente senza precauzioni.

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.

  • 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.';
}
}
}
}
}

Comprendere questa separazione detta come dobbiamo strutturare i nostri sviluppi:

  1. 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.
  2. 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).
  • ✓ Separazione Stretta: Logica di business incapsulata in oggetti Table e Codeunit; interfaccia confinata in oggetti Page.
  • ✓ Rendimiento ETL: Esposizione esclusiva di oggetti Query di tipo API per estrazioni verso Power BI, evitando le penalizzazioni dei FlowFields di pagine.
  • ✓ Estensibilità: Modificazione del modello standard di Microsoft mediante estensioni disaccoppiate (tableextension e pageextension).