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

Umdenken: von C/SIDE zu Extensions

Warum es C/SIDE nicht mehr gibt, wie das Extension-Modell aufgebaut ist und welche NAV-Kenntnisse weiter gelten. Mit Vergleich der Begriffe und Werkzeuge.

Stand November 2026 · Version 29

Autor: Elvis Schmidt, decoso GmbH & Co. KG

Lernziele dieser Seite. Danach weißt du, warum es C/SIDE nicht mehr gibt, wie das Extension-Modell aufgebaut ist, welche deiner NAV-Kenntnisse weiter gelten, was die neuen Begriffe bedeuten und welches alte Werkzeug durch welches neue ersetzt wurde. Auf dieser Seite wird noch nichts installiert, das folgt auf Seite 2.

1Was zwischen NAV 2017 und heute passiert ist

NAV 2017 war eine der letzten Versionen, in denen C/SIDE das einzige ernsthafte Entwicklungswerkzeug war. Der Umbau lief in drei Schritten:

VersionNameBedeutung für Entwickler
10NAV 2017C/SIDE, C/AL, Windows-Client. Events gibt es schon (seit NAV 2016), ebenso „Extensions v1“ auf Basis von Delta-Dateien und PowerShell. Kaum jemand hat sie genutzt.
11NAV 2018Erstmals AL und Visual Studio Code („Extensions v2“), parallel zu C/SIDE.
13Business Central Oktober 2018Neuer Produktname. C/SIDE und AL existieren nebeneinander. Die Codeunit 1 wird abgeschafft und durch Events ersetzt.
14Business Central Frühjahr 2019Letzte Version mit C/SIDE, C/AL und Windows-Client. Typische Zwischenstation bei Migrationen.
15Business Central 2019 Wave 2Der Schnitt: Nur noch AL, nur noch Web-Client. Auch die Standardanwendung von Microsoft ist jetzt eine AL-App.
16 und höherBusiness Central 20xx Wave 1 / Wave 2Zwei Hauptversionen pro Jahr (April und Oktober), die Versionsnummer steigt jeweils um eins. 2025 Wave 1 ist Version 26, 2025 Wave 2 ist Version 27 und so weiter.

Der Grund für den Umbau war die Cloud. Wenn Microsoft tausende Kundendatenbanken selbst betreibt und jeden Monat aktualisiert, darf kein Kunde geänderte Standardobjekte haben. Sonst müsste bei jedem Update jemand Objekte abgleichen, so wie du es von NAV-Upgrades kennst. Die Lösung: Der Standard bleibt unberührt, und alles Kundenspezifische liegt in getrennten Paketen, die sich an den Standard andocken.

2Das Grundprinzip: Erweitern statt Ändern

NAV 2017

Eine Datenbank enthält alle Objekte. Du öffnest Tabelle 18 im Object Designer, fügst Feld 50000 hinzu, öffnest Codeunit 80 und schreibst deinen Code zwischen zwei Kommentarmarker. Standard und Anpassung sind danach untrennbar vermischt. Jedes Update bedeutet Vergleichen und Zusammenführen.

Business Central

Der Standard ist eine App von Microsoft. Deine Anpassung ist eine eigene App mit eigenen Dateien. Sie enthält nur das, was du hinzufügst: neue Objekte, Erweiterungen bestehender Tabellen und Seiten sowie Code, der auf Ereignisse des Standards reagiert. Ein Update tauscht die Microsoft-App aus, deine App bleibt installiert.

Die Schichten einer Business-Central-Umgebung

Deine App (Per-Tenant Extension, IDs 50000–99999)
Apps von Drittanbietern aus AppSource und weitere Microsoft-Apps (z. B. Shopify Connector, Länderfunktionen)
Base Application: Finanzen, Verkauf, Einkauf, Lager, Produktion … (das, was früher „die NAV-Objekte“ waren)
Business Foundation und System Application: Grundfunktionen wie Nummernserien, E-Mail, Dateihilfen, Kryptografie
Plattform: Server, Web-Client, Systemtabellen (2000000000 und höher), Datenbank

Jede Schicht darf nur die Schichten unter sich verwenden. Deine App erklärt in der Datei app.json, von welchen Apps sie abhängt, und kann deren öffentliche Objekte nutzen und erweitern. Umgekehrt weiß die Base Application nichts von deiner App.

Was „erweitern“ konkret heißt

