Zum Inhalt springen
Von C/AL zu AL: der Kurs für NAV-EntwicklerEin Kurs der decoso GmbH & Co. KGErstgespräch
Kursübersicht › Seite 3 von 11

Tabellen und Datentypen

Tabellen und Table Extensions in AL, Datentypen, Schlüssel und Trigger im Vergleich zu NAV 2017. Mit Übung an der Beispiel-App.

Stand November 2026 · Version 29

Autor: Elvis Schmidt, decoso GmbH & Co. KG

Lernziele dieser Seite. Du kannst danach eigene Tabellen in AL schreiben, Standardtabellen mit einer Table Extension erweitern, Enums statt Optionen einsetzen, FlowFields und Schlüssel definieren und weißt, welche Schemaänderungen nach einer Auslieferung noch erlaubt sind. Am Ende steht eine Übung, die das Beispiel von Seite 2 zu einer kleinen Besuchsverwaltung ausbaut.

1Eine Tabelle, alt und neu

Das Tabellenobjekt ist inhaltlich dasselbe geblieben: Felder, Schlüssel, Feldgruppen, Trigger. Geändert hat sich die Schreibweise.

NAV 2017, Textexport (gekürzt)
OBJECT Table 50000 Customer Visit
{
  OBJECT-PROPERTIES
  {
    Date=01.03.17;
    Time=12:00:00;
    Modified=Yes;
    Version List=ABC1.00;
  }
  PROPERTIES
  {
    CaptionML=[DEU=Kundenbesuch;
               ENU=Customer Visit];
    LookupPageID=Page50000;
  }
  FIELDS
  {
    { 1 ; ;Entry No.    ;Integer ;
        AutoIncrement=Yes;
        CaptionML=[DEU=Lfd. Nr.;
                   ENU=Entry No.] }
    { 2 ; ;Customer No. ;Code20  ;
        TableRelation=Customer;
        CaptionML=[DEU=Debitorennr.;
                   ENU=Customer No.] }
    { 5 ; ;Visit Type   ;Option  ;
        CaptionML=[DEU=Besuchsart;
                   ENU=Visit Type];
        OptionCaptionML=[
          DEU=Vor Ort,Telefon,Messe;
          ENU=On Site,Phone,Trade Show];
        OptionString=On Site,Phone,Trade Show }
  }
  KEYS
  {
    { ;Entry No. ;Clustered=Yes }
    { ;Customer No.,Visit Date }
  }
  FIELDGROUPS
  {
  }
  CODE
  {
    BEGIN
    END.
  }
}
Business Central, AL (gekürzt)
table 50100 "ABC Customer Visit"
{
    Caption = 'Customer Visit';
    DataClassification = CustomerContent;

    fields
    {
        field(1; "Entry No."; Integer)
        {
            Caption = 'Entry No.';
            AutoIncrement = true;
        }
        field(2; "Customer No."; Code[20])
        {
            Caption = 'Customer No.';
            TableRelation = Customer;
        }
        field(5; "Visit Type"; Enum "ABC Visit Type")
        {
            Caption = 'Visit Type';
        }
    }

    keys
    {
        key(PK; "Entry No.")
        {
            Clustered = true;
        }
        key(CustomerDate; "Customer No.", "Visit Date")
        {
        }
    }
}

Was sich geändert hat:

  • Captions stehen nur noch auf Englisch im Code, die Übersetzung liegt in der XLIFF-Datei (Seite 4).
  • Option wird zu einem eigenen Objekt vom Typ enum (Abschnitt 6).
  • Schlüssel haben Namen (PK, CustomerDate). Der erste Schlüssel ist der Primärschlüssel.
  • DataClassification ist neu und Pflicht. Auf Tabellenebene gesetzt, gilt sie für alle Felder.
  • Verweise auf Objekte erfolgen über Namen, nicht über Nummern (TableRelation = Customer, LookupPageId = "ABC Customer Visits").
  • Feldnummern in eigenen Tabellen sind frei wählbar (1, 2, 3 …). Nur die Objekt-ID muss im Bereich der app.json liegen.

2Tabelleneigenschaften

