Ir al contenido

Extendiendo Tablas (TableExtension)

Criação de extensões a nível de base de dados para injetar novos campos físicos e modificar o comportamento do ERP.

0lecturas

O princípio de desenvolvimento moderno em ecossistemas Cloud é a não intrusão. Não temos acesso ao código C/AL original da Microsoft, nem queremos ter (quebraria as atualizações automáticas).

Para alterar a base de dados, nós usamos o objeto tableextension. A nível do motor SQL, o que o Business Central faz por trás é criar uma nova tabela suplementária com nosso prefijo, e o sistema orquestra automaticamente um JOIN transparente (1 a 1) cada vez que se lê ou é escrito um registro.

Antes de programar, devemos conhecer as diretrizes de segurança e design:

  • IDs de Desarrollo: Debemos usar los rangos asignados a nuestra licencia de cliente (normalmente del 50000 al 99999).
  • Lo que SÍ podemos hacer: Añadir campos nuevos, añadir nuevas claves (keys), modificar ciertas propiedades de campos estándar (como el Caption).
  • Lo que NO podemos hacer: Eliminar campos estándar, cambiar el tipo de dato de un campo estándar, o eliminar claves primarias estándar.

2. Desarrollo: Estructura de un tableextension

Sección titulada «2. Desarrollo: Estructura de un tableextension»

Suponhamos um cenário real do nosso ambiente: O departamento de compras requer analisar métricas baseadas no “Fornecedor Final” da mercadoria, mas a tabela de recebimentos padrão registra apenas o distribuidor logístico.

Vamos a inyectar el campo en la tabla 121 (Purch. Rcpt. Line).

Nombre del archivo: 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")
{
}
}
}

En el momento en que guardamos este código y hacemos un despliegue al Sandbox (pulsando F5 o Ctrl+F5 en VS Code), el motor SQL Server altera el esquema físico.

A partir desse segundo:

  • El campo "Proveedor Final" existe.
  • Ocupa espaço em disco.
  • Puede ser consumido inmediatamente por nuestras APIs (Objetos Query).
  • Pode ser utilizado por qualquer outra extensão de lógica de código (Codeunits).

⚠️ O Dado Clandestino: No entanto, os trabalhadores que utilizam a interface web do Business Central NO podem vê-lo nem editá-lo. Físicamente está lá, mas visualmente não. Para expô-lo aos usuários, devemos criar obrigatoriamente uma extensão da interface visual (pageextension).

4. Checklist de Validação e Implantação

Sección titulada «4. Checklist de Validación y Despliegue»
  • ✓ Esquema SQL: Actualización exitosa del esquema en Azure SQL/SQL Server mediante sincronización automática del NST.
  • ✓ Cumplimiento GDPR: Clasificación de datos DataClassification explícita en todos los campos nuevos.
  • ✓ Rendimiento: Creación de claves secundarias (keys) para campos indexados de extracción masiva en ETL/Power BI.