10.5. Integration

10.5.1. Issue Management
10.5.2. Requirements Management
10.5.3. E-Mail
10.5.4. Network
10.5.5. LDAP Settings
10.5.6. CAS Settings

On the Integration page, external systems are connected and their settings are managed. It features six tabs, Issue Management, Requirements Management, E-Mail, Network, LDAP and CAS.

10.5.1. Issue Management

An issue management system (also called issue tracker or bug tracker) is an application for managing issues that occur during the testing process. Issues can contain information and reports about errors in a software system.

Issues can be created in issue management systems, retrieved and assigned to failed test case results. It is possible to configure and use multiple issue management systems simultaneously.

Klaros-Test­management supports the following issue management systems:

  • Bugzilla, a free open source issue management system (see http://www.bugzilla.org/).
  • GitHub, a web-based Git repository hosting service offering both plans for private repositories or free accounts, which are usually used to host open-source software projects (see http://github.com/)
  • GitLab, a web-based DevOps lifecycle tool that provides a Git-repository manager providing wiki, issue-tracking and CI/CD pipeline features, using an open-source license (see http://gitlab.com/).
  • Jira , is a commercial issue management system produced by Atlassian Pty Ltd. (see http://www.atlassian.com/).
  • Mantis , a free open source issue management system (see http://www.mantisbt.org/).
  • Redmine , a free open source issue management system (see http://www.redmine.org/).
  • Trac, a free open source issue management system (see http://trac.edgewall.org/).
[Caution] External Configuration Required

Some issue management systems need to be configured before they can be successfully connected to Klaros-Test­management. For more information, see Section 3.14, “Configuring External Issue Management Systems”.

[Important] Token based authentication

Some issue management systems like Jira, GitHub or GitLab restrict access to token-based authentication. Authentication via username and password is not supported.

Klaros-Test­management is supporting a token based authentication scheme as well. Just use the required username and the token as password.

The “Issue Management” Tab

Figure 10.18. The Issue Management Tab


The table shows the following values:

ID

Assigned automatically.

Additional Information

A tooltip appears when the cursor is placed over the icon shown here.

no credentials for background synchronization has been provided.

System

The used issue management system (Bugzilla, Jira (Version 4.3 or higher), Jira Legacy (Version 4.2 or lower), GitHub, GitLab, Mantis, Redmine and Trac).

URL

The link to the issue management system.

Project

See Section 10.5.1.4, “Project”.

Description

A short description of the issue management system.

Actions

The executable actions.

10.5.1.1. Adding a new Issue Management System

By clicking on the button New a new empty table row will appear. All attributes of the issue management system can be defined here.

With Save the issue management system saved. The ID of the issue management system (IM00001) is automatically assigned by Klaros-Test­management.

With New several table rows can be created and edited at the same time. Only when clicking on Save the data is stored in the database.

With Discard all changes are undone.

[Note] Red IDs

All rows with red IDs have been changed and are not yet saved!

10.5.1.2. Actions

The following actions can be performed in the action column:

10.5.1.3. Table Operationen

The following operations can be performed in the line above the table on the right:

  •   Filter / Sort
  • Only active / Show all
  •   Export
  •   Column selection

All operations are described in detail in Section 5.2.3.1, “Overview Page”.

10.5.1.4. Project

If the issue management system organizes issues in projects, a project ID is required to address the specific project. Jira, Redmine, Mantis and Bugzilla use such a project id. With GitHub, GitLab, and Trac, the URL is used to address different projects.

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

10.5.1.4.1. Bugzilla

The Bugzilla project id consists of the Product field value.

The Bugzilla Project ID

Figure 10.19. The Bugzilla Project ID


10.5.1.4.2. Jira

The Jira project id consists of the Key field value.

The Jira Project ID

Figure 10.20. The Jira Project ID


10.5.1.4.3. Mantis

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

The Mantis Project ID

Figure 10.21. The Mantis Project ID


10.5.1.4.4. Redmine

The Redmine project id consists of the Identifier field value.

The Redmine Project ID

Figure 10.22. The Redmine Project ID


10.5.1.5. Editing an existing Issue Management System

In the Action column, click the icon to check whether a connection to the issue management system can be established.

[Tip] Trailing Slashes of URLs

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

10.5.1.6. Editing an existing Issue Management System

Clicking on the icon in the action column on the right opens a dialog. The credentials for the background synchronization can be provided here. In addition, the status values for fixed issues are defined here.

[Important] Important

The credentials entered here will solely be used for background synchronization. If users creates or updates an issue, their personal credentials will be used to authenticate against the issue management system. If credentials are missing or not valid, then users are prompted to enter them.

10.5.1.6.1. Assignment of status values for completed issues

Each issue has a status field that documents its current state (e.g. "In progress" or "Fixed"). The individual statuses and their naming vary according to the issue management system used. Klaros-Test­management only distinguishes between open and resolved issues. An issue is considered closed when no further work needs to be done on it (e.g. "Closed", "Rejected"), otherwise it is still open.

Resolved issues are displayed in green, open ones in red. Section 9.6.2, “Issues by Test Case Details”

Edit the status mappings

Figure 10.23. Edit the status mappings


The resolved issue states must be named exactly as they are in the issue management system, otherwise they will not be properly identified and will be counted as open issues.