修改 UI 界面(PageExtension)
修改 ERP 视觉层以显示新字段、隐藏元素并使用 AL 调整布局
0阅读
完成新功能开发周期后,修改数据库后需介入表示层。
pageextension 对象允许我们将新字段注入到现有界面中,移动元素位置,甚至隐藏(修改可见性)会给用户造成“视觉噪音”的列。
与基于纯 HTML 的传统网页不同,Business Central 的页面是元数据分层树。要插入我们的字段,必须使用空间修饰符(“Anchors”)告诉系统确切的位置相对于现有标准字段。
可用的修饰符包括:
addbefore(CampoDestino):将其插入到左侧(或上方)。addafter(CampoDestino):将其插入到右侧(或下方)。addfirst(GrupoDestino):将其作为容器的第一个元素插入。addlast(GrupoDestino):将其作为容器的最后一个元素插入。moveafter(CampoDestino, MiCampo):用于重新排序现有字段。
2. 开发:将我们的字段注入 UI
Sección titulada «2. Desarrollo: Inyectando nuestro campo en la UI»按照我们的“最终供应商”场景(在上一模块的表 121 中创建),现在需要将其显示出来。由于我们已确定该公司使用两个不同的窗口来查看此表,因此需要执行两个独立的 pageextension。
显示收货行(Posted Purchase Rcpt. Subform)的标准页面是 528。我们将把字段放在物料描述的正右侧。
文件: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; } } }}我们发现仓库团队没有使用页面 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 环境中数据的“三重奏”:
- 持久化(后端): 我们通过
tableextension在 SQL 中创建物理空间。底层系统开始对其进行操作。 - 交互(前端): 我们通过
pageextension在所有需要的界面上为人类提供读写入口。 - 分析(数据管道): 我们通过
Query APIs以隐蔽且高速的方式将该数据导出到我们的商业智能(Power BI)仓库。
4. UI 和用户体验(UX)检查表
Sección titulada «4. Checklist de UI y Experiencia de Usuario (UX)»- ✓ ApplicationArea: 在每个注入字段中显式定义
ApplicationArea = All属性,以防止引擎将其隐藏。 - ✓ 可访问性:在所有视觉控件中包含描述性工具提示。
- ✓ 业务约束: 在历史页面或只读页面上实现
Editable = false属性,以确保会计数据的不可变性。

