Rozszerzanie tabel (TableExtension)
Tworzenie rozszerzeń na poziomie bazy danych, aby wstrzykiwać nowe pola fizyczne i modyfikować zachowanie ERP.
Zasada nowoczesnego rozwoju w ekosystemach chmury to brak ingerencji. Nie mamy dostępu do oryginalnego kodu C/AL firmy Microsoft i nie chcemy go mieć (co mogłoby zakłócić automatyczne aktualizacje).
Aby zmienić bazę danych, używamy obiektu tableextension. Na poziomie silnika SQL, to co Business Central robi za nas jest tworzeniem nowej tabeli pomocniczej z naszym prefiksem, a system automatycznie orkiestruje przezroczyste mapowanie (1 do 1) za każdym razem, gdy odczytujemy lub zapisujemy rekord.
1. Zasady i ograniczenia obiektu
Sección titulada «1. Reglas y Limitaciones del Objeto»Przed programowaniem musimy znać wytyczne dotyczące bezpieczeństwa i projektowania:
- ID rozwoju: Musimy używać zakresów przypisanych do naszej licencji klienta (zwykle od
50000do99999). - Co możemy zrobić: Możemy dodać nowe pola, dodać nowe klucze (
keys), zmodyfikować pewne właściwości pól standardowych (takie jakCaption). - Co nie możemy zrobić: Nie możemy usunąć pól standardowych, zmienić typu danych pola standardowego, ani usunąć standardowych kluczy podstawowych.
2. Rozwój: Struktura tableextension
Sección titulada «2. Desarrollo: Estructura de un tableextension»Załóżmy scenariusz z naszego otoczenia: Dział zakupów wymaga analizy metryk opartych na "Końcowym Dostawcy" towaru, ale tabela standardowych odbiorów rejestruje tylko logistycznego dystrybutora.
Wstrzykniemy pole do tabeli 121 (Purch. Rcpt. Line).
Nazwa pliku: 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. Natychmiastowy efekt (i to, czego brakuje)
Sección titulada «3. El Efecto Inmediato (Y lo que falta)»W momencie, gdy zapisujemy ten kod i wdrażamy go w Sandbox (klikając F5 lub Ctrl+F5 w VS Code), silnik SQL Server modyfikuje fizyczny schemat.
Od tej sekundy:
- Pole
"Proveedor Final"istnieje. - Zajmuje miejsce na dysku.
- Może być używany natychmiast przez nasze API (obiekty
Query). - Może być wykorzystane przez dowolne inne rozszerzenie logiki kodu (Codeunits).
⚠️ Dane Ukryte: Jednak pracownicy, którzy korzystają z interfejsu webowego Business Central nigdy nie mogą ich zobaczyć ani edytować. Fizycznie są one tam, ale wizualnie nie. Aby je udostępnić użytkownikom, musimy obligatoryjnie utworzyć rozszerzenie interfejsu wizualnego (
pageextension).
4. Lista kontrolna walidacji i wdrożenia
Sección titulada «4. Checklist de Validación y Despliegue»- ✓ Schemat SQL: Pomyślna aktualizacja schematu w Azure SQL/SQL Server za pomocą automatycznej synchronizacji NST.
- ✓ Zgodność z RODO: Jawna klasyfikacja danych
DataClassificationwe wszystkich nowych polach. - ✓ Wydajność: Tworzenie kluczy wtórnych (
keys) dla pól indeksowanych w ETL/Power BI.

