Skip to content
This repository has been archived by the owner on Dec 5, 2019. It is now read-only.
/ qthulhu Public archive

WP7 Qt Trial Web Application to manage links in JIRA

License

Notifications You must be signed in to change notification settings

OpenReqEU/qthulhu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Before this project was archived it passed the sonarqube quality metrics. SonarqubeQthulhu

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.

Technical description

Technologies used

  • Spring Boot
  • Tomcat
  • Vis.js
  • Google Gson
  • Okhttp3
  • Maven
  • Bootstrap

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

Functionalities planned

  • 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.

Adapt Qthulhu

You might need to adapt the colorPaletteStatus and arrowPaletteType in Qthulhus issueid.jsp to the words used in your Jira.

Create .war

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.

Search1

for example Issue: QTWB-30 and layer 2.

Search2

which will then give you the LinkMap for issue QTWB-30 with layer 2.

LinkMapEx

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)

Search3

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.

Filter

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.

ConsistencyCheck

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.

LinkDetection

What does this application do?

Visualising the link network, recommending missing links and checking the consistency of your release plans.

What’s next?

  • Editing links on the fly
  • Transform this from a web-application to a jira plugin

Challenges

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.

Technical structure

techstructure The service sends a request (JIRA keys, e.g. “QTWB-30”) for data to milla and receives a JSON with the issue data. This data is then visualized.

Notes for Developers

I tried to comment most of the code to make it understandable. The Java part just gets the data in a vis.js friendlier format. The javascript & HTML/CSS will get some more functionality in the next iterations.

How to contribute

See OpenReq project contribution guidelines.

License

Free use of this software is granted under the terms of the EPL version 2 (EPL2.0).

About

WP7 Qt Trial Web Application to manage links in JIRA

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published