EigenschaftBedeutungHinweis für Umsteiger
CaptionAnzeigename, englisch.Ersetzt CaptionML.
DataClassificationDatenschutzklasse für alle Felder.Neu. Meist CustomerContent.
LookupPageId, DrillDownPageIdSeite für Nachschlagen und Drilldown.Wie früher, aber mit Seitennamen.
DataCaptionFieldsFelder, die in der Titelzeile von Karten erscheinen.Unverändert.
DataPerCompanyfalse = Daten gelten für alle Mandanten.Unverändert. Nachträglich nicht änderbar.
TableTypeNormal oder Temporary, daneben Typen für externe Datenquellen (z. B. Dataverse).Temporary ist neu: Die Tabelle existiert nie in der Datenbank (Abschnitt 11).
Extensiblefalse verbietet anderen Apps, die Tabelle zu erweitern.Neu. Standard ist true.
AccessPublic oder Internal. Interne Tabellen sind für andere Apps unsichtbar.Neu. Wichtig, wenn andere Apps auf deiner aufbauen.
PermissionsRechte, die der Code der Tabelle auf andere Tabellen braucht.Unverändert, neue Schreibweise: Permissions = tabledata Customer = rm;
ReplicateDataSteuert die Übernahme bei Cloud-Migration und Datenreplikation.Selten nötig.
ObsoleteState, ObsoleteReason, ObsoleteTagMarkiert die Tabelle als veraltet.Neu, siehe Abschnitt 12.

3Datentypen für Tabellenfelder

TypSchreibweiseWas sich gegenüber NAV 2017 geändert hat
CodeCode[20]Maximallänge 2048 statt 250.
TextText[100]Maximallänge 2048 statt 250. Textvariablen ohne Längenangabe sind unbegrenzt, Tabellenfelder brauchen immer eine Länge.
Integer, BigInteger, Decimal, BooleanInteger …Unverändert.
Date, Time, DateTime, Duration, DateFormulaDate …Unverändert. DateTime wird weiterhin in UTC gespeichert.
OptionOption mit OptionMembersGibt es noch, aber für neue Felder nimmt man Enum.
EnumEnum "ABC Visit Type"Neu. Eigenes Objekt, erweiterbar, in der Datenbank weiterhin eine Ganzzahl.
GuidGuidUnverändert, wird häufiger gebraucht (SystemId, APIs).
BlobBlobWeiterhin für große Texte und Binärdaten. Zugriff nur über Streams (Seite 6).
Media, MediaSetMedia, MediaSetGab es in NAV 2017 schon, ist heute der Standard für Bilder. Der Web-Client zeigt sie direkt an, die Daten liegen außerhalb des Datensatzes.
RecordId, TableFilterRecordId …Unverändert.

Typen wie List, Dictionary, JsonObject oder TextBuilder gibt es nur als Variablen, nicht als Tabellenfelder. Sie sind Thema von Seite 6.

Achtung, Standardfelder sind länger geworden. Viele Felder der Base Application wurden seit NAV 2017 verlängert, zum Beispiel Name und Beschreibung von 50 auf 100 Zeichen. Wenn du alten Code übernimmst, der solche Werte in Text[50]-Variablen oder -Felder kopiert, gibt es Überlauffehler zur Laufzeit. Der sichere Weg ist, die Länge des eigenen Feldes am Standardfeld auszurichten und per F12 nachzusehen, wie lang es heute ist.

4Feldeigenschaften

Fast alle Eigenschaften aus C/SIDE gibt es weiter, mit denselben Namen. Die Werte schreibt man als true/false statt Yes/No.

EigenschaftBedeutung
CaptionAnzeigename. Ohne Caption wird der Feldname verwendet und nicht übersetzt.
DataClassificationÜberschreibt die Angabe der Tabelle für dieses Feld.
TableRelation, ValidateTableRelationVerknüpfung mit Prüfung und Nachschlagen.
FieldClass, CalcFormulaNormal, FlowField oder FlowFilter (Abschnitt 8).
Editable, NotBlank, InitValue, MinValue, MaxValueWie früher.
DecimalPlaces, AutoFormatType, AutoFormatExpression, BlankZeroFormatierung von Zahlen und Beträgen.
AutoIncrementAutomatische Zählung durch die Datenbank. Bei Abbruch der Transaktion entstehen Lücken, also nicht für lückenlose Nummern verwenden.
ExtendedDatatypeEMail, URL, PhoneNo, Masked usw. Der Client macht daraus Links oder verdeckt die Eingabe.
OptionMembers, OptionCaptionNur für Option-Felder. OptionMembers ersetzt OptionString.
ToolTipIn neueren Versionen kann der ToolTip schon am Tabellenfeld stehen und gilt dann für alle Seiten.
AccessSichtbarkeit des Feldes für andere Apps (Public, Internal, Local, Protected).
ObsoleteState …Markiert das Feld als veraltet (Abschnitt 12).

