| Docs Help
  AppSource  
Docs  /  NCC Cube (NAV)  /  Appendix

Upgrade to Business Central


2024/06/26 • 5 min. to read

In this topic

This topic is for developers and describes the steps required to transfer the data from the old C/AL version (NAV AddOn) to the new AL version (BC Extension).

Important

The following describes the upgrade of a solution without customizations. If customizations exist in the old solution, separate extensions must be created for the customizations.

Prerequisites for the Upgrade

  • Minimum NCC 13.00 Older versions of NCC must first be updated in NAV.

Files for the upgrade

All files needed in each step for the upgrade can be downloaded here: NCC_UpgradeToBC_20240624.zip

APPLICATION UPGRADE

All steps described refer to this document: [Microsoft Docs] Business Central - Upgrading Customized C/AL Application to Microsoft Base Application Version 19. Preparations and steps 1-2 must be performed for each installation.

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 The current Excel Report Builder represents the target app, so there is nothing else to do in step 3.

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 step 4, empty apps are created, which subsequently take ownership of old C/AL tables. Use the file NAVAX Consulting GmbH_NCE Customization_14.0.0.app here.

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 a "Table migration Extension" is created, which contains all tables of the old C/AL solution (incl. NCC). This is necessary so that data from the old C/AL tables can be transferred to the new AL apps (system and NCE). In the second version of the "Table migration Extension", a reference to the provided app "NCE Customization" must be added to the migration.json file: 
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 step 10, the app "NCE Customization 14.0.0.0" is published. Use the file NAVAX Consulting GmbH_NCE Customization_14.0.0.app here.

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 step 12, the "NCE Customization 14.0.0.0" app is installed.

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 step 13, the app "NCE Customization 19.0.0.0" is published. Use the file NAVAX Consulting GmbH_NCE Customization_19.0.0.app here.

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 step 14, the "NCE Customization 19.0.0.0" app is synchronized.

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 step 17, the "NCE Customization 19.0.0.0" app is installed with the Start-NAVAppDataUpgrade command. The upgrade to BC19 can be completed, there are no other special considerations regarding Excel Report Builder.

After the upgrade

Once the upgrade is complete, the data from the old NCC Cube system can be prepared for transfer to the new version. For this purpose, the app "Excel Report Builder 14.0.0.0" must be installed. Use the file NAVAX Consulting GmbH_Excel Report Builder_14.0.0.0.app here. This app contains only the data structure and no Excel Report Builder application code. After the installation, the upgrade routine can be started via the page NCE Upgrade, which can be found via the search. The upgrade routine only needs to be started in one company and runs automatically across all companies in the database. Please note that the date format of the client (region settings) is used when converting the date filters. The Excel Report Builder data is now prepared for the new version. The last step is to publish the latest version of Excel Report Builder and install it using the Start-NAVAppDataUpgrade command. The two apps "NCE Customization 14.0.0.0" and "NCE Customization 19.0.0.0" must then be uninstalled and unpublished. The same applies to the app "Excel Report Builder 14.0.0.0".

Information about the new solution and settings that should be checked after the upgrade


Submit feedback for

Next topic

In this topic

★ Featured App

DE|EN Imprint
◀☰▶
△