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

Git, AL-Go, Claude und Deployment

Versionsverwaltung mit Git, Auslieferung mit AL-Go für GitHub und Entwickeln mit KI-Assistenten: vom Commit bis zur App im Tenant.

Stand November 2026 · Version 29

Autor: Elvis Schmidt, decoso GmbH & Co. KG

Lernziele dieser Seite Nach dieser Seite kannst du mit Branches und Pull Requests arbeiten, ein Repository mit AL-Go für GitHub so einrichten, dass jede Änderung automatisch gebaut und getestet wird, eine Version freigeben und in den Tenant des Kunden bringen, Claude Code mit einer CLAUDE.md und dem AL MCP Server sinnvoll im Repository einsetzen, alten C/AL-Code mit Txt2AL als Ausgangsmaterial umwandeln und den Weg der Daten von NAV 2017 nach Business Central einschätzen.

1Was sich gegenüber NAV 2017 ändert

In NAV 2017 lag der Code in der Datenbank. Versionsverwaltung war die „Version List“, das Datum am Objekt und ein Ordner mit FOB-Dateien. Mehrere Entwickler an einem Objekt bedeutete Absprache auf Zuruf. In Business Central liegt der Code in Textdateien, und damit gelten die Werkzeuge der restlichen Softwarewelt.

ThemaNAV 2017Business Central
Ort des CodesEntwicklungsdatenbankGit-Repository
VersionsstandVersion List, Modified-Flag, DatumCommit-Historie, Tags, Versionsnummer in app.json
Paralleles ArbeitenObjekt sperren oder absprechenJeder arbeitet in seinem Branch, Zusammenführen per Pull Request
Wer hat was geändert?Vergleich von Textexportengit log, git blame, GitLens zeigt es je Zeile
ReviewSelten, von HandPull Request mit Diff, Kommentaren und automatischem Build
Build„Compile all“ im Object DesignerPipeline baut bei jeder Änderung in einer sauberen Umgebung
AuslieferungFOB importieren, Schema synchronisieren.app-Datei aus der Pipeline, Upload über das Admin Center oder automatisch
Zurück zum alten StandDatenbanksicherung oder altes FOBAlten Tag auschecken; beim Kunden gilt aber: nur vorwärts mit höherer Version
Hilfe beim SchreibenKeineKI-Assistenten, die den Code im Repository lesen, ändern und über den Compiler prüfen

2Git-Begriffe für C/SIDE-Entwickler

BegriffBedeutungVergleich aus der alten Welt
RepositoryOrdner mit allen Dateien und ihrer vollständigen GeschichteEntwicklungsdatenbank plus alle je gesicherten Stände
CommitBenannter, unveränderlicher Stand aller DateienFOB-Export mit Datum und Kommentar
BranchEigene Entwicklungslinie, in der du ungestört arbeitestKopie der Entwicklungsdatenbank
mainDie Hauptlinie; sie ist immer baubar und auslieferbarDie „saubere“ Entwicklungsdatenbank
MergeZwei Linien zusammenführenText-Merge mit dem Merge Tool, nur automatisch
Pull RequestAntrag, einen Branch in main zu übernehmen, mit Diff, Review und Build„Kannst du mal drüberschauen, bevor ich importiere?“
Remote (origin)Das Repository auf GitHubZentraler Server
Clone, Pull, PushHolen, aktualisieren, hochladen–
TagFester Name für einen Commit, z. B. v1.1.0.0Versionsstempel
StashHalbfertige Änderungen kurz beiseitelegen–

Die Befehle für den Alltag

git status                         # Was ist geändert?
git pull                           # Neuesten Stand holen
git switch -c feature/besuchsplan  # Neuen Branch anlegen und wechseln
git add .                          # Änderungen für den Commit vormerken
git commit -m "Besuchsplan: Tabelle und Liste"
git push -u origin feature/besuchsplan
git switch main                    # Zurück zur Hauptlinie
git log --oneline -10              # Die letzten zehn Commits
git diff                           # Noch nicht vorgemerkte Änderungen ansehen
git restore datei.al               # Änderung an einer Datei verwerfen

Fast alles davon geht auch in VS Code über die Seitenleiste „Quellcodeverwaltung“ (Strg+Umschalt+G). Die Befehle zu kennen hilft trotzdem, weil Anleitungen und Fehlermeldungen sie verwenden.

3Branches und Pull Requests

Für ein kleines Team genügt ein einfaches Modell: Es gibt main, und für jede Aufgabe einen kurzlebigen Branch.

SchrittWas passiert
1. Aufgabe als Issue anlegenAuf GitHub beschreibst du, was gebaut werden soll. Das Issue bekommt eine Nummer.
2. Branch anlegengit switch -c feature/42-besuchsplan von aktuellem main.
3. EntwickelnKleine Commits, lokal mit F5 und den Tests aus Seite 9 prüfen.
4. Push und Pull RequestBranch hochladen, auf GitHub „Compare & pull request“. In der Beschreibung „Closes #42“.
5. Automatischer BuildAL-Go baut App und Test-App und führt alle Tests aus (Abschnitt 6).
6. ReviewEin Kollege liest den Diff, kommentiert, gibt frei. Arbeitest du allein, liest du deinen eigenen Diff. Das findet erstaunlich viel.
7. Merge„Squash and merge“ macht aus allen Commits des Branches einen einzigen in main. Der Branch wird gelöscht.
8. CI/CD auf mainAL-Go baut erneut und liefert auf Wunsch gleich in eine Testumgebung.
Branch-NameZweck
mainAuslieferbarer Stand
feature/...Neue Funktion
bugfix/...Fehlerbehebung
release/1.1Nur bei Bedarf: Wartungslinie für einen Hotfix auf eine bereits ausgelieferte Version, während main schon weiter ist
Kurzlebige Branches. Ein Branch, der zwei Wochen lebt, erzeugt Konflikte. Zerlege große Aufgaben in Teile, die jeweils nach ein bis zwei Tagen in main landen. Halbfertiges versteckst du nicht im Branch, sondern hinter einer fehlenden Aktion oder einem Schalter in der Einrichtung.

4Konflikte und Repository-Regeln

Typische Konfliktquellen in AL-Projekten

QuelleProblemAbhilfe
ObjektnummernZwei Entwickler vergeben in ihren Branches dieselbe Nummer. Git meldet keinen Konflikt, weil es verschiedene Dateien sind; erst der Build scheitert.AL Object ID Ninja (Seite 2) vergibt Nummern über einen gemeinsamen Dienst; der Build im Pull Request fängt den Rest.
Feldnummern in derselben Table ExtensionWie oben, innerhalb einer DateiEbenso; Konflikt wird beim Merge sichtbar
Übersetzungsdateien (.xlf)Große XML-Dateien, an denen jede Textänderung dreht.g.xlf nicht einchecken oder beim Konflikt neu erzeugen; die .de-DE.xlf nach dem Merge mit NAB AL Tools abgleichen
Berechtigungssatz „Objects“Jede neue Objektdatei ändert dieselbe ListeZeilen alphabetisch halten, dann lassen sich Konflikte leicht auflösen
app.json (Version)Zwei Branches erhöhen die VersionVersion nicht im Feature-Branch ändern, sondern über den Workflow (Abschnitt 8)
Layoutdateien (.docx, .xlsx)Binär, nicht zusammenführbarAbsprechen, wer das Layout ändert; im Konfliktfall eine Fassung wählen

Einen Konflikt löst du in VS Code: Die Datei zeigt beide Fassungen mit den Schaltflächen „Aktuelle Änderung“, „Eingehende Änderung“ und „Beide“. Danach bauen, testen, committen.

Regeln auf GitHub

EinstellungWirkung
Branch-Schutz für mainKein direkter Push; Änderungen nur per Pull Request
Erforderliche StatusprüfungMerge erst, wenn der Pull-Request-Build grün ist
Erforderliches ReviewMindestens eine Freigabe (im Zwei-Personen-Team sinnvoll, allein abschalten)
Lineare HistorieNur Squash oder Rebase, kein Merge-Commit-Geflecht
Secret Scanning, Push ProtectionGitHub blockiert Commits, die erkennbare Zugangsdaten enthalten