Du willst …Mittel in ALEinschränkung
Felder zu einer Standardtabelle hinzufügentableextensionBestehende Felder kannst du nicht löschen oder im Typ ändern. Einige Eigenschaften lassen sich anpassen.
Felder und Aktionen auf einer Standardseite ergänzen, verschieben, ausblendenpageextensionDen Code der Standardseite kannst du nicht ändern, nur eigene Trigger ergänzen.
Werte zu einer Auswahlliste hinzufügenenumextensionNur wenn das Enum als erweiterbar markiert ist.
Spalten und Layouts zu einem Standardbericht hinzufügenreportextensionBestehende Datenelemente bleiben, wie sie sind.
In Standardcode eingreifen (prüfen, ergänzen, ersetzen)Event SubscriberNur an Stellen, an denen Microsoft ein Event vorgesehen hat.
Etwas komplett Neues bauentable, page, codeunit, report, query, xmlport …Keine, außer dem ID-Bereich.
Die wichtigste Konsequenz. „Ich ändere mal eben die Zeile im Standard“ gibt es nicht mehr. Wenn an der gewünschten Stelle kein Event existiert, hast du drei Wege: die Anforderung anders lösen, ein neues Event bei Microsoft beantragen (über Issues im GitHub-Repository microsoft/ALAppExtensions) oder die Logik in eigenen Objekten nachbauen. Der dritte Weg ist teuer, weil du Standardänderungen dann selbst nachziehen musst.

3Was wegfällt

WegWas das für dich bedeutet
C/SIDE und Object DesignerEs gibt keine Entwicklungsumgebung mehr, die in der Datenbank arbeitet. Code liegt als Textdateien auf deiner Festplatte.
Änderungen an StandardobjektenSiehe Abschnitt 2. Das ist die größte Umstellung im Kopf.
FOB- und TXT-DateienAusgeliefert wird eine einzige .app-Datei, die alle Objekte deiner Erweiterung enthält.
Windows-Client (RTC)Es gibt nur noch den Web-Client im Browser, dazu Apps für Tablet und Telefon. Alles, was auf dem Client-PC lief (Client-seitiges DotNet, Automation, lokale Dateipfade), ist nicht mehr möglich.
Entwicklerlizenz und Lizenzdatei (Cloud)In der Cloud gibt es keine Lizenzdatei. Der Bereich 50000–99999 steht jedem Tenant frei zur Verfügung. Benutzer werden über Microsoft-365-Lizenzen berechtigt.
MenuSuiteSeiten und Berichte werden über Eigenschaften am Objekt selbst in der Suche („Wie möchten Sie weiter verfahren“) sichtbar.
DotNet-Variablen (Cloud)In der Cloud verboten. AL hat eigene Datentypen für HTTP, JSON, XML, Text und Listen. Was fehlt, löst man über einen externen Dienst, z. B. eine Azure Function.
Dateisystem und Server-Pfade (Cloud)Kein FILE-Datentyp, kein C:\Temp, kein Netzlaufwerk. Dateien wandern über Streams zum Browser oder über Webdienste zu Speichern wie Azure Blob Storage oder SharePoint.
Direkter SQL-Zugriff (Cloud)Kein SQL Server Management Studio, keine eigenen Views, keine Abfragen von außen. Externer Zugriff läuft über APIs.
Codeunit 1 „ApplicationManagement“Die bekannten Einsprungpunkte (Anmeldung, Firmenwechsel, Formatierung) sind jetzt Events in Systemcodeunits, die du abonnierst.
Version List, Modified-Kennzeichen, Datum und Zeit am ObjektDie Historie führt Git. Die Version steht einmal in der app.json und gilt für die ganze App.
Objektabgleich bei UpgradesEntfällt vollständig. Dafür musst du prüfen, ob deine App mit der neuen Version noch kompiliert.
Objektsperren im TeamJeder arbeitet in seiner eigenen Kopie des Codes. Zusammengeführt wird über Git.
WITH-AnweisungAbgeschafft. Variablen werden immer ausgeschrieben, auf Seiten heißt es Rec.Feld.

4Was bleibt

