Änderung der UI-Schnittstelle (PageExtension)
Modifizierung der visuellen Ebene des ERP, um neue Felder anzuzeigen, Elemente auszublenden und das Layout mittels AL zu ändern.
Um den Entwicklungszyklus einer neuen Funktion abzuschließen, müssen wir nach der Änderung der Datenbank in die Präsentationsschicht eingreifen.
Das Objekt pageextension ermöglicht es uns, unsere neuen Felder in bestehende Bildschirme zu injizieren, Seitenelemente zu verschieben und sogar Spalten auszublenden (die Sichtbarkeit zu ändern), die beim Benutzer „visuelles Rauschen“ verursachen.
1. Das Verankerungssystem (Layout-Modifikatoren)
Sección titulada «1. El Sistema de Anclaje (Modificadores de Layout)»Im Gegensatz zu herkömmlichen Webseiten, die auf reinem HTML basieren, sind Business Central-Seiten ein hierarchischer Metadatenbaum. Um unser Feld einzufügen, müssen wir räumliche Modifikatoren ("Anchors") verwenden, um dem System genau mitzuteilen, wo es im Verhältnis zu einem bestehenden Standardfeld platziert werden soll.
Die verfügbaren Modifikatoren sind:
addbefore(CampoDestino): Fügt es direkt links (oder oben) ein.addafter(CampoDestino): Fügt es direkt rechts (oder unten) ein.addfirst(GrupoDestino): Fügt es als erstes Element eines Containers ein.addlast(GrupoDestino): Fügt es als letztes Element eines Containers ein.moveafter(CampoDestino, MiCampo): Zum Umordnen bestehender Felder.
2. Entwicklung: Einfügen unseres Feldes in die UI
Sección titulada «2. Desarrollo: Inyectando nuestro campo en la UI»Basierend auf unserem Szenario des „Endlieferanten“ (erstellt im vorherigen Modul in Tabelle 121) müssen wir diesen nun anzeigen. Da wir festgestellt haben, dass das Unternehmen zwei verschiedene Fenster zur Anzeige dieser Tabelle verwendet, müssen wir zwei unabhängige pageextension durchführen.
Fall 1: Erweiterung der Microsoft-Standardseite
Sección titulada «Caso 1: Extensión sobre la Página Estándar de Microsoft»Die Standardseite, die die Lieferbelegzeilen anzeigt, ist die 528 („Posted Purchase Rcpt. Subform“). Wir werden unser Feld direkt rechts neben der Artikelbeschreibung platzieren.
Datei: 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; } } }}Fall 2: Erweiterung einer internen benutzerdefinierten Seite
Sección titulada «Caso 2: Extensión sobre una Página Personalizada Interna»Wir haben festgestellt, dass das Lagerteam nicht Seite 528 verwendet, sondern eine intern erstellte, vereinfachte Version namens Lineas albaran compra (Seite 50017). Für sie muss das Feld sehr gut sichtbar und direkt neben der Menge stehen.
Datei: 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. Zusammenfassung des Datenlebenszyklus
Sección titulada «3. Resumen del Ciclo de Vida del Dato»Mit diesem letzten Schritt haben wir die "Triforce" der Daten in einer modernen DevSecOps-Umgebung vervollständigt:
- Persistenz (Backend): Wir erstellen den physischen Speicherplatz in SQL mittels
tableextension. Das zugrunde liegende System beginnt, damit zu arbeiten. - Interaktion (Frontend): Wir stellen den Menschen die Lese-/Schreibpunkte über
pageextensionin allen erforderlichen Schnittstellen zur Verfügung. - Analyse (Data Pipeline): Wir exportieren dieselben Daten unsichtbar und mit hoher Geschwindigkeit über
Query APIsin unsere Business-Intelligence-Repositories (Power BI).
4. Checkliste für UI und User Experience (UX)
Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»- ✓ ApplicationArea: Die Eigenschaft
ApplicationArea = Allwird in jedem injizierten Feld explizit definiert, um zu verhindern, dass die Engine sie ausblendet. - ✓ Barrierefreiheit: Einbindung beschreibender Tooltips in allen visuellen Steuerelementen.
- ✓ Geschäftsregeln: Die Eigenschaft
Editable = falseist auf Historien- oder schreibgeschützten Seiten implementiert, um die Unveränderlichkeit der Buchhaltungsdaten zu gewährleisten.