Was nie ins Repository gehört

Kennwörter, Client Secrets, Tokens, Lizenzdateien, Kundendaten, Datenbanksicherungen, die .app-Dateien aus .alpackages. Was einmal gepusht wurde, bleibt in der Geschichte, auch wenn du die Datei löschst. Ein versehentlich eingechecktes Secret gilt als verbrannt: sofort im Entra-Portal neu erzeugen, nicht nur aus Git entfernen.

5AL-Go für GitHub einrichten

AL-Go für GitHub ist Microsofts fertige Sammlung von GitHub-Actions-Workflows für Business-Central-Apps. Du schreibst keine Pipeline, du übernimmst eine Vorlage und stellst sie über Einstellungsdateien ein. Es gibt zwei Vorlagen: microsoft/AL-Go-PTE für Per-Tenant-Extensions und microsoft/AL-Go-AppSource für AppSource-Apps.

Weg A: Neues Repository aus der Vorlage

Auf GitHub microsoft/AL-Go-PTE öffnen, „Use this template“ → „Create a new repository“, privat anlegen, klonen und die Ordner app und test hineinkopieren.

Weg B: Vorhandenes Repository umstellen

Für das Kursprojekt abc-kundenapp übernimmst du die Ordner .github und .AL-Go aus der Vorlage in dein Repository und checkst sie ein. Danach führst du einmal den Workflow „Update AL-Go System Files“ aus, damit alles zum aktuellen Stand der Vorlage passt.

abc-kundenapp/
├── .github/
│   ├── workflows/              <- die Workflows von AL-Go (nicht von Hand ändern)
│   └── AL-Go-Settings.json     <- Einstellungen für das Repository
├── .AL-Go/
│   └── settings.json           <- Einstellungen für das Projekt
├── app/                        <- Haupt-App
├── test/                       <- Test-App
├── CLAUDE.md                   <- Abschnitt 12
└── abc-kundenapp.code-workspace

AL-Go findet Apps selbst: Jeder Ordner mit einer app.json ist eine App; hängt sie von den Testbibliotheken ab, gilt sie als Test-App. In den Einstellungen kannst du die Ordner auch ausdrücklich nennen (appFolders, testFolders).

Kosten und Laufzeit: Die Workflows laufen auf Rechnern von GitHub (Actions-Minuten; private Repositories haben ein monatliches Freikontingent). Ein Lauf mit Container und Tests dauert spürbar länger als dein lokaler Build, typischerweise eine Viertelstunde oder mehr. Wer häufig baut, stellt einen eigenen Runner bereit oder nutzt die Einstellung, ohne Container zu kompilieren.

6Die Workflows von AL-Go

Die Workflows findest du im Repository unter „Actions“. Manche starten von selbst, andere stößt du mit „Run workflow“ an.

WorkflowStartAufgabe
Pull Request BuildAutomatisch bei jedem Pull RequestBaut alle Apps, führt die Tests aus, meldet das Ergebnis am Pull Request
CI/CDAutomatisch bei jedem Push auf mainBaut, testet, legt die .app-Dateien als Artefakte ab und liefert bei eingerichteter Umgebung aus
Create ReleaseVon HandMacht aus einem erfolgreichen Build ein GitHub-Release mit Tag, Notizen und .app-Dateien
Increment Version NumberVon HandErhöht die Version in allen app.json-Dateien und erzeugt dafür einen Pull Request
Publish To EnvironmentVon HandSpielt einen Build oder ein Release in eine Business-Central-Umgebung ein
Test Current / Next Minor / Next MajorVon Hand oder nach ZeitplanBaut und testet gegen die aktuelle, die nächste Minor- und die nächste Major-Version von Business Central
Create a new app / Create a new test appVon HandLegt einen neuen App-Ordner samt app.json an
Create Online Dev. EnvironmentVon HandErzeugt eine Online-Sandbox für die Entwicklung
Update AL-Go System FilesVon Hand oder nach ZeitplanHolt die neueste Fassung der Workflows aus der Vorlage; braucht das Secret GhTokenWorkflow
„Test Next Major“ ist der eigentliche Gewinn. Auf Seite 9 stand: Tests zeigen dir vor dem Update, ob deine App mit der nächsten Version noch läuft. Dieser Workflow tut genau das. Lass ihn wöchentlich nach Zeitplan laufen; scheitert er, hast du Wochen statt Stunden Zeit zum Reagieren.

7Einstellungen von AL-Go

Einstellungen stehen in JSON-Dateien und werden in fester Reihenfolge zusammengeführt: Organisation, Repository (.github/AL-Go-Settings.json), Projekt (.AL-Go/settings.json), dazu Fassungen je Workflow oder Benutzer.

// .AL-Go/settings.json
{
  "country": "de",
  "appFolders": [ "app" ],
  "testFolders": [ "test" ],
  "enableCodeCop": true,
  "enableUICop": true,
  "enablePerTenantExtensionCop": true,
  "rulesetFile": "app/abc.ruleset.json",
  "failOn": "error"
}
// .github/AL-Go-Settings.json
{
  "type": "PTE",
  "templateUrl": "https://github.com/microsoft/AL-Go-PTE@main",
  "versioningStrategy": 0,
  "environments": [ "TEST", "PROD" ],
  "DeployToTEST": {
    "EnvironmentName": "TEST",
    "ContinuousDeployment": true
  },
  "DeployToPROD": {
    "EnvironmentName": "Production",
    "ContinuousDeployment": false
  }
}
EinstellungBedeutung
countryLokalisierung, gegen die gebaut wird. Für dich de, at oder ch.
artifactLegt die Business-Central-Version fest, gegen die gebaut wird. Ohne Angabe die aktuelle.
enableCodeCop usw., rulesetFileDieselben Analyzer und dasselbe Ruleset wie lokal (Seite 9).
versioningStrategyWie Build- und Revisionsnummer der erzeugten App entstehen (Abschnitt 8).
environments, DeployTo…Zielumgebungen und ob nach jedem Build auf main automatisch geliefert wird.
useCompilerFolderKompiliert ohne Docker-Container. Schneller, aber Tests brauchen weiterhin eine laufende Umgebung.
doNotRunTestsSchaltet Tests ab. Nur als Notbehelf.
installApps, appDependencyProbingPathsFremde Apps, von denen deine App abhängt, und woher sie kommen.

Die vollständige Liste mit Erklärungen steht in der Dokumentation von AL-Go unter „Settings“.

8Versionieren und freigeben

Auf Seite 8 hast du die Version von Hand in app.json erhöht und einen Tag gesetzt. Mit AL-Go teilt ihr euch die Arbeit: Du bestimmst Major und Minor, die Pipeline vergibt Build und Revision.

StelleWer setzt sie?Beispiel
Major.MinorDu, über den Workflow „Increment Version Number“ (Eingabe z. B. +0.1 oder 2.0)1.2
Build.RevisionAL-Go beim Bauen, je nach versioningStrategy aus der Laufnummer des Workflows oder aus dem Datum1.2.57.0

Damit hat jeder Build eine eindeutige, aufsteigende Version, und du kannst jede .app-Datei beim Kunden einem Lauf und einem Commit zuordnen.

Ablauf einer Freigabe

Nr.Schritt
1Alle Pull Requests für die Version sind in main; der letzte CI/CD-Lauf ist grün.
2Die Version läuft in der Testumgebung, der Kunde hat abgenommen.
3Workflow „Create Release“ starten: Name, Tag (z. B. 1.2.0), Art der Version. AL-Go erzeugt das Release mit den .app-Dateien und Versionshinweisen aus den Pull Requests.
4„Publish To Environment“ für die Produktion mit genau diesem Release.
5„Increment Version Number“, damit main für die nächste Version weiterzählt. „Create Release“ bietet das als Option gleich mit an.

Hotfix auf eine ausgelieferte Version

Ist main schon bei 1.3, der Kunde aber auf 1.2 und braucht sofort eine Korrektur, legst du vom Release-Tag einen Branch release/1.2 an (der Workflow „Create Release“ kann das mit erledigen), behebst dort den Fehler, lässt AL-Go bauen und lieferst 1.2.x aus. Dieselbe Korrektur muss zusätzlich nach main. Vergisst du das, kommt der Fehler mit 1.3 zurück.

