Estensione delle tabelle (TableExtension)
Creazione di estensioni a livello di database per iniettare nuovi campi fisici e modificare il comportamento dell'ERP.
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.
1. Regole e Limitazioni dell'Oggetto
Sección titulada «1. Reglas y Limitaciones del Objeto»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
50000a99999). - Cosa POSSIAMO fare: Aggiungere nuovi campi, aggiungere nuove chiavi (
keys), modificare determinate proprietà dei campi standard (comeCaption). - Cosa NON possiamo fare: Eliminare i campi standard, cambiare il tipo di dati di un campo standard o eliminare le chiavi primarie standard.
2. Sviluppo: Struttura di un tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»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).
4. Checklist di Convalida e Distribuzione
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ Schema SQL: Aggiornamento riuscito dello schema in Azure SQL/SQL Server tramite sincronizzazione automatica dell'NST.
- ✓ Conformità GDPR: Classificazione esplicita dei dati
DataClassificationin tutti i nuovi campi. - ✓ Prestazioni: Creazione di chiavi secondarie (
keys) per campi indicizzati di estrazione massiva in ETL/Power BI.>

