Steps to Upgrade

22 Aug 2024
2 Minutes to read
Contributors

Steps to Upgrade

Updated on 22 Aug 2024
2 Minutes to read
Contributors

Article summary

Did you find this summary helpful?

Thank you for your feedback

Back Up

Before upgrading, users must back up their configuration by using the backup tools provided by Formpipe.

Always perform a backup before upgrading the Lasernet Extension.

Follow these steps:

Sign in to the Dynamics 365 Business Central application.
Click Lasernet Document Management and select the Export/Import tile from the Miscellaneous group.

The Manage Lasernet Connector Data page is displayed.

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

The Company Selector page is displayed.

Select all companies from the list and click OK.

Save the exported file.

Your backup is complete.

Uninstall and Re-Install Lasernet Connector

After the backup is complete, uninstall or update the Lasernet Connector, depending on your BC environment.

Business Central Online

Sign in to Business Central Admin Center.
Locate the Manage Apps page.
Locate the Lasernet app from Formpipe.
Click Install update from the Available Update Action column.
Once you have completed these steps, jump to the Lasernet Configuration section of this guide.

Business Central OnPrem

Consult this link to learn Microsoft's best practices on unpublishing an extension.

Uninstall Lasernet Connector by opening PowerShell and using the following prompt:

Example:

Uninstall-NAVApp -ServerInstance BC -Name "Lasernet Connector OnPrem" -Version 4.3.2.0

Unpublish Lasernet Connector by using the following prompt:

Example:

Unpublish-NAVApp -ServerInstance BC -Name "Lasernet Connector OnPrem" -Version 4.3.2.0

Publish Lasernet Connector by using the following prompt:

Example:

Publish-NAVApp -ServerInstance bc -Path "C:\ProgramData\BcContainerHelper\Extensions\bcserver\my\Lasernet.app" -skipverification

We recommend consulting this link to learn Microsoft's best practices on installing and publishing an extension.

Install Lasernet Connector by using the following prompt:

Example:

Install-NAVApp -ServerInstance bc -Name "Lasernet Connector OnPrem" –Tenant Default

Lasernet Configuration

Formpipe needs to change the Lasernet Configuration to support new features in the Lasernet Connector (such as improved archive report structure). Always double-check if your Lasernet Configuration has undergone any changes.

If you are in doubt, contact your Lasernet reseller.

Open your Lasernet Configuration.

The following steps (2-6) need to be repeated for all reports.

Open a Form and select the PDF sheet.

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

Select the Criteria Tab.

Remove the criteria and close the form.

Close the report Form.

Repeat this process (steps 2-6) on all reports.

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

Select the Destination Tab.

Change all your Destinations Criteria so that they match the following images. Note that you might have other destinations and criteria because you have different output modules. In this case, merge the new criteria so they will still work with your configuration.

Destination: Azure Storage

Destination: #Printer#

Destination: Mail Output

Destination: Archive

Destination: Null

Add the destination.

Select Forms from the left menu and open the Transformer Form called General Transformation from all forms.

Deactivate the following two actions in the Actions window.

Save and Close the form.

XML Structure

In 4.0.0.x, we have changed the way we create the XML file. Therefore, we were also forced to change the XML structure slightly, but that has an impact on your Rearranges on your reports/Forms. Check all your forms if the rearrange matches the new structure.

The following has been changed:

CustomLineFields and CustomHeaderFields

If you are adding additional data via Document Layout, then you need to change the rearranges. If not, you can skip this part.

Old XML structure

New structure

Note

The data itself is moved from the ValueHeader element to the Parent, in this case, Picture.

Tip: Work on an older grab file and then simply locate the rearrange and then drag the rearrange from ValueHeader to the Parent. This keeps the rearrange in the right window/output so that has not changed.