Fehler verursachende Änderungen erkennen und vermeiden

  • 3 Minuten

Wenn Sie eine oder mehrere Anwendungen in AppSource aktiviert haben, müssen Sie sicherstellen, dass Sie keine Fehler verursachenden Änderungen vornehmen, Sie eine neue Version Ihrer App veröffentlichen.

Die Einführung unangekündigter Fehler verursachender Änderungen ist eine Unannehmlichkeit, die Sie unbedingt vermeiden sollten, ebenso für Microsoft und neue Versionen von Business Central.

Fehler verursachende Änderungen sind jedoch unvermeidlich. Stattdessen sollten Sie lernen, mit ihnen richtig umzugehen. Sie können dies mithilfe der folgenden Techniken tun:

  • AppSourceCop verwenden, um Fehler verursachende Änderungen zu erkennen

  • Ihre internen Implementierungen auszublenden versuchen, um zukünftige Fehler zu vermeiden

  • Ihre Apps regelmäßig anhand der neuesten Abhängigkeiten überprüfen und kompilieren

  • Abschreibungseigenschaften verwenden, um bevorstehende Pausen anzukündigen

Was ist eine wichtige Änderung?

Eine wichtige Änderung ist eine Änderung, bei der Sie möglicherweise Änderungen an Ihrer Anwendung vornehmen müssen, um eine Unterbrechung Ihrer Integration zu vermeiden.

Eine wichtige Änderung hat folgende Eigenschaften:

  • Sie ist zerstörerisch für Ihre Lösung

  • Benötigt Arbeit

  • Wird als Ärger empfunden

  • Notwendig für Innovation

Codeänderungen, die als fehlerhaft gelten, werden auf der Seite AppSourceCop Analyzer-Regeln dokumentiert.

Nicht alle aufgeführten Regeln befassen sich mit Fehler verursachenden Änderungen. Die Liste enthält alle Regeln, die Sie befolgen müssen, um Ihren Code bei AppSource einreichen zu können.

Die Liste der Regeln ist in Arbeit, ebenso wie die Dokumentation. Weitere Regeln werden im Laufe der Zeit definiert. Wenn Sie ein Problem entdecken, können Sie es hier melden.

Wie erkenne ich, dass ich eine wichtige Änderung vorgenommen habe?

AppSourceCop ist ein Analysator, der Regeln erzwingt, die von Erweiterungen eingehalten werden müssen, die auf Microsoft AppSource veröffentlicht werden sollen.

Wie vermeide ich, die Lösung zu beschädigen?

Befolgen Sie diese Regeln, um Fehler verursachende Änderungen zu vermeiden:

  • Bestehende öffentliche APIs müssen vorhanden und funktionsfähig bleiben.

  • Neue öffentliche APIs müssen mit den alten APIs koexistieren.

  • Implementierungsdetails sollten nicht öffentlich sichtbar sein, um neue Abhängigkeiten zu vermeiden.

Wie kann ich neuen Code koexistieren lassen?

Wenden Sie diese Techniken an, damit neuer Code mit altem Code koexistiert:

  • Versionsverwaltung verwenden

  • Produktswitches verwenden

  • Alt und Neu synchron halten

  • Alt durch Neu/Überladen mit neuer Funktionalität umleiten

Wie kann ich neuen Code mit Switches koexistieren lassen?

Befolgen Sie diese Richtlinien, um neuen Code für die Koexistenz mit Switches zu aktivieren:

  • Entweder alte oder neue Arbeiten, nicht beide

  • Neue Funktionen können möglicherweise erst aktiviert werden, wenn alle Abhängigkeiten die neue Implementierung berücksichtigen.

Wie kann ich neuen Code mit Synchronisierung koexistieren lassen?

  • Sowohl die alte als auch die neue Implementierung funktionieren.

  • Kann sehr schwierig zu implementieren sein, da keine Methode für alle geeignet ist. Suchen Sie für einige Beispiele nach Sync.Dep.Fld in Version 16.0 von Business Central.

Wie verstecke ich Implementierungsdetails?

Sie können Implementierungsdetails mithilfe der Zugriffs‑ und erweiterbaren Eigenschaften ausblenden.

Wie führe ich Fehler verursachende Änderungen richtig ein?

Sie sollten die Abschreibung von Codetechniken implementieren. Es gibt drei Eigenschaften, um dies in AL zu erreichen.

Wie zeigt Microsoft Fehler verursachende Änderungen?

Während sich unsere APIs weiterentwickeln, werden wir angemessene Anstrengungen unternehmen, um Sie rechtzeitig über Fehler verursachende Änderungen zu informieren, und zwar mit ausreichender Zeit, um sich an diese Änderungen anzupassen. Fehler verursachende Änderungen werden im Code dokumentiert. Damit Sie sehen können, ob Maßnahmen erforderlich sind, müssen Sie Ihre Lösung regelmäßig gegen alle Abhängigkeiten kompilieren. Wir können Änderungen ohne vorherige Ankündigung vornehmen, wenn die Änderung als nicht Fehler verursachend angesehen wird oder wenn es sich um eine Fehler verursachende Änderung handelt, um kritische Produktfehler oder rechtliche, Sicherheits‑ oder Datenschutzbedenken auszuräumen. Unter Fehler verursachende Änderungen finden Sie Beispiele für diese Änderungen und Informationen zu deren Behebung.