Tabellen Uitbreiden (TableExtension)
Creatie van extensies op database-niveau om nieuwe fysieke velden te injecteren en het gedrag van het ERP aan te passen.
Het principe van moderne ontwikkeling in Cloud-ecosystemen is niet-intrusie. We hebben geen toegang tot de originele C/AL-code van Microsoft, en dat willen we ook niet (dat zou automatische updates verstoren).
Om de database te wijzigen, gebruiken we het object tableextension. Op SQL-motorniveau creëert Business Central op de achtergrond een nieuwe aanvullende tabel met ons voorvoegsel, en het systeem orkestreert automatisch een transparante JOIN (1-op-1) telkens wanneer een record wordt gelezen of geschreven.
1. Regels en beperkingen van het object
Sección titulada «1. Reglas y Limitaciones del Objeto»Voordat we gaan programmeren, moeten we de beveiligings- en ontwerprichtlijnen kennen:
- Ontwikkelings-ID's: We moeten de bereiken gebruiken die zijn toegewezen aan onze klantlicentie (normaal gesproken van
50000tot99999). - Wat we WEL kunnen doen: Nieuwe velden toevoegen, nieuwe sleutels toevoegen (
keys), bepaalde eigenschappen van standaardvelden wijzigen (zoals deCaption). - Wat we NIET kunnen doen: Standaardvelden verwijderen, het datatype van een standaardveld wijzigen, of standaard primaire sleutels verwijderen.
2. Ontwikkeling: Structuur van een tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Stel je een reëel scenario uit onze omgeving voor: De inkoopafdeling wil statistieken analyseren op basis van de "Eindleverancier" van de goederen, maar de standaard ontvangsttabel registreert alleen de logistieke distributeur.
We gaan het veld injecteren in tabel 121 (Purch. Rcpt. Line).
Bestandsnaam: 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. Het onmiddellijke effect (en wat er nog ontbreekt)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»Zodra we deze code opslaan en een deployment naar de Sandbox uitvoeren (door op F5 of Ctrl+F5 te drukken in VS Code), wijzigt de SQL Server-engine het fysieke schema.
Vanaf dat moment:
- Het veld
"Proveedor Final"bestaat. - Het neemt schijfruimte in beslag.
- Het kan onmiddellijk worden geconsumeerd door onze API's (Objecten
Query). - Het kan worden gebruikt door elke andere code-logica-extensie (Codeunits).
⚠️ De Clandestiene Data: Werknemers die de webinterface van Business Central gebruiken, kunnen dit echter NIET zien of bewerken. Fysiek is het aanwezig, maar visueel niet. Om het aan gebruikers te tonen, moeten we verplicht een extensie van de visuele interface maken (
pageextension).
4. Checklist voor validatie en implementatie
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ SQL-schema: Succesvolle schema-update in Azure SQL/SQL Server via automatische synchronisatie van de NST.
- ✓ AVG-naleving: Expliciete gegevensclassificatie
DataClassificationin alle nieuwe velden. - ✓ Prestaties: Creatie van secundaire sleutels (
keys) voor geïndexeerde velden voor massa-extractie in ETL/Power BI.>