TableRelation mit Bedingungen

field(10; "No."; Code[20])
{
    Caption = 'No.';
    TableRelation = if (Type = const(Item)) Item
                    else if (Type = const(Resource)) Resource
                    else if (Type = const("G/L Account")) "G/L Account" where("Direct Posting" = const(true));
}

Die Logik ist dieselbe wie früher, nur klein geschrieben und mit runden Klammern um die Bedingung.

5Systemfelder: Jede Tabelle hat sie automatisch

Die Plattform fügt jeder Tabelle Felder hinzu, die du nicht selbst deklarierst.

FeldTypInhalt
SystemIdGuidUnveränderliche, eindeutige Kennung des Datensatzes. Bleibt auch beim Umbenennen gleich.
SystemCreatedAt, SystemCreatedByDateTime, GuidZeitpunkt und Benutzer der Anlage.
SystemModifiedAt, SystemModifiedByDateTime, GuidZeitpunkt und Benutzer der letzten Änderung.
SystemRowVersionBigIntegerZähler, der bei jeder Änderung steigt. Nützlich für Delta-Abgleiche mit externen Systemen.
// Datensatz über die SystemId holen, z. B. in einer Schnittstelle
if Customer.GetBySystemId(CustomerId) then
    ...

// Alle seit gestern geänderten Debitoren
Customer.SetFilter(SystemModifiedAt, '>=%1', CreateDateTime(Today() - 1, 0T));

Eigene Felder wie „Angelegt am“ oder „Geändert von“, die du in NAV 2017 in jede Tabelle eingebaut hast, sind damit meist überflüssig. Die Benutzerfelder enthalten die Sicherheits-ID des Benutzers, den Namen holst du aus der Tabelle User.

6Enum statt Option

Eine Option war in NAV 2017 fest in das Feld eingebaut. Wer einen Wert ergänzen wollte, musste das Feld und jede Variable, jeden Parameter und jede Seite mit derselben Optionsliste ändern. Ein Enum ist ein eigenes Objekt, das an einer Stelle definiert und überall verwendet wird.

enum 50101 "ABC Visit Type"
{
    Extensible = true;
    Caption = 'Visit Type';

    value(0; "On Site")
    {
        Caption = 'On Site';
    }
    value(1; Phone)
    {
        Caption = 'Phone';
    }
    value(2; "Trade Show")
    {
        Caption = 'Trade Show';
    }
}
  • Die Zahl vor dem Namen ist der Ordinalwert, der in der Datenbank steht. Er muss nicht lückenlos sein.
  • Extensible = true erlaubt anderen Apps, Werte hinzuzufügen. Der Standardwert ist false.
  • Vergebene Ordinalwerte darfst du später nicht mehr ändern oder neu belegen, sonst bedeuten gespeicherte Daten plötzlich etwas anderes.

Ein Enum erweitern

Eine andere App (oder deine eigene bei einem Standard-Enum) fügt Werte so hinzu:

enumextension 50200 "XYZ Visit Type Ext" extends "ABC Visit Type"
{
    value(50200; "XYZ Video Call")
    {
        Caption = 'Video Call';
    }
}

Der Ordinalwert des neuen Eintrags sollte im ID-Bereich der erweiternden App liegen, damit zwei Erweiterungen nicht denselben Wert belegen. Viele Standard-Enums sind erweiterbar, aber nicht alle. Ob eines erweiterbar ist, siehst du mit F12 an der Eigenschaft Extensible.

Mit Enums arbeiten

var
    Visit: Record "ABC Customer Visit";
    VisitType: Enum "ABC Visit Type";
    i: Integer;
begin
    // Zuweisen und vergleichen
    Visit."Visit Type" := Visit."Visit Type"::Phone;
    VisitType := Enum::"ABC Visit Type"::"Trade Show";
    if Visit."Visit Type" = VisitType then
        ...

    // Umwandeln
    i := VisitType.AsInteger();                          // 2
    VisitType := Enum::"ABC Visit Type".FromInteger(1);  // Phone
    Message(Format(VisitType));                          // Caption in der Sprache des Benutzers

    // Alle Werte durchlaufen, auch die aus Erweiterungen
    foreach i in Enum::"ABC Visit Type".Ordinals() do
        ...
end;
Folge der Erweiterbarkeit. Bei einem erweiterbaren Enum kennst du nie alle Werte. Ein case ohne else-Zweig ignoriert fremde Werte stillschweigend. Schreibe immer einen else-Zweig, der entweder sinnvoll reagiert oder einen Fehler meldet. Die saubere Lösung für unterschiedliches Verhalten je Wert sind Interfaces (Seite 5).

