Alterando a Interfaz UI (PageExtension)
Modificação da capa visual do ERP para mostrar novos campos, ocultar elementos e alterar a disposição mediante AL.
Para completar o ciclo de desenvolvimento de uma nova funcionalidade, uma vez modificada a base de dados, devemos intervir na camada de apresentação.
O objeto pageextension nos permite injetar nossos novos campos em telas existentes, mover elementos de localização, e até ocultar (modificar a visibilidade) colunas que geram “ruido visual” ao usuário.
1. O Sistema de Ancoragem (Modificadores de Layout)
Sección titulada «1. El Sistema de Anclaje (Modificadores de Layout)»Diferente das páginas web tradicionais baseadas em HTML puro, as páginas do Business Central são uma árvore hierárquica de metadados. Para inserir nosso campo, devemos usar modificadores espaciais (“Anchors”) para dizer ao sistema exatamente onde colocá-lo em relação a um campo padrão existente.
Os modificadores disponíveis são:
- addbefore(CampoDestino)
: O insere justo à esquerda (ou acima). - addafter(CampoDestino)
: O insere justo à direita (ou abaixo). - addfirst(GrupoDestino)
: O insere como primeiro elemento de um contêiner. - addlast(GrupoDestino)
: O insere como último elemento de um contêiner. - moveafter(CampoDestino, MiCampo)
: Para reordenar campos existentes.
2. Desenvolvimento: Injetando nosso campo na UI
Sección titulada «2. Desarrollo: Inyectando nuestro campo en la UI»Seguindo nosso cenário do “Proveedor Final” (criado no módulo anterior na tabela 121), agora devemos mostrá-lo. Dado que identificamos que a empresa utiliza duas janelas diferentes para visualizar essa tabela, devemos realizar duas pageextension independentes.
Caso 1: Extensão sobre a Página Padrão da Microsoft
Sección titulada «Caso 1: Extensión sobre la Página Estándar de Microsoft»A página padrão que mostra as linhas de albarão é a 528 (“Posted Purchase Rcpt. Subform”). Vamos colocar nosso campo justo à direita da descrição do artigo.
Arquivo: Pag-Ext50100.PurchRcptLinesExt.al
// 1. Declaración y enlace a la página originalpageextension 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: Extensão sobre uma Página Personalizada Interna
Sección titulada «Caso 2: Extensión sobre una Página Personalizada Interna»Identificamos que o time de armazém não usa a página 528, mas sim uma simplificada criada internamente chamada Lineas albaran compra (Página 50017). Para eles, o campo deve ser muito visível e estar junto à quantidade.
Arquivo: 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. Resumo do Ciclo de Vida do Dado
Sección titulada «3. Resumen del Ciclo de Vida del Dato»Com este último passo, completamos a “Triforça” do dado em um ambiente DevSecOps moderno:
- Persistência (Backend): Criamos o espaço físico em SQL mediante tableextension
. O sistema subyacente começa a operar com ele. - Interação (Frontend): Proporcionamos aos humanos os pontos de leitura/escrita mediante pageextension
em todas as interfaces requeridas. - Análise (Data Pipeline): Exportamos de forma invisível e a alta velocidade esse mesmo dado mediante Query APIs
para nossos repositórios de Inteligência de Negócios (Power BI).
4. Checklist de UI e Experiência de Usuário (UX)
Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»- ✓ ApplicationArea: Propriedade ApplicationArea = All
definida explicitamente em cada campo injetado para evitar que o motor o oculte. - ✓ Accesibilidade: Inclusão de ToolTips descriptivos em todos os controles visuais.
- ✓ 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.

