9.6. Issues

9.6.1. Overview Page
9.6.2. Action
9.6.3. Bulk Actions
9.6.4. Table Operations
9.6.5. Details Page
9.6.6. Issue Details (Creating a new Issue)
9.6.7. Link Issue

Issues from external issue management systems (like Jira or GitLab) can be linked with test cases and systems under test in Klaros-Test­management. In addition to this, issues can be created from Klaros-Test­management in connected issue management systems (even during test execution).

For this, at least one issue management system must be configured and assigned to the desired project. The configuration of an issue management system is described in Section 10.5.1, “Issue Management”, Section 6.1.2.6.1, “Issue Management” shows how to assign the issue management system to a project.

9.6.1. Overview Page

The overview page displays all issues present in the project in a table. This chapter shows how to create, edit and edit issues.

Pressing the New button opens up the Section 9.6.6, “Issue Details (Creating a new Issue)” page.

Pressing the Link button opens up the Link Issues panel, in which existing issues from issue management systems can be linked to test cases and systems under test (see Section 9.6.7, “Link Issue”).

The “Issues” Page

Figure 9.31. The Issues Page


The table shows the following values:

ID

The external issue Id.

Additional Information

On the one hand, the symbol of the issue management system is displayed here. Clicking this icon opens the issue in the issue management system. On the other hand, a can appear. In this case, the administrator should be informed immediately. Reasons for displaying the can be among others:
  • Deactivation of the issue management system.

  • Incorrect configuration of the issue management system in Klaros-Test­management or in the issue management system. The configuration of an issue management system is described in Section 10.5.1, “Issue Management”.

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

System

The ID of the issue management system.

Summary

The summary of the issue.

Test Cases

A list of test cases assigned to this issue with the result of their latest execution.

Systems under Test

A list of systems under test assigned to this issue.

Assigned To

The username of the responsible user.

Priority

The priority of the issue.

State

The state of the issue.

Action

The executable actions.

9.6.2. Action

The following actions can be performed in the action column:

  •   Edit
  •   Open issue in external issue management system
  •   Open print view
  •   Delete

If a issue has been deleted, it is internally marked with a deletion marker and is only visible to administrators. For deleted issues, the following actions are available instead of Delete:

  •   Restore
  •   Remove the issue from the database
[Important] Important

Pressing the icon does not delete the issue in the issue management system, only the reference in the database!

9.6.3. Bulk Actions

On the Issue page, one or more issues can be selected for bulk actions. Bulk actions are described in Section 5.2.3.1.5, “Bulk Actions”.

The following bulk actions are supported for issues:

  •   Open print view
  •   Delete
  •   Restore the issue (only Administrator).
  •   Remove the issue from the database (only Administrator).

For additional information, see Section 5.2.3.1.5, “Bulk Actions”.

9.6.4. Table Operations

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

  •   Filter / Sort
  • Show all / Only active (only Administrator)
  •   Search
  •   Export
  •   Column selection

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

9.6.5. Details Page

Each issue has its own detail page with several additional tabs. Clicking on the ID of the respective requirement or on the icon on the right in the action column takes you to the tab that was selected last. When called for the first time, this is the Properties tab.

The following tabs are available: Properties, Test Cases, Systems under Test and Changes.

9.6.5.1. Actions

On the detail pages there are more icons in the upper right corner. The following actions can be performed here:

  Open external link

Shows the issue in the external issue management system.

  Synchronize

Synchronizes the local issue with the external source.

  Open print view

A print-ready view of the issue can be created here. With a click on the icon this opens in a new browser tab.

Print views are described in detail in Section 5.2.3.2.1, “Print Pages”.

  Create Bookmarks

Issues may be linked to from outside of Klaros-Test­management using the link on the icon. By clicking on the icon this link will be copied to the clipboard.

Bookmarks are described in detail in Section 5.2.3.2.2, “Bookmarks”.

    Browse

Use the green arrows at the very top right to switch between the issues present on the previous page.

9.6.5.2. Properties

In this tab ( Figure 9.32) several attributes of the issues are displayed and can be edited if the user has the appropriate permission.

The “Properties” Tab

Figure 9.32. The Properties Tab


The issue ID is a hyperlink to the corresponding issue in the issue management system.

9.6.5.3. Test Cases

This view lists all test cases that are associated with this issue.

The “Test Cases” Tab

Figure 9.33. The Test Cases Tab


