Ir al contenido

Úprava uživatelského rozhraní UI (PageExtension)

Úprava vizuální vrstvy ERP za účelem zobrazení nových polí, skrytí prvků a změny rozvržení pomocí AL.

0čtení

K dokončení vývojového cyklu nové funkce, jakmile je databáze upravena, musíme zasáhnout do prezentační vrstvy.

Objekt pageextension nám umožňuje vkládat naše nová pole do existujících obrazovek, přesouvat prvky na místě a dokonce i skrývat (upravovat viditelnost) sloupce, které uživateli způsobují „vizuální šum“.

1. Systém ukotvení (Modifikátory rozvržení)

Sección titulada «1. El Sistema de Anclaje (Modificadores de Layout)»

Na rozdíl od tradičních webových stránek založených na čistém HTML jsou stránky Business Central hierarchickým stromem metadat. K vložení našeho pole musíme použít prostorové modifikátory („Anchors“), abychom systému přesně řekli, kam jej umístit vzhledem k existujícímu standardnímu poli.

Dostupné modifikátory jsou:

  • addbefore(CampoDestino): Vloží jej přímo vlevo (nebo výše).
  • addafter(CampoDestino): Vloží jej přímo vpravo (nebo níže).
  • addfirst(GrupoDestino): Vloží ho jako první prvek kontejneru.
  • addlast(GrupoDestino): Vloží ho jako poslední prvek kontejneru.
  • moveafter(CampoDestino, MiCampo): Pro přeskupování existujících polí.

2. Vývoj: Vložení našeho pole do uživatelského rozhraní

Sección titulada «2. Desarrollo: Inyectando nuestro campo en la UI»

V souladu s naším scénářem „Poslední dodavatel“ (vytvořeným v předchozím modulu v tabulce 121) jej musíme nyní zobrazit. Protože jsme zjistili, že společnost používá pro zobrazení této tabulky dvě různé okna, musíme provést dvě nezávislé pageextension.

Případ 1: Rozšíření na standardní stránce Microsoft

Sección titulada «Caso 1: Extensión sobre la Página Estándar de Microsoft»

Standardní stránka, která zobrazuje řádky dodacího listu, je 528 („Posted Purchase Rcpt. Subform“). Naše pole umístíme těsně vpravo od popisu položky.

Soubor: 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;
}
}
}
}

Případ 2: Rozšíření na interní vlastní stránce

Sección titulada «Caso 2: Extensión sobre una Página Personalizada Interna»

Zjistili jsme, že skladový tým nepoužívá stránku 528, ale zjednodušenou interně vytvořenou verzi s názvem Lineas albaran compra (stránka 50017). Pro ně musí být pole velmi viditelné a umístěné vedle množství.

Soubor: 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;
}
}
}
}

Tímto posledním krokem jsme dokončili „Trisílu“ dat v moderním prostředí DevSecOps:

  1. Persistence (Backend): V SQL vytváříme fyzický prostor pomocí tableextension. Podpůrný systém s ním začíná pracovat.
  2. Interakce (Frontend): Poskytujeme lidem body pro čtení/zápis pomocí pageextension ve všech požadovaných rozhraních.
  3. Analýza (Data Pipeline): Tato stejná data neviditelně a vysokou rychlostí exportujeme pomocí Query APIs do našich úložišť Business Intelligence (Power BI).

4. Kontrolní seznam UI a uživatelské zkušenosti (UX)

Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»
  • ✓ ApplicationArea: Vlastnost ApplicationArea = All je v každém injektovaném poli explicitně definována, aby se zabránilo jejímu skrytí motorem.
  • ✓ Přístupnost: Zařazení popisných ToolTips do všech vizuálních ovládacích prvků.
  • ✓ Omezení podnikání: Vlastnost Editable = false implementovaná na stránkách historie nebo pouze pro čtení pro zajištění neměnnosti účetních dat.