Microsoft Teams for Jira Server

Official plugin for Jira Server that integrates with Microsoft Teams.

Usage

Jira administrator can install Microsoft Teams plugin to his system via embedded Marketplace (<Configuration gear> -> Find new apps/plugins) or by manually downloading plugin JAR files from Marketplace pages for Jira plugin. Links to the official documentation are specified on Marketplace pages.

Supported products (on 5 Mar, 2021). See EOL policy.

• Jira Server 7.0.0 - 9.8.0 JDK 8.

A note on future development plans

In order to accelerate our journey to the cloud, together, Atlassian will continue to maintain these apps' compatibility with our Server products. However, we will not be creating new features or matching feature parity with our Cloud integrations. If you would like to add your own customizations/features to the integration, we encourage you to fork this repository and customize it as you wish like we’ve seen many customers do.

When Jira Server releases new versions, we will validate the compatibility of these apps and release new versions within four weeks of their public release.

Installation

Prerequisites

1. JDK 8 is installed on your machine.
2. Standalone Jira server is installed on your machine or you have installed Atlassian SDK (https://developer.atlassian.com/server/framework/atlassian-sdk/install-the-atlassian-sdk-on-a-windows-system/).
3. You have Atlassian plugin SDK on your machine. It should be installed automatically on step #1. Please check if you have folder C:\Applications\Atlassian on your machine. [ATLASSIAN_PLUGIN_FOLDER]
4. Repository is cloned to local folder [ADDON_FOLDER] on your machine.

Build addon

1. Go to [ADDON_FOLDER]\src\main\resources and edit integration.properties file:
   • Add value for aud_claim=MICROSOFT_BOT_APPLICATION_ID, where MICROSOFT_BOT_APPLICATION_ID uniques ID of your JIRA Bot Application
   • Add value for signalr_hub_url=https://MICROSOFT_BOT_APPLICATION_BASE_URL/JiraGateway?atlasId=%s&atlasUrl=%s&pluginVersion=%s, where MICROSOFT_BOT_APPLICATION_BASE_URL url of hosted application or your local instance of Jira Server app run on ngrok or another tunnel.
   • Save changes.
2. Run next command from the root folder [ADDON_FOLDER]: "[ATLASSIAN_PLUGIN_FOLDER]\ [APACHE_MAVEN_FOLDER]\bin\mvn package -DskipTests". For example: C:\Applications\Atlassian\atlassian-plugin-sdk-8.0.16\apache-maven-3.5.4\bin\mvn package -DskipTests
3. Wait until command successfully finished.
4. Go to [ADDON_FOLDER]\target folder. You should see new file microsoft-teams-integration-0.0.0.0.jar.
5. Please use this addon file to proceed with JIRA <-> MS Teams integration.

Run addon

1. To run plugin just use atlas-run --product jira from root folder.
2. To enable quick reload find and change property <enableQuickReload> to true in pom.xml. Full documentation is here: https://developer.atlassian.com/server/framework/atlassian-sdk/modify-the-plugin-using-quickreload/.
3. To change jira version: find and change <refapp.version> & <amps.version> in pom.xml.

Debug addon

1. Create Remote JVM Debug with default settings and start via atlas-debug --product jira.
2. To recompile plugin use atlas-mvn package.

Enable logging

1. Log-In as an admin user and go to Jira Administration > System;
2. In the left column press "Logging and profiling" under System support;
3. Under "Default Loggers" section press Configure logging level for another package;
4. Add next packages one by one and set Logging level DEBUG for each:
   • com.microsoft.teams.lifecycle
   • com.microsoft.teams.lifecycle.scheduler
   • com.microsoft.teams.oauth
   • com.microsoft.teams.service
   • com.microsoft.teams.utils

Documentation

Full documentation is always available at: https://developer.atlassian.com/display/DOCS/Introduction+to+the+Atlassian+Plugin+SDK

Tests

Run all unit tests (from the root project folder):

atlas-mvn clean test

Run unit tests in a specific module:

cd <that-module>
atlas-mvn clean test

Contributions

Contributions to Microsoft Teams for Jira Server are welcome! Please see CONTRIBUTING.md for details.

License

Copyright (c) 2019 - 2021 Atlassian and others. Apache 2.0 licensed, see LICENSE file.