9Auslieferung in den Tenant

Es gibt drei Wege, eine Per-Tenant-Extension in eine Online-Umgebung zu bringen.

WegVorgehenGeeignet für
VS Code (F5)Veröffentlicht als Entwicklerversion. Nur in Sandboxes, und die Entwicklerversion kann bei Umgebungsupdates entfernt werden.Entwicklung, nie für Auslieferung
Admin CenterIm Business Central Admin Center die Umgebung öffnen, dort die Apps der Umgebung verwalten und die .app-Datei hochladen, installieren oder für das nächste Update einplanen.Gelegentliche Auslieferung von Hand
AL-Go „Publish To Environment“ oder Continuous DeploymentDie Pipeline spielt den geprüften Build selbst ein.Regelmäßige Auslieferung, mehrere Umgebungen
Änderung gegenüber Seite 8: Dort stand, der Administrator lade die App in der Erweiterungsverwaltung über „Erweiterung hochladen“ hoch. Laut Microsoft wird das Hochladen und Installieren von Per-Tenant-Extensions über die Seite „Erweiterungsverwaltung“ (und über die Automation API) abgelöst: Seit 2026 Release Wave 1 sollen Administratoren von Online-Umgebungen dafür das Admin Center oder die Admin Center API verwenden; als Upload-Weg soll die Seite voraussichtlich mit 2027 Release Wave 1 entfallen. Zum Ansehen der installierten Erweiterungen bleibt sie erhalten. Plane Anleitungen für Kunden gleich mit dem Admin Center. Quelle: Deprecated features in the platform.

Anmeldung der Pipeline: das Secret AuthContext

Damit AL-Go in eine Umgebung liefern darf, braucht es Zugangsdaten als GitHub-Secret. AL-Go sucht der Reihe nach <Umgebungsname>-AuthContext, <Umgebungsname>_AuthContext und zuletzt das allgemeine AuthContext. Der empfohlene Weg ist eine App-Registrierung in Entra ID (Service-to-Service):

Nr.Schritt
1App-Registrierung in Microsoft Entra ID anlegen, wie auf Seite 7 für die Schnittstelle, aber eine eigene nur für die Auslieferung.
2In Business Central auf der Seite „Microsoft Entra-Anwendungen“ die Client-ID eintragen und die Berechtigungssätze D365 AUTOMATION und EXTEN. MGT. - ADMIN zuweisen.
3Anmeldung wählen: am besten Federated Credential (das Repository wird in der App-Registrierung eingetragen, es gibt kein gespeichertes Kennwort), sonst Client Secret.
4Auf GitHub unter Settings → Secrets and variables → Actions das Secret anlegen, z. B. TEST-AuthContext.
// Wert des Secrets mit Federated Credential – eine Zeile, ohne Umbrüche
{"tenantId":"<tenantId>","scopes":"https://api.businesscentral.dynamics.com/","clientId":"<clientId>"}

// Wert des Secrets mit Client Secret – eine Zeile, ohne Umbrüche
{"tenantId":"<tenantId>","scopes":"https://api.businesscentral.dynamics.com/","clientId":"<clientId>","clientSecret":"<clientSecret>"}
Zwei Stolpersteine aus der AL-Go-Dokumentation: Das JSON muss komprimiert in einer Zeile stehen, sonst maskiert GitHub einzelne Zeilen wie die geschweifte Klammer und die Workflows brechen. Und: Fehlt das Secret für eine bestimmte Umgebung, greift AL-Go ohne Warnung auf das allgemeine AuthContext zurück. Betreust du mehrere Kunden in einem Repository, lege je Umgebung ein eigenes Secret an und kein allgemeines. Quelle: AL-Go: Secrets.

Für die Produktion richtest du auf GitHub zusätzlich ein „Environment“ mit Pflichtfreigabe ein: Der Workflow hält an, bis eine benannte Person auf „Approve“ klickt. In privaten Repositories setzt das einen bezahlten GitHub-Plan voraus; ohne ihn lieferst du in die Produktion von Hand über „Publish To Environment“.

10Umgebungen und Updates

UmgebungTypInhaltAuslieferung
Lokaler Container je EntwicklerDockerCRONUS, TestbibliothekenF5
DEVOnline-SandboxCRONUS oder anonymisierte DatenF5 oder automatisch aus Feature-Branches
TESTOnline-SandboxKopie der ProduktionAutomatisch nach jedem Build auf main
PRODProduktionEchtdatenNur freigegebene Releases, mit Freigabe
Sandbox als Kopie der Produktion: Sie enthält echte Kundendaten. Beim Kopieren werden zwar Aufgabenwarteschlange und ausgehende Verbindungen angehalten, aber prüfe E-Mail-Konten, Schnittstellen-Einrichtungen und Zahlungsdienste, bevor jemand darin „nur testet“. Sonst gehen Testrechnungen an echte Kunden.

Plattform-Updates im Blick behalten

WasWannDeine Aufgabe
Minor-UpdateMonatlichIn der Regel nichts; „Test Next Minor“ zeigt Ausnahmen
Major-UpdateZweimal im Jahr (Release Wave 1 im Frühjahr, Wave 2 im Herbst)Vorher gegen die Vorschau bauen und testen, Warnungen zu veralteten Elementen abarbeiten
Update-FensterIm Admin Center je Umgebung einstellbarMit dem Kunden festlegen; TEST vor PROD aktualisieren lassen
Veraltete ElementeMindestens zwölf Monate zwischen Markierung und Entfernung (Abschnitt 19)AL0432-Warnungen nicht liegen lassen

Kompiliert deine App gegen die neue Version nicht mehr, kann die Umgebung nicht aktualisiert werden. Microsoft benachrichtigt den Administrator, und nach Ablauf einer Frist wird die App im Zweifel deinstalliert, damit das Update durchläuft. Genau dafür lädst du eine angepasste Fassung vorab für „das nächste Major-Update“ hoch (Seite 8).

11Claude Code im Repository

Claude Code ist ein Coding-Agent: Er liest die Dateien im Repository, schlägt Änderungen vor, schreibt sie, führt Befehle aus und arbeitet in Schleifen, bis ein Ziel erreicht ist. Für AL-Entwicklung ist das dann wertvoll, wenn Claude nicht nur Text erzeugt, sondern kompilieren und die Fehler selbst lesen kann. Sonst rät es bei Event-Namen und Signaturen genauso, wie dieser Kurs es an manchen Stellen musste.

EinsatzformBeschreibungGeeignet für
Lokal im RepositoryIm Terminal im Projektordner gestartet; arbeitet auf deinem Branch, du siehst jeden SchrittTägliche Entwicklung
In GitHubReagiert auf @claude in Issues und Pull Requests und erstellt selbst Pull Requests (Abschnitt 15)Kleine, klar beschriebene Aufgaben; Review
Chat mit Repository als KontextGespräch über Code, Architektur, Fehlersuche; ohne CompilerErklären, Entwürfe, Fragen wie in diesem Kurs

Wo Claude bei AL stark ist, und wo nicht

StarkMit Vorsicht
Gerüste: Tabelle, Liste, Karte, Berechtigungssatz, Test-Codeunit nach vorhandenem Muster
C/AL-Logik in AL-Schreibweise übertragen
Tests zu vorhandenem Code schreiben
Analyzer-Warnungen abarbeiten
Übersetzungen in der XLIFF-Datei ergänzen
Code erklären, auch fremden Standardcode
Diffs prüfen und auf Lücken hinweisen
Namen von Events, Prozeduren und Feldern der Base Application: ohne Symbolsuche oft plausibel, aber falsch
Was in welcher Version verfügbar ist
Regeln für Schemaänderungen und Upgrade: Claude kennt deine ausgelieferten Versionen nicht
Fachliche Entscheidungen: Was soll bei Storno passieren? Das weißt nur du
Alles, was Produktionsdaten oder Zugangsdaten berührt
Du bleibst verantwortlich. Claude arbeitet im Feature-Branch, nie direkt auf main. Jede Änderung geht durch denselben Pull Request mit Build, Tests und deinem Review wie die eines Kollegen. Gib Claude keine Zugangsdaten zur Produktion und lass es nicht in Produktionsumgebungen veröffentlichen.

