Getting Started
If your users are running on a virtualized environment (Citrix, Terminal Server, etc), you should use a specific version of our add-in to install.
To get the correct installation file, please visit the admin area of our add-in in Jira (Jira → Add-ons → Outlook App → General Overview). In the rightmost box, you'll find an advanced section, which will provide you with a download link.
You will need to specify the following options first:
- Your Office installation bitness (please note that this can differ from the Windows bitness)
- Where settings should be stored (Roamed Application Data or Local Application Data)
The installer you download here, works a bit different than the default one. Here are the basic differences:
- Installs to %ProgramFiles% instead of %LocalAppData%
- Does not have an automatic updater
- Will be active for all users on the Terminal Server instance by default
Installation
After you install the application on your terminal server, there will be a registry key that needs to be set for each user (e.g. via GPO), which we cannot do via the installer.
You can find a description here: Fix: Clicking on the Jira Tab opens an empty folder
Configuration
By default, the Outlook add-in will be active for all users on the Terminal Server instance. In most cases, this will not be the preferred deployment, as only a subset of users will be Jira users. To change this, please do the following:
- Export & remove the following registry folder. This will deactivate the add-in for all users.
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\yasoonBase
To re-enable the add-in for certain users, import the values from the exported file for each user, but into the HKEY_CURRENT_USER hive, e.g.:
yasoon.regWindows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\yasoonBase] "Description"="yasoonBase" "FriendlyName"="Jira" "LoadBehavior"=dword:00000003 "Manifest"="file:///C:\\Program Files (x86)\\yasoon\\yasoonBase.vsto|vstolocal"
- Now only specified users will be able to use the Jira add-in from Outlook