Ir al contenido

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.

0čtení

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.

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

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

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