Upgrading from versions 2.60–6.50 to version 8.00
With Continia Document Capture 8.00 and Continia Expense Management 8.00, Continia Software released a combined upgrade guide that our partners can use to upgrade directly from Document Capture 4.50–6.50/Expense Management 2.60–6.50 to Document Capture 8.00/Expense Management 8.00.
Note
When you upgrade from Document Capture 7.00/Expense Management 7.00 to version 8.00, follow the regular upgrade procedure described in Manual upgrade from version 7.00 to version 8.00 or Automated data upgrade from version 7.00 to version 8.00.
This upgrade guide describes the manual upgrade of Document Capture (DC) and Expense Management (EM) in the version of Microsoft Dynamics NAV/Business Central (BC) currently used with Document Capture and Expense Management (NAV 3.70 to BC v14).
If you're using Document Capture or Expense Management in Microsoft Dynamics 365 Business Central online, the main upgrade performs automatically when you install Document Capture 8.00/Expense Management 8.00 (after uninstalling Document Capture 7.00/Expense Management 7.00).
Migration from a FOB-based version of NAV/Business Central to an on-premises extension/online, see Upgrading NAV/Business Central with Expense Management installed and Migrating Expense Management from Business Central on-premises to cloud.
Prerequisites
Important
If Document Capture and Expense Management haven't already been installed in your system, don't use any information in this document.
Use this upgrade guide with the following versions of Document Capture and Expense Management:
Document Capture
- Document Capture 4.50 with any service pack
- Document Capture 5.00 with any service pack
- Document Capture 5.50 with any service pack
- Document Capture 6.00 with any service pack
- Document Capture 6.50 with any service pack
Expense Management
- Expense Management 2.60 with any service pack
- Expense Management 3.00 with any service pack
- Expense Management 3.50 with any service pack
- Expense Management 4.00 with any service pack
- Expense Management 6.50 with any service pack
If your 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 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 aren't backward-compatible with older components, and the components included in this version aren't backward-compatible with older objects.
Task 1: Check minimum version requirements
Ensure that your current system is running one of the supported versions of Document Capture or Expense Management listed in the Prerequisites section. If not, you must follow an upgrade guide from a version earlier version than Document Capture 4.50 and/or Expense Management 2.60. For more information, see the previous upgrade guides:
For Document Capture: https://continia.zendesk.com/hc/en-us/sections/201853305-Upgrade-Guides (only available to partners)
For Expense Management: https://continia.zendesk.com/hc/da/sections/360000175700-Upgrade-Guides (only available to partners)
Task 2: Import an 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've modified your customer's system, check if any of the modified objects conflict with Document Capture or Expense Management objects, and then 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: Import pre-upgrade package
The pre-upgrade package depends on both your NAV/Business Central version and the version of Document Capture/Expense Management that you're upgrading from.
Important
You must use the correct upgrade package.
Here's an example of a pre-upgrade filename and how to interpret it:
- “NAV 2016 to BC14 - DC4.50 to DC8.00, EM2.60 to EM8.00 – Direct Upgrade Pre”.fob
- The NAV version is between NAV 2016 and BC v14 (Business Central April 2019 )
- The Document Capture/Expense Management version before the upgrade is DC v4.50 and EM v2.60
- This is the pre-upgrade .fob
Task 5: Run pre-upgrade step
After importing the correct pre-upgrade package (replace all),
- Go to either Document Capture Setup or Expense Management Setup.
- Click Upgrade Upgrade Data to Latest Version. This performs the pre-upgrade.
Important
You must start the upgrade in a company with either Document Capture or Expense Management activated.
If you upgrade from DC v6.00.x or DC v6.50.x, or from EM v4.00.x or EM v6.50.x, the following isn't relevant:
Before starting the upgrade, ensure the product activation status is correct in all companies that are being upgraded. If the upgrade code detects a company without a valid activation state, it stop the upgrade with the following error message:
- "One or more companies have a wrong activation state. Run page 6086102 "CDC Company Registration Upg." to update the companies activation state, and then rerun the pre-migration to continue the upgrade process."
Running this page/form (depending on the NAV version) allows you to activate or deactivate Document Capture and Expense Management separately for each company. The upgrade can't continue unless all product/company combinations are either activated or deactivated.
Task 6: Upgrade server components
You must perform all installations described below using the Setup executable, located in the root of the product folder (Setup.exe).
Note
The installer updates the add-ins folder (Client/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 that your installation resides in.
To upgrade your server components, use the guide appropriate to your version of NAV/Business Central:
| Version | Guide |
|---|---|
| NAV Server 2009 – 2009 R2 | Only perform the following steps if you're using Dynamics NAV 2009 – 2009 R2:
|
| NAV Server 2013 – BC14 | Only perform the following steps if you're using Dynamics NAV 2013 – Business Central April 2019 (BC14):
|
| NAV Classic Upgrade PC | Only perform the following steps if you're using Dynamics NAV Classic:
|
| NAV RTC Upgrade PC | Only perform the following steps if you're 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 DC v8.00/EM v8.00 objects from the product folder. Some objects may show a warning during import, as some parts of the new Version List have a 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 DC v8.00/EM v8.00 object package, skip the following four pages. The pages were unintentionally included in the release packages but 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: Complete the post-upgrade steps
Important
You must start the upgrade in a company with either Document Capture or Expense Management activated.
To complete the post-upgrade task:
- Import the object post-upgrade package corresponding to your Business Central version (“BC14 - DC8.00-DC12.00 to DC24.00, EM8.00-EM12.00 to EM24.00 – Direct Upgrade Post.fob”).
- 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*|*BF*). Set Synchronize Schema to Later. Some Document Capture/Expense Management objects may not compile. They are deleted later in the upgrade process.
- Compile all MenuSuites (not just Document Capture and Expense Management).
- 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 activated company. This handles all companies and upgrade Document Capture and Expense Management data, if needed.
- The post-update process should complete without any errors.
- Restart the RTC Client.
- Verify that the activation status of the upgraded companies is as expected.
The post-upgrade part of the process is now complete.
Task 9: Upgrade client components
To upgrade your client components, use the guide appropriate to your version of NAV/Business Central:
| Version | Guide |
|---|---|
| NAV Classic Clients | Only perform the following steps if you're using Dynamics NAV Classic:
|
| NAV RTC Clients 2009 – 2016 | Only perform the following steps if you're using Dynamics NAV 2009 – 2016:
|
| NAV RTC Clients 2017 – BC14 |
|
Task 10: Delete the unused application and upgrade objects
After completing the upgrade,
Remove the upgrade objects (All object types, with Force): Filter: 6086100..6086199
Note
Before deletion, for versions prior to NAV 2015, upgrade tables and obsolete tables must be emptied manually.
Some objects that were part of the Document Capture/Expense Management version that you upgraded from are not needed anymore. Therefore, whenever you upgrade from one of the following versions, delete the objects specified:
- Tables:
6085620|6085701
- Tables:
The following objects are deleted in code, so you don't need to delete them manually:
- Forms:
6085606|6085716|6085751|6086348|6086403|6086418|6192771|6192773|6192776 - Pages:
6085606|6086037|6086054|6086348|6192771|6192777|6192778|6192773|6192776 - Codeunits:
6085620|6085622|6085747|6085800|6086335|6085929|6192774|6192776|6192778
Specifically for 2009 R2 RTC
Support for the NAV 2009 R2 RoleTailored Client was discontinued as of DC v8.00 and EM v8.00. Only the Classic Client is supported.
Delete all Document Capture and Expense Management pages, except web service pages. Pages used as web services by the Continia Web Approval Portal all end with “(WS)” in the object name.
Document Capture contains modifications to the following four standard pages. Manually remove these modifications after the upgrade.
- Page 26 Vendor Card
- Page 138 Posted Purchase Invoice
- Page 140 Posted Purchase Credit Memo
- Page 344 Navigate
Task 11: Update the Continia Web Approval Portal
To update the Continia Web Portal:
- If you use NAV objects prior to NAV 2009 R2, you must import the updated Web Approval Portal objects from the product folder. For NAV 2009 R2 and later versions, 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. You are only required to run this function in one company.
- If you continue to use Continia Web Portal on-premises, create a new website in IIS or update the existing one.
- From the Continia Users page in NAV, run the function Export Users to export web users.
Task 12: Update vendor templates configured with “Prices incl. VAT”
The final task in the upgrade process is to update the vendor templates:
The following is only necessary if you upgrade from versions DC v4.50, DC v5.00, or DC v5.50 and the system contains vendor templates with Prices incl. VAT.
For the release of DC v6.00, the registration of purchase documents with Prices incl. VAT was changed. To benefit from the new functionality, some modifications to existing vendor templates are needed. For more information about the updated functionality and necessary changes, see How to upgrade templates with prices, including VAT, when upgrading to DC6-00 (this article is only available to partners).
The article mentions the Template Upgrade Tool. You can find this in the DC v8.00 product .fob by importing the following objects:
Table: 6086110 and 6086111
Page: 6086100 and 6086101
Related information
Manual upgrade from version 7.00 to version 8.00
Automated data upgrade from version 7.00 to version 8.00