Filip Jacobi

Bochum · BC-Entwickler

Termin buchen

Business Central Extension Update Fehler

Business Central Extension Update FehlerAL-Extension nach Release Wave reparieren

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.

Wenn das automatische Microsoft-Update eure Extension aus dem Takt bringt

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.

Was passiert, wenn das Update an eurer Extension scheitert?

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.

Typische Ursachen und Lösungen

Die meisten Update-Fehler lassen sich auf wenige Muster zurückführen:

UrsacheSymptomLösung
Veraltete Tabellenfelder (ObsoleteState Removed)Compilerfehler beim Bezug auf das FeldAuf das Nachfolgefeld umstellen, Daten ggf. per Upgrade-Codeunit übernehmen
Entfernte oder geänderte Prozeduren der Basis-AppCompilerfehler, fehlende Methode oder geänderte SignaturEmpfohlenen Nachfolger einsetzen
Abgelöste Event PublisherEvent-Subscriber findet seinen Publisher nicht mehrAuf das neue Event umstellen und Logik prüfen
Mechanisch von C/AL nach AL konvertierter CodeViele Warnungen, schwer wartbar, bricht bei jeder Wave an anderer StelleGezieltes Refactoring nach aktuellen AL-Mustern
Abhängigkeit von einer nicht aktualisierten Fremd-AppExtension lässt sich wegen der Abhängigkeit nicht installierenVersion 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).

Was ich anbiete

Extension-Kompatibilitätsanalyse

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.

Extension-Reparatur

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.

Upgrade-sicheres Refactoring

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.

Für wen ist das relevant?

Ihr braucht diese Unterstützung, wenn:

Beispiel: typischer Reparaturablauf

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.

So läuft die Zusammenarbeit

  1. Erstgespräch (kostenlos, 30 Minuten): Ihr schildert das Problem, ich sage euch direkt, ob und wie ich helfen kann.
  2. Diagnose und Einschätzung: Ich sehe mir Fehlermeldungen und AL-Code an. Eine erste Diagnose bekommt ihr innerhalb von 48 Stunden.
  3. Angebot: Ihr erhaltet eine schriftliche Einschätzung mit Vorgehen und Aufwand, als Festpreis oder nach Aufwand.
  4. Umsetzung: Ich repariere die Extension, teste sie in einer Sandbox auf der Zielversion und spiele sie nach eurer Freigabe ein.
  5. Übergabe und Dokumentation: Ihr bekommt eine Dokumentation der Änderungen und eine Liste der Punkte, die bei kommenden Waves relevant werden.

Konditionen

PunktRegelung
Erstgesprächkostenlos, 30 Minuten
Erste Diagnoseinnerhalb von 48 Stunden
AbrechnungFestpreis oder nach Aufwand ab 120 € pro Stunde
Vertragkein Jahresvertrag, keine Mindestabnahme

Häufige Fragen

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.

Wann ich helfen kann

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.

Erstgespräch buchen

Passende Ratgeber

Verwandte Seiten

Über mich

Filip Jacobi — Business Central Entwickler & Berater

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 Werdegang
Kostenloses Erstgespräch buchen

Festpreis oder nach Aufwand ab 120 €/h · kein Jahresvertrag