Bestehende Option in ein Enum umwandeln

Ein Option-Feld lässt sich ohne Datenverlust auf ein Enum umstellen, wenn die Ordinalwerte des Enums genau den Positionen der alten Optionsliste entsprechen (erste Option = 0, zweite = 1 usw.). In der Datenbank steht in beiden Fällen dieselbe Ganzzahl. Microsoft hat auf diese Weise fast alle Optionen der Base Application umgestellt, weshalb du in altem Code oft auf Typkonflikte zwischen Option-Variablen und Enum-Feldern stößt. Die Lösung ist, die Variable ebenfalls als Enum zu deklarieren.

7Schlüssel und Feldgruppen

keys
{
    key(PK; "Entry No.")
    {
        Clustered = true;
    }
    key(CustomerDate; "Customer No.", "Visit Date")
    {
        SumIndexFields = "Duration (Minutes)";
    }
    key(ExternalRef; "External Reference")
    {
        Unique = true;
    }
}

fieldgroups
{
    fieldgroup(DropDown; "Entry No.", "Customer No.", "Visit Date", "Visit Type")
    {
    }
    fieldgroup(Brick; "Customer No.", "Visit Date", Description)
    {
    }
}
ElementBedeutung
Erster SchlüsselPrimärschlüssel. Nach der Auslieferung nicht mehr änderbar.
ClusteredPhysische Sortierung in der Datenbank, fast immer der Primärschlüssel.
SumIndexFields, MaintainSiftIndexSIFT wie früher, für schnelle Summen in FlowFields.
UniqueErzwingt Eindeutigkeit auch bei einem Sekundärschlüssel. Neu.
IncludedFieldsZusätzliche Spalten im Index, die nicht zur Sortierung gehören. Neu, für Performance-Optimierung.
EnabledSchlüssel abschalten, ohne ihn zu löschen.
Feldgruppe DropDownSpalten in der Nachschlageliste von Feldern, die auf diese Tabelle verweisen.
Feldgruppe BrickFelder in der Kachelansicht von Listen, vor allem auf dem Telefon.

Im Code sprichst du Schlüssel wie früher über die Felder an: Visit.SetCurrentKey("Customer No.", "Visit Date");. Der Schlüsselname dient nur der Deklaration.

8FlowFields und FlowFilter

field(3; "Customer Name"; Text[100])
{
    Caption = 'Customer Name';
    FieldClass = FlowField;
    CalcFormula = lookup(Customer.Name where("No." = field("Customer No.")));
    Editable = false;
}
field(20; "Date Filter"; Date)
{
    Caption = 'Date Filter';
    FieldClass = FlowFilter;
}
field(21; "Total Duration (Minutes)"; Integer)
{
    Caption = 'Total Duration (Minutes)';
    FieldClass = FlowField;
    CalcFormula = sum("ABC Customer Visit"."Duration (Minutes)"
                      where("Customer No." = field("Customer No."),
                            "Visit Date" = field("Date Filter")));
    Editable = false;
}

Die Methoden sind dieselben: sum, count, exist, lookup, min, max, average. Im Code brauchst du weiterhin CalcFields bzw. SetAutoCalcFields. Auf Seiten berechnet der Client FlowFields automatisch.

9Trigger und Funktionen in Tabellen

trigger OnInsert()
begin
    TestField("Customer No.");
    if "Visit Date" = 0D then
        "Visit Date" := WorkDate();
    UpdateLastVisit();
end;

trigger OnModify()
begin
    UpdateLastVisit();
end;

local procedure UpdateLastVisit()
var
    Customer: Record Customer;
begin
    if not Customer.Get("Customer No.") then
        exit;
    if "Visit Date" <= Customer."ABC Letzter Besuch" then
        exit;
    Customer."ABC Letzter Besuch" := "Visit Date";
    Customer.Modify();
end;
  • OnInsert, OnModify, OnDelete, OnRename sowie OnValidate und OnLookup am Feld gibt es unverändert.
  • Sie laufen wie früher nur, wenn der Aufrufer Insert(true), Modify(true) usw. verwendet. Eingaben über Seiten lösen sie immer aus.
  • Innerhalb der Tabelle darfst du Felder ohne Rec. ansprechen. Auf Seiten ist Rec. Pflicht.
  • Funktionen sind standardmäßig öffentlich. Mit local sind sie nur im Objekt sichtbar, mit internal nur in der eigenen App.
  • Funktionsaufrufe ohne Parameter schreibt man mit Klammern: Modify(), WorkDate(), FindSet().

