| Docs Hilfe
  AppSource  
Docs  /  NCC Cube (NAV)  /  Anhang

Upgrade auf Business Central


2024/06/26 • 5 Min. Lesedauer

In diesem Thema

Dieses Thema richtet sich an Entwickler und beschreibt, welche Schritte notwendig sind, um die Daten aus der alten C/AL-Version (NAV AddOn) in die neue AL-Version (BC Extension) zu übernehmen.

Wichtig

Nachfolgend wird das Upgrade einer Lösung ohne Kundenanpassungen beschrieben. Wenn in der alten Lösung Anpassungen vorhanden sind, müssen für die Anpassungen eigene Extensions erstellt werden.

Voraussetzungen für das Upgrade

  • Mindestens NCC 13.00 Ältere Versionen von NCC müssen zuerst in NAV aktualisiert werden.

Dateien für das Upgrade

Alle in den einzelnen Schritten benötigten Dateien für das Upgrade können hier heruntergeladen werden: NCC_UpgradeToBC_20240624.zip

APPLICATION UPGRADE

Alle beschriebenen Schritte beziehen sich auf dieses Dokument: [Microsoft Docs] Business Central - Upgrading Customized C/AL Application to Microsoft Base Application Version 19. Vorbereitungen und die Schritte 1-2 müssen für die jeweilige Installation ausgeführt werden.

Task 3: Move code customizations to extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-3-move-code-customizations-to-extensions Der aktuelle Excel Report Builder stellt die Ziel-App dar, daher ist in Schritt 3 nichts weiter zu tun.

Task 4: Create empty System, Base, and customization extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-4-create-empty-system-base-and-customization-extensions In Schritt 4 werden leere Apps erstellt, die in weiterer Folge Besitz von alten C/AL Tabellen übernehmen. Verwenden Sie hier die Datei NAVAX Consulting GmbH_NCE Customization_14.0.0.0.app.

Task 5: Create table migration extension

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-5-create-table-migration-extension In Task 5 wird eine "Table migration Extension" erstellt, die alle Tabellen der alten C/AL Lösung (inkl. NCC) enthält. Dies ist notwendig damit Daten der alten C/AL Tabellen in neue AL Apps (System und NCE) übernommen werden können. In der zweiten Version der "Table migration Extension" muss die Datei migration.json um einen Verweis auf die bereitgestellte App "NCE Customization" erweitert werden: 
migration.json
{
    "apprules": [
        {
            "id": "63ca2fa4-4f03-4f2b-a480-172fef340d3f"
        },
        {
            "id": "437dbf0e-84ff-417a-965d-ed2bb9650972"
        },
        {
            "id": "619f4013-17a8-49b0-b5ce-2a88b0fce34f"
        }
    ]
}

Task 10: Publish DestinationAppsForMigrations extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-10-publish-destinationappsformigrations-extensions In Schritt 10 wird die App "NCE Customization 14.0.0.0" published. Verwenden Sie hier die Datei NAVAX Consulting GmbH_NCE Customization_14.0.0.0.app.

Task 12: Install DestinationAppsForMigration and move tables

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-12-install-destinationappsformigration-and-move-tables In Schritt 12 wird die App "NCE Customization 14.0.0.0" installiert.

Task 13: Publish final extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-13-publish-final-extensions In Schritt 13 wird die App "NCE Customization 19.0.0.0" published. Verwenden Sie hier die Datei NAVAX Consulting GmbH_NCE Customization_19.0.0.0.app.

Task 14: Synchronize final extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-14-synchronize-final-extensions In Schritt 14 wird die App "NCE Customization 19.0.0.0" synchronisiert.

Task 17: Upgrade and install final extensions

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v19#task-17-upgrade-and-install-final-extensions In Schritt 17 wird die App "NCE Customization 19.0.0.0" mit dem Befehl Start-NAVAppDataUpgrade installiert. Das Upgrade auf BC19 kann zu Ende geführt werden, es sind keine weiteren Besonderheiten bezüglich des Excel Report Builders zu beachten.

Nach dem Upgrade

Ist das Upgrade abgeschlossen, können die Daten des alten NCC Cube für die Übernahme in die neue Version vorbereitet werden. Dazu muss die App "Excel Report Builder 14.0.0.0" installiert werden. Verwenden Sie hier die Datei NAVAX Consulting GmbH_Excel Report Builder_14.0.0.0.app. Diese App enthält nur die Datenstruktur und keinen Anwendungscode des Excel Report Builders. Nach der Installation, kann die Upgrade Routine über die Page NCE Upgrade, zu finden über die Suche, gestartet werden. Die Upgrade Routine muss nur in einem Mandanten gestartet werden und läuft automatisch über alle Mandanten der Datenbank. Bitte beachten Sie, dass bei der Umwandlung der Datumsfilter das Datumsformat des Clients (Regionseinstellungen) verwendet wird. Die Daten des Excel Report Builders sind nun für die neue Version aufbereitet. Im letzten Schritt muss die aktuelle Version des Excel Report Builders veröffentlicht und mit dem Befehl Start-NAVAppDataUpgrade installiert werden. Die beiden Apps "NCE Customization 14.0.0.0" und "NCE Customization 19.0.0.0" müssen danach deinstalliert und die Veröffentlichung aufgehoben werden. Selbiges gilt für die App "Excel Report Builder 14.0.0.0".

Informationen zur neuen Lösung und Einstellungen, die nach dem Upgrade geprüft werden sollten


Feedback senden für

Nächstes Thema

In diesem Thema

★ Featured App

DE|EN Impressum
◀☰▶
△