1Eine Tabelle, alt und neu
Das Tabellenobjekt ist inhaltlich dasselbe geblieben: Felder, Schlüssel, Feldgruppen, Trigger. Geändert hat sich die Schreibweise.
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.
}
}
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.jsonliegen.
2Tabelleneigenschaften
| Eigenschaft | Bedeutung | Hinweis für Umsteiger |
|---|---|---|
Caption | Anzeigename, englisch. | Ersetzt CaptionML. |
DataClassification | Datenschutzklasse für alle Felder. | Neu. Meist CustomerContent. |
LookupPageId, DrillDownPageId | Seite für Nachschlagen und Drilldown. | Wie früher, aber mit Seitennamen. |
DataCaptionFields | Felder, die in der Titelzeile von Karten erscheinen. | Unverändert. |
DataPerCompany | false = Daten gelten für alle Mandanten. | Unverändert. Nachträglich nicht änderbar. |
TableType | Normal oder Temporary, daneben Typen für externe Datenquellen (z. B. Dataverse). | Temporary ist neu: Die Tabelle existiert nie in der Datenbank (Abschnitt 11). |
Extensible | false verbietet anderen Apps, die Tabelle zu erweitern. | Neu. Standard ist true. |
Access | Public oder Internal. Interne Tabellen sind für andere Apps unsichtbar. | Neu. Wichtig, wenn andere Apps auf deiner aufbauen. |
Permissions | Rechte, die der Code der Tabelle auf andere Tabellen braucht. | Unverändert, neue Schreibweise: Permissions = tabledata Customer = rm; |
ReplicateData | Steuert die Übernahme bei Cloud-Migration und Datenreplikation. | Selten nötig. |
ObsoleteState, ObsoleteReason, ObsoleteTag | Markiert die Tabelle als veraltet. | Neu, siehe Abschnitt 12. |
3Datentypen für Tabellenfelder
| Typ | Schreibweise | Was sich gegenüber NAV 2017 geändert hat |
|---|---|---|
| Code | Code[20] | Maximallänge 2048 statt 250. |
| Text | Text[100] | Maximallänge 2048 statt 250. Textvariablen ohne Längenangabe sind unbegrenzt, Tabellenfelder brauchen immer eine Länge. |
| Integer, BigInteger, Decimal, Boolean | Integer … | Unverändert. |
| Date, Time, DateTime, Duration, DateFormula | Date … | Unverändert. DateTime wird weiterhin in UTC gespeichert. |
| Option | Option mit OptionMembers | Gibt es noch, aber für neue Felder nimmt man Enum. |
| Enum | Enum "ABC Visit Type" | Neu. Eigenes Objekt, erweiterbar, in der Datenbank weiterhin eine Ganzzahl. |
| Guid | Guid | Unverändert, wird häufiger gebraucht (SystemId, APIs). |
| Blob | Blob | Weiterhin für große Texte und Binärdaten. Zugriff nur über Streams (Seite 6). |
| Media, MediaSet | Media, MediaSet | Gab 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, TableFilter | RecordId … | Unverändert. |
Typen wie List, Dictionary, JsonObject oder TextBuilder gibt es nur als Variablen, nicht als Tabellenfelder. Sie sind Thema von Seite 6.
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.
| Eigenschaft | Bedeutung |
|---|---|
Caption | Anzeigename. Ohne Caption wird der Feldname verwendet und nicht übersetzt. |
DataClassification | Überschreibt die Angabe der Tabelle für dieses Feld. |
TableRelation, ValidateTableRelation | Verknüpfung mit Prüfung und Nachschlagen. |
FieldClass, CalcFormula | Normal, FlowField oder FlowFilter (Abschnitt 8). |
Editable, NotBlank, InitValue, MinValue, MaxValue | Wie früher. |
DecimalPlaces, AutoFormatType, AutoFormatExpression, BlankZero | Formatierung von Zahlen und Beträgen. |
AutoIncrement | Automatische Zählung durch die Datenbank. Bei Abbruch der Transaktion entstehen Lücken, also nicht für lückenlose Nummern verwenden. |
ExtendedDatatype | EMail, URL, PhoneNo, Masked usw. Der Client macht daraus Links oder verdeckt die Eingabe. |
OptionMembers, OptionCaption | Nur für Option-Felder. OptionMembers ersetzt OptionString. |
ToolTip | In neueren Versionen kann der ToolTip schon am Tabellenfeld stehen und gilt dann für alle Seiten. |
Access | Sichtbarkeit 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.
| Feld | Typ | Inhalt |
|---|---|---|
SystemId | Guid | Unveränderliche, eindeutige Kennung des Datensatzes. Bleibt auch beim Umbenennen gleich. |
SystemCreatedAt, SystemCreatedBy | DateTime, Guid | Zeitpunkt und Benutzer der Anlage. |
SystemModifiedAt, SystemModifiedBy | DateTime, Guid | Zeitpunkt und Benutzer der letzten Änderung. |
SystemRowVersion | BigInteger | Zä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 = trueerlaubt anderen Apps, Werte hinzuzufügen. Der Standardwert istfalse.- 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;
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)
{
}
}
| Element | Bedeutung |
|---|---|
| Erster Schlüssel | Primärschlüssel. Nach der Auslieferung nicht mehr änderbar. |
Clustered | Physische Sortierung in der Datenbank, fast immer der Primärschlüssel. |
SumIndexFields, MaintainSiftIndex | SIFT wie früher, für schnelle Summen in FlowFields. |
Unique | Erzwingt Eindeutigkeit auch bei einem Sekundärschlüssel. Neu. |
IncludedFields | Zusätzliche Spalten im Index, die nicht zur Sortierung gehören. Neu, für Performance-Optimierung. |
Enabled | Schlüssel abschalten, ohne ihn zu löschen. |
Feldgruppe DropDown | Spalten in der Nachschlageliste von Feldern, die auf diese Tabelle verweisen. |
Feldgruppe Brick | Felder 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,OnRenamesowieOnValidateundOnLookupam 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 istRec.Pflicht. - Funktionen sind standardmäßig öffentlich. Mit
localsind sie nur im Objekt sichtbar, mitinternalnur 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öglichkeit | Syntax | Einschränkung |
|---|---|---|
| Neue Felder | field(…) im Abschnitt fields | Feldnummer im ID-Bereich der App, Name mit Präfix. |
| Standardfelder anpassen | modify("Feldname") { … } | Nur ausgewählte Eigenschaften (z. B. Caption, zusätzliche TableRelation) und zusätzliche Trigger. Typ und Länge nicht. |
| Code beim Validieren eines Standardfelds | trigger OnBeforeValidate(), OnAfterValidate() innerhalb von modify | Der Standard-Trigger selbst bleibt unverändert. |
| Code bei Einfügen, Ändern, Löschen, Umbenennen | OnBeforeInsert, OnAfterInsert, OnBeforeModify, OnAfterModify, OnBeforeDelete, OnAfterDelete, OnBeforeRename, OnAfterRename | Laufen nur, wenn die Tabellentrigger ausgeführt werden. |
| Neue Schlüssel | Abschnitt keys | Ein Schlüssel darf entweder nur eigene Felder oder nur Standardfelder enthalten, keine Mischung. Der Primärschlüssel ist tabu. |
| Feldgruppen ergänzen | addlast(DropDown; …) | Nur hinzufügen, nicht entfernen. |
| Eigene Funktionen | procedure … | 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
OnAfterInsertEventusw. 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
TransferFieldsden Wert wie früher. Sonst brauchst du einen Event Subscriber.
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.
| Erlaubt | Nicht 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.
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:
| Funktion | Zweck |
|---|---|
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.ReadIsolation | Sperrverhalten 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.
- Kompiliere mit Strg+Umschalt+B und behebe gemeldete Fehler.
- Veröffentliche mit F5.
- Öffne die Tabelle im Browser mit
?table=50100. Sie ist noch leer, eine Seite zum Erfassen bauen wir auf Seite 4. - Öffne
?table=18und suche die drei ABC-Felder am Ende der Spaltenliste. - Versuch: Ändere
DescriptionvonText[100]aufText[50]und veröffentliche erneut mitschemaUpdateModeSynchronize. Lies die Fehlermeldung und nimm die Änderung zurück. - 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.