扩展表格(TableExtension)
创建数据库级别的扩展以注入新物理字段并修改ERP行为
0阅读
现代云生态系统开发原则是不侵入性。我们无法访问微软的原始C/AL代码,也不希望如此(这会破坏自动更新)
要修改数据库,我们使用 tableextension 对象。在 SQL 引擎层面,Business Central 在后台会创建一个带有我们前缀的新补充表,并且系统在每次读取或写入记录时都会自动编排一个透明的 JOIN(1 对 1)。
在编程之前,我们必须了解安全和设计指南:
- 开发 ID:我们必须使用分配给客户端许可证的范围(通常从
50000到99999)。 - 我们可以做的事情:添加新字段、添加新键(
keys),以及修改某些标准字段属性(例如Caption)。 - 我们不能做到:删除标准字段,更改标准字段的数据类型,或删除标准主键
2. 开发:tableextension 的结构
Sección titulada «2. Desarrollo: Estructura de un tableextension»假设我们环境中的一个真实场景:采购部门需要分析基于“最终供应商”的指标,但标准收货表仅记录物流供应商
我们将把该字段注入到表 121(Purch. Rcpt. Line)中。
文件名:Tab-Ext50100.PurchRcptLineExt.al
// 1. Declaración: ID libre, Nombre de la extensión, y la tabla base que extendemos.tableextension 50100 "Portelcore PurchRcptLine Ext" extends "Purch. Rcpt. Line"{ fields { // 2. Creación del nuevo campo físico. ID libre y Tipo de dato (Texto de 100 caracteres). field(50100; "Proveedor Final"; Text[100]) { // PROPIEDADES DEL CAMPO
// Etiqueta visual que verán los usuarios y sistemas externos Caption = 'Proveedor Final';
// DataClassification (GDPR): Obligatorio declarar qué tipo de información guardamos. // Posibles valores: CustomerContent, EndUserIdentifiableInformation, SystemMetadata, etc. DataClassification = CustomerContent;
// Descripción técnica para otros desarrolladores Description = 'Registra el fabricante real de la materia prima, no el distribuidor intermediario.';
// LÓGICA DE NEGOCIO Y EVENTOS trigger OnValidate() begin // Se ejecuta cada vez que el valor cambia y es aceptado. // Aquí podríamos llamar a funciones de validación compleja o cruzar con otras tablas. if Rec."Proveedor Final" = '' then Message('Aviso DevSecOps: Se recomienda encarecidamente registrar el proveedor final para Power BI.'); end; } }
// 3. OPTIMIZACIÓN (Índices SQL) keys { // Si prevemos que Power BI o el ERP filtrarán masivamente por este campo, // debemos crear una clave secundaria (Non-Clustered Index) en SQL. key(Key_ProvFinal; "Proveedor Final") { } }}3. 即时效果(以及缺失的部分)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»保存此代码并部署到 Sandbox(在 VS Code 中按 F5 或 Ctrl+F5)时,SQL Server 引擎会修改物理架构。
从那一刻起:
- 字段
"Proveedor Final"已存在。 - 占用磁盘空间
- 它可以立即被我们的 API 使用(
Query对象)。 - 可以被任何其他代码单元扩展使用
⚠️ 隐秘数据:然而,使用 Business Central Web 界面的员工无法看到也无法编辑它。物理上它存在,但视觉上不可见。要将其展示给用户,我们必须创建一个可视界面扩展(
pageextension)。
- ✓ SQL模式:通过NST自动同步在Azure SQL/SQL Server上成功更新模式
- ✓ GDPR 合规:在所有新字段中明确
DataClassification数据分类。 - ✓ 性能:为 ETL/Power BI 中批量提取的索引字段创建二级键(
keys)。>

