Ir al contenido

Altération de l'interface utilisateur (PageExtension)

Modification de la couche visuelle de l'ERP pour afficher de nouveaux champs, masquer des éléments et modifier la disposition via AL.

0vues

Pour compléter le cycle de développement d'une nouvelle fonctionnalité, une fois la base de données modifiée, nous devons intervenir sur la couche de présentation.

L'objet pageextension nous permet d'injecter nos nouveaux champs dans des écrans existants, de déplacer des éléments de site, et même de masquer (modifier la visibilité) des colonnes qui génèrent un « bruit visuel » pour l'utilisateur.

1. Le Système d'Ancrage (Modificateurs de Layout)

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

Contrairement aux pages web traditionnelles basées sur du HTML pur, les pages de Business Central sont un arbre hiérarchique de métadonnées. Pour insérer notre champ, nous devons utiliser des modificateurs spatiaux (« Anchors ») pour indiquer au système exactement où le placer par rapport à un champ standard existant.

Les modificateurs disponibles sont :

  • addbefore(CampoDestino) : L'insère juste à gauche (ou au-dessus).
  • addafter(CampoDestino) : L'insère juste à droite (ou en dessous).
  • addfirst(GrupoDestino) : L'insère comme premier élément d'un conteneur.
  • addlast(GrupoDestino) : L'insère comme dernier élément d'un conteneur.
  • moveafter(CampoDestino, MiCampo) : Pour réordonner les champs existants.

2. Développement : Injection de notre champ dans l'UI

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

En suivant notre scénario du « Fournisseur Final » (créé dans le module précédent dans le tableau 121), nous devons maintenant l'afficher. Étant donné que nous avons identifié que l'entreprise utilise deux fenêtres différentes pour visualiser ce tableau, nous devons effectuer deux pageextension indépendants.

La page standard qui affiche les lignes de bon de livraison est la 528 (« Posted Purchase Rcpt. Subform »). Nous allons placer notre champ juste à droite de la description de l'article.

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

Nous avons détecté que l'équipe de l'entrepôt n'utilise pas la page 528, mais une version simplifiée créée en interne appelée Lineas albaran compra (Page 50017). Pour eux, le champ doit être très visible et situé à côté de la quantité.

Fichier : 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. Résumé du Cycle de Vie de la Donnée

Sección titulada «3. Resumen del Ciclo de Vida del Dato»

Avec cette dernière étape, nous avons complété la « Triforce » de la donnée dans un environnement DevSecOps moderne :

  1. Persistance (Backend) : Nous créons l'espace physique en SQL via tableextension. Le système sous-jacent commence alors à fonctionner avec celui-ci.
  2. Interaction (Frontend) : Nous fournissons aux humains les points de lecture/écriture via pageextension sur toutes les interfaces requises.
  3. Analyse (Data Pipeline) : Nous exportons de manière invisible et à haute vitesse cette même donnée via Query APIs vers nos référentiels d'informatique décisionnelle (Power BI).

4. Checklist d'UI et Expérience Utilisateur (UX)

Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»
  • ✓ ApplicationArea : Propriété ApplicationArea = All définie explicitement dans chaque champ injecté pour éviter que le moteur ne le masque.
  • ✓ Accessibilité : Inclusion de tooltips descriptifs sur tous les contrôles visuels.
  • ✓ Contraintes métier : Propriété Editable = false implémentée sur les pages d'historique ou en lecture seule pour garantir l'immuabilité des données comptables.