10.5.4.  Issue Management

10.5.4.1. Adding a new Issue Management System
10.5.4.2. Editing an existing Issue Management System
10.5.4.3. Deleting an Issue Management System

An issue management system is a software package that manages and maintains lists of issues. Issues are reports about defects in a software system.

Klaros-Testmanagement is capable of creating issue entries in an issue management system and assigning them to failed test runs. It is possible to configure multiple issue management systems. At the moment Klaros-Testmanagement supports the following issue management systems:

[Important]Important

Please refer to Section 3.9, “Configuring External Issue Management Systems” for detailed information on prerequisites for the different issue management systems. Some systems need to be configured properly before they can be connected to.

The issue management systems are configured in the Issue Management section in the define menu. The issue management page is shown in Figure 10.12, “The Issue Management Configuration Screen”

Figure 10.12. The Issue Management Configuration Screen

The Issue Management Configuration Screen


The issue management systems sections shows all of the configured issue management systems in one table. It is possible to change the properties of each entry by editing the fields of the table directly and pressing the save button afterwards.

The properties of the issue management system are

ID

The internal id of the issue management system. This property is assigned automatically and cannot be altered by the user. If the deleting of an issue management system is prohibited, e.g. there are already test case results assigned to issues in the issue tracker, the ID has additionally a lock icon attached.

System

The system column indicates which issue management system is used. Currently Klaros-Testmanagement supports JIRA, Trac, Mantis, Redmine, and Bugzilla.

Project

If the issue management system organizes issues in projects, it is possible to specify the project id where the new issues should be created in the issue management system. JIRA Redmine Mantis and Bugzilla manages their issues in different projects. For Trac, the URL is used to select different projects.

Description

In the description field a description of the issue management system can be entered.

URL

In the URL field the link to the issue management system is specified. To check if the URL is valid, the Validate the URL button on the right of the URL field can be pressed. If the URL to the issue management system is configured correctly, a confirmation message will be displayed in the message area.

[Tip]Trailing slashes in URLs

In case of an authentication error, first check whether the addition or deletion of a trailing slash resolves the issue.

Action

The action column contains a button that can be used to delete an issue management system from the configuration. If the issue management system is unused, i.e. it is not used in any project, the configuration of the issue management system can be deleted.

[Tip]Project selection

The valid project ID values can be found in the issue management systems at the following locations.

Bugzilla Project ID

The Bugzilla project id consists of the Product field value as shown below.

Figure 10.13. The Bugzilla Project ID

The Bugzilla Project ID

JIRA Project ID

The JIRA project id consists of the Key field value as shown below.

Figure 10.14. The JIRA Project ID

The JIRA Project ID

Mantis Project ID

The Mantis project id consists of the Project Name field value as shown below.

Figure 10.15. The Mantis Project ID

The Mantis Project ID

Redmine Project ID

The Redmine project id consists of the Identifier field value as shown below.

Figure 10.16. The Redmine Project ID

The Redmine Project ID

10.5.4.1. Adding a new Issue Management System

To add a new issue management system, click the New button. An empty row will be added to the list of issue management systems. After the new row is filled with the correct values, clicking the Save save button will persist the settings for the issue management system. Clicking Cancel will discard the changes.