Manual upgrade from version 7.00 to version 8.00
With Document Capture version 8.00 and Expense Management version 8.00, Continia Software is releasing an upgrade guide that our partners can use to upgrade Document Capture 7.00, Expense Management 7.00 or a system with both Document Capture 7.00 and Expense Management 7.00 installed.
This upgrade guide describes the manual upgrade of Document Capture and Expense Management on the version of NAV (NAV 3.70 to BC14) currently used with Document Capture and Expense Management.
If you are looking for a more automated process, refer to Automated data upgrade from version 7.00 to version 8.00. That document describes how to upgrade Document Capture or Expense Management using the new Data Upgrade tools from Microsoft.
If you are using Document Capture or Expense Management in Microsoft Business Central online, the main upgrade performs automatically when you install Document Capture 8.00 (after uninstalling Document Capture 7.00).
If you are migrating from a FOB-based version of NAV/BC to on-premises extension and/or online, see Upgrading NAV/Business Central with Document Capture installed and Migrating Document Capture 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 7.00 with any service pack.
Expense Management
- Expense Management 7.00 with any service pack.
If the system is running an older version, you must first upgrade to the required versions.
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 will instruct 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 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 important you follow the upgrade guide from an earlier version to DC7.00 and or EM7.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 updated NAV 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're ready to be imported later in the upgrade process.
Task 4: Check pre-upgrade package
There are no pre-upgrade steps in version 8.00.
Task 5: Install all tools and components
You must perform all installations described below from the Document Capture 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.
Task 6: Upgrade server components
To upgrade your server components, follow one of the guides below, depending on your version of NAV/Business Central:
| Version | Guide |
|---|---|
| NAV Server 2009 -> 2009 R2 | Only perform the following steps if you are using Dynamics NAV 2009 -> 2009 R2:
|
| NAV Server 2013 -> BC14 | Only perform the following steps if you are using Dynamics NAV 2013 -> Microsoft Dynamics 365 Business Central Spring 2019 Update (BC14):
|
| NAV Classic Upgrade PC | Only perform the following steps if you are using Dynamics NAV Classic:
|
| NAV RTC Upgrade PC | Only perform the following steps if you are using Dynamics NAV RTC:
|
Task 7: Update NAV objects and data
Important
Before you modify objects or start the data upgrade, first back up the database.
- Import the new DC8.00 / EM8.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.
- For NAV 2015 and later, during object import, set Synchronize Schema to Later.
Warning
For all versions from NAV 2013 to Business Central October 2018 (BC v13), the following applies: When importing the DC8.00/EM8.00 object package, skip the following four pages. The pages were unintentionally included in the release packages – and are removed in service pack 1.
- Page 5 Currencies
- Page 10 Countries/Regions
- Page 209 Units of Measure
- Page 472 VAT Posting Setup
Task 8: Post upgrade
To complete the post-upgrade task:
Import the object package named “(Your NAV version) - Document Capture 8.00, Expense Management 8.00 - PostUpgrade.fob”.
In Import Worksheet, use Replace All.
When using NAV 2015 or a newer version, during import, set Synchronize Schema to Later.
Compile all Document Capture and Expense Management objects (Version List filter *DC*|*EM*|*CC*|*DN*). When using NAV 2015 or later, set Synchronize Schema to Later. Some Document Capture/Expense Management objects will not compile, and will be deleted later in the upgrade process.
Compile all MenuSuites (not just Document Capture and Expense Management).
When using NAV 2015 or later, run Tools > Sync. Schema For All Tables > With Validation.
Restart the RTC Client.
Run the function Upgrade Data to Latest Version from the Document Capture Setup card or the Expense Management Setup Card in any company. The routine will handle all companies and upgrade both Document Capture data, and Expense Management data if needed.
The post upgrade part of the process is now complete.
Task 9: Upgrade client components
To upgrade your client components, use the relevant guide to your version of NAV/Business Central from the following table.
| Version | Guide |
|---|---|
| NAV Classic Clients | Only perform the following steps if you are using Dynamics NAV Classic:
|
| NAV RTC Clients 2009 -> 2016 | Only perform the following steps if you are using Dynamics NAV 2009 -> 2016:
|
| NAV RTC Clients 2017 -> BC14 |
|
Task 10: Delete upgrade objects
After completing the upgrade, remove the upgrade objects (All object types, with Force):
Filter: 6086100..6086199
Note
On earlier versions than NAV 2015, upgrade tables must be emptied manually prior to deletion.
Task 11: Update the Continia Web Approval Portal
The final task in the upgrade process is to update the Continia Web Portal:
- Depending on the version you're using, the Web Portal objects must either be imported, or they're already included:
- For version of NAV 2009 R2 and earlier - if you're using NAV objects from theses early versions, you must import the updated Web Portal objects from the product folder.
- For versions of NAV 2009 R2 and later - these objects are included in the base package.
- 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. It is only required to run this function in one company.
- If you continue to using Continia Web Portal on-premises, then you must create a new Web Site in IIS or update the existing one.
- Run the function Export Users, to export web users from the Continia Users screen in NAV.