10Table Extension: Standardtabellen erweitern

Die Table Extension ersetzt das Anlegen von 50000er-Feldern direkt in der Standardtabelle. Hier die Erweiterung des Debitors, ausgebaut aus dem Beispiel von Seite 2:

tableextension 50100 "ABC Customer Ext" extends Customer
{
    fields
    {
        field(50100; "ABC Letzter Besuch"; Date)
        {
            Caption = 'Last Visit';
            DataClassification = CustomerContent;

            trigger OnValidate()
            var
                FutureDateErr: Label 'The last visit cannot be in the future.';
            begin
                if "ABC Letzter Besuch" > Today() then
                    Error(FutureDateErr);
            end;
        }
        field(50101; "ABC Kundenklasse"; Enum "ABC Kundenklasse")
        {
            Caption = 'Customer Class';
            DataClassification = CustomerContent;
        }
        field(50102; "ABC Anzahl Besuche"; Integer)
        {
            Caption = 'No. of Visits';
            FieldClass = FlowField;
            CalcFormula = count("ABC Customer Visit" where("Customer No." = field("No.")));
            Editable = false;
        }
    }

    keys
    {
        key(ABCKundenklasse; "ABC Kundenklasse")
        {
        }
    }

    fieldgroups
    {
        addlast(DropDown; "ABC Kundenklasse")
        {
        }
    }

    trigger OnAfterDelete()
    var
        Visit: Record "ABC Customer Visit";
    begin
        Visit.SetRange("Customer No.", "No.");
        if not Visit.IsEmpty() then
            Visit.DeleteAll(true);
    end;
}

Was eine Table Extension kann

MöglichkeitSyntaxEinschränkung
Neue Felderfield(…) im Abschnitt fieldsFeldnummer im ID-Bereich der App, Name mit Präfix.
Standardfelder anpassenmodify("Feldname") { … }Nur ausgewählte Eigenschaften (z. B. Caption, zusätzliche TableRelation) und zusätzliche Trigger. Typ und Länge nicht.
Code beim Validieren eines Standardfeldstrigger OnBeforeValidate(), OnAfterValidate() innerhalb von modifyDer Standard-Trigger selbst bleibt unverändert.
Code bei Einfügen, Ändern, Löschen, UmbenennenOnBeforeInsert, OnAfterInsert, OnBeforeModify, OnAfterModify, OnBeforeDelete, OnAfterDelete, OnBeforeRename, OnAfterRenameLaufen nur, wenn die Tabellentrigger ausgeführt werden.
Neue SchlüsselAbschnitt keysEin Schlüssel darf entweder nur eigene Felder oder nur Standardfelder enthalten, keine Mischung. Der Primärschlüssel ist tabu.
Feldgruppen ergänzenaddlast(DropDown; …)Nur hinzufügen, nicht entfernen.
Eigene Funktionenprocedure …Sie sind danach an jeder Variablen vom Typ der Tabelle aufrufbar, z. B. Customer.ABCCalcVisits().
// Beispiel für modify: auf Änderung eines Standardfelds reagieren
modify("Salesperson Code")
{
    trigger OnAfterValidate()
    begin
        if "Salesperson Code" <> xRec."Salesperson Code" then
            "ABC Letzter Besuch" := 0D;
    end;
}

Regeln und Hintergründe

  • Eine Extension pro Tabelle und App. Deine App kann die Tabelle Customer nur einmal erweitern. Alle Felder für den Debitor stehen also in einer Datei.
  • Speicherung. Die Felder landen nicht in der Standardtabelle, sondern in einer Begleittabelle mit demselben Primärschlüssel. Die Plattform verknüpft beide beim Lesen automatisch. Für dich im Code ist das unsichtbar, Customer."ABC Kundenklasse" verhält sich wie ein normales Feld.
  • Performance. Die Verknüpfung kostet etwas Zeit. Bei Massenverarbeitung hilft SetLoadFields, das nur die benötigten Spalten lädt (Seite 9).
  • Trigger oder Event Subscriber? Die Trigger in der Table Extension und Subscriber auf OnAfterInsertEvent usw. leisten Ähnliches. Trigger sind einfacher und stehen beim Feld. Subscriber sind flexibler, weil sie in einer Codeunit gebündelt und gezielt abgeschaltet werden können (Seite 5).
  • Übergabe an andere Tabellen. Felder wandern nicht automatisch vom Verkaufskopf in den gebuchten Beleg. Wenn die Zieltabelle ein Feld mit derselben Feldnummer und demselben Typ hat, übernimmt TransferFields den Wert wie früher. Sonst brauchst du einen Event Subscriber.
