Docs  /  NCKR Kostenrechnung (NAV)  /  Anhang

Upgrade auf Business Central

2024/05/08 • 6 Min. Lesedauer

In diesem Thema

• Voraussetzungen für das Upgrade
• Hinweise zum Upgrade
• Dateien für das Upgrade
• Vorbereitung 1: Alte Tabellen in der NAV-Datenbank umbenennen
• Vorbereitung 2: Alte Felder in den Standard-Tabellen der NAV-Datenbank umbenennen
• APPLICATION UPGRADE
• Task 3: Move code customizations to extensions
• Task 4: Create empty System, Base, and customization extensions
• Task 5: Create table migration extension
• Task 10: Publish DestinationAppsForMigrations extensions
• Task 12: Install DestinationAppsForMigration and move tables
• Task 13: Publish final extensions
• Task 14: Synchronize final extensions
• Task 17: Upgrade and install final extensions
• Nach dem Upgrade
• Informationen zur neuen Lösung und Einstellungen, die nach dem Upgrade geprüft werden sollten

Mehr anzeigen

Weniger anzeigen

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.

Voraussetzungen für das Upgrade

• Mindestens NCKR 6.00 Ältere Versionen von NCKR müssen zuerst in NAV aktualisiert werden.

Hinweise zum Upgrade

• Umlagen können nicht automatisch konvertiert werden und müssen nach dem Upgrade neu angelegt werden.

Dateien für das Upgrade

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

Vorbereitung 1: Alte Tabellen in der NAV-Datenbank umbenennen

Die Tabellen der alten Lösung befinden sich bereits in der NAV-Datenbank im 1000000-Objektbereich. Um die Tabellenstruktur der alten Lösung auf eine einheitliche Basis zu bringen und um Namenskonflikte mit den Tabellen der neuen Lösung zu vermeiden, müssen die alten Tabellen aktualisiert und umbenannt werden. Importieren Sie dafür die Datei NCCA_UpgradeToBC_Step1_RenameOldTables.fob mit Replace All. Die alten Tabellen sind danach mit OLD_ gekennzeichnet. Der Code, die Variablen und Funktionen und alle TableRelations zu den Standard-Objekten wurden ebenfalls aus den alten Tabellen entfernt.

Vorbereitung 2: Alte Felder in den Standard-Tabellen der NAV-Datenbank umbenennen

Die Felder der alten Lösung befinden sich bereits in den Standard-Tabellen der NAV-Datenbank im 1000000-Bereich. Um die Feldstruktur der alten Lösung auf eine einheitliche Basis zu bringen und um Namenskonflikte mit den Feldern der neuen Lösung zu vermeiden, müssen die alten Felder aktualisiert und umbenannt werden. Nachdem Sie die Objekte in eine separate Datenbank importiert haben, müssen die Felder der alten Lösung (gekennzeichnet mit OLD_NCCA) von der separaten Datenbank in die NAV-Datenbank kopiert werden.

Folgende Felder müssen kopiert werden:

Tabelle 17 G/L Entry Feldnr. 1002000

Tabelle 200 Work Type Feldnr. 1002000 bis Feldnr. 1002001

Tabelle 242 Source Code Setup Feldnr. 1002000 bis Feldnr. 1002010

Tabelle 5601 FA Ledger Entry Feldnr. 1002000

Tabelle 5606 FA Posting Group Feldnr. 1001750 bis Feldnr. 1001751

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 Die aktuelle NCCA Kostenrechnung 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_NCCA Customization_14.0.0.0.app. Für jede weitere Änderung an der Datenstruktur der Standardanwendung oder der NAVAX Kostenrechnung müssen eigene Upgrade-Apps und Konvertierungsroutinen erstellt werden.

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. NCCA) enthält. Dies ist notwendig damit Daten der alten C/AL Tabellen in neue AL Apps (System und NCCA) übernommen werden können. In der zweiten Version der "Table migration Extension" muss die Datei migration.json um einen Verweis auf die bereitgestellte App "NCCA Customization" erweitert werden:

migration.json
{
    "apprules": [
        {
            "id": "63ca2fa4-4f03-4f2b-a480-172fef340d3f"
        },
        {
            "id": "437dbf0e-84ff-417a-965d-ed2bb9650972"
        },
        {
            "id": "ca7a7451-d586-4034-9afe-7a2468241936"
        }
    ]
}

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 "NCCA Customization 14.0.0.0" published. Verwenden Sie hier die Datei NAVAX Consulting GmbH_NCCA 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 "NCCA 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 "NCCA Customization 19.0.0.0" published. Verwenden Sie hier die Datei NAVAX Consulting GmbH_NCCA 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 "NCCA 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 "NCCA 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 der NCCA Kostenrechnung zu beachten.

Nach dem Upgrade

Ist das Upgrade abgeschlossen, können die Daten der alten Kostenrechnung für die Übernahme in die neue Version vorbereitet werden. Dazu muss die App "NCCA Cost Accounting by NAVAX 14.0.0.0" installiert werden. Verwenden Sie hier die Datei NAVAX Consulting GmbH_NCCA Cost Accounting by NAVAX_14.0.0.0.app. Diese App enthält nur die Datenstruktur und keinen Anwendungscode der Kostenrechnung. Nach der Installation, kann die Upgrade Routine über die Page NCCA 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 der Kostenrechnung sind nun für die neue Version aufbereitet. Im letzten Schritt muss die aktuelle Version der NCCA Kostenrechnung veröffentlicht und mit dem Befehl Start-NAVAppDataUpgrade installiert werden. Die beiden Apps "NCCA Customization 14.0.0.0" und "NCCA Customization 19.0.0.0" müssen danach deinstalliert und die Veröffentlichung aufgehoben werden. Selbiges gilt für die App "NCCA Cost Accounting by NAVAX 14.0.0.0".

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

• Auf der Seite Anlagenbuchungsgruppen gibt es jetzt 3 statt 2 Felder für die Kostenrechnung.
• Falls gewisse NaviCalc-Einstellungen nicht übernommen werden konnten, werden Bemerkungen mit weiteren Informationen in den Zeilen und Spalten der Auswertung angelegt.