Equisys Technical Notes

Technical guidance, explanations and fixes for our products

PRB: License error when non Zetadocs user accesses a form with the embedded addin



ID: ZTN4201

This Zetadocs technical note applies to:

  • Version 4.x and 5 of Zetadocs for NAV


When a non Zetadocs user accesses a form that was configured to use the embedded Zetadocs addin and they have not installed Zetadocs for NAV on their machine, they get an error stating that they need to be licensed to use Zetadocs and then Microsoft Dynamics NAV crashes.


When the user opens the form and the embedded addin code is executed, it is trying to find out if the Zetadocs for NAV has a valid license. Since the Zetadocs for NAV is not installed on that specific user’s PC the check fails to find the appropriate library and generates an error.


Zetadocs provides a function that informs you if the Zetadocs for NAV is installed. This function can be found in the Zetadocs Utilities codeunit (9009959) and it is called isZetadocsInstalled. The issue can be resolved by wrapping the SetRecordID function that is inserted in the form code with this function as a condition. The code can be seen below.


IF (ZetadocsUtilities.IsZetadocsInstalled) THEN BEGIN




An additional global variable needs to be created for the above code to work. The details of the variable are shown below:

  • Name: ZetadocsUtilities
  • DataType: Codeunit
  • SubType: Zetadocs-Utilities (ID:9009959)


This fault can be corrected using the steps shown above.

Last updated: 30th August 2012 (AT/MW)

Keywords: Embedded addin error non Zetadocs user


Recent news

As part of our drive towards making the software simpler to use, Zetadocs Expenses now supports single sign-on using Microsoft work or school accounts. This makes it easier for Office 365 ...

This article describes the new features and other improvements in the August 2019 release of the Zetadocs Expenses service. Zetadocs Expenses ...