Zur Benennung. In diesem Kurs heißen einige Felder deutsch („ABC Kundenklasse“), weil das Beispiel so begonnen hat. In echten Projekten empfehle ich englische Objekt- und Feldnamen und deutsche Texte nur in der Übersetzung. Dann passt dein Code zum Standard, und englischsprachige Kollegen und Werkzeuge kommen damit zurecht.

11Temporäre Tabellen

Variable als temporär deklarieren (wie früher)

var
    TempVisit: Record "ABC Customer Visit" temporary;
begin
    TempVisit.Init();
    TempVisit."Entry No." := 1;
    TempVisit.Insert();
end;

Tabelle selbst als temporär definieren (neu)

table 50105 "ABC Visit Buffer"
{
    TableType = Temporary;
    Caption = 'Visit Buffer';

    fields
    {
        ...
    }
}

Mit TableType = Temporary wird in der Datenbank nie eine Tabelle angelegt. Das hat zwei Vorteile: Niemand kann versehentlich echte Daten hineinschreiben, und du darfst Felder später frei ändern oder löschen, weil es kein Schema gibt. Für Puffer- und Hilfstabellen ist das die bessere Wahl. Mit Rec.IsTemporary() prüfst du im Code, ob ein Datensatz temporär ist.

12Schemaänderungen und veraltete Felder

Sobald eine Version deiner App in einer Umgebung mit Daten installiert ist, prüft die Plattform bei jedem Update, ob die neue Version Daten gefährden würde.

ErlaubtNicht erlaubt
Neue Tabellen und Felder
Text- und Code-Felder verlängern
Neue Sekundärschlüssel
Enum-Werte hinzufügen
Option in Enum umwandeln (gleiche Ordinalwerte)
Captions, ToolTips, Trigger, Code ändern
Felder oder Tabellen löschen
Datentyp ändern
Text- und Code-Felder kürzen
Primärschlüssel ändern
Normales Feld in FlowField umwandeln
DataPerCompany ändern

Umbenennen von Feldern und Tabellen solltest du ebenfalls wie verboten behandeln. Es bricht jede abhängige App, jede Schnittstelle und jedes Berichtslayout, das den alten Namen verwendet.

Der Weg für nicht mehr benötigte Felder

// Version 1.5: Feld als auslaufend markieren. Code, der es nutzt, bekommt eine Warnung.
field(50103; "ABC Altes Feld"; Text[30])
{
    Caption = 'Old Field';
    DataClassification = CustomerContent;
    ObsoleteState = Pending;
    ObsoleteReason = 'Replaced by field ABC Neues Feld.';
    ObsoleteTag = '1.5';
}

// Version 2.0: Feld als entfernt markieren. Es darf im Code nicht mehr verwendet werden.
field(50103; "ABC Altes Feld"; Text[30])
{
    Caption = 'Old Field';
    DataClassification = CustomerContent;
    ObsoleteState = Removed;
    ObsoleteReason = 'Replaced by field ABC Neues Feld.';
    ObsoleteTag = '2.0';
}
  • Die Felddefinition bleibt dauerhaft im Code stehen, auch im Zustand Removed. Die Spalte bleibt in der Datenbank.
  • Die Feldnummer ist damit verbraucht. Vergib sie nicht neu.
  • Soll ein Feld einen anderen Typ bekommen, legst du ein neues Feld an, kopierst die Werte in einer Upgrade-Codeunit (Seite 8) und markierst das alte als veraltet.
  • Genauso geht Microsoft mit dem Standard um. Die Warnungen, die du beim Kompilieren zu Standardfeldern siehst, stammen aus diesem Mechanismus.
Deshalb lohnt sich Sorgfalt vor der ersten Auslieferung. In der Sandbox kannst du mit schemaUpdateMode ForceSync oder Recreate noch alles umbauen (Seite 2). Danach bleibt jedes Feld für immer. Prüfe Namen, Typen und Längen, bevor die App zum ersten Mal in die Produktion geht.

13Kleine Neuerungen beim Datenzugriff

Die Record-Funktionen sind dieselben geblieben. Einige sind hinzugekommen:

