Ir al contenido

Alterando la Interfaz UI (PageExtension)

Modificació de la capa visual de l'ERP per mostrar nous camps, ocultar elements i alterar la disposició mitjançant AL.

0lectures

Per completar el cicle de desenvolupament d'una nova característica, un cop modificada la base de dades, hem d'intervenir la capa de presentació.

El objeto pageextension nos permite inyectar nuestros nuevos campos en pantallas existentes, mover elementos de sitio, e incluso ocultar (modificar la visibilidad) columnas que generan “ruido visual” al usuario.

1. El Sistema d'Ancoratge (Modificadors de Layout)

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

A diferència de les pàgines web tradicionals basades en HTML pur, les pàgines de Business Central són un arbre jeràrquic de metadades. Per inserir el nostre camp, hem d'utilitzar modificadors espacials ("Anchors") per dir-li al sistema exactament on col·locar-lo respecte a un camp estàndard existent.

Els modificadors disponibles són:

  • addbefore(CampoDestino): Lo inserta justo a la izquierda (o arriba).
  • addafter(CampoDestino): Lo inserta justo a la derecha (o abajo).
  • addfirst(GrupoDestino): Lo inserta como primer elemento de un contenedor.
  • addlast(GrupoDestino): Lo inserta como último elemento de un contenedor.
  • moveafter(CampoDestino, MiCampo): Para reordenar campos existentes.

2. Desenvolupament: Injectant el nostre camp a la UI

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

Siguiendo nuestro escenario del “Proveedor Final” (creado en el módulo anterior en la tabla 121), ahora debemos mostrarlo. Dado que hemos identificado que la empresa utiliza dos ventanas diferentes para visualizar esta tabla, debemos realizar dos pageextension independientes.

Cas 1: Extensió sobre la Pàgina Estàndard de Microsoft

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

La página estándar que muestra las líneas de albarán es la 528 (“Posted Purchase Rcpt. Subform”). Vamos a colocar nuestro campo justo a la derecha de la descripción del artículo.

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

Cas 2: Extensió sobre una Pàgina Personalitzada Interna

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

Hemos detectado que el equipo de almacén no usa la página 528, sino una simplificada creada internamente llamada Lineas albaran compra (Página 50017). Para ellos, el campo debe ser muy visible y estar junto a la cantidad.

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

Amb aquest últim pas, hem completat la "Triforça" de la dada en un entorn DevSecOps modern:

  1. Persistencia (Backend): Creamos el espacio físico en SQL mediante tableextension. El sistema subyacente comienza a operar con él.
  2. Interacción (Frontend): Proporcionamos a los humanos los puntos de lectura/escritura mediante pageextension en todas las interfaces requeridas.
  3. Análisis (Data Pipeline): Exportamos de forma invisible y a alta velocidad ese mismo dato mediante Query APIs hacia nuestros repositorios de Inteligencia de Negocio (Power BI).

4. Checklist de UI i Experiència d'Usuari (UX)

Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»
  • ✓ ApplicationArea: Propiedad ApplicationArea = All definida explícitamente en cada campo inyectado para evitar que el motor lo oculte.
  • ✓ Accesibilidad: Inclusión de ToolTips descriptivos en todos los controles visuales.
  • ✓ Restricciones de Negocio: Propiedad Editable = false implementada en páginas de histórico o de sólo lectura para garantizar la inmutabilidad de los datos contables.