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 Vista, Windows 7, Windows 8/8.1, Windows 10
- Internet Explorer 10+, Edge
- .NET framework 4.5+
- 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 UPM in Jira (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 embedded browser of the add-on):
----------------------------------------------------------------------------------------------------------------
- make sure the Jira admin installed the related plugin in Jira (https://marketplace.atlassian.com/1210861)
- IE10+ or Edge should be installed
- make sure you are able to login to Jira using the Internet Explorer 10+ due to SSL-certs etc.
  -- you only need to do this once, because Outlook internally uses the IE to render e-mails
- the configure dialog will ask for a Jira URL
  -- valid URL like: https://jira.company.com,  http://company.com:8080/jira 
  -- be aware of company proxies, firewalls, and so on
  -- using an IP address or fully qualified domain name (FQDN) in some cases work instead of using an URLs like http://jira.intranet:8080


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

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