FunktionZweck
Rec.GetBySystemId(Id)Datensatz über die SystemId lesen.
Rec.SetLoadFields(Feld1, Feld2)Nur bestimmte Spalten laden. Wichtig bei Tabellen mit vielen Erweiterungsfeldern (Seite 9).
Rec.ReadIsolationSperrverhalten beim Lesen gezielt steuern, feiner als LockTable (Seite 9).
Rec.IsTemporary()Prüfen, ob die Variable temporär ist.
Rec.TableCaption(), Rec.FieldCaption(Feld)Wie früher, jetzt mit Klammern.

14Tabellen im Browser ansehen

„Tabelle ausführen“ im Object Designer gibt es nicht mehr. Der Ersatz ist ein Parameter in der Adresse des Web-Clients:

https://businesscentral.dynamics.com/<Tenant>/DEV?table=50100
https://businesscentral.dynamics.com/<Tenant>/DEV?table=18

Die Ansicht zeigt alle Felder der Tabelle einschließlich der Erweiterungs- und Systemfelder. Je nach Berechtigung und Umgebung ist sie schreibgeschützt. Du kannst die Tabelle auch als Startobjekt in der launch.json eintragen: "startupObjectType": "Table", "startupObjectId": 50100.

15Übung: Besuchsverwaltung

Baue auf dem Projekt von Seite 2 auf. Lege im Ordner src die folgenden Dateien an.

src/ABCKundenklasse.Enum.al

enum 50100 "ABC Kundenklasse"
{
    Extensible = true;
    Caption = 'Customer Class';

    value(0; " ")
    {
        Caption = ' ';
    }
    value(1; A)
    {
        Caption = 'A';
    }
    value(2; B)
    {
        Caption = 'B';
    }
    value(3; C)
    {
        Caption = 'C';
    }
}

src/ABCVisitType.Enum.al: das Enum aus Abschnitt 6.

src/ABCCustomerVisit.Table.al

table 50100 "ABC Customer Visit"
{
    Caption = 'Customer Visit';
    DataClassification = CustomerContent;
    // LookupPageId und DrillDownPageId folgen auf Seite 4, sobald die Seite existiert.

    fields
    {
        field(1; "Entry No."; Integer)
        {
            Caption = 'Entry No.';
            AutoIncrement = true;
            Editable = false;
        }
        field(2; "Customer No."; Code[20])
        {
            Caption = 'Customer No.';
            TableRelation = Customer;
            NotBlank = true;
        }
        field(3; "Customer Name"; Text[100])
        {
            Caption = 'Customer Name';
            FieldClass = FlowField;
            CalcFormula = lookup(Customer.Name where("No." = field("Customer No.")));
            Editable = false;
        }
        field(4; "Visit Date"; Date)
        {
            Caption = 'Visit Date';
        }
        field(5; "Visit Type"; Enum "ABC Visit Type")
        {
            Caption = 'Visit Type';
        }
        field(6; Description; Text[100])
        {
            Caption = 'Description';
        }
        field(7; "Salesperson Code"; Code[20])
        {
            Caption = 'Salesperson Code';
            TableRelation = "Salesperson/Purchaser";
        }
        field(8; "Duration (Minutes)"; Integer)
        {
            Caption = 'Duration (Minutes)';
            MinValue = 0;
        }
    }

    keys
    {
        key(PK; "Entry No.")
        {
            Clustered = true;
        }
        key(CustomerDate; "Customer No.", "Visit Date")
        {
            SumIndexFields = "Duration (Minutes)";
        }
    }

    fieldgroups
    {
        fieldgroup(DropDown; "Entry No.", "Customer No.", "Visit Date", "Visit Type")
        {
        }
        fieldgroup(Brick; "Customer No.", "Visit Date", Description)
        {
        }
    }

    trigger OnInsert()
    begin
        TestField("Customer No.");
        if "Visit Date" = 0D then
            "Visit Date" := WorkDate();
        UpdateLastVisit();
    end;

    trigger OnModify()
    begin
        UpdateLastVisit();
    end;

    local procedure UpdateLastVisit()
    var
        Customer: Record Customer;
    begin
        if not Customer.Get("Customer No.") then
            exit;
        if "Visit Date" <= Customer."ABC Letzter Besuch" then
            exit;
        Customer."ABC Letzter Besuch" := "Visit Date";
        Customer.Modify();
    end;
}