Der größere Teil deines Wissens gilt weiter. Das ist der Grund, warum erfahrene NAV-Entwickler meist nach wenigen Wochen produktiv sind.

  • Die Sprache. AL ist C/AL mit leicht geänderter Schreibweise. FindSet, SetRange, CalcFields, TestField, Validate, Commit, Codeunit.Run funktionieren wie früher.
  • Die Objekttypen. Tabellen, Pages, Codeunits, Reports, XMLports und Queries gibt es weiterhin. Hinzugekommen sind die Extension-Typen, Enums, Interfaces und Berechtigungssätze.
  • Das Datenmodell. Debitor ist Tabelle 18, Verkaufskopf Tabelle 36, Artikelposten Tabelle 32. Felder sind hinzugekommen, wenige wurden entfernt.
  • Die Architektur der Anwendung. Buchungsroutinen, Buch.-Blätter, Posten, Dimensionen, Nummernserien, Einrichtungstabellen und Aufgabenwarteschlange folgen denselben Mustern.
  • Trigger. OnInsert, OnValidate, OnAfterGetRecord, OnOpenPage gibt es unverändert.
  • FlowFields, FlowFilter, Schlüssel, SumIndexFields, temporäre Tabellen. Alles noch da.
  • Events. Publisher und Subscriber kennst du vielleicht schon aus NAV 2016/2017. Neu ist nur, dass sie vom Sonderfall zum Normalfall geworden sind und dass der Standard heute viele tausend davon anbietet.

5Derselbe Code, alt und neu

Beispiel A: Eine einfache Codeunit

NAV 2017, Textexport
OBJECT Codeunit 50000 Customer Check
{
  OBJECT-PROPERTIES
  {
    Date=01.03.17;
    Time=12:00:00;
    Modified=Yes;
    Version List=ABC1.00;
  }
  PROPERTIES
  {
  }
  CODE
  {
    VAR
      Text001@1000 : TextConst 'DEU=Debitor %1 ist gesperrt.;ENU=Customer %1 is blocked.';

    PROCEDURE CheckCustomer@1(CustomerNo@1000 : Code[20]);
    VAR
      Customer@1001 : Record 18;
    BEGIN
      Customer.GET(CustomerNo);
      IF Customer.Blocked <> Customer.Blocked::" " THEN
        ERROR(Text001,Customer."No.");
    END;

    BEGIN
    END.
  }
}
Business Central, AL-Datei
codeunit 50100 "ABC Customer Check"
{
    procedure CheckCustomer(CustomerNo: Code[20])
    var
        Customer: Record Customer;
        CustomerBlockedErr: Label 'Customer %1 is blocked.',
            Comment = '%1 = Customer No.';
    begin
        Customer.Get(CustomerNo);
        if Customer.Blocked <> Customer.Blocked::" " then
            Error(CustomerBlockedErr, Customer."No.");
    end;
}

Die Unterschiede im Einzelnen:

  • Die Objekteigenschaften Datum, Zeit, Modified und Version List sind verschwunden.
  • Die internen Nummern hinter Variablen und Funktionen (@1000) gibt es nicht mehr.
  • Tabellen werden mit Namen angesprochen (Record Customer), nicht mit Nummer.
  • TextConst mit mehreren Sprachen wird zu Label mit nur englischem Text. Die deutsche Übersetzung liegt in einer separaten Übersetzungsdatei (Seite 4).
  • Schlüsselwörter schreibt man per Konvention klein, Funktionen in PascalCase. AL unterscheidet Groß- und Kleinschreibung nicht, der Compiler akzeptiert beides.
  • Der Objektname trägt ein Präfix. Er darf weiterhin höchstens 30 Zeichen lang sein, das Präfix zählt mit.

Beispiel B: Eingriff in die Verkaufsbuchung

Anforderung: Ein Verkaufsbeleg darf nur gebucht werden, wenn beim Debitor das Zusatzfeld „Kundenklasse“ gefüllt ist.

NAV 2017: Codeunit 80 „Sales-Post“ ändern
// in Codeunit 80, Funktion OnRun
...
// ABC001 >>
Cust.GET("Sell-to Customer No.");
Cust.TESTFIELD("Customer Class");
// ABC001 <<
...

Das Feld "Customer Class" wurde vorher direkt in Tabelle 18 als Feld 50000 angelegt. Beide Standardobjekte sind danach geändert.

Business Central: eigene Codeunit mit Subscriber
codeunit 50101 "ABC Sales Post Checks"
{
    [EventSubscriber(ObjectType::Codeunit,
        Codeunit::"Sales-Post",
        'OnBeforePostSalesDoc', '', false, false)]
    local procedure CheckCustomerClass(
        var SalesHeader: Record "Sales Header")
    var
        Customer: Record Customer;
    begin
        Customer.Get(SalesHeader."Sell-to Customer No.");
        Customer.TestField("ABC Kundenklasse");
    end;
}

