Ideagen Internal Audit (Aura): Document or record launched via hyperlink opens the wrong application instance
Example Scenario
- You have two Ideagen Internal Audit (Aura) environments
- In the first instance of Ideagen Internal Audit (Aura) your colleague selects a document or record and right clicks to Copy Shortcut
- They paste the hyperlink into an external application (e.g. Word, or an email)
- You click the hyperlink, but your second instance of Ideagen Internal Audit (Aura) launches and opens that version of the document or record
Cause
Ideagen Internal Audit (Aura) has a system setting called VisionLinkSuffix, which uniquely identifies an environment. It is used in two ways:
- When you right click on an item in Pentana and Copy Shortcut, the hyperlink that gets copied to the clipboard contains the VisionLinkSuffix, e.g.
VisionLinkSuffix:LaunchAudit,Audit,7f46fc64-f3e8-45c4-b2e8-8d3759998e3a
- When the hyperlink is clicked, it is used to look up the following Windows Registry key:
Computer\HKEY_CURRENT_USER\Software\Classes\VisionLinkSuffix\shell\open\command
This key contains the path to the file Vision.application (if ClickOnce is in use) or Vision.exe (if not).
The path to this file is written by Ideagen Internal Audit (Aura) itself when it is launched.
So, if both environments share the same VisionLinkSuffix, clicking a hyperlink will launch the instance of Ideagen Internal Audit (Aura) that you last launched.
Workaround
The simple workaround is to launch the desired instance of Ideagen Internal Audit (Aura) on your PC from its shortcut, quit, then click the hyperlink. When launching, Pentana will write the 'correct' path to the Windows Registry, and so when the hyperlink is clicked Windows will find the intended instance of the application and launch that.
Solution
To correctly configure the system, each instance of Ideagen Internal Audit (Aura) should have a unique VisionLinkSuffix. The procedure for changing this is described in article Ideagen Internal Audit (Aura): Changing the value for VisionLinkSuffix.