src/ABCCustomerExt.TableExt.al: ersetze den Inhalt durch die Fassung aus Abschnitt 10.

  1. Kompiliere mit Strg+Umschalt+B und behebe gemeldete Fehler.
  2. Veröffentliche mit F5.
  3. Öffne die Tabelle im Browser mit ?table=50100. Sie ist noch leer, eine Seite zum Erfassen bauen wir auf Seite 4.
  4. Öffne ?table=18 und suche die drei ABC-Felder am Ende der Spaltenliste.
  5. Versuch: Ändere Description von Text[100] auf Text[50] und veröffentliche erneut mit schemaUpdateMode Synchronize. Lies die Fehlermeldung und nimm die Änderung zurück.
  6. Committe den Stand: git add ., git commit -m "Besuchstabelle, Enums und Debitorfelder", git push.

16Typische Denkfehler

  • „Feldnummern ab 50000 in jeder Tabelle neu beginnen.“ In Table Extensions müssen die Nummern im Bereich deiner App liegen. Vergib sie fortlaufend über die ganze App, am einfachsten mit AL Object ID Ninja.
  • „Das Präfix lasse ich weg, der Name ist ja eindeutig.“ Bis Microsoft oder eine andere App ein Feld gleichen Namens einführt. Dann lässt sich deine App nicht mehr installieren.
  • „Ich nehme Option, das kenne ich.“ Funktioniert, aber niemand kann die Liste später erweitern, auch du selbst nur mit Änderungen an jeder Verwendung.
  • „DataClassification bleibt auf ToBeClassified.“ Der Analyzer warnt, und in AppSource-Apps ist es ein Fehler. Setze sie einmal auf Tabellenebene.
  • „Mein neues Feld im Verkaufskopf erscheint automatisch in der gebuchten Rechnung.“ Nur wenn du es dort ebenfalls anlegst, mit derselben Feldnummer und demselben Typ.
  • „Ich lege eigene Felder für Anlagedatum und Benutzer an.“ Die Systemfelder liefern das bereits.
  • „AutoIncrement für Belegnummern.“ Es entstehen Lücken. Für lückenlose Nummern nimmst du Nummernserien.

17Selbsttest

Wo werden die Felder einer Table Extension gespeichert?

In einer Begleittabelle mit demselben Primärschlüssel wie die Standardtabelle. Die Plattform verknüpft beide beim Lesen automatisch.

Warum ist ein Enum einer Option überlegen?

Es wird einmal definiert und überall verwendet, andere Apps können Werte ergänzen, und es kann Interfaces implementieren. In der Datenbank steht weiterhin eine Ganzzahl.

Du willst ein ausgeliefertes Feld von Text[30] auf Code[20] ändern. Wie gehst du vor?

Neues Feld anlegen, Werte in einer Upgrade-Codeunit kopieren, altes Feld mit ObsoleteState = Pending und später Removed markieren.

Welche Trigger stehen dir in einer Table Extension für ein Standardfeld zur Verfügung?

OnBeforeValidate und OnAfterValidate innerhalb von modify("Feldname").

Darf ein Schlüssel in einer Table Extension ein Standardfeld und ein eigenes Feld kombinieren?

Nein. Er enthält entweder nur Felder der Standardtabelle oder nur Felder der Extension.

Worauf musst du bei einem case über ein erweiterbares Enum achten?

Auf einen else-Zweig, weil andere Apps Werte hinzufügen können, die dein Code nicht kennt.

Wie siehst du den Inhalt einer Tabelle ohne eigene Seite?

Über den Adressparameter ?table=<Nummer> im Web-Client.

Wann wählst du TableType = Temporary statt einer temporären Variablen?

Wenn die Tabelle ausschließlich als Puffer dient. Sie wird dann nie in der Datenbank angelegt und unterliegt keinen Schemaregeln.

18Zusammenfassung

Tabellen funktionieren wie in NAV 2017, nur als Text geschrieben. Standardtabellen erweiterst du mit einer Table Extension, die Felder, Schlüssel, Trigger und Funktionen ergänzt. Enums lösen Optionen ab, Systemfelder liefern Kennung und Änderungsdaten gratis, und nach der ersten Auslieferung kannst du das Schema nur noch erweitern, nicht mehr zurückbauen.

Checkliste: Besuchstabelle angelegt · zwei Enums definiert · Debitor um drei Felder, einen Schlüssel und einen Löschtrigger erweitert · Tabellen im Browser geprüft · abgelehnte Schemaänderung einmal gesehen · Stand committet.

Code-Review für deine erste Extension?Wir schauen drauf, bevor sie zum Kunden geht.

Erstgespräch vereinbaren

Fehler gefunden? Bitte melden. Wir prüfen jede Meldung.