Das Feld kommt aus einer tableextension (Seite 3). Codeunit 80 und Tabelle 18 bleiben unberührt.

Die Codeunit „Sales-Post“ löst an dieser Stelle das Event OnBeforePostSalesDoc aus. Das System ruft alle Funktionen auf, die sich dafür angemeldet haben. Du musst die Codeunit nirgends eintragen oder aufrufen, die Anmeldung über das Attribut genügt. Das Event hat mehr Parameter als hier verwendet, ein Subscriber darf die nicht benötigten weglassen. Events und ihre Feinheiten sind Thema von Seite 5.

Wie findet man das passende Event? Der Quellcode der Base Application ist lesbar. In VS Code springst du mit „Go to Definition“ (F12) in jede Standardcodeunit und suchst dort die Stelle, an der du früher deinen Code eingefügt hättest. Kurz davor oder danach steht fast immer ein Aufruf, der mit OnBefore… oder OnAfter… beginnt.

6Begriffe, die du ab jetzt ständig hörst

BegriffBedeutungEntsprechung in NAV 2017
TenantDer Mandant eines Kunden in der Microsoft-Cloud, gebunden an dessen Microsoft-Entra-Verzeichnis (früher Azure AD).Grob: die Installation eines Kunden
Umgebung (Environment)Eine Datenbank mit eigener Version und eigenen Apps innerhalb eines Tenants. Es gibt die Typen Produktion und Sandbox.Datenbank plus Dienststufe
SandboxUmgebung zum Entwickeln und Testen. Nur hier darfst du direkt aus VS Code veröffentlichen und debuggen. Sie lässt sich als Kopie der Produktion anlegen.Test- oder Entwicklungsdatenbank
Admin CenterWeb-Oberfläche zur Verwaltung der Umgebungen: anlegen, kopieren, Update-Zeitpunkt festlegen, Sitzungen und Telemetrie einsehen.Administration Tool und SQL-Verwaltung
App oder ExtensionEin Paket aus AL-Objekten. Beide Wörter bedeuten dasselbe.FOB-Datei, aber sauber abgegrenzt
.app-DateiDas kompilierte Paket, das installiert wird.FOB-Datei
app.jsonSteckbrief der App: eindeutige ID, Name, Herausgeber, Version, ID-Bereich, Abhängigkeiten, Zielplattform.Keine
SymboleBeschreibung aller Objekte einer App (Tabellen, Felder, Funktionen). Der Compiler braucht die Symbole der Apps, auf die du aufbaust.Die Objekte lagen einfach in der Datenbank
Per-Tenant Extension (PTE)Individuelle App für genau einen Kunden. Wird als Datei in die Umgebung hochgeladen.Kundenanpassung
AppSource-AppÖffentlich vertriebene App, von Microsoft technisch geprüft, mit eigenem ID-Bereich.Add-on mit registriertem Nummernkreis
Base ApplicationDie Geschäftslogik von Microsoft als AL-App.Standardobjekte
System ApplicationFachunabhängige Hilfsmodule von Microsoft.Teile der alten Codeunits 1, 419, 9 usw.
Plattform- und AnwendungsversionVersion des Servers bzw. der Base Application. In deiner app.json gibst du an, welche Mindestversion du brauchst.Build-Nummer und Version List
RuntimeVersionsstand der Sprache AL. Legt fest, welche Sprachmerkmale dein Code nutzen darf.Keine
TelemetrieLaufzeitdaten (Fehler, lange Abfragen, Sperren), die an Azure Application Insights gesendet werden.Ereignisanzeige und SQL Profiler
Online und On-PremisesOnline (SaaS) wird von Microsoft betrieben. On-Premises läuft auf eigenen Servern und erlaubt einiges, was online verboten ist.Alles war On-Premises
Docker-ContainerLokale Business-Central-Instanz zum Entwickeln, ohne Installation auf dem Rechner.Lokale NAV-Installation

Die Arten von Apps im Vergleich

