Upgrading Customized C/AL Versions of Document Capture

  • 02/10/2023
  • 6 minutes to read

The upgrade of Continia Document Capture and Continia Expense Management from C/AL code customizations to AL extensions is based on the standard Microsoft upgrade process, as described in this guide. The text below functions as a sort of add-on to this guide, detailing all additional prequisites and any Continia-specific steps to be taken for each task in the Microsoft guide.

Note that you must upgrade both Document Capture and Expense Management at the same time. To upgrade your C/AL versions of these apps to AL extensions, you must upgrade to Business Central 2023 release wave 2 (BC v23) in accordance with the Microsoft guide referenced above.

Prerequisites

  • You must first upgrade to Microsoft Dynamics 365 Business Central April 2019 (BC v14). For an overview of which BC v14 versions are compatible with BC v23, see Dynamics 365 Business Central Upgrade Compatibility Matrix.
  • Document Capture must be upgraded to the latest released version, including the latest service pack.

Upgrade process

Important

To ensure a consistent migration to BC v23, Expense Management must be installed even if it isn't used in the database. When the migration is complete, you can uninstall Expense Management again if you want.

The numbered tasks mentioned below all refer to the tasks of the Microsoft guide Upgrading Customized C/AL Application to Microsoft Base Application version 23. All of these tasks deal with third-party extensions, which in this case means the four Continia apps Document Capture, Expense Management, Continia Core and Continia Delivery Network. For each of the tasks, you must perform the actions described:

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

For this task, you'll need empty versions of the four Continia apps. You can find these using the link below:

Task 5: Create table migration extension

In this task, you must create two versions of an extension that consists only of the non-system table objects from your custom base application. The second version is an empty extension containing a migration.json file, as described under "Create the second version - empty" in the Microsoft guide. Append the following IDs to this migration.json file:

  • 4b915d7e-c02a-435f-85ab-649086c1e002
  • 0745e76d-0b72-4641-87c2-ee45db5d2c32
  • 6da8dd2f-e698-461f-9147-8e404244dd85
  • 8d4eab29-8c7f-4b6c-be9a-b7fdfb9da196

Task 10: Publish DestinationAppsForMigrations extensions

In step 2 of this task, publish the following four extensions in the order given:

  1. Continia Core
  2. Continia Delivery Network
  3. Continia Document Capture
  4. Continia Expense Management

To do this, run the following four commands, where "<path to extension>" is the path to the location where the empty extensions downloaded in task 4 above have been saved:


Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Core"
Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Delivery Network"
Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Document Capture"
Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Expense Management"

Task 11: Synchronize tenant

In step 4 of this task, run the following four commands:


Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Core”
Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Delivery Network"
Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Document Capture”
Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Expense Management”

Task 12: Install DestinationAppsForMigration and move tables

In step 3 of this task, install the Continia apps in your system, and move data from the old tables to the new tables owned by the table migration extension.


Install-NAVApp -ServerInstance <server instance name> -Name “Continia Core”
Install-NAVApp -ServerInstance <server instance name> -Name “Continia Delivery Network”
Install-NAVApp -ServerInstance <server instance name> -Name “Continia Document Capture”
Install-NAVApp -ServerInstance <server instance name> -Name “Continia Expense Management”

Task 13: Publish final extensions

In step 5 of this task, run the following four commands, where "<path to extension>" is the path to the location where you saved the extensions that you created in task 3 of the Microsoft guide:


Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Core"
Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Delivery Network"
Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Document Capture"
Publish-NAVApp -ServerInstance <server instance name> -Path "<path to extension>\Continia Expense Management"

Task 14: Synchronize final extensions

In this task, run the following four commands:


Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Core”
Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Delivery Network"
Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Document Capture”
Sync-NAVApp -ServerInstance <server instance name> -Name “Continia Expense Management”

Task 17: Upgrade and install final extensions

In this task, run the following four commands:


Start-NAVAppDataUpgrade -ServerInstance <server instance name> -Name “Continia Core”
Start-NAVAppDataUpgrade -ServerInstance <server instance name> -Name “Continia Delivery Network”
Start-NAVAppDataUpgrade -ServerInstance <server instance name> -Name “Continia Document Capture”
Start-NAVAppDataUpgrade -ServerInstance <server instance name> -Name “Continia Expense Management”

See also

Migrating Document Capture from Business Central On-Premises to Cloud