This article provides a step-by-step guide on how to upgrade to the Lasernet Connector for Business Central Version 4.x.x.x.

Backup

You need to backup your configuration by using the backup tools provided by Formpipe.  Follow these steps:

1. Sign into the Dynamics 365 Business Central (D365 BC) application.

2. Click Lasernet Document Mgt. and select the Export/Import cue from the Miscellaneous group.

The Manage Lasernet Connector Data page is displayed.

3. Select all elements from the page except for the Copy Data Between Companies, and then click the Export button.

If you don't have this page but a different page, then you are on a older Lasernet Connector version. Please upgrade your Lasernet Connector to version 3.0.1.1 before continuing.

The Company Selector page is displayed.

4. Select all companies from the list and click OK.

5. Save the exported file.

Your backup is complete.

Uninstallation of Lasernet Connector

After the backup is complete, uninstall the Lasernet Connector. 

1. On the BC main headline page, click Setup & Extensions.

2. Locate Lasernet Connector, click the vertical ellipses icon and select Uninstall.

The Extension Uninstallation page is displayed

3. Ensure the Delete Extension Data is selected. This is because we have changed the object range number and the table structure has also changed.

4. Select Yes on the warning page.

5. Continue uninstalling Lasernet Connector.

Unpublish Lasernet Connector

If you have D365 Business Central Online, please go to step no. 2.

1. Open PowerShell and Unpublish the Lasernet Connector. 

2.  On the BC main headline page, click Setup & Extensions.

3. Locate the Lasernet Connector and select the 3 ...

4. Select Unpublish.

Please click here to see Microsoft's guidance for best practices with unpublishing an extension.

Installing Lasernet

Please see the Lasernet Dynamics 365 Business Central Connector Installation Guide to install Lasernet again. 

Prepare Backup file

Before we can import our backup into the new Lasernet version, we need to prepare the backup file. Please follow these steps:

1. Open the backup file in either Notepad or Notepad++.

2. Search '<ReportID>800' and replace it with '<ReportID>120680'.

3. Save the file again.

Restore backup

1. Sign into the Dynamics 365 Business Central (D365 BC) application.

2. Click Lasernet Document Mgt. and select the Export/Import cue from the Miscellaneous group.

3. Click the Import button and then Choose...  Locate your backup.

4.  Select Yes.

5.  Select Yes.

6. Select all companies and click OK.

7.  A log will appear. Please Close it.

Take a backup of the Translations / Labels, since it only was imported into the current company. If you only have one company, then please continue with Check and enable your reports

8. Select these two settings in the Manage Lasernet Connector Data page and then select Copy:

9. Select the other company and the one you have logged into.

10. Close the Importing Log page.

11. Please repeat steps 8 - 10 for all your additional companies.

Check and enable your reports

1. Open Lasernet Setup.

2. Ensure that BC is selected within Archive Type and that Archive is enabled.

3. Close the page and go to Report Setup.

4.  Make sure all your reports are active.

5. Close the page and please print one of the active reports. 

Repeat all five steps again in all your companies. If you only have one, then you can go to the next step.

Lasernet Configuration

In order to support new features in the Lasernet Connector (such as improved archive report structure), we need to make some changes to the Lasernet Configuration.

1. Please open your Lasernet Configuration.

The following steps needs (2-6) to be done on all reports.

2. Open a Form and select the PDF sheet.

3.  From the top menu, select Sheet and then Sheet Options.

4. Select the Criteria Tab.

5. Remove the criteria and close the form.

6. Close the report Form.

Please repeat this on all reports. Step 2 - 6.

7. Select Modules from the menu on the left side and open Destination Selection.