Entwickler-ExtensionPer-Tenant ExtensionAppSource-App
Wie kommt sie in die Umgebung?Mit F5 aus VS CodeUpload in der Erweiterungsverwaltung oder automatisiert per APIInstallation aus dem Marktplatz
Wo erlaubt?Nur SandboxSandbox und ProduktionSandbox und Produktion
ID-Bereich50000–9999950000–99999Von Microsoft zugeteilter Bereich
Prüfung durch MicrosoftKeineKeine vorab, aber sie muss mit jeder neuen Version kompilierenTechnische Validierung bei jeder Einreichung
BesonderheitKann bei Updates der Umgebung entfernt werden, nicht für Dauerbetrieb gedachtDer Normalfall für KundenprojektePräfix muss registriert sein

Der Lebenszyklus einer App

In NAV hast du ein FOB importiert und die Schemaänderung bestätigt. In Business Central sind das getrennte Schritte, die VS Code bei F5 allerdings automatisch hintereinander ausführt:

  1. Veröffentlichen (Publish). Das Paket wird dem Server bekannt gemacht und kompiliert.
  2. Synchronisieren (Sync). Tabellen und Felder werden in der Datenbank angelegt. Felder aus Table Extensions landen nicht in der Standardtabelle, sondern in einer Begleittabelle.
  3. Installieren (Install). Die App wird aktiv. Beim ersten Mal läuft deine Install-Codeunit, falls vorhanden.
  4. Aktualisieren (Upgrade). Eine höhere Version ersetzt die alte. Deine Upgrade-Codeunit kann Daten umbauen.
  5. Deinstallieren (Uninstall). Die App wird inaktiv. Die Daten bleiben standardmäßig erhalten und sind nach einer Neuinstallation wieder da.
  6. Veröffentlichung aufheben (Unpublish). Das Paket wird vom Server entfernt.
Schema-Regel. Sobald eine Version deiner App in einer Umgebung mit Daten installiert war, darfst du in der nächsten Version keine Felder oder Tabellen löschen, umbenennen oder im Typ ändern. Solche Änderungen gelten als zerstörerisch und werden abgelehnt. Stattdessen markierst du das Feld als veraltet und legst ein neues an. In der Sandbox lässt sich das für die Entwicklung umgehen, in der Produktion nicht. Details auf Seite 3 und 8.

7Übersetzungstabelle: Werkzeuge und Handgriffe

NAV 2017Business Central
Object DesignerVisual Studio Code mit der Erweiterung „AL Language“
Objekt speichern und kompilieren (F11)Datei speichern, Paket bauen mit Strg+Umschalt+B
Objekt ausführen (Strg+R)F5 (mit Debugger) oder Strg+F5 (ohne). Welches Objekt startet, steht in launch.json.
FOB exportieren und importieren.app-Datei bauen und hochladen
TXT-Export für VergleicheDer Code ist bereits Text. Vergleiche macht Git.
Version List, DokumentationstriggerGit-Historie, Commit-Texte, Versionsnummer in app.json
Kommentarmarker // ABC001 >>Überflüssig, eigener Code liegt in eigenen Dateien
Merge-Werkzeuge, Merge-NAVApplicationObjectEntfällt
Debugger im Windows-ClientDebugger in VS Code. In der Produktion nur Snapshot-Debugging (Aufzeichnung, nachträgliche Analyse).
NAV Development Shell, Administration ShellAdmin Center und dessen API. Für Container das PowerShell-Modul BcContainerHelper.
Lizenzdatei hochladenOnline nicht nötig
Objektsperre (Lock)Git-Branches und Pull Requests
Entwicklungsdatenbank beim KundenSandbox-Umgebung, bei Bedarf als Kopie der Produktion
SQL-Backup zurückspielenUmgebung im Admin Center kopieren oder auf einen Zeitpunkt wiederherstellen

8Übersetzungstabelle: Sprachmittel

