Automated data upgrade from versions 8.00–11.00 to version 12.00
With Document Capture version 12.00 and Expense Management version 12.00, Continia Software released a combined upgrade guide. Partners can use this guide to upgrade Document Capture 8.00–11.00, Expense Management 8.00–11.00, or a system with both Document Capture 8.00–11.00 and Expense Management 8.00–11.00 installed.
This upgrade guide describes the upgrade of Document Capture (DC) and Expense Management (EM) using the more automated Data Upgrade on BC14. If you want a manual pre/post upgrade process, see Manual upgrade from versions 8.00–11.00 to version 12.00.
If you are using Document Capture or Expense Management in Microsoft Business Central cloud, the main upgrade performs automatically when you install Document Capture 12.00/Expense Management 12.00.
Important
Document Capture 2023 R1 (12.00) is only available for the following versions of Business Central (BC):
- Business Central 2023 release wave 2 (BC v23)
- Business Central 2023 release wave 1 (BC v22)
- Business Central 2022 release wave 2 (BC v21)
- Business Central April 2019 (v14, FOB-based)
This means clients using older NAV/BC versions cannot upgrade to DC12.00. Instead, they must upgrade to DC8.00, as this version will continue to be supported with service packs.
If you want to migrate from a FOB-based version of NAV/BC to an on-premises extension/cloud, see Upgrading NAV/Business Central with Expense Management installed and Migrating Expense Management from Business Central on-premises to cloud.
You can use this upgrade guide with the following versions of Document Capture and Expense Management:
Document Capture
- Document Capture 8.00 with any service pack
- Document Capture 9.00 with any service pack
- Document Capture 10.00 with any service pack
- Document Capture 11.00 with any service pack
Expense Management
- Expense Management 8.00 with any service pack
- Expense Management 9.00 with any service pack
- Expense Management 10.00 with any service pack
- Expense Management 11.00 with any service pack
If the system is running an older version, you must first upgrade to the required versions (8.00).
In this version, the Document Capture client components and server components were upgraded. This means you must update these components before you start working with Document Capture and Expense Management. This guide instructs you how to do this correctly.
The Document Capture and Expense Management objects in this version are not backwards-compatible with older components, and the components in this version are not backwards-compatible with older objects.
Important
If Document Capture and Expense Management are not already installed, DO NOT use any information in this document.
Task 1: Check the minimum version requirements
Ensure the current system is running one of the supported versions of Document Capture or Expense Management listed in the summary section. If not, it is very important you follow the upgrade guide from an earlier version to DC8.00–11.00 and/or EM8.00–11.00. For more information. see the previous upgrade guides:
- For Document Capture: https://continia.zendesk.com/hc/en-us/sections/201853305-Upgrade-Guides
- For Expense Management: https://continia.zendesk.com/hc/da/sections/360000175700-Upgrade-Guides
Task 2: Import an updated Business Central license file
You require a partner developer license throughout the upgrade process. After the upgrade you must use a new/updated customer license file from Microsoft and import it into NAV.
If you are using the Dynamics NAV server, you must restart the Dynamics NAV server to use the new license.
Task 3: Merge objects
If you have modified your customer's system, check if any of the modified objects conflict with Document Capture or Expense Management objects and merge if necessary. Best practice is to merge objects in a test system, so they are ready to be imported later in the upgrade process.
Task 4: Upgrade server components
You must perform all installations described below from the Setup executable, located in the root of the product folder (Setup.exe).
Note
The installer updates the add-ins folder (Client and/or Server) in the standard installation path. Therefore, if your installation path differs from the standard Microsoft path, copy the new add-in folder to the folder your installation resides in.
To upgrade your server components, follow the guide below:
| Version | Guide |
|---|---|
| BC14 | Only perform the following steps if you are using Business Central April 2019 (BC14):
|
Task 5: Update Business Central objects and data
Important
Before you modify objects or start the data upgrade, first back up the database.
- Import the new DC12.00 / EM12.00 objects from the product folder.
- Some objects may show a warning during import as some parts of the new Version List have changed format. In Import Worksheet, use Replace All.
- During object import, set Synchronize Schema to Later.
Task 6: Complete post-upgrade steps
To complete the post-upgrade task:
- Import the object package named “BC14 - DC8.00-DC11.00 to DC12.00, EM8.00-EM11.00 to EM12.00 – Direct Upgrade Post”.
- In Import Worksheet, use Replace All.
- During import, set Synchronize Schema to Later.
- Compile all Document Capture and Expense Management objects (Version List filter *DC*|*EM*|*CC*|*DN*). Set Synchronize Schema to Later.
- Compile all MenuSuites (not just Document Capture and Expense Management).
- Run Tools > Sync. Schema For All Tables > With Validation.
- Run Tools > Data Upgrade > Start… to open the Start Data Upgrade page.
- Under Execution Mode, select Serial.
- Under Continue on Error, deselect the checkbox.
- Click OK to close the page.
The post-upgrade part of the process is now complete.
Data upgrade troubleshooting
If the data upgrade fails, try the following:
- If the data upgrade fails, you must run the Get-NAVDataUpgrade [ServerInstance] -ErrorOnly powershell command to find out what the actual error is, or use the debugger with Debug Next.
- If you receive the following error message, this means there's a problem downloading the Control Add-in resources. This problem can occur when Continia's services are down, or there's a server firewall problem.
- “Function 'UpdatePerDatabase' in the upgrade codeunit '6086106' has failed because of the following error: 'A call to System.Net.WebClient.DownloadData failed with this message: The remote server returned an error: (404) Not Found.'.”
- You can try again by running Tools > Data Upgrade > Resume…
- If the same error is thrown, you can Design Codeunit 6086106 and comment the following line of code: CODEUNIT.RUN(CODEUNIT::"CDC Capture RTC Library");
- Then run Tools > Data Upgrade > Resume…
- This skips the Control Add-in being downloaded when upgrading. Therefore, you must download it manually after the data upgrade from the Document Capture Setup page:
- On the Actions tab, click Import Continia Web Client Add-Ins > Import Client Add-Ins, to import all relevant add-ins.
Task 7: Upgrade client components
To upgrade your client components, use the following guide:
| Version | Guide |
|---|---|
| BC14 |
|
Task 8: Delete unused application and upgrade objects
After completing the upgrade, remove the upgrade objects (All object types, with Force):
Filter: 6086100..6086199
After deleting the upgrade objects, import the upgrade placeholder objects from the fob-file containing the new Document Capture/Expense Management objects. Only import the objects within the id-range: 6086100..6086199
This ensures all objects compile and the upgrade is not accidentally restarted. The following objects are deleted in the code. Therefore, you do not need to delete them manually.
- Pages:
6225210|6225211 - Codeunits:
6086047
The tables below are cleared of content. However, they must be removed manually:
- Tables:
6086204|6086205|6086206|6086207|6086208
Task 9: Update the Continia Web Approval Portal
The final task in the upgrade process is to update the Continia Web Portal:
- Compile all Document Capture and Expense Management objects (Version List filter *DC*|*EM*|*CC*|*DN*).
- Run the function Create Web Services from the Continia Web Portal list. You are only required to run this function in one company.
- If you continue using Continia Web Portal on-premises, then you must create a new website in IIS or update the existing one.
- Run the function Export Users to export web users from the Continia Users page in Business Central.