Ir al contenido

Rozširovanie tabuliek (TableExtension)

Vytvorenie rozšírení na úrovni databáze pre injektovanie nových fyzických polí a úpravu správania ERP.

0lecturas

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.

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 50000 do 99999).
  • Co můžeme dělat: Přidávat nová pole, přidávat nové klíče (keys), upravovat určité vlastnosti standardních polí (jako Caption).
  • Co nemůžeme dělat: Odstranit standardní pole, změnit typ dat standardního pole nebo odstranit standardní primární klíče.

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")
{
}
}
}

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 DataClassification ve 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.