Rozširovanie tabuliek (TableExtension)
Vytvorenie rozšírení na úrovni databáze pre injektovanie nových fyzických polí a úpravu správania ERP.
Zásada moderného vývoja v cloudových ekosystémoch je nezasahovanie. Nemáme prístup k pôvodnému kódu C/AL spoločnosti Microsoft a nechceme ho mať (automatické aktualizácie by boli narušené).
Pro úpravu databáze používáme objekt tableextension. Na úrovni motoru SQL vytváří Business Central za námi novou doplňkovou tabulku s naším předponou, a systém automaticky orchestrates transparentní JOIN (1:1) pokaždé, když je čten nebo zapsán záznam.
1. Pravidlá a obmedzenia objektu
Sección titulada «1. Reglas y Limitaciones del Objeto»Pred programovaním musíme poznať bezpečnostné a dizajnové smernice:
- ID vývoje: Musíme používat rozsahy přidělené naší klientské licenci (obvykle od
50000do99999). - Co můžeme dělat: Přidávat nová pole, přidávat nové klíče (
keys), upravovat určité vlastnosti standardních polí (jakoCaption). - Co nemůžeme dělat: Odstranit standardní pole, změnit typ dat standardního pole nebo odstranit standardní primární klíče.
2. Vývoj: Struktura tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Predpokladajme reálny scenár z nášho prostredia: Oddelenie nákupu vyžaduje analýzu metrík založených na „Konečnom dodávateľovi“ tovaru, ale štandardná tabuľka štandardných príjmov zaznamenáva len logistického distribútora.
Budeme injektovat pole do tabulky 121 (Purch. Rcpt. Line).
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 čo ešte chýba)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»V okamžiku, kdy uložíme tento kód a provedeme nasazení do Sandboxu (stisknutím F5 nebo Ctrl+F5 v VS Code), motor SQL Server změní fyzické schéma.
Od tohto okamihu:
- Pole
"Proveedor Final"existuje. - Zaberá miesto na disku.
- Může být okamžitě spotřebováno našimi API (objekty
Query). - Môže byť použitý ľubovoľným iným rozšírením logiky kódu (Codeunits).
⚠️ Skrytá data: Nicméně uživatelé, kteří používají webové rozhraní Business Central, nemohou vidět nebo upravit tato pole. Fyzicky tam jsou, ale vizuálně ne. Chcete-li je zobrazit uživatelům, musíme povinně vytvořit rozšíření vizuálního rozhraní (
pageextension).
4. Kontrolný zoznam validácie a nasadenia
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ Schéma SQL: Úspěšná aktualizace schématu v Azure SQL/SQL Server prostřednictvím automatické synchronizace NST.
- ✓ Splnění GDPR: Explicitní klasifikace dat
DataClassificationve všech nových polích. - ✓ Výkon: Vytvoření sekundárních klíčů (
keys) pro indexovaná pole hromadného extrahování v ETL/Power BI.

