OpenReq Issue Link Map
This repository is no longer maintained. This repository is archived for parties interested in the standalone functionality that this repo once offered. Now, the functionality has been moved to OpenReq Issue Link Map. For full details of capability and intended usage, please see OpenReq Issue Link Map.
This web application was created as a result of the OpenReq project funded by the European Union Horizon 2020 Research and Innovation programme under grant agreement No 732463.
This web application visualizes the links between issues inside Qt’s JIRA. It uses the microservices of UH (API references) to manage links and the similarity detection of UPC (API references) to recommend missing links. The OpenReq services milla, mallikas, keljucaas, mulperi, palmu, nikke and the similarity detection are used by this web application and need to be running in order for the web application to function.
- Spring Boot
- Google Gson
Functionalities of the OpenReq Issue Link Map
Currently available features
- Visualization of the link network of public issues in Qt’s JIRA While in JIRA the user can only see the direct links, this tool enables the user to go more in-depth and also view indirect links between JIRA items.
- Quick info for selected issue Essential information of an issue is displayed on the right-hand side.
- Navigating the link network The user can drag items and add or remove layers.
- Consistency Checker Checking if the issues in the link map do not have conflicting link type and priority and displaying the result.
- Filtering the issue link map for specified properties To support the user in navigating this link network filters should be in place to hide issues depending on their status, the link type between them.
- Accepting & rejecting proposed links The results of a link detection are also visualized, this view should can be toggled on and off for a specific issue. While the link detection is enabled the user is given a list where he can decide what type of link should be used or if this proposed link should not be a link.
Functionalities in development
- Full Integration into Jira as a Jira plug-in Currently, accepted and rejected links are not written into the Jira database, just back to mallikas.
- Add more filter options Adding more filter options to also filter f.e. egdes
- Editing links By right-clicking an edge, the user can change the link type, switch direction or remove the link
Accessing the application
The application is accessible here
!This is currently broken! Additionally, a connection to the tool is in https://bugreports-test.qt.io/secure/Dashboard.jspa. This connection is created by installing the "jira-redirction" plugin.
How to install
You first need to deploy the following OpenReq microservices:
Mallikas is a database that Qthulhu accesses over milla, so it needs to contain the issues you want to visualize.
Change properties of Qthulhu
In src/main/java/eu.openreq.qt.qthulhu change the URLs in the class Property to the corresponding endpoints of your deployment of milla.
You might need to adapt the colorPaletteStatus and arrowPaletteType in Qthulhus issueid.jsp to the words used in your Jira.
This is a maven project, so use
mvn clean package
in your IDE and then run
java -jar qthulhu-webapp-1.0.war
How to use
You can directly search for an issue here.
for example Issue: QTWB-30 and layer 2.
which will then give you the LinkMap for issue QTWB-30 with layer 2.
Alternatively, you can access the test instance of Qt's jira https://bugreports-test.qt.io/secure/Dashboard.jspa and search for an issue. On the view page you can scroll down Issue Links, underneath this you will find OpenReq Dependency Browser (old name, needs to be updated to OpenReq Link Map)
You then can use the node filter, to filter the link map for the status, type or priority. Per default, issues with status done are not shown.
To check a release plan for inconsistencies in the issues and links, you can use the consistency checker. It searches the link map up to depth 5 for inconsistencies. It also lists all releases and the found inconsistencies.
The link detection searches for an issue potentially linked issues which are not linked in Jira. These missing links are then recommended and can be accepted or rejected by the users. Currently these changes are not written to the Jira database.
What does this application do?
Visualising the link network, recommending missing links and checking the consistency of your release plans.
- Editing links on the fly
- Transform this from a web-application to a jira plugin
Only the public issues are available. If a person has a Qt account, they should be able to see all the issues In the link map that they would be able to see in JIRA. Additionally, the ability to accept, reject and edit links need to be tied to the permisisons the user has in Jira.
Notes for Developers
How to contribute
Free use of this software is granted under the terms of the EPL version 2 (EPL2.0).