This is a quick documenation of "Teamworkx Outlook Integration for Jira"
For a full documentation please visit https://documentation.catworkx.com/cwxjiratool/latest

Single User installation
This documentation describes the installation for a single user,
if you want to install the add-in on a multi user environment (e.g. terminal server) 
or deploy it via GPO please download the mass deployment edition instead.
=====================================================================================


1. Content of ZIP file:
-----------------------
- setup.exe
- Teamworkx.Outlook.Integration.for.Jira.msi
- README_FIRST.TXT


2. Prerequisites:
-----------------
- Outlook 2007, 2010, 2013, 2016, 2019 (32bit or 64bit)
- Windows 7, Windows 8/8.1, Windows 10 (1809+)
- Internet Explorer 11 on Win 7, 8/8.1
- Edge on Windows 10 required for Jira 8.12+
- .NET framework 4.6.2+
- Jira 5.0.1+


3. Installation:
----------------
Please follow these steps to install the Add-In
The installation is per USER (registers to HKCU) not per MASCHINE (HKLM).

1) Uninstall all previous versions of the add-in. (Uninstalling first is the save path. Usually just installing/upgrading
   works as well, older files will be overwritten. Just in case of any errors, always uninstall and then reinstall the plugin.)
2) Use setup.exe (not the MSI file) to install the Add-In
3) Install the related Jira app via "Find new Apps" in the Jira Administration (search for Outlook Integration). The installed version 
   of the JIRA app needs to be qual or greater than the Outlook AddIn.
4) Run Outlook and configure the connection settings (for further details check https://documentation.catworkx.com/cwxjiratool/latest)


4. Some hints in case something is not working as expected (esp. when using the internal browser of the add-on):
----------------------------------------------------------------------------------------------------------------
- make sure the Jira admin installed the related plugin in Jira (https://marketplace.atlassian.com/1210861)
- the internal browser uses Edge for rendering on Windows 10 (1809+) for Jira 8.0+ by default (configurable)
- the internal browser uses Internet Explorer 11 on Windows 7 and 8/8.1
- make sure you are able to login to Jira using Edge / Internet Explorer due to SSL-certs etc.
  -- you only need to do this once, because Outlook internally uses the Edge/IE to render e-mails
- the Edge browser is not able to open Jira on 127.0.0.1 / localhost

- if nothing works and the Add-in does not load anymore:
  -- try to uninstall the addin using the installer or windows uninstall routine
  -- search for "71EA6BBB-E9AA-434B-BE3D-8D9C9D007626" and "o2jexpress.AddinModule" in the registry and remove the keys
  -- install the Add-in again

5. Change log
-------------

https://documentation.catworkx.com/cwxjiratool/latest/change-log


