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 NCP 13.00
Ältere Versionen von NCP 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:
NCP_UpgradeToBC_20230405.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 NCP_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.
Wichtig
Die geänderten Standard-Tabellen finden Sie in der Datei NCP_UpgradeToBC_Step2_RenameOldFields.fob.
Importieren Sie die Objekte in eine separate Datenbank, welche keine Anpassungen hat.
Die Objekte basieren auf einer Microsoft Dynamics 365 Business Central "Spring 2019" (Version 14.0) AT Version.
Nachdem Sie die Objekte in eine separate Datenbank importiert haben, müssen die Felder der alten Lösung (gekennzeichnet mit OLD_NCP) von der separaten Datenbank in die NAV-Datenbank kopiert werden.
Ist das Upgrade abgeschlossen, können die Daten des alten NCP Zahlungsverkehrs für die Übernahme in die neue Version vorbereitet werden.
Da die neue Version in 3 Apps aufgeteilt ist, müssen auch 3 separate Übernahmen durchgeführt werden.
Wichtig dabei ist, dass zuerst die Payments Base Übernahme durchgeführt wird und erst danach die Payments Export/Import Übernahmen.
Installieren Sie zuerst die 3 Apps (ebenfalls im NCP_UpgradeToBC_20220729.zip enthalten):
NAVAX Consulting GmbH_NCP Payments Base by NAVAX_14.0.0.0.app
NAVAX Consulting GmbH_NCPE Payments Export by NAVAX_14.0.0.0.app
NAVAX Consulting GmbH_NCPI Payments Import by NAVAX_14.0.0.0.app
Diese Apps enthalten nur die Datenstruktur und keinen Anwendungscode.
Nach der Installation, kann die Payments Base Upgrade Routine über die Page NCP Upgrade, zu finden über die Suche, gestartet werden.
Danach können die Payment Exports und Payment Imports Upgrade Routinen über die Page NCPE Upgrade und NCPI Upgrade, zu finden über die Suche, gestartet werden.
Die Upgrade Routinen müssen nur in einem Mandanten gestartet werden und laufen automatisch über alle Mandanten der Datenbank.
Die Daten des NCP Zahlungsverkehrs sind nun für die neue Version aufbereitet.
Im letzten Schritt muss die aktuelle Version des NCP Zahlungsverkehrs (bestehend aus 3 Apps) veröffentlicht und mit dem Befehl Start-NAVAppDataUpgrade installiert werden.
Die beiden Apps "NCP Customization 14.0.0.0" und "NCP Customization 19.0.0.0" müssen danach deinstalliert und die Veröffentlichung aufgehoben werden. Selbiges gilt für die 3 Apps "NCP Payments Base by NAVAX 14.0.0.0", "NCPE Payments Export by NAVAX 14.0.0.0" und "NCPI Payments Import by NAVAX 14.0.0.0".
