Ir al contenido

修改 UI 界面(PageExtension)

修改 ERP 视觉层以显示新字段、隐藏元素并使用 AL 调整布局

0阅读

完成新功能开发周期后,修改数据库后需介入表示层。

pageextension 对象允许我们将新字段注入到现有界面中,移动元素位置,甚至隐藏(修改可见性)会给用户造成“视觉噪音”的列。

与基于纯 HTML 的传统网页不同,Business Central 的页面是元数据分层树。要插入我们的字段,必须使用空间修饰符(“Anchors”)告诉系统确切的位置相对于现有标准字段。

可用的修饰符包括:

  • addbefore(CampoDestino):将其插入到左侧(或上方)。
  • addafter(CampoDestino):将其插入到右侧(或下方)。
  • addfirst(GrupoDestino):将其作为容器的第一个元素插入。
  • addlast(GrupoDestino):将其作为容器的最后一个元素插入。
  • moveafter(CampoDestino, MiCampo):用于重新排序现有字段。

按照我们的“最终供应商”场景(在上一模块的表 121 中创建),现在需要将其显示出来。由于我们已确定该公司使用两个不同的窗口来查看此表,因此需要执行两个独立的 pageextension。

显示收货行(Posted Purchase Rcpt. Subform)的标准页面是 528。我们将把字段放在物料描述的正右侧。

文件: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;
}
}
}
}

我们发现仓库团队没有使用页面 528,而是使用了一个内部创建的简化页面 Lineas albaran compra(页面 50017)。对他们来说,该字段必须非常醒目,并位于数量旁边。

文件: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;
}
}
}
}

通过此最后一步,我们完成了现代 DevSecOps 环境中数据的“三重奏”:

  1. 持久化(后端): 我们通过 tableextension 在 SQL 中创建物理空间。底层系统开始对其进行操作。
  2. 交互(前端): 我们通过 pageextension 在所有需要的界面上为人类提供读写入口。
  3. 分析(数据管道): 我们通过 Query APIs 以隐蔽且高速的方式将该数据导出到我们的商业智能(Power BI)仓库。
  • ✓ ApplicationArea: 在每个注入字段中显式定义 ApplicationArea = All 属性,以防止引擎将其隐藏。
  • ✓ 可访问性:在所有视觉控件中包含描述性工具提示。
  • ✓ 业务约束: 在历史页面或只读页面上实现 Editable = false 属性,以确保会计数据的不可变性。