Test cases can be assigned to the issues by clicking the Assign button. This opens up a dialog, where multiple test cases can be selected at once.

The “Assign Test Cases” Dialog

Figure 9.34. The Assign Test Cases Dialog


The following bulk actions are supported for test cases:

  •   Remove

The detail page of a test case shows a list of all issues that are associated with it, as shown in section Section 6.7.2.8, “Issues”.

9.6.5.4. Systems under Test

The page lists all systems under test assigned to the issue.

If you want to associate systems under test with the issue, click the Assign button and select one or more systems under test.

The following bulk actions are supported for systems under test:

  •   Remove

The detail page of a system under test shows a list of all issues that are associated with it, as shown in section Section 6.5.2.6, “Issues”.

The “Systems under test” Tab

Figure 9.35. The Systems under test Tab


The “Assign Systems under test” Dialog

Figure 9.36. The Assign Systems under test Dialog


9.6.5.5. Changes

The tab Changes shows the change history of this issue.

For a detailed description of the Changes view, see Section 5.2.3.2.8, “Change History”.

9.6.6. Issue Details (Creating a new Issue)

The “Create Issue” Page

Figure 9.37. The Create Issue Page


The first defined issue management system of the active project is automatically selected from the Issue-Management-System dropdown list.

[Note] Note

If the list of issue management systems is empty, then at least one issue management system has to be configured and linked to the active project. The configuration of issue management systems is described in Section 10.5.1, “Issue Management”. Section 6.1.2.6.1, “Issue Management” contains instructions on how to add an issue management system to a project.

By default Klaros-Test­management uses the credentials entered at the login screen to authenticate the user to the issue management system. When using Bugzilla, the email/password combination of the user is tried as well, as this is the common case for a login name there. If the credentials entered at login do not work and the issue management system has not yet been used during the session, Klaros-Test­management will request new authentication information in a dialog window.

[Important] Token based authentication (Jira Cloud instances, GitLab)

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

Some Vendors like Jira and GitLab limit access to token based authentication Authenticating via username and password is no longer supported for these systems.

Clicking the icon opens up the external issue management system in a new tab.

Clicking the icon opens up a dialog to change the authentication information.

If an issue management system has been selected, a list of issue fields is shown. The exact number and names of those fields vary, depending on the type and configuration of the issue management system. Mandatory fields are shaded in a different color.

[Note] Note

All mandatory fields need to be filled, otherwise the issue cannot be saved.

Issue Fields for every Issue-Management-System

TestCases

The test cases to link this issue with.

Systems under Test

The systems under test to link this issue with.

Update Test Case State

Selecting this checkbox opens up a new dropdown list in which the new state of the linked test cases can be selected.

9.6.6.1. Creating a Bugzilla Issue

The “Bugzilla Issue ” Page

Figure 9.38. The Bugzilla Issue Page


9.6.6.2. Creating a GitHub Issue

The “GiHub Issue” Page

Figure 9.39. The GiHub Issue Page


9.6.6.3. Creating a GitLab Issue

The “GitLab Issue” Page

Figure 9.40. The GitLab Issue Page


9.6.6.4. Creating a Jira Issue

The “Jira Issue” Page

Figure 9.41. The Jira Issue Page


9.6.6.5. Creating a Mantis Issue

The “Mantis Issue” Page

Figure 9.42. The Mantis Issue Page


9.6.6.6. Creating a Redmine Issue

The “Redmine Issue” Page

Figure 9.43. The Redmine Issue Page


9.6.6.7. Creating a Trac Issue

The “Trac Issue”Page

Figure 9.44. The Trac IssuePage


9.6.6.8. Creating a YouTrack Issue

The “YouTrack Issue”Page

Figure 9.45. The YouTrack IssuePage


9.6.7. Link Issue

In addition to creating issues from within Klaros-Test­management, it is possible to link issues from an issue management system to test cases and systems under test in Klaros-Test­management.

The “Link Issue” Panel

Figure 9.46. The Link Issue Panel


To link an issue to a test case or sytem under test, an issue management system must be selected first. Pressing the Link button links the issue with the entered ID to the selected test cases and systems under test.

System

The issue management system from which issues are to be linked.

ID

The id of the issue to be linked.

Pressing the icon searches the issue management system for an issue that matches the entered id. Upon a successful search, pressing the Link button links the issue to the selected test cases and systems under test.