Ir al contenido

Alterando la Interfaz UI (PageExtension)

Modificación de la capa visual del ERP para mostrar nuevos campos, ocultar elementos y alterar la disposición mediante AL.

0lecturas

Para completar el ciclo de desarrollo de una nueva característica, una vez modificada la base de datos, nosotros debemos intervenir la capa de presentación.

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 de Anclaje (Modificadores de Layout)

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

A diferencia de las páginas web tradicionales basadas en HTML puro, las páginas de Business Central son un árbol jerárquico de metadatos. Para insertar nuestro campo, debemos usar modificadores espaciales (“Anchors”) para decirle al sistema exactamente dónde colocarlo respecto a un campo estándar existente.

Los modificadores disponibles son:

  • 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. Desarrollo: Inyectando nuestro campo en 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.

Caso 1: Extensión sobre la Página Estándar 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;
}
}
}
}

Caso 2: Extensión sobre una Página Personalizada 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;
}
}
}
}

Con este último paso, hemos completado la “Trifuerza” del dato en un entorno DevSecOps moderno:

  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 y Experiencia de Usuario (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.