1.40 Deployment on Terminal Server

new version

We have a new version of Outlook Email for Jira!

This is the documentation for the old add-in. If you are looking for info about the new one, please click click here.

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.reg

Windows 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