Business Central Extension Update Fehler
Business Central Extension nach Update defekt? Ich repariere inkompatible AL-Extensions, auch fremden Code. Erste Diagnose in 48h, Festpreis oder ab 120 €/h.
Aktualisiert am · von Filip Jacobi
Eine Business Central Extension fällt nach einem Update meist aus, weil sie auf Objekte, Felder oder Prozeduren der Basis-App verweist, die Microsoft als veraltet markiert und inzwischen entfernt oder geändert hat. Die Reparatur besteht darin, diese Referenzen gezielt auf die aktuellen Nachfolger umzustellen und die Extension gegen die neue Version neu zu kompilieren. Ich übernehme Analyse und Reparatur und sorge dafür, dass die Extension auch die nächste Release Wave übersteht.
Business Central Online bekommt zwei Hauptversionen pro Jahr, im April und im Oktober, dazu in allen übrigen Monaten je eine Nebenversion. Ihr könnt den Termin innerhalb des Update-Zeitraums verschieben, aber nicht dauerhaft auslassen. Wer eine eigene Extension betreibt, die veraltete AL-Objekte nutzt oder gegen geänderte Basis-Objekte programmiert ist, riskiert, dass das Update an dieser Extension scheitert oder die Funktion danach fehlt (Quelle: Microsoft Learn, Zeitplan für Updates, Stand: Oktober 2026).
Das Problem kündigt sich früh an, wird aber oft übersehen: Der AL-Compiler meldet veraltete Referenzen lange vorher als Warnung. Wer diese Warnungen nicht aktiv verfolgt, bemerkt das Problem erst, wenn eine Funktion im laufenden Betrieb fehlt.
Microsoft markiert Objekte zuerst als veraltet und entfernt sie in einer späteren Version. Referenziert eure Extension ein entferntes oder geändertes Objekt, lässt sie sich gegen die neue Version nicht mehr kompilieren, und das Update eurer Umgebung schlägt fehl.
Schlägt das Update fehl, versucht Microsoft es sieben Tage später erneut. Nach dem Update-Zeitraum und der Kulanzphase beginnt die Durchsetzungsphase, in der Microsoft inkompatible Extensions automatisch deinstallieren kann, damit das Update durchläuft. Die Daten bleiben erhalten, die Funktion fehlt aber (Quelle: Microsoft Learn, Zeitplan für Updates, Stand: Oktober 2026). Welche Funktionen der Basis-App wegfallen oder ersetzt werden, listet Microsoft unter veraltete Funktionen (W1).
Die Fristen der einzelnen Phasen und wie ihr das Problem Schritt für Schritt selbst eingrenzt, erkläre ich im Ratgeber Extension nach Update nicht kompatibel.
Die meisten Update-Fehler lassen sich auf wenige Muster zurückführen:
| Ursache | Symptom | Lösung |
|---|---|---|
Veraltete Tabellenfelder (ObsoleteState Removed) | Compilerfehler beim Bezug auf das Feld | Auf das Nachfolgefeld umstellen, Daten ggf. per Upgrade-Codeunit übernehmen |
| Entfernte oder geänderte Prozeduren der Basis-App | Compilerfehler, fehlende Methode oder geänderte Signatur | Empfohlenen Nachfolger einsetzen |
| Abgelöste Event Publisher | Event-Subscriber findet seinen Publisher nicht mehr | Auf das neue Event umstellen und Logik prüfen |
| Mechanisch von C/AL nach AL konvertierter Code | Viele Warnungen, schwer wartbar, bricht bei jeder Wave an anderer Stelle | Gezieltes Refactoring nach aktuellen AL-Mustern |
| Abhängigkeit von einer nicht aktualisierten Fremd-App | Extension lässt sich wegen der Abhängigkeit nicht installieren | Version der Abhängigkeit prüfen, mit dem Anbieter klären oder Abhängigkeit entkoppeln |
Der Compiler unterscheidet dabei klar: Referenzen auf Elemente mit ObsoleteState Pending erzeugen Warnungen, Referenzen auf Removed erzeugen Fehler (Quelle: Microsoft Learn, ObsoleteState-Eigenschaft).
Ich prüfe eure Extension systematisch auf veraltete AL-Objekte: alle Referenzen mit ObsoleteState, alle Bezüge auf veraltete Felder und Prozeduren, alle Stellen, die bei der nächsten Release Wave brechen werden, nicht nur die, die schon gebrochen sind.
Das Ergebnis ist eine klare Übersicht: was ist akut kaputt, was wird als Nächstes brechen, was ist langfristig sauber.
Ich stelle den betroffenen AL-Code auf aktuelle Microsoft-Standards um:
Das Ziel ist nicht nur, dass die Extension heute wieder läuft, sondern dass sie beim nächsten Release-Zyklus nicht erneut bricht.
Hat eine Extension tiefere strukturelle Probleme, etwa weil sie ursprünglich in C/AL geschrieben und mechanisch nach AL konvertiert wurde, gehe ich tiefer.
Typische Muster solcher Extensions: viele direkte Tabellenzugriffe statt gekapselter Codeunits, fehlende Trennung von Geschäftslogik und Oberfläche, globale Variablen, wo Events sauberer wären. Diese Muster machen nicht nur Updates fehleranfällig, sie sind auch eine häufige Ursache für Performance-Probleme. Mehr dazu unter Business Central Performance optimieren.
Ihr braucht diese Unterstützung, wenn:
Beispiel: Ein Produktionsunternehmen betreibt eine eigene Extension für die Erfassung von Fertigungsaufträgen, die seit Jahren kaum angefasst wurde. Nach einer Release Wave lässt sie sich nicht mehr kompilieren. Die Analyse zeigt eine Reihe veralteter Feldreferenzen, teils schon Removed, teils noch Pending, sowie Prozeduren der Basis-App, deren Signatur sich geändert hat. Nach der Reparatur kompiliert die Extension ohne Fehler, die Warnungen sind beseitigt, und die Pending-Fälle brechen bei der nächsten Wave nicht mehr.
| Punkt | Regelung |
|---|---|
| Erstgespräch | kostenlos, 30 Minuten |
| Erste Diagnose | innerhalb von 48 Stunden |
| Abrechnung | Festpreis oder nach Aufwand ab 120 € pro Stunde |
| Vertrag | kein Jahresvertrag, keine Mindestabnahme |
Wie schnell bekommen wir eine Diagnose, wenn das Update schon fehlgeschlagen ist?
Eine erste Diagnose bekommt ihr innerhalb von 48 Stunden. Dafür reichen mir zunächst die Fehlermeldung aus dem Business Central Admin Center und Zugriff auf den AL-Code der Extension. Weil Microsoft ein fehlgeschlagenes Update sieben Tage später erneut versucht, bleibt meist Zeit, die Reparatur vor dem nächsten Versuch in einer Sandbox zu testen. Fehlt im laufenden Betrieb bereits eine wichtige Funktion, nutzt den Business Central Notfall Support.
Kannst du vorab sehen, ob unsere Extension beim nächsten Update Probleme macht?
Ja. Der AL-Compiler meldet Referenzen auf Pending-Elemente als Warnung, und Microsoft bietet vor jeder Hauptversion eine Vorschau-Sandbox an. Viele Teams ignorieren die Warnungen, weil sie noch keinen Fehler verursachen. Ich mache eine Vorab-Analyse und zeige euch, was bei den kommenden Release Waves kritisch wird.
Musst du die Extension komplett neu schreiben?
Meistens nicht. Die meisten Reparaturen sind gezielte Anpassungen an den veralteten Stellen. Nur wenn die Architektur so problematisch ist, dass Flicken langfristig teurer wird als Neubauen, empfehle ich einen Neuschrieb, und das sage ich euch vorher klar.
Kannst du auch helfen, wenn die Extension von einem anderen Entwickler stammt und es keine Dokumentation gibt?
Ja, das ist der Normalfall. Ich arbeite seit 2014 mit Navision und Business Central, zuerst bei einem BC-Systemhaus, später als IT-Teamleiter, heute freiberuflich von Bochum aus, und habe mich in dieser Zeit oft in fremden Code eingearbeitet. Ich gehe dabei systematisch vor: Tabellenstruktur, Event-Subscriptions, Codeunit-Aufrufe. Das dauert etwas länger als bei gut dokumentiertem Code, ist aber gut machbar.
Was kostet es, wenn du unsere Extension reparierst?
Das Erstgespräch ist kostenlos. Danach arbeite ich zum Festpreis oder nach Aufwand ab 120 € pro Stunde, ohne Jahresvertrag und ohne Mindestabnahme. Den Aufwand bekommt ihr vor dem Start schriftlich, erst dann entscheidet ihr.
Wenn eine Extension nach einem Business Central Update nicht mehr läuft, die nächste Release Wave ansteht oder ihr unsicher seid, wie kritisch eure Obsolete-Warnungen sind, sprecht mich direkt an. Bei akuten Ausfällen hilft auch der Business Central Notfall Support, für eine vorbeugende Prüfung das AL Code Review.
Über mich
Freiberuflicher BC-Entwickler und Berater aus Bochum. Ich arbeite direkt mit eurem Fachbereich, ohne Agentur-Overhead, ohne Account-Staffelung. Remote und vor Ort in NRW verfügbar.
Mehr über mich und meinen WerdegangFestpreis oder nach Aufwand ab 120 €/h · kein Jahresvertrag
Schreibt mir eine Nachricht oder ruft direkt an.