NAV 2017 (C/AL)Business Central (AL)Mehr dazu
Feld in Standardtabelle anlegentableextensionSeite 3
Feld auf Standardseite einfügenpageextension mit addafter, addlast, modify, moveafterSeite 4
Code im Standard einfügenEvent SubscriberSeite 5
Option-Feld mit OptionStringenum, erweiterbar durch enumextensionSeite 3
CaptionML, OptionCaptionMLCaption auf Englisch plus XLIFF-ÜbersetzungsdateiSeite 4
TextConstLabelSeite 5
MenuSuiteEigenschaften UsageCategory und ApplicationAreaSeite 4
CASE über Optionswerte mit festem Verhalteninterface mit Implementierung je Enum-WertSeite 5
Funktion mit Eigenschaft Local=Yeslocal procedure, zusätzlich internal und protectedSeite 5
WITH Rec DOEntfällt, immer ausschreibenSeite 5
DotNet für HTTP, JSON, XML, StringBuilder, ListenHttpClient, JsonObject, XmlDocument, TextBuilder, List, DictionarySeite 6
FILE, UPLOAD, DOWNLOAD, Codeunit 419InStream und OutStream, UploadIntoStream, DownloadFromStream, Codeunit „Temp Blob“Seite 6
Text mit Maximallänge 1024Textvariablen ohne Längenangabe sind unbegrenzt. Tabellenfelder vom Typ Text bis 2048 Zeichen.Seite 3
Tabelleneigenschaft für temporäre Nutzung per VariableZusätzlich TableType = Temporary am ObjektSeite 3
Report mit RDLC- oder Word-LayoutZusätzlich Excel-Layouts, mehrere Layouts pro Bericht, reportextensionSeite 7
Page oder Codeunit als SOAP- oder OData-WebdienstAPI-Pages und API-Queries mit fester Adresse und Versionierung. OData bleibt, SOAP gilt als auslaufend.Seite 7
Rollen und Berechtigungen als Daten pflegenObjekttyp permissionset im CodeSeite 8
Upgrade-Codeunits im Upgrade ToolkitCodeunits mit Subtype = Install oder Upgrade in der AppSeite 8
Test-Codeunits (selten genutzt)Test-Codeunits, üblich in einer eigenen Test-App, in der Pipeline automatisch ausgeführtSeite 9
NAS für HintergrundverarbeitungAufgabenwarteschlange, TaskScheduler, StartSessionSeite 5
Codeunit 1Events in SystemcodeunitsSeite 5

9Online oder On-Premises: Was ändert das für dich?

In der app.json steht die Eigenschaft target. Sie entscheidet, was der Compiler zulässt.

"target": "Cloud" (Standard)"target": "OnPrem"
Läuft inOnline und On-PremisesNur On-Premises
DotNetVerbotenErlaubt (nur serverseitig)
Dateisystem des ServersVerbotenErlaubt
Zugriff auf bestimmte SystemfunktionenEingeschränktErweitert

Empfehlung: Entwickle immer für Cloud, auch wenn der Kunde heute eigene Server hat. Die App läuft dann überall, und ein späterer Wechsel in die Cloud kostet keinen Umbau. Technisch lässt sich On-Premises sogar noch der Quellcode der Base Application ändern. Damit holt man sich aber alle alten Upgrade-Probleme zurück und versperrt den Weg in die Cloud.

10Updates: Der Standard bewegt sich unter dir

In NAV 2017 blieb eine Kundendatenbank oft jahrelang auf demselben Stand. Online ist das anders:

  • Monatlich kommt ein kleineres Update mit Fehlerkorrekturen.
  • Halbjährlich kommt eine neue Hauptversion. Der Kunde kann den Termin innerhalb eines Zeitfensters verschieben, aber nicht dauerhaft verhindern.
  • Microsoft entfernt Felder, Funktionen und Events nicht sofort. Sie werden zuerst als veraltet markiert (ObsoleteState = Pending), der Compiler zeigt dann eine Warnung. Erst nach einer Übergangszeit, in der Regel mindestens ein Jahr, werden sie entfernt.
  • Vor jeder Hauptversion stehen Vorschau-Versionen bereit, gegen die du deine App testweise bauen kannst.
Praktische Folge. Compiler-Warnungen sind keine Nebensache mehr. Eine Warnung „wird in Version X entfernt“ ist ein Arbeitsauftrag mit Frist. Eine Pipeline, die deine App regelmäßig gegen die nächste Version baut, meldet solche Probleme, bevor der Kunde sie spürt. AL-Go bringt dafür fertige Abläufe mit (Seite 10).

11Der Arbeitsalltag im Vergleich

NAV 2017
  1. Mit der Entwicklungsumgebung an der Datenbank anmelden.
  2. Objekt sperren und im Designer öffnen.
  3. Ändern, speichern, kompilieren.
  4. Im Client testen.
  5. Version List pflegen.
  6. FOB exportieren.
  7. Beim Kunden importieren, Schema synchronisieren.
Business Central
  1. Repository klonen oder aktualisieren, Branch anlegen.
  2. AL-Dateien in VS Code bearbeiten. Fehler erscheinen schon beim Tippen.
  3. Mit F5 in die Sandbox veröffentlichen und im Browser testen.
  4. Änderungen committen und pushen.
  5. Pull Request stellen. Die Pipeline baut und testet automatisch.
  6. Nach dem Zusammenführen entsteht die .app-Datei mit neuer Versionsnummer.
  7. App in die Produktion hochladen oder automatisch ausrollen.

12Typische Denkfehler von Umsteigern

  • „Ich kopiere die Standardcodeunit und ändere meine Kopie.“ Das kompiliert, aber du verpasst ab dann jede Korrektur von Microsoft an dieser Logik. Nur als letzter Ausweg.
  • „Ich lege die Felder wie früher ab 50000 in jeder Tabelle an.“ Feldnummern in Table Extensions müssen im Bereich deiner App liegen und sollten über die ganze App eindeutig vergeben werden. Ohne Präfix im Feldnamen drohen Konflikte mit anderen Apps und künftigen Standardfeldern.
  • „Das Feld brauche ich nicht mehr, ich lösche es.“ Nach der ersten Auslieferung nicht mehr möglich, siehe Schema-Regel.
  • „Ich teste schnell in der Produktion.“ Veröffentlichen aus VS Code geht dort nicht. Jede Änderung braucht eine neue Version der App.
  • „Ich schreibe die Datei nach C:\Export.“ Der Server steht bei Microsoft. Plane Schnittstellen von Anfang an über Webdienste, Streams oder Cloud-Speicher.
  • „Ein Subscriber auf OnAfterModify reicht.“ Tabellen-Events laufen bei jedem Schreibvorgang, auch in Massenverarbeitungen. Wähle das fachlich engste Event, sonst leidet die Performance.
  • „Warnungen ignoriere ich.“ Siehe Abschnitt 10.
  • „Eine große App für alles.“ Möglich, aber getrennte Apps für klar abgegrenzte Themen lassen sich einzeln ausliefern und testen. Eine App pro Kunde ist für den Anfang trotzdem ein vernünftiger Start.

13Selbsttest

Warum kannst du Codeunit 80 nicht mehr direkt ändern?

Sie gehört zur Base Application von Microsoft, die als eigene App ausgeliefert und bei Updates komplett ersetzt wird. Deine App kann sie nur über Events beeinflussen.

Was ist der Unterschied zwischen einer Sandbox und einer Produktionsumgebung aus Entwicklersicht?

In die Sandbox kannst du direkt aus VS Code veröffentlichen und dort debuggen. In die Produktion kommt nur eine fertige App-Datei per Upload oder Automatisierung, und Debuggen geht nur per Snapshot.

Wo steht die deutsche Übersetzung einer Feldbezeichnung?

In einer XLIFF-Datei im Ordner Translations, nicht im AL-Code. Im Code steht nur der englische Text.

Was passiert mit den Daten deiner Felder, wenn die App deinstalliert wird?

Sie bleiben standardmäßig in der Datenbank und sind nach einer Neuinstallation wieder sichtbar. Gelöscht werden sie nur, wenn man das beim Deinstallieren ausdrücklich wählt.

Welchen ID-Bereich nutzt du für eine Kundenanpassung, und brauchst du dafür online eine Lizenz?

50000 bis 99999. Eine Lizenzdatei ist online nicht nötig.

An der Stelle, an der du eingreifen willst, gibt es kein Event. Was tust du?

Zuerst prüfen, ob ein Event in der Nähe oder ein anderer Lösungsweg genügt. Sonst ein Event bei Microsoft beantragen. Das Nachbauen der Standardlogik ist der letzte Ausweg.

Warum solltest du auch für On-Premises-Kunden mit "target": "Cloud" entwickeln?

Die App läuft dann in beiden Welten, und ein späterer Umzug in die Cloud erfordert keinen Umbau von DotNet- oder Dateizugriffen.

14Zusammenfassung

Du wechselst von „eine Datenbank, in der ich alles ändern darf“ zu „ein geschützter Standard, an den ich mein eigenes Paket andocke“. Die Sprache und das Datenmodell bleiben dir erhalten. Neu sind der Ort des Codes (Dateien und Git statt Datenbank), die Art des Eingriffs (Extensions und Events statt Änderung) und der Takt (laufende Updates statt seltener Upgrades).

Alter C/AL-Bestand?Wir analysieren, was davon als Extension weiterlebt und was der Standard heute kann.

So läuft eine Migration ab

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