Upgrade-Verantwortlichkeiten und bewährte Verfahren kennenlernen
Wenn Ihre App alle unsere Überprüfungen bestanden hat und in App Source live geschaltet wurde, können Kunden Ihre Erweiterung installieren und für ihr Unternehmen verwenden. Sie könnten sich die Frage stellen, was jetzt mit der App passiert?
In den folgenden Abschnitten werden die verschiedenen Upgrade-Szenarien beschrieben, die beim Aktualisieren von Business Central aufgetreten sind.
Szenario 1: Business Central-Service-Update
Sie müssen keine Fehlerbehebungen, Funktionserweiterungen oder App-Änderungen an Ihrer App vornehmen. Es funktioniert weiterhin einwandfrei ohne Interaktion von Ihrer Seite.
Auswirkung
Die monatlichen Service-Upgrades auf Business Central wirken sich nicht auf Ihre App aus. Ihre App wird nur verschoben, und es muss kein Upgrade-Code von Ihrer App verwendet werden. Business Central selbst wird auf Ihrem Mandanten aktualisiert, und sobald der Vorgang abgeschlossen ist, sieht der Kunde keinen Unterschied zu Ihrer App.
Scenario 2: App-Update
Sie (unser Partner) fügen Ihrer App einige Funktionen und einige kleinere Fehlerbehebungen hinzu. Die App wird zur Überprüfung eingereicht. Die App besteht die Überprüfung und wird in den Dienst eingecheckt. Diese Version ist jetzt die aktive App für alle neuen und bestehende Mandanten, auf denen Ihre App noch nie installiert wurde.
Auswirkung
Kunden können entweder eine Deinstallation durchführen und dann selbst neu installieren, oder sie können ihren Partner bitten, dies in ihrem Namen über das Fenster „Erweiterungsverwaltung“ in Business Central zu tun. Andernfalls müssen sie bis zu unserer üblichen Hauptveröffentlichung alle sechs Monate warten. Dies ist das einzige Mal, dass Microsoft ein erzwungenes Upgrade von Erweiterungen durchführt (mit Ausnahme kritischer Hotfix-Erweiterungsupdates).
Szenario 3: Gemeldete Fehler in Ihrer App
Ihnen (unserem Partner) wurden von verschiedenen Kunden einige Fehler gemeldet, die sich auf ihre Nutzung der App auswirken. Die Fehler sind nicht kritisch, aber sie sind wichtig. Der Partner nimmt die Korrekturen in der App vor und reicht sie zur Überprüfung erneut ein. Die App besteht die Überprüfung und wird in den Dienst eingecheckt. Dies ist jetzt die aktive App für alle neuen und bestehende Mandanten, auf denen Ihre App noch nie installiert wurde.
Auswirkung
Wir erzwingen immer noch nicht auf allen Mandanten das Upgrade dieser App auf die neueste Version. Einige Mandanten verwenden möglicherweise nicht die Funktionalität, die diese Fehler enthält, und funktionieren weiterhin einwandfrei mit der aktuellen Version der App. Daher sollten Sie direkt mit allen betroffenen Kundenmandanten zusammenarbeiten, um die neueste App-Version zu deinstallieren und neu zu installieren, die Korrekturen für die Fehler enthält.
Szenario 4: Kritischer Fehler in Ihrer App
Bei Mandanten wird ein kritischer Fehler in der App gefunden. Diese Mandanten können aufgrund dieses Fehlers ihre tägliche Arbeit nicht erledigen. Dies passt in das Hotfix-Szenario, da es kritisch ist. Ein Supportticket bezieht sich auf diesen Fall. Der Partner stellt sofort eine korrigierte App zur Überprüfung zur Verfügung. Das Überprüfungsteam legt größten Wert darauf und führt die Überprüfung so schnell wie möglich durch. Die korrigierte App besteht die Überprüfung und wird in den Dienst eingecheckt. Alle Mandanten mit der App werden von Microsoft automatisch auf diese korrigierte Version aktualisiert.
Szenario 5: Die Microsoft-Funktion unterbricht Ihre App
Microsoft muss Ihre App-Datei für eine erforderliche Änderung des Business Central-Kerns beschädigen. Einige Gründe für die Unterbrechung können Sicherheit, Fehler im zugrunde liegenden Code, zusätzliche Funktionen mit hoher Priorität usw. sein. Beachten Sie, dass Microsoft versucht, Ihre App nicht durch Änderungen zu beschädigen. Wir versuchen, geeignete Möglichkeiten zu finden, um die Änderungen vorzunehmen, ohne Ihre App zu beschädigen. Wenn wir jedoch keinen geeigneten (nicht beschädigenden) Weg finden, können wir Ihre App beschädigen. Dies ist in einer kleineren Updateveröffentlichungen nicht so wahrscheinlich (es sei denn, von unserer Seite ist eine Sicherheitsänderung erforderlich, und dies ist die Änderung, die Ihre App beschädigt). In größeren Veröffentlichungen (derzeit alle sechs Monate) besteht dafür jedoch eine größere Wahrscheinlichkeit.
Auswirkung
Hier ist der Prozess, wenn dieses Szenario stattfindet:
Erstens wird Microsoft zu keinem Zeitpunkt eine grundlegende Änderung in der Produktionsumgebung vornehmen. Daher wird von bestehenden Mandanten nicht erwartet, dass der „Breaking Change“ auftritt.
Wenn Microsoft eine wichtige Änderung vornimmt, erfolgt dies in einem Build-Zweig, der für eine zukünftige Version vorgesehen ist (monatlicher Service, kleinere oder größere Version).
Wir benachrichtigen einen Partner im Voraus und geben ihm Zeit, seine App zu korrigieren, zu validieren und für die Veröffentlichung vorzubereiten.
Die korrigierte App ist bereits in unserem Service und wird nach Bedarf verschoben, wenn Ihr Mandant in die Business Central-Version verschoben werden soll, in der sich die App ändert.
Infolgedessen sollte der Kunde (Besitzer des Mandanten) niemals sehen, dass sein Business Central unterbrochen wird. Der Mandant wird auf die Version aktualisiert, die die jeweilige App beschädigt, da der Mandant von einem monatlichen Service-Update von Business Central zu einem anderen verschoben wird. Der Service erkennt jedoch, dass eine neue erforderliche Version dieser App vorhanden ist (Ihre korrigierte Version). Daher wird dies automatisch für den Mandanten installiert (die korrigierte Version der App).
Schlussfolgerungen
Sie sind für Ihre App verantwortlich. Sie besitzen den Prozess für das Aktualisieren der App und das Bereitstellen von Upgrade-Code, wenn sich das Schema zwischen den Versionen der App ändert.
Wenn ein Kunde Ihre App deinstalliert und später erneut installiert, erhält er bei der zweiten Installation der App die neueste Version von AppSource.
Wie Microsoft Ihre App behandelt
Wenn Microsoft einen Mandanten mit einem Service-Update aktualisiert, wird Ihre App anhand der neuen Service-Version getestet. Wenn die App beschädigt wird, kehrt Microsoft zum vorherigen fehlerfreien Zustand zurück. Ihr Kunde erfährt nie, dass etwas beschädigt werden konnte.
Wenn ein Mandant eine Erweiterung über die Seite „Erweiterungsverwaltung“ oder AppSource deinstalliert und neu installiert, gibt es eine Plattformlogik, die bestimmt, ob eine Installation oder ein Upgrade stattfinden muss. Wir erkennen, welche Version der Erweiterung der Mandant zuvor installiert hat, und führen die entsprechende Aktion aus. Daher entspricht das Ergebnis der manuellen Deinstallation oder Installation der Erweiterung einem automatisierten Upgrade.
Darüber hinaus tritt bei Deinstallations‑, Installations‑ oder Upgrade-Aktionen kein Datenverlust auf. Daten für Erweiterungen werden in eigenen Tabellen in der Mandantendatenbank gespeichert. Eine Erweiterung wird zunächst in der Mandantendatenbank synchronisiert, bevor Sie installiert wird. Dieser Schritt ist implizit und erfolgt automatisch, wenn ein Mandant eine Erweiterung installiert. Dieser Synchronisierungsprozess erstellt die Datenbanktabellen für die Erweiterung. Sobald die Erweiterung installiert ist und der Mandant sie verwendet, werden erweiterungsspezifische Daten in diesen Tabellen gespeichert.
Wenn eine Erweiterung deinstalliert wird, werden diese Tabellen nicht entfernt. Daher sind die Daten bei einer Neuinstallation (oder Aktualisierung) der Erweiterung weiterhin verfügbar. Sie müssen sich keine Gedanken über Datenverlust machen, wenn Sie den Weg des Deinstallierens und erneuten Installierens auswählen. Beachten Sie jedoch, dass, wenn während der Deinstallation der Erweiterung Aktionen für den Mandanten ausgeführt werden, die Ereignisse der Erweiterung und dergleichen nicht funktionieren und Ihre App möglicherweise die Erstellung neuer Daten verpasst. Versuchen Sie, diesen Vorgang auszuführen, während der Mandant nicht online ist.