Ir al contenido

扩展表格(TableExtension)

创建数据库级别的扩展以注入新物理字段并修改ERP行为

0阅读

现代云生态系统开发原则是不侵入性。我们无法访问微软的原始C/AL代码,也不希望如此(这会破坏自动更新)

要修改数据库,我们使用 tableextension 对象。在 SQL 引擎层面,Business Central 在后台会创建一个带有我们前缀的新补充表,并且系统在每次读取或写入记录时都会自动编排一个透明的 JOIN(1 对 1)。

在编程之前,我们必须了解安全和设计指南:

  • 开发 ID:我们必须使用分配给客户端许可证的范围(通常从 50000 到 99999)。
  • 我们可以做的事情:添加新字段、添加新键(keys),以及修改某些标准字段属性(例如 Caption)。
  • 我们不能做到:删除标准字段,更改标准字段的数据类型,或删除标准主键

假设我们环境中的一个真实场景:采购部门需要分析基于“最终供应商”的指标,但标准收货表仅记录物流供应商

我们将把该字段注入到表 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)。>