Ir al contenido

Estensione delle tabelle (TableExtension)

Creazione di estensioni a livello di database per iniettare nuovi campi fisici e modificare il comportamento dell'ERP.

0letture

Il principio dello sviluppo moderno negli ecosistemi Cloud è la non intrusione. Non abbiamo accesso al codice C/AL originale di Microsoft, né vogliamo averlo (interromperebbe gli aggiornamenti automatici).

Per alterare il database, utilizziamo l'oggetto tableextension. A livello di motore SQL, ciò che Business Central fa in background è creare una nuova tabella supplementare con il nostro prefisso, e il sistema orchestra automaticamente un JOIN trasparente (1 a 1) ogni volta che viene letto o scritto un record.

Prima di programmare, dobbiamo conoscere le linee guida di sicurezza e design:

  • ID di sviluppo: Dobbiamo utilizzare gli intervalli assegnati alla nostra licenza cliente (normalmente da 50000 a 99999).
  • Cosa POSSIAMO fare: Aggiungere nuovi campi, aggiungere nuove chiavi (keys), modificare determinate proprietà dei campi standard (come Caption).
  • Cosa NON possiamo fare: Eliminare i campi standard, cambiare il tipo di dati di un campo standard o eliminare le chiavi primarie standard.

Supponiamo uno scenario reale del nostro ambiente: Il dipartimento acquisti richiede di analizzare metriche basate sul “Fornitore Finale” della merce, ma la tabella delle ricezioni standard registra solo il distributore logistico.

Andiamo a iniettare il campo nella tabella 121 (Purch. Rcpt. Line).

Nome del file: 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. L'Effetto Immediato (E ciò che manca)

Sección titulada «3. El Efecto Inmediato (Y lo que falta)»

Nel momento in cui salviamo questo codice e effettuiamo un deployment nel Sandbox (premendo F5 o Ctrl+F5 in VS Code), il motore SQL Server altera lo schema fisico.

Da quel secondo in poi:

  • Il campo "Proveedor Final" esiste.
  • Occupa spazio su disco.
  • Può essere consumato immediatamente dalle nostre API (Oggetti Query).
  • Può essere utilizzato da qualsiasi altra estensione di logica di codice (Codeunits).

⚠️ Il Dato Clandestino: Tuttavia, gli utenti che utilizzano l'interfaccia web di Business Central NON possono vederlo né modificarlo. Fisicamente è presente, ma non visivamente. Per esporlo agli utenti, dobbiamo necessariamente creare un'estensione dell'interfaccia visiva (pageextension).

  • ✓ Schema SQL: Aggiornamento riuscito dello schema in Azure SQL/SQL Server tramite sincronizzazione automatica dell'NST.
  • ✓ Conformità GDPR: Classificazione esplicita dei dati DataClassification in tutti i nuovi campi.
  • ✓ Prestazioni: Creazione di chiavi secondarie (keys) per campi indicizzati di estrazione massiva in ETL/Power BI.>