Das Tabellenerweiterungsobjekt „Debitoren“ erstellen

  • 4 Minuten

Die Debitorentabelle ist wie viele andere Tabellen Teil des Business Central-Dienstes und kann von Entwicklern nicht direkt geändert werden. Entwickler müssen einen neuen Objekttyp erstellen: eine Tabellenerweiterung, um weitere Felder hinzuzufügen oder Eigenschaften für diese Tabelle zu ändern.

Für die Debitorenbelohnungserweiterung möchten Sie der Debitorentabelle ein Feld hinzufügen. Der folgende Code erstellt eine Tabellenerweiterung für die Debitorentabelle und fügt das Feld RewardPoints hinzu.

tableextension 50100 Customer extends Customer
{
  fields
  {
    field(10001; RewardPoints; Integer)
    {
      Caption = 'Reward Points';
      DataClassification = CustomerContent;
      MinValue = 0;
    }
  }
}

Hinweis

Wenn Sie diese Tabellenerweiterung in Ihrem Projekt erstellen und ein Kompilierungsfehler angezeigt wird, dass die Kundentabelle unbekannt ist, bedeutet dies wahrscheinlich, dass Sie die Symbole noch nicht in Ihr VSCode-Projekt heruntergeladen haben.

Führen Sie folgende Schritte aus, um die Symbole herunterzuladen:

  1. Wählen Sie auf der Befehlspalette in VScode „AL: Symbole herunterladen“ aus.

  2. Wenn Sie zum ersten Mal Symbole herunterladen, werden Sie dazu aufgefordert, sich als Entwickler für den jeweiligen Mandanten zu authentifizieren. Unten rechts auf dem Bildschirm wird ein Nachrichtenfeld angezeigt. Wählen Sie es aus. Ihr Browser wird geöffnet. Fügen Sie den Code ein, und authentifizieren Sie sich dann mit denselben Anmeldeinformationen, die Sie in Ihrer BC SaaS-Umgebung verwenden.

  3. Schließen Sie danach das Browserfenster, und die Symbole werden heruntergeladen.

  4. Wenn die Symbole heruntergeladen sind, sollte in Ihrem VSCode-Projekt ein Ordner mit dem Namen vorhanden sein: .alpackages enthält die Anwendungs-, Basis‑ und zwei System-Apps.

Die Eigenschaft MinValue legt den Mindestwert für ein Feld fest. Die Feldeinstellung wird während der Prüfung überprüft. Die Prüfung erfolgt nur, wenn das Feld oder der Steuerwert über die Benutzeroberfläche aktualisiert wird, z. B. wenn ein Wert auf einer Seite aktualisiert wird oder wenn ein Feld in einer Tabelle direkt aktualisiert wird. Wenn ein Feld über den Anwendungscode aktualisiert wird, wird die Eigenschaft MinValue nicht validiert.

Wichtige Hinweise zu Tabellenerweiterungsobjekten sind:

  • Nur Tabellen mit der Eigenschaft Extensible, die auf true gesetzt sind, können erweitert werden.

  • Erweiterungsobjekte können einen Namen mit einer maximalen Länge von 30 Zeichen haben.

  • System‑ und virtuelle Tabellen können nicht erweitert werden. Systemtabellen werden im ID-Bereich von 2.000.000.000 und höher erstellt.

  • In einer Erweiterung können Sie nur ein Tabellenerweiterungsobjekt für eine bestimmte Tabelle erstellen. Mit anderen Worten: Sie können mehrere Tabellenerweiterungsobjekte in einer Erweiterung haben, wenn sie alle unterschiedliche Tabellen erweitern. Sie können mehrere Erweiterungen (Apps) erstellen, die dasselbe Tabellenobjekt erweitern.