Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To update the add-in to a new version, you’ll need to download the new version from Jira. Please make sure to use the correct one (per-machine). You can either uninstall the old version first or just run the new installer directly - it will take care of removing the old files. In any case, the user data (login, preferences) will be kept, so after a restart of Outlook, everything will continue to work as before!

...

Partial rollout

In case you want the add-in to only show up for a subset of users on the same machine, you’ll need to make a few adjustments after the installation. First, you’ll need to de-register the add-in globally (think HKLM) and register it per-user instead. The per-user registration can for example happen in an after-logon script, or you can run the registration under the users account.

The registration in the Windows registry is handled by an exe-file that is shipped with the add-in, and can be found in the installation directory (%ProgramFiles%\Outlook Email for Jira\adxregistrator.exe).

Use the folllowing command to de-register the add-in for everyone (executed with the same user as the installation has been done). Replace <installDir> with the actual path (%ProgramFiles%\Outlook Email for Jira).

Code Block
<installDir>\adxregistrator.exe /uninstall="<installDir>\jira_for_outlook.dll" /privileges=admin

Then, you’ll need to run the following command for each user that should have the add-in enabled. Please note that this needs to run under the users account, as it will register the add-in in HKCU.

Code Block
<installDir>\adxregistrator.exe /install="<installDir>\jira_for_outlook.dll" /privileges=user

...

Default Configurations

It is possible to add a default configuration for the COM add-in. Most importantly it can be used to default the Jira url to make it easier for the users. It requires a dataStore.json file in the Installation folder. This configuration file will get copied into the user-specific AppData folder on first-use.

...