Ir al contenido

Erweitern von Tabellen (TableExtension)

Erstellung von Erweiterungen auf Datenbankebene, um neue physische Felder einzufügen und das Verhalten des ERP zu modifizieren.

0Lesungen

Das Prinzip der modernen Entwicklung in Cloud-Ökosystemen ist die Nicht-Invasivität. Wir haben keinen Zugriff auf den ursprünglichen C/AL-Code von Microsoft und wollen diesen auch nicht (das würde automatische Updates beeinträchtigen).

Um die Datenbank zu ändern, verwenden wir das Objekt tableextension. Auf SQL-Engine-Ebene erstellt Business Central im Hintergrund eine neue ergänzende Tabelle mit unserem Präfix, und das System orchestriert automatisch einen transparenten JOIN (1:1), wann immer ein Datensatz gelesen oder geschrieben wird.

1. Regeln und Einschränkungen des Objekts

Sección titulada «1. Reglas y Limitaciones del Objeto»

Vor dem Programmieren müssen wir die Sicherheits- und Designrichtlinien kennen:

  • Entwicklungs-IDs: Wir müssen die unserer Kundenlizenz zugewiesenen Bereiche verwenden (normalerweise von 50000 bis 99999).
  • Was wir TUN können: Neue Felder hinzufügen, neue Schlüssel (keys) hinzufügen, bestimmte Eigenschaften von Standardfeldern ändern (wie Caption).
  • Was wir NICHT tun können: Standardfelder löschen, den Datentyp eines Standardfelds ändern oder Standard-Primärschlüssel löschen.

Nehmen wir ein reales Szenario aus unserer Umgebung an: Die Einkaufsabteilung muss Metriken basierend auf dem „Endlieferanten“ der Ware analysieren, aber die Standard-Wareneingangstabelle erfasst nur den Logistikverteiler.

Wir werden das Feld in die Tabelle 121 (Purch. Rcpt. Line) injizieren.

Dateiname: 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. Die unmittelbare Auswirkung (und was noch fehlt)

Sección titulada «3. El Efecto Inmediato (Y lo que falta)»

Sobald wir diesen Code speichern und ein Deployment in die Sandbox durchführen (durch Drücken von F5 oder Ctrl+F5 in VS Code), ändert die SQL Server-Engine das physische Schema.

Ab dieser Sekunde:

  • Das Feld "Proveedor Final" existiert.
  • Es belegt Speicherplatz auf der Festplatte.
  • Kann sofort von unseren APIs konsumiert werden (Objekte Query).
  • Es kann von jeder anderen Code-Logik-Erweiterung (Codeunits) verwendet werden.

⚠️ Der versteckte Datensatz: Benutzer, die die Web-Schnittstelle von Business Central verwenden, können ihn jedoch weder sehen noch bearbeiten. Physisch ist er vorhanden, aber visuell nicht. Um ihn den Benutzern zugänglich zu machen, müssen wir zwingend eine Erweiterung der visuellen Benutzeroberfläche (pageextension) erstellen.

4. Checkliste für Validierung und Bereitstellung

Sección titulada «4. Checklist de Validación y Despliegue»
  • ✓ SQL-Schema: Erfolgreiche Aktualisierung des Schemas in Azure SQL/SQL Server durch automatische NST-Synchronisierung.
  • ✓ DSGVO-Konformität: Explizite DataClassification Datenklassifizierung in allen neuen Feldern.
  • ✓ Performance: Erstellung von Sekundärschlüsseln (keys) für indizierte Felder zur Massenextraktion in ETL/Power BI.>