12Die Datei CLAUDE.md

Claude Code liest beim Start die Datei CLAUDE.md im Wurzelordner des Repositorys. Dort steht alles, was ein neuer Kollege am ersten Tag wissen müsste. Ohne sie beginnt jede Sitzung bei null und Claude erfindet Präfix, Nummern und Stil neu.

# ABC Kundenapp

Per-Tenant-Extension für Dynamics 365 Business Central (Online, Lokalisierung DE).
Sprache: AL. Zielversion und Runtime stehen in app/app.json – nicht ändern.

## Aufbau
- app/   Haupt-App (wird ausgeliefert), Objekt-IDs 50100–50149
- test/  Test-App, Objekt-IDs 50150–50199, hängt von app/ ab
- Eine Datei je Objekt in src/, Dateiname: <Objektname ohne Leerzeichen>.<Typ>.al
  (z. B. ABCCustomerVisit.Table.al, ABCCustomerCardExt.PageExt.al)

## Feste Regeln
- Präfix "ABC " für alle Objekte, Felder in Extensions und Steuerelemente in Page Extensions.
- Nächste freie Objekt- und Feldnummer immer über das Werkzeug al_getnextobjectid
  ermitteln, nie raten.
- Captions, ToolTips und Labels nur auf Englisch im Code. Deutsche Texte gehören in
  app/Translations/ABC Kundenapp.de-DE.xlf. Die .g.xlf nie bearbeiten.
- Jedes Feld: Caption, ToolTip (beginnt mit "Specifies"), DataClassification.
- Kein WITH, Felder auf Pages immer mit Rec. qualifizieren.
- Texte in Error/Message/Confirm als Label mit Endung Err/Msg/Qst.
- Enum statt Option. Neue Enums: Extensible = true.
- Standardlogik nur über Event Subscriber ändern. Subscriber liegen in eigenen
  Codeunits (Name endet auf "Subscribers") und enthalten keine Geschäftslogik.
- Kein Commit in Subscribern. Keine Webaufrufe in Schreibtransaktionen.
- Neue Tabelle => in die Berechtigungssätze ABC Visit - Objects/Read/Edit/Admin aufnehmen.

## Schema – besonders wichtig
Version 1.1 ist beim Kunden ausgeliefert. Deshalb:
- Keine Felder löschen, umbenennen, kürzen oder im Typ ändern.
- Keine Primärschlüssel ändern.
- Statt dessen: neues Feld, altes auf ObsoleteState = Pending, Upgrade-Schritt mit
  Upgrade Tag in codeunit "ABC Upgrade". Vorher nachfragen.

## Tests
- Zu jeder Änderung an Logik gehört ein Test in test/src.
- Aufbau: [SCENARIO] / [GIVEN] / [WHEN] / [THEN], Daten über Library-Codeunits erzeugen.
- Kein Test darf sich auf CRONUS-Stammdaten verlassen.

## Arbeitsweise
- Vor dem Schreiben: Event- und Prozedurnamen der Base Application mit
  al_symbolsearch nachschlagen. Nichts aus dem Gedächtnis übernehmen.
- Nach jeder Änderung: al_compile, dann al_getdiagnostics. Erst fertig melden,
  wenn es keine Fehler und keine neuen Warnungen gibt.
- Nicht veröffentlichen (al_publish) ohne ausdrückliche Aufforderung.
  Nie in eine Produktionsumgebung.
- app.json (id, version, idRanges, runtime), launch.json und die Dateien unter
  .github/ und .AL-Go/ nicht ändern.
- Kleine Commits mit deutscher Nachricht im Imperativ. Nicht auf main arbeiten.

## Nicht tun
- Keine Zugangsdaten, Tenant-IDs oder Kundendaten in Dateien schreiben.
- Keine Analyzer-Regeln per Pragma oder Ruleset abschalten, um einen Build grün zu bekommen.
GrundsatzErklärung
Kurz und konkretDie Datei wird bei jeder Sitzung gelesen. Schreibe Regeln, keine Aufsätze; diesen Kurs kopierst du nicht hinein.
Begründungen dort, wo Verstöße teuer sindDie Schema-Regel steht mit Grund da, damit Claude sie auch in Fällen anwendet, die du nicht aufgezählt hast.
Lebendes DokumentMacht Claude denselben Fehler zweimal, ergänzt du eine Zeile. Die Datei liegt im Repository und geht durch denselben Review wie Code.
Auch für MenschenWas dort steht, sind eure Teamregeln. Ein neuer Kollege liest sie genauso.

13AL MCP Server

Der AL MCP Server ist ein eigenständiger Server von Microsoft, der die AL-Werkzeuge über das Model Context Protocol für beliebige KI-Agenten bereitstellt: bauen, kompilieren, veröffentlichen, Symbole suchen, Diagnosen lesen. Er läuft als eigener Prozess und braucht kein geöffnetes VS Code. Voraussetzungen laut Microsoft: AL-Language-Erweiterung ab Version 17.0 (sie bringt das Programm altool mit), die .NET-8-Laufzeit und für Werkzeuge mit Serverzugriff eine Netzwerkverbindung zur Umgebung.

WerkzeugAufgabeNutzen für Claude
al_compileCode prüfen, ohne .app zu erzeugen; schneller als ein voller BuildNach jeder Änderung die eigenen Fehler sehen
al_getdiagnosticsCompiler- und Analyzer-Meldungen gefiltert abrufenGezielt Fehler und Warnungen abarbeiten
al_symbolsearchSymbole im Projekt, in den Abhängigkeiten oder auf der Umgebung suchenEchte Event-, Feld- und Prozedurnamen statt geratener
al_getnextobjectidNächste freie Objektnummern reservierenKeine Nummernkonflikte
al_buildProjekt bauen und .app erzeugenPaket für den Test
al_downloadsymbolsSymbolpakete ladenFrisches Projekt arbeitsfähig machen
al_getpackagedependenciesAbhängigkeiten aus app.json auflistenÜberblick
al_addprojectWeiteres Projekt nach dem Start hinzufügenApp und Test-App gemeinsam
al_publishIn eine Umgebung veröffentlichenNur auf Aufforderung und nur in Sandboxes
al_auth_login, al_auth_logoutAnmeldung an Entra ID im Browser, Token zwischenspeichern und löschenVor Cloud-Zugriffen

Start und Einbindung

# Start von Hand, zwei Projekte, Standard-Ein-/Ausgabe
altool launchmcpserver "C:\Repos\abc-kundenapp\app" "C:\Repos\abc-kundenapp\test" --transport stdio
// .mcp.json im Wurzelordner des Repositorys
{
  "mcpServers": {
    "al": {
      "command": "altool",
      "args": [
        "launchmcpserver",
        "C:\\Repos\\abc-kundenapp\\app",
        "C:\\Repos\\abc-kundenapp\\test",
        "--transport", "stdio"
      ]
    }
  }
}

Der Agent startet den Server selbst und fragt die verfügbaren Werkzeuge ab. Der Server hält über seine Laufzeit eine Kompiliersitzung; Symbole und Zwischenstände bleiben zwischen den Aufrufen erhalten, was die Schleife aus Kompilieren, Fehler lesen, Korrigieren und erneut Kompilieren schnell macht. Bei mehreren Projekten wählt der Parameter projectPath das Ziel eines Aufrufs. Quelle und Einzelheiten: AL MCP Server (Microsoft Learn).

Praktischer Hinweis: altool liegt im Installationsordner der AL-Erweiterung und steht nicht von selbst im Suchpfad. Trage entweder den vollen Pfad als command ein oder nimm den Ordner in die Umgebungsvariable PATH auf. Da der Pfad die Versionsnummer der Erweiterung enthält, ändert er sich mit jedem Update; die PATH-Lösung oder ein kleines Startskript erspart dir das Nachziehen. Wie genau dein Agent MCP-Server registriert, steht in dessen Dokumentation.

14Aufgaben für Claude beschreiben

Deine ursprüngliche Frage in diesem Kurs war: „Ihm Objekte beschreiben mit ID und Typ?“ Die Antwort nach zehn Seiten: Den Typ ja, die ID nicht. Die Nummer holt sich Claude über al_getnextobjectid, das Präfix aus CLAUDE.md. Du beschreibst das, was nur du weißt: das fachliche Verhalten.

Zu dünn

Mach eine Tabelle für
Besuchspläne mit Page.

Brauchbar

Neue Funktion "Besuchsplan".

Tabelle "ABC Visit Plan":
- Customer No. (Pflicht, Relation Customer)
- Planned Date (Pflicht, nicht in der
  Vergangenheit)
- Visit Type (Enum "ABC Visit Type",
  Vorgabe aus "ABC Visit Setup")
- Salesperson Code (Relation
  Salesperson/Purchaser, Vorgabe vom
  Debitor)
- Status: Open, Done, Cancelled
PK: fortlaufende Entry No.

Liste mit Suche "Visit Plans", editierbar.
Aktion "Mark as Done": legt einen
"ABC Customer Visit" mit dem geplanten
Datum an und setzt Status Done. Nur bei
Status Open, sonst Fehler.

Berechtigungssätze ergänzen. Tests für:
Vorgabewerte, Datum in Vergangenheit
abgelehnt, Mark as Done legt Besuch an,
zweites Mark as Done scheitert.

Zeig mir zuerst deinen Plan
(Objekte, Dateien), dann umsetzen.
Baustein einer guten AufgabeWarum
Fachliches Verhalten mit Regeln und AusnahmenDas kann Claude nicht wissen
Verweis auf vorhandene Muster („wie die Besuchsliste“)Einheitlicher Stil ohne lange Erklärung
Erwartete TestsSie sind deine Abnahme: Was getestet ist, musst du nicht von Hand prüfen
„Erst Plan, dann umsetzen“Ein falscher Ansatz kostet dich eine Minute Lesen statt zwanzig Dateien Review
Abgrenzung („nichts an der Besuchstabelle ändern“)Verhindert gut gemeinte Umbauten
Kleine AufgabenEin Pull Request, den du in zehn Minuten lesen kannst

Die Arbeitsschleife

Nr.SchrittWer
1Branch anlegen, Aufgabe beschreibenDu
2Plan vorschlagenClaude
3Plan prüfen, korrigieren, freigebenDu
4Symbole nachschlagen, Dateien schreiben, kompilieren, Fehler behebenClaude mit AL MCP Server
5Diff lesen, mit F5 ausprobieren, Tests laufen lassenDu
6Nachbessern lassen oder selbst ändernBeide
7Pull Request, Build durch AL-Go, MergeDu
Worauf du im Review bei KI-Code besonders achtest: erfundene oder veraltete Events (der Compiler fängt die meisten, aber nicht alle – ein Subscriber auf ein falsches, aber existierendes Event kompiliert), Tests, die immer grün sind (asserterror ohne Fehlerprüfung, Seite 9), abgeschaltete Regeln, vergessene Berechtigungssätze und Übersetzungen, Commit an Stellen ohne Grund, Schemaänderungen an ausgelieferten Tabellen und unnötig viel Code für eine einfache Sache.

15Claude in Issues und Pull Requests

Mit der Claude-Code-GitHub-Integration reagiert Claude auf Erwähnungen in Issues und Pull Requests. Die Einrichtung startest du lokal in Claude Code mit dem Befehl /install-github-app; er installiert die GitHub-App im Repository und legt Workflow und Secret an. Die Beschreibung findest du unter Claude Code GitHub Actions.

AnwendungBeispiel
Review eines Pull Requests@claude prüfe diesen PR gegen die Regeln in CLAUDE.md, besonders Schemaänderungen und fehlende Tests
Kleine Aufgabe aus einem Issue@claude setze dieses Issue um und erstelle einen Pull Request
Fehlgeschlagenen Build erklären@claude warum scheitert der Build? Schlage eine Korrektur vor
Versionshinweise@claude fasse die Änderungen seit dem letzten Release für den Kunden auf Deutsch zusammen
Grenze in GitHub: Der Workflow läuft auf einem Rechner von GitHub ohne deine AL-Erweiterung und ohne Symbole. Ohne zusätzliche Einrichtung kann Claude dort nicht kompilieren. Der eigentliche Prüfer bleibt deshalb der Pull-Request-Build von AL-Go: Claude schreibt, AL-Go baut und testet, du gibst frei. Für umfangreichere Aufgaben arbeitest du lokal, wo der AL MCP Server zur Verfügung steht.

16Alten Code umwandeln: Txt2AL

Du hast vermutlich Jahre an C/AL-Code. Niemand tippt den ab. Microsoft hat dafür das Kommandozeilenprogramm Txt2AL ausgeliefert, das Textexporte von C/AL-Objekten in AL-Dateien umwandelt. Es lag den Versionen NAV 2018 bis Business Central 14 bei.

Für NAV 2017 bedeutet das: Txt2AL verlangt den Export in der „neuen Syntax“, die es erst ab NAV 2018 gibt. Deine Objekte müssen also zuerst in eine Datenbank der Version 14 gebracht werden. Dieser Schritt ist für den Datenweg ohnehin nötig (Abschnitt 18).

Ablauf

# 1. Eigene Objekte (neue Tabellen, Pages, Codeunits, Reports) aus BC 14 exportieren
finsql.exe Command=ExportToNewSyntax, File="C:\Convert\New\objects.txt", `
    Database="BC14", ServerName="localhost", Filter="Id=50000..99999"

# 2. Für geänderte Standardobjekte: Deltas gegen den unveränderten Standard bilden
#    (Standard und geänderte Fassung jeweils in neuer Syntax exportiert)
Compare-NAVApplicationObject `
    -OriginalPath "C:\Convert\Base\*.txt" `
    -ModifiedPath "C:\Convert\Modified\*.txt" `
    -DeltaPath    "C:\Convert\Delta" `
    -ExportToNewSyntax

# 3. Umwandeln
txt2al.exe --source="C:\Convert\New"   --target="C:\Convert\AL\New"   --rename
txt2al.exe --source="C:\Convert\Delta" --target="C:\Convert\AL\Delta" --rename --extensionStartId=50100
Was Txt2AL liefertWas es nicht liefert
Eigene Tabellen, Pages, Codeunits, Reports, XMLports, Queries als AL-Objekte
Aus Deltas: neue Felder als tableextension, neue Steuerelemente und Aktionen als pageextension
Berichtslayouts als Dateien
Codeänderungen in Standardobjekten: Sie werden nicht zu Event Subscribern, sondern fehlen oder stehen als Kommentar da
Ersatz für DotNet, Dateizugriffe, Automation (Seite 6)
Präfixe, ToolTips, DataClassification, Enums statt Options
Code ohne WITH und mit Rec.
Berechtigungssätze, Tests

Das Ergebnis ist Rohmaterial, kein Produkt. Es kompiliert selten auf Anhieb gegen "target": "Cloud". Hier spielt Claude seine Stärke aus: Die mechanische Nacharbeit (WITH entfernen, Rec. ergänzen, Labels, ToolTips, Präfix, Options zu Enums, Analyzer-Warnungen) ist genau die Sorte Arbeit, die ein Agent mit Compiler-Zugriff zuverlässig und geduldig erledigt. Die fachliche Arbeit (welche Standardänderung wird welcher Subscriber, was entfällt, weil der Standard es heute kann) bleibt bei dir.

17Von der Anpassung zur Extension

Der häufigste Fehler beim Umstieg ist, die alte Lösung eins zu eins nachzubauen. Zwischen NAV 2017 und heute liegen viele Versionen Standardentwicklung. Gehe deine Anpassungen einzeln durch und sortiere sie.

KategorieTypischer AnteilVorgehen
Kann der Standard heuteMehr als gedachtWeglassen, Standard einrichten. Beispiele: E-Mail-Versand von Belegen, Excel-Layouts, Genehmigungen, Dimensionskorrekturen, Analysemodus statt eigener Listenberichte
Wird nicht mehr gebrauchtErheblichWeglassen. Frage den Fachbereich; vieles wurde für jemanden gebaut, der längst nicht mehr im Haus ist
Gibt es als AppSource-AppEinige große BrockenKaufen statt bauen: Dokumentenmanagement, Zahlungsverkehr, EDI, Lagerscanner
Geht ohne CodeEinigePower Automate, Personalisierung, Profile, Berichtslayouts des Kunden
Eigene Felder, Tabellen, AuswertungenDer KernAls Extension neu bauen, Txt2AL als Starthilfe
Eingriffe in BuchungsroutinenWenige, aber heikleEvent suchen (Seite 5). Fehlt eines, bei Microsoft im Repository für Event-Anfragen beantragen und bis dahin einen anderen Weg wählen
Geht in der Cloud grundsätzlich nichtSeltenLokale Dateien, COM, direkter SQL-Zugriff: Ersatz nach Seite 6 oder Auslagerung in einen Azure-Dienst

Eine oder mehrere Apps?

SchnittVorteilNachteil
Eine App je KundeEinfach, keine AbhängigkeitenWird mit den Jahren groß; nichts wiederverwendbar
Basis-App plus Fach-AppsWiederverwendbare Teile, getrennte AuslieferungAbhängigkeiten, Reihenfolge bei Upgrade, mehr Verwaltung

Beginne mit einer App. Teile erst, wenn du einen konkreten Grund hast, etwa denselben Baustein für einen zweiten Kunden.

18Der Weg der Daten

Es gibt zwei grundsätzlich verschiedene Wege von einer NAV-2017-Datenbank nach Business Central Online.

Weg 1: Technisches Upgrade mit vollständiger Historie

Ein direktes Upgrade von NAV 2017 auf eine aktuelle Version gibt es nicht. Microsoft nennt für NAV 2017 (Version 10) als Ziel der aktuellen Versionen diesen Pfad: zuerst auf Business Central Spring 2019 (Version 14), dann auf 2024 Release Wave 2 (Version 25), dann auf die Zielversion; der Pfad verlangt die Umwandlung der Anwendung von C/AL nach AL. Version 25 ist dabei eine Pflichtstation („stepping stone“), weil Microsoft seit Version 26 die über die Jahre als entfernt markierten Tabellen und Felder tatsächlich aus dem Schema löscht. Die Cloud-Migration nach Version 26 oder höher läuft deshalb ebenfalls über Version 25. Quellen: Supported upgrade paths und Deprecated features in the platform.

Nr.StationWas passiert
1NAV 2017 → Business Central 14 (noch C/AL)Klassisches Upgrade wie früher: Objekte zusammenführen, Datenbank technisch konvertieren, Datenupgrade mit dem Upgrade Toolkit. Deine Anpassungen sind danach noch C/AL-Änderungen im Standard.
2Anpassungen in Extensions umwandelnTxt2AL und Nacharbeit (Abschnitte 16 und 17). Die Felder in den Table Extensions bekommen dieselben Nummern und Namen wie die alten 50000er-Felder, eigene Tabellen behalten Nummer und Namen. Nur so lassen sich die vorhandenen Daten der Extension zuordnen.
3Version 14 → Version 25 on-premisesWechsel auf Microsofts Base Application als Extension. Die Daten deiner Anpassungen gehen dabei aus den Standardtabellen in den Besitz deiner Extension über. Dafür gibt es ein eigenes, in der Upgrade-Dokumentation beschriebenes Verfahren.
4Cloud-MigrationIn der Online-Umgebung dieselben Extensions installieren, dann die geführte Einrichtung für die Cloud-Migration ausführen. Sie kopiert die Daten tabellenweise aus der lokalen SQL-Datenbank in den Online-Tenant und führt anschließend das Datenupgrade auf die Online-Version aus.
5NacharbeitBenutzer und Berechtigungen neu zuordnen, Schnittstellen umstellen (OAuth, APIs), Berichtslayouts, Aufgabenwarteschlange, Abnahme durch den Fachbereich.

Weg 2: Neueinführung mit Datenübernahme

Nr.Schritt
1Leere Online-Umgebung einrichten, Standard konfigurieren, Extension installieren
2Stammdaten über Konfigurationspakete oder APIs übernehmen: Debitoren, Kreditoren, Artikel, Sachkonten, Preise, deine eigenen Tabellen
3Offene Posten, Lagerbestände und Salden zum Stichtag über Buch.-Blätter einbuchen
4Offene Aufträge und Bestellungen übernehmen oder zum Stichtag abarbeiten
5Altsystem lesend weiterbetreiben oder die Historie in ein Auswertungssystem auslagern

Abwägung

KriteriumWeg 1: UpgradeWeg 2: Neueinführung
HistorieVollständig im neuen SystemBleibt im Altsystem
Aufwand technischHoch: drei Stationen, Zwischenversionen aufbauen, alle Anpassungen müssen mitMittel: nur was gebraucht wird
AltlastenWandern mit: Datenmüll, veraltete Einrichtungen, vergessene FelderChance zum Aufräumen
ProzesseBleiben wie sie sindLassen sich am heutigen Standard neu ausrichten
StichtagJederzeitAm besten zum Geschäftsjahreswechsel
RisikoTechnisch: scheiternde Upgrade-Schritte, lange LaufzeitenFachlich: vergessene Daten, Abstimmung der Salden
Passt beiWenig Anpassungen, Historie zwingend, Prozesse stabilViel gewachsener Code, Wunsch nach Neuordnung, lange Zeit seit dem letzten Upgrade
Einschätzung: Bei einem Sprung von NAV 2017 mit vielen Anpassungen ist Weg 2 oft der wirtschaftlichere, weil der Umbau der Anpassungen in Extensions in beiden Fällen anfällt, die drei Upgrade-Stationen aber nur bei Weg 1. Die Entscheidung hängt an der Frage, wie viel Historie im neuen System wirklich gebraucht wird, und die beantwortet der Fachbereich, nicht die Technik. Wegen der Aufbewahrungspflichten für Buchhaltungsdaten muss das Altsystem bei Weg 2 lesbar bleiben; kläre das mit Steuerberater oder Wirtschaftsprüfer.
Das ist ein eigenes Projekt. Dieser Abschnitt gibt dir den Überblick, um mitreden und planen zu können. Die Einzelschritte, vor allem Station 3 und die Voraussetzungen der Cloud-Migration (unterstützte SQL-Server-Version, Datenbankgröße, Kompatibilitätsgrad), ändern sich mit den Versionen. Lies vor dem Start die Upgrade- und Migrationsartikel für genau deine Zielversion und plane mindestens einen vollständigen Probelauf mit einer Kopie der Echtdaten.

19Geprüft: Korrekturen zu früheren Seiten

Auf Seite 1 hattest du zwei Punkte zur Prüfung vorgemerkt. Für diese Seite wurden sie in der Microsoft-Dokumentation nachgeschlagen (Stand der Abfrage: November 2026). Dabei sind weitere Punkte aufgefallen, die frühere Seiten betreffen.

SeiteDort standLaut Microsoft-Dokumentation
1, 7SOAP ist auslaufend, der Zeitplan wurde mehrfach angepasstSOAP-Endpunkte gelten seit 2021 Release Wave 1 als veraltet. Konkret entfällt mit Version 29.0 (2026 Release Wave 2) die Möglichkeit, eine Microsoft-Page als SOAP-Endpunkt bereitzustellen; schon seit Version 26 war das nur noch über einen Schalter in der Funktionsverwaltung möglich. Wer es weiter braucht, muss den Quelltext der Page in eine eigene Extension kopieren.
7OData V4 auf veröffentlichten UI-Pages „funktioniert, ist aber zerbrechlich“Schärfer: Ab Version 30 (2027 Release Wave 1) lassen sich Microsoft-Pages auch nicht mehr als OData-Endpunkt bereitstellen. Das betrifft jede Page aus einer App des Herausgebers Microsoft. Eigene API-Pages sind damit nicht nur die Empfehlung, sondern der einzige dauerhafte Weg.
1Übergangsfrist für veraltete Objekte „mindestens ein Jahr“Bestätigt: Nach der Markierung als veraltet vergehen mindestens zwölf Monate bis zur Entfernung, teils mehr; ein festes Datum nennt Microsoft nicht. Der ObsoleteTag nennt die Version der Markierung, nicht die der Entfernung. Beispiel aus der Dokumentation: Tag '18.0' bedeutet, der Code ist in 19 und 20 noch da und wird frühestens in 21 entfernt.
8Upload der App über „Erweiterungsverwaltung → Erweiterung hochladen“Wird abgelöst: seit 2026 Release Wave 1 Admin Center oder Admin Center API; Entfall als Upload-Weg voraussichtlich 2027 Release Wave 1 (Abschnitt 9). Das betrifft auch den Upgrade-Test in der Online-Sandbox aus Abschnitt 19 der Seite 8.
8Lizenzdatei .flf als NAV-2017-BegriffErgänzung für On-Premises: Seit Version 22 wird das Format .flf nicht mehr importiert, es gilt .bclicense.
8Berechtigungssätze als AL-ObjekteErgänzung: On-Premises ließ sich bis Version 28 noch auf rein datenbasierte Berechtigungssätze umschalten; ab Version 29.0 gibt es das nicht mehr.
8, 9PowerShell-Befehle mit BcContainerHelperHinweis: Die Verwaltungsmodule des Servers sind auf PowerShell 7 umgestellt; Windows PowerShell 5 ist ab Version 29 keine unterstützte Konfiguration mehr. Nutze PowerShell 7 für Container aktueller Versionen.
7Basic Authentication mit Web Service Access Key ist online abgeschaltetBestätigt: Für Online endete das zum 1. Oktober 2022; OAuth 2.0 ist dort die einzige Möglichkeit. On-Premises bleibt der Zugriffsschlüssel vorerst möglich.
9Telemetrie über VerbindungszeichenfolgeBestätigt: Der Instrumentation Key allein wird seit Version 22 nicht mehr unterstützt; die Verbindungszeichenfolge ist richtig.

Quellen: Deprecated features in the platform und Microsoft Timeline for Deprecating Code in Business Central.

Zu den Versionsnummern im Kurs: Die Beispiele in app.json nennen Version 26 und Runtime 15.0. Die Upgrade-Dokumentation führt inzwischen 2026 Release Wave 2 (Version 29) als Ziel. Trage in deinen Projekten die Version deiner tatsächlichen Umgebung ein; AL: Go! schlägt passende Werte vor.

20Übung: Vom Branch bis in den Tenant

Schritt 1 – Hauptlinie schützen

Aktiviere auf GitHub für main den Branch-Schutz: Änderungen nur per Pull Request. Die Pflicht-Statusprüfung trägst du nach Schritt 3 nach, wenn der Workflow einmal gelaufen ist.

Schritt 2 – AL-Go übernehmen

Lege einen Branch feature/al-go an. Übernimm .github und .AL-Go aus der Vorlage microsoft/AL-Go-PTE und trage die Einstellungen aus Abschnitt 7 ein, zunächst ohne den Block environments. Committe, pushe und öffne einen Pull Request.

Schritt 3 – Ersten Pull-Request-Build beobachten

Unter „Actions“ läuft der „Pull Request Build“. Sieh dir das Protokoll an: Container anlegen, Apps kompilieren, Test-App veröffentlichen, Tests ausführen. Scheitert er, lies die Meldung; häufige Ursachen sind eine application-Version in app.json, die es als Artefakt nicht gibt, und Abhängigkeiten der Test-App mit falscher GUID (Seite 9). Nach grünem Lauf: Merge, und beobachte den CI/CD-Lauf auf main. Lade das Artefakt mit den .app-Dateien herunter und vergleiche die Versionsnummer mit app.json.

Schritt 4 – CLAUDE.md und MCP-Konfiguration

Neuer Branch feature/claude-setup. Lege CLAUDE.md aus Abschnitt 12 an und passe sie an (Präfix, ID-Bereiche, ausgelieferte Version). Lege .mcp.json aus Abschnitt 13 an. Starte den AL MCP Server einmal von Hand im Terminal, um zu sehen, ob altool gefunden wird. Pull Request, Merge.

Schritt 5 – Eine Funktion mit Claude bauen

Lege ein Issue „Besuchsplan“ mit der Beschreibung aus Abschnitt 14 an und einen Branch feature/<Nr>-besuchsplan. Starte Claude Code im Repository und gib die Aufgabe. Achte auf den Ablauf:

BeobachteErwartung
Legt Claude zuerst einen Plan vor?Ja: Liste der Objekte und Dateien
Woher kommen die Objektnummern?Aus al_getnextobjectid, nicht geraten
Schlägt Claude Namen aus der Base Application nach?Ja, etwa das Feld für den Verkäufer am Debitor über al_symbolsearch
Kompiliert Claude nach den Änderungen?Ja, und behebt die eigenen Fehler
Sind Berechtigungssätze und Tests dabei?Ja, wie in CLAUDE.md verlangt

Wo Claude von den Regeln abweicht, ergänze CLAUDE.md um eine Zeile, statt es nur im Gespräch zu sagen.

Schritt 6 – Review wie bei einem Kollegen

Lies den Diff vollständig. Veröffentliche mit F5, probiere „Mark as Done“ aus, führe die Tests im AL Test Tool aus. Prüfe die Punkte aus dem Kasten in Abschnitt 14. Ergänze die deutschen Übersetzungen (oder lass Claude sie ergänzen und lies sie gegen). Dann Pull Request mit „Closes #Nr“, Build abwarten, Merge.

Schritt 7 – Auslieferung einrichten

Lege eine App-Registrierung für die Auslieferung an, trage sie in deiner Sandbox als Entra-Anwendung mit D365 AUTOMATION und EXTEN. MGT. - ADMIN ein und lege das Secret TEST-AuthContext an (Abschnitt 9, komprimiertes JSON). Ergänze in .github/AL-Go-Settings.json die Umgebung TEST mit ContinuousDeployment. Nach dem Merge liefert der nächste CI/CD-Lauf in die Sandbox. Prüfe dort im Admin Center oder in der Erweiterungsverwaltung die installierte Version.

Schritt 8 – Release 1.2

Starte „Create Release“ mit Tag 1.2.0. Sieh dir das Release auf GitHub an: Versionshinweise, .app-Dateien. Starte danach „Increment Version Number“ mit +0.1 und führe den erzeugten Pull Request zusammen. main steht jetzt auf 1.3.

Schritt 9 – Blick nach vorn

Starte „Test Next Major“ von Hand. Läuft er durch, ist deine App für die nächste Version bereit. Wenn nicht, hast du deine erste echte Wartungsaufgabe, und zwar rechtzeitig.

21Typische Fallen

FalleWas passiertAbhilfe
Direkt auf main gearbeitetKein Review, kein Build vor der Übernahme; ein Fehler steht sofort in der HauptlinieBranch-Schutz, Pull Requests
Langlebige BranchesGroße Konflikte, vor allem in XLIFF und BerechtigungssätzenKleine Aufgaben, täglich zusammenführen
Gleiche Objektnummer in zwei BranchesBuild scheitert nach dem MergeObject ID Ninja oder al_getnextobjectid, Build im Pull Request
Secret eingechecktBleibt in der Geschichte, auch nach dem LöschenSofort neu erzeugen; GitHub-Secrets und Push Protection nutzen
AuthContext als mehrzeiliges JSONWorkflows brechen mit maskierten KlammernKomprimiert in einer Zeile
Nur ein allgemeines AuthContext bei mehreren KundenAuslieferung mit den falschen Zugangsdaten, ohne WarnungJe Umgebung ein eigenes Secret
Auslieferung per F5 in die Kundensandbox, dann „ist ja drauf“Entwicklerversion, kein echter Upgrade-Weg, kann beim Update verschwindenImmer das Paket aus der Pipeline über Admin Center oder AL-Go
.app vom Entwicklerrechner ausgeliefertNiemand weiß, aus welchem Stand sie gebaut wurdeNur Artefakte aus CI/CD oder Release
Hotfix nur im Release-BranchFehler kehrt mit der nächsten Version zurückKorrektur immer auch nach main
Workflows von AL-Go von Hand geändertNächstes „Update AL-Go System Files“ überschreibt die ÄnderungAnpassen über Einstellungen
„Test Next Major“ nie gestartetInkompatibilität fällt erst auf, wenn Microsoft das Update blockiert meldetWöchentlich nach Zeitplan
Claude ohne CLAUDE.mdJede Sitzung erfindet Präfix, Nummern und Stil neuRegeln ins Repository
Claude ohne CompilerPlausibler Code mit erfundenen Events und FeldnamenAL MCP Server; Symbolsuche zur Pflicht machen
KI-Code ungelesen übernommenSchemaänderungen, abgeschaltete Regeln, wirkungslose TestsReview wie bei jedem Kollegen; Build und Tests entscheiden
Riesige Aufgabe an ClaudeFünfzig Dateien, die niemand prüfen kannKleine Aufgaben, erst Plan
Txt2AL-Ergebnis für fertig gehaltenKompiliert nicht für die Cloud; Standardänderungen fehlen stillschweigendAls Rohmaterial behandeln; Liste der Standardänderungen getrennt abarbeiten
Alles eins zu eins nachgebautTeure Extension für Dinge, die der Standard längst kannJede Anpassung zuerst gegen den heutigen Standard prüfen
Direktes Upgrade von NAV 2017 geplantGibt es nichtPfad über Version 14 und 25, oder Neueinführung
Integration auf Microsoft-Pages als Webdienst gebautEntfällt als SOAP mit Version 29, als OData mit Version 30Standard-APIs oder eigene API-Pages
Sandbox-Kopie der Produktion sendet echte E-MailsTestbelege beim Kunden des KundenNach dem Kopieren E-Mail, Schnittstellen und Warteschlangen prüfen

22Selbsttest, Zusammenfassung, Ausblick

Selbsttest

  1. Was ist der Unterschied zwischen Commit, Branch und Pull Request?
  2. Zwei Entwickler vergeben in ihren Branches dieselbe Objektnummer. Warum meldet Git keinen Konflikt, und wo fällt es auf?
  3. Welche Workflows von AL-Go laufen automatisch, und was tun sie?
  4. Wer bestimmt bei AL-Go welchen Teil der Versionsnummer?
  5. Was braucht AL-Go, um in eine Umgebung zu liefern, und welche Berechtigungssätze bekommt die Entra-Anwendung?
  6. Warum lieferst du nie die .app-Datei von deinem Rechner aus?
  7. Was gehört in die CLAUDE.md, und warum steht die Schema-Regel dort mit Begründung?
  8. Welche Werkzeuge des AL MCP Servers verhindern erfundene Event-Namen und doppelte Objektnummern?
  9. Was leistet Txt2AL bei Codeänderungen in Standardobjekten?
  10. Über welche Stationen führt ein technisches Upgrade von NAV 2017, und wann ist eine Neueinführung die bessere Wahl?
Lösungen anzeigen
  1. Ein Commit ist ein gespeicherter Stand, ein Branch eine eigene Entwicklungslinie aus Commits, ein Pull Request der Antrag, einen Branch nach Review und Build in main zu übernehmen.
  2. Die Objekte liegen in verschiedenen Dateien, also gibt es textlich keinen Konflikt. Der Compiler meldet die doppelte Nummer beim Build nach dem Zusammenführen.
  3. „Pull Request Build“ bei jedem Pull Request (bauen, testen, Ergebnis am Pull Request) und „CI/CD“ bei jedem Push auf main (bauen, testen, Artefakte ablegen, bei Einrichtung ausliefern).
  4. Major und Minor bestimmst du über „Increment Version Number“; Build und Revision vergibt AL-Go beim Bauen.
  5. Ein Secret mit dem AuthContext, am besten je Umgebung (<Umgebung>-AuthContext), als komprimiertes JSON. Die Entra-Anwendung bekommt D365 AUTOMATION und EXTEN. MGT. - ADMIN.
  6. Weil nicht nachvollziehbar ist, aus welchem Stand sie gebaut wurde und ob Tests gelaufen sind. Ausgeliefert wird nur, was die Pipeline aus einem bestimmten Commit gebaut und geprüft hat.
  7. Aufbau, Präfix, ID-Bereiche, Stil- und Schema-Regeln, Testvorgaben, Arbeitsweise und Verbote. Die Begründung sorgt dafür, dass die Regel auch auf Fälle angewandt wird, die nicht aufgezählt sind.
  8. al_symbolsearch für echte Namen aus Projekt und Abhängigkeiten, al_getnextobjectid für freie Nummern; dazu al_compile und al_getdiagnostics als Kontrolle.
  9. Nichts Brauchbares: Sie werden nicht zu Event Subscribern. Txt2AL wandelt eigene Objekte und aus Deltas neue Felder und Steuerelemente um; die Eingriffe in Standardcode baust du von Hand über Events neu.
  10. NAV 2017 → Version 14 → Version 25 → Zielversion beziehungsweise Cloud-Migration, mit Umwandlung von C/AL nach AL. Eine Neueinführung passt, wenn viel gewachsener Code vorhanden ist, Prozesse neu geordnet werden sollen und die Historie im Altsystem bleiben darf.

Zusammenfassung dieser Seite

Der Code lebt im Git-Repository, Änderungen entstehen in kurzlebigen Branches und kommen nur über Pull Requests in die Hauptlinie. AL-Go für GitHub baut und testet jede Änderung, vergibt Versionsnummern, erzeugt Releases, liefert in die Umgebungen und prüft deine App gegen kommende Versionen. Claude Code wird mit CLAUDE.md und dem AL MCP Server zu einem Kollegen, der eure Regeln kennt und seinen Code selbst kompiliert; Review, Tests und fachliche Entscheidungen bleiben bei dir. Alter C/AL-Code ist über Txt2AL Rohmaterial, und für die Daten wählst du bewusst zwischen technischem Upgrade über die Versionen 14 und 25 und einer Neueinführung.

Der ganze Kurs auf einen Blick

SeiteKernsatz
1 UmdenkenDu änderst den Standard nicht mehr, du erweiterst ihn von außen.
2 SetupVS Code, AL-Erweiterung, Git und eine Sandbox ersetzen C/SIDE.
3 TabellenTable Extensions und Enums; nach der Auslieferung wird am Schema nur noch ergänzt.
4 PagesPage Extensions, Suche statt Menü, Englisch im Code und Deutsch in XLIFF.
5 Code & EventsEvent Subscriber statt Codeänderung, Interfaces statt CASE.
6 DotNet-ErsatzStreams, HttpClient, Json und die System Application statt DotNet und Dateisystem.
7 Reports & DatenLayouts als Dateien, Report Extensions, eigene API-Pages mit OAuth.
8 Berechtigungen & UpgradeBerechtigungssätze und Datenumzug sind Teil der App.
9 QualitätTests, Analyzer, Debugger und Telemetrie laufen ständig mit.
10 Git, Claude, DeploymentVom Branch über die Pipeline in den Tenant, mit einem Agenten als Kollegen.

Wie es weitergeht

SchrittEmpfehlung
ÜbenDie Besuchsverwaltung aus den Übungen einmal vollständig bauen und alle Stellen korrigieren, die in den roten Kästen zur Prüfung markiert sind. Was der Compiler bei dir anders meldet, ist richtiger als dieser Kurs.
Erstes echtes ProjektEine kleine, abgegrenzte Anpassung eines Kunden als Extension umsetzen: zwei Felder, eine Liste, ein Subscriber, ein Bericht. Mit Tests und Pipeline, auch wenn es übertrieben wirkt.
Standard lesenMit F12 regelmäßig in die Base Application schauen. Der Quelltext von Microsoft ist das beste Lehrbuch für Muster und Events.
Auf dem Laufenden bleibenZweimal im Jahr die Release-Pläne und die Liste der veralteten Funktionen lesen; die Warnungen AL0432 im eigenen Code sind dein Frühwarnsystem.
NachweisDie Microsoft-Lernpfade zur Entwicklerprüfung MB-820 decken denselben Stoff ab und eignen sich zur Lückensuche.

KI-gestützte Entwicklung im Team einführen?Wir zeigen, wie wir damit arbeiten, und richten es mit euch ein.

Erstgespräch vereinbaren

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