Alterazione dell'interfaccia UI (PageExtension)
Modifica dello strato visivo dell'ERP per mostrare nuovi campi, nascondere elementi e alterare il layout tramite AL.
Per completare il ciclo di sviluppo di una nuova funzionalità, una volta modificato il database, dobbiamo intervenire sul livello di presentazione.
L'oggetto pageextension ci consente di iniettare i nostri nuovi campi in schermate esistenti, spostare elementi del sito e persino nascondere (modificare la visibilità) colonne che generano “rumore visivo” per l'utente.
1. Il Sistema di Ancoraggio (Modificatori di Layout)
Sección titulada «1. El Sistema de Anclaje (Modificadores de Layout)»A differenza delle pagine web tradizionali basate su HTML puro, le pagine di Business Central sono un albero gerarchico di metadati. Per inserire il nostro campo, dobbiamo usare modificatori spaziali ("Anchors") per dire al sistema esattamente dove posizionarlo rispetto a un campo standard esistente.
I modificatori disponibili sono:
addbefore(CampoDestino): Lo inserisce proprio a sinistra (o sopra).addafter(CampoDestino): Lo inserisce proprio a destra (o sotto).addfirst(GrupoDestino): Lo inserisce come primo elemento di un contenitore.addlast(GrupoDestino): Lo inserisce come ultimo elemento di un contenitore.moveafter(CampoDestino, MiCampo): Per riordinare i campi esistenti.
2. Sviluppo: Iniettare il nostro campo nella UI
Sección titulada «2. Desarrollo: Inyectando nuestro campo en la UI»Seguendo il nostro scenario del "Fornitore Finale" (creato nel modulo precedente nella tabella 121), ora dobbiamo visualizzarlo. Poiché abbiamo identificato che l'azienda utilizza due finestre diverse per visualizzare questa tabella, dobbiamo eseguire due pageextension indipendenti.
Caso 1: Estensione sulla Pagina Standard di Microsoft
Sección titulada «Caso 1: Extensión sobre la Página Estándar de Microsoft»La pagina standard che mostra le righe della bolla di consegna è la 528 (“Posted Purchase Rcpt. Subform”). Posizioneremo il nostro campo proprio a destra della descrizione dell'articolo.
File: Pag-Ext50100.PurchRcptLinesExt.al
// 1. Declaración y enlace a la página originalpageextension 50100 "Portelcore PurchRcptLines Ext" extends "Posted Purchase Rcpt. Subform"{ layout { // 2. Punto de anclaje visual (Inmediatamente después de "Description") addafter(Description) { // 3. Declaración del campo a mostrar (Rec es el puntero al registro actual) field("Proveedor Final"; Rec."Proveedor Final") { // ApplicationArea es obligatorio. Si no se pone, el campo queda invisible por seguridad. ApplicationArea = All;
// Texto de ayuda (Hover) para guiar al usuario ToolTip = 'Indica el nombre del fabricante original de la materia prima (Analítica DevSecOps).';
// Propiedades de formato (opcionales) ShowMandatory = true; // Pone un asterisco rojo (aunque no fuerza el error en la base de datos)
// Nota arquitectónica: En páginas de histórico (Albaranes Registrados), // por norma general los campos deberían ser de solo lectura. Editable = false; } } }}Caso 2: Estensione su una Pagina Personalizzata Interna
Sección titulada «Caso 2: Extensión sobre una Página Personalizada Interna»Abbiamo rilevato che il team del magazzino non utilizza la pagina 528, ma una versione semplificata creata internamente chiamata Lineas albaran compra (Pagina 50017). Per loro, il campo deve essere molto visibile e posizionato accanto alla quantità.
File: Pag-Ext50101.CustomPurchRcptLinesExt.al
pageextension 50101 "Portelcore CustomRcptLines Ext" extends "Lineas albaran compra"{ layout { addafter(Quantity) { field("Proveedor Final"; Rec."Proveedor Final") { ApplicationArea = All; ToolTip = 'Fabricante de origen.';
// Destaque visual: Pone el texto en negrita Style = Strong; } } }}3. Riepilogo del Ciclo di Vita del Dato
Sección titulada «3. Resumen del Ciclo de Vida del Dato»Con quest'ultimo passaggio, abbiamo completato la "Triforza" del dato in un ambiente DevSecOps moderno:
- Persistenza (Backend): Creiamo lo spazio fisico in SQL tramite
tableextension. Il sistema sottostante inizia a operare con esso. - Interazione (Frontend): Forniamo agli umani i punti di lettura/scrittura tramite
pageextensionin tutte le interfacce richieste. - Analisi (Data Pipeline): Esportiamo in modo invisibile e ad alta velocità lo stesso dato tramite
Query APIsverso i nostri repository di Business Intelligence (Power BI).
4. Checklist di UI ed Esperienza Utente (UX)
Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»- ✓ ApplicationArea: Proprietà
ApplicationArea = Alldefinita esplicitamente in ogni campo iniettato per evitare che il motore la nasconda. - ✓ Accessibilità: Inclusione di ToolTip descrittivi in tutti i controlli visuali.
- ✓ Vincoli di Business: Proprietà
Editable = falseimplementata nelle pagine di storico o di sola lettura per garantire l'immutabilità dei dati contabili.

