isabella232 / solman-fb-jira-addon

Connect JIRA to the SAP Solution Manager Focused Build external tool API.

Important Notice

We have decided to stop the maintenance of this public GitHub repository.

Solution Manager Focused Build Jira Add-on

Description

With Focused Build for SAP Solution Manager SAP delivers a seamless tool-based requirements-to-deploy process within SAP Solution Manager. To satisfy a typical integration scenario during the build phase it provides a generic OData web service API to integration with external software development tools like Jira or MS Team Foundation Server.

This Jira Add-on provides you an example how to connect Jira to the Solution Manager Focused Build external tool API.

The integration allows development teams to use Jira during the build phase. All other parts of the requirement to deploy process remain in SAP Solution Manager. Starting point for the interaction with Jira is once the architects finished the scoping of the Work Packages. With the status change handover to development the external tool API in Focused Build is triggered and creates for Work Packages and Work Items corresponding issues (Epic and User Story) on Jira side.

For the User Story Jira will be the leading systems, which means the status is changed on Jira side and synchronized back to Solution Manager to update the status of the Work Item. For the Work Packages Solution Manager remains the leading system. All status changes of the Work Packages are done on Solution Manager side (implicitly via the status changes of the corresponding Work Items) and the status change is synchronized to Jira.

During the initial creation of the Epics and User Stories also the assigned documents from Solution Documentation are transferred to Jira and attached to the issue.

Requirements

1. You need to have a SAP Solution Manager with Focused Build installed (ST-OST add-on) and configured.
2. You need to have your own Jira Instance.

Download and Installation

• Download the project.
• Build the project with Maven. As result of the build you will get a JAR file.
• In the Administration -> Add-on section of the Jira system you can upload the JAR. By doing this the Add-on is getting deployed.

Configuration

• perform required configuration on Jira side
• perform the Jira Add-on configuration
• perform the required configuration of the Solution Manager external tool API

Limitations

• As the external tool API of Focused Build does not allow the creation of objects on Solution Manager side this Jira add-on only creates issues on Jira side. You cannot use it to create objects (business requirement, IT requirement, change,...) in Solution Manager out of Jira issues.
• Once the issues are created on Jira side only status updates are exchanged between Solution Manager and Jira. There is not delta update on both sides for other information (e.g. description change, effort change,...)

How to obtain support

This project is provided "as-is".

License

Copyright (c) 2017 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, v. 2 except as noted otherwise in the LICENSE file.