Ir al contenido

Änderung der UI-Schnittstelle (PageExtension)

Modifizierung der visuellen Ebene des ERP, um neue Felder anzuzeigen, Elemente auszublenden und das Layout mittels AL zu ändern.

0Lesungen

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.

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 original
pageextension 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:

  1. Persistenz (Backend): Wir erstellen den physischen Speicherplatz in SQL mittels tableextension. Das zugrunde liegende System beginnt, damit zu arbeiten.
  2. Interaktion (Frontend): Wir stellen den Menschen die Lese-/Schreibpunkte über pageextension in allen erforderlichen Schnittstellen zur Verfügung.
  3. Analyse (Data Pipeline): Wir exportieren dieselben Daten unsichtbar und mit hoher Geschwindigkeit über Query APIs in unsere Business-Intelligence-Repositories (Power BI).
  • ✓ ApplicationArea: Die Eigenschaft ApplicationArea = All wird 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 = false ist auf Historien- oder schreibgeschützten Seiten implementiert, um die Unveränderlichkeit der Buchhaltungsdaten zu gewährleisten.