Rozšiřování tabulek (TableExtension)
Vytváření rozšíření na úrovni databáze pro vkládání nových fyzických polí a úpravu chování ERP.
Principem moderního vývoje v cloudových ekosystémech je nezasahování. Nemáme přístup k původnímu C/AL kódu od Microsoftu a ani ho nechceme (narušilo by to automatické aktualizace).
Pro změnu databáze používáme objekt tableextension. Na úrovni SQL motoru Business Central vytváří novou doplňkovou tabulku s naším prefixem a systém automaticky orchestrates transparentní JOIN (1:1) pokaždé, když je záznam čten nebo zapsán.
1. Pravidla a omezení objektu
Sección titulada «1. Reglas y Limitaciones del Objeto»Před programováním musíme znát bezpečnostní a designové směrnice:
- ID vývoje: Musíme použít rozsahy přidělené naší klientské licenci (obvykle od
50000do99999). - Co můžeme udělat: Přidat nová pole, přidat nové klíče (
keys), upravit určité vlastnosti standardních polí (jakoCaption). - Co nemůžeme udělat: Smazat standardní pole, změnit typ dat standardního pole nebo smazat standardní primární klíče.
2. Vývoj: Struktura tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Představme si reálný scénář z našeho prostředí: Oddělení nákupu potřebuje analyzovat metriky na základě „Konečného dodavatele“ zboží, ale standardní tabulka příjmů zaznamenává pouze logistického distributora.
Pole do tabulky 121 (Purch. Rcpt. Line) nainjektujeme.
Název souboru: 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. Okamžitý efekt (A co chybí)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»Jakmile tento kód uložíme a provedeme nasazení do Sandboxu (stisknutím F5 nebo Ctrl+F5 ve VS Code), motor SQL Server změní fyzický schéma.
Od této sekundy:
- Pole
"Proveedor Final"existuje. - Zabírá místo na disku.
- Může být okamžitě využito našimi API (objekty
Query). - Může být použito jakýmkoli jiným rozšířením logiky kódu (Codeunits).
⚠️ Skrytý údaj: Pracovníci používající webové rozhraní Business Central jej však nevidí ani nemohou upravovat. Fyzicky zde je, ale vizuálně nikoliv. Aby byl uživatelům zpřístupněn, musíme povinně vytvořit rozšíření vizuálního rozhraní (
pageextension).
4. Kontrolní seznam pro validaci a nasazení
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ SQL schéma: Úspěšná aktualizace schématu v Azure SQL/SQL Server prostřednictvím automatické synchronizace NST.
- ✓ Soulad s GDPR: Explicitní klasifikace dat
DataClassificationve všech nových polích. - ✓ Výkon: Vytvoření sekundárních klíčů (
keys) pro indexovaná pole pro hromadný export v ETL/Power BI.>

