9.6. Issues

9.6.1. Übersichtsseite
9.6.2. Aktion
9.6.3. Massenaktionen
9.6.4. Tabellenoperationen
9.6.5. Detailseite
9.6.6. Issue - Details
9.6.7. Einen Issue verlinken

Issues aus externen Issue-Management-Systemen (wie Jira oder GitLab) lassen sich mit Testfällen und Testsystemen in Klaros-Test­management verknüpfen. Ebenso lassen sich Issues von Klaros-Test­management aus in angebundenen Issue-Management-Systemen erstellen (auch während der Testausführung).

Dazu muss mindestens ein Issue-Management-System konfiguriert und dem gewünschten Projekt zugeordnet werden. Die Konfiguration eines Issue-Management-Systems ist in Abschnitt 10.5.1, „Issue Management“ beschrieben, Abschnitt 6.1.2.6.1, „Issue Management“ zeigt wie das Issue-Management-System einem Projekt zugeordnet wird.

9.6.1. Übersichtsseite

Die Übersichtsseite zeigt alle im Projekt vorhandenen Issues in einer Tabelle an. In diesem Kapitel wird gezeigt, wie Issues erstellt, verlinkt und bearbeitet werden.

Ein Klick auf den Button Neu öffnet die Seite Abschnitt 9.6.6, „Issue - Details“.

Ein Klick auf den Button Verknüpfen öffnet das Issues verknüpfen Panel, in dem vorhandene Issues aus Issue-Management-Systemen mit Testfällen und Testsystemen verknüpft werden können (siehe Abschnitt 9.6.7, „Einen Issue verlinken“).

Die Übersichtsseite „Issues“

Abbildung 9.31. Die Übersichtsseite Issues


Die Tabelle zeigt die folgenden Werte:

ID

Die externe Issue Referenz.

Zusätzliche Hinweise

Hier wird zum Einen das Symbol des Issue-Managament-Systems angezeigt. Ein Klick auf das Symbol öffnet das Issue im Issue-Management-System. Zum Anderen kann hier auch ein erscheinen. In diesem Fall sollte sofort der Administrator informiert werden. Ursachen für das Anzeigen des können unter Anderem sein:
  • Deaktivierung des Issue-Management-Systems

  • Fehlerhafte Konfiguration des Issue-Management-Systems in Klaros-Test­management oder im Issue-Management-System. Die Konfiguration eines Issue-Management-Systems ist in Abschnitt 10.5.1, „Issue Management“ beschrieben.

Ein Tooltip erscheint, wenn der Cursor über dem hier angezeigten Icon platziert wird.

System

Die ID des Issue-Management-Systems.

Zusammenfassung

Die Zusammenfassung des Issues.

Testfälle

Eine Liste der verknüpften Testfälle mit dem Ergebnis ihrer letzten Ausführung.

Testsysteme

Eine Liste der verknüpften Testsysteme.

Zuständig

Der Benutzername des zuständigen Benutzers.

Priorität

Die Priorität des Issues.

Status

Der Status des Issues.

Aktion

Die ausführbaren Aktionen.

9.6.2. Aktion

Die Aktionsspalte befindet sich ganz rechts in der Tabelle. Folgende Aktionen lassen sich hier vornehmen:

  •   Bearbeiten
  •   Issue im externen Issue-Managment-System öffnen
  •   Druckansicht öffnen
  •   Löschen

Wurde ein Issue gelöscht, ist es zunächst mit einer Löschmarkierung versehen und nur noch für Administratoren sichtbar. Für gelöschte Issues stehen dann statt Löschen die folgenden Aktionen zur Verfügung:

  •   Wiederherstellen
  •   Das Issue aus der Datenbank entfernen
[Wichtig] Wichtig

Ein Klick auf löscht nicht das Issue im Issue-Management-System, sondern es wird nur aus der Datenbank entfernt!

9.6.3. Massenaktionen

Bestimmte Aktionen lassen sich auch auf mehrere Issues gleichzeitig anwenden. Dazu wählen Sie in der Spalte ganz links die Issues aus, auf die die Aktion angewendet werden soll.

Für Issues werden folgende Massenaktionen unterstützt:

  •   Druckansicht öffnen
  •   Löschen
  •   Wiederherstellen des Issues (nur Administrator).
  •   Das Issue aus der Datenbank entfernen (nur Administrator).

Weitere Informationen hierzu finden Sie unter Abschnitt 5.2.3.1.5, „Massenaktionen“.

9.6.4. Tabellenoperationen

In der Zeile rechts oberhalb der Tabelle lassen sich folgende Operationen vornehmen:

  •   Filter / Sortieren
  • Zeige alle / Nur aktive (Nur Administrator)
  •   Suchen
  •   Exportieren
  •   Spaltenauswahl

Alle Operationen sind ausführlich in Abschnitt 5.2.3.1, „Übersichtsseite“ beschrieben.

9.6.5. Detailseite

Jedes Issue verfügt über eine eigene Detailseite mit weitergehenden Unteransichten. Mit Klick auf die ID des betreffenden Issues oder auf das Icon rechts in der Aktionsspalte gelangen Sie zu der als letztes ausgewählten Detailansicht. Bei erstmaligem Aufruf ist dies die Ansicht Eigenschaften.

Es stehen die folgenden Ansichten zur Verfügung: Eigenschaften, Testfälle, Testsysteme und Änderungen.

9.6.5.1. Aktionen

Auf den Detailseiten befinden sich rechts oben weitere Icons. Folgende Aktionen lassen sich hier vornehmen:

  Externen Link öffnen

Öffnet das Issue im externen Issue-Management-System.

  Aktualisieren

Synchronisiert das lokale Issue mit der externen Quelle.

  Druckansicht erstellen

Hier kann eine druckfreundliche Ansicht des Issues erstellt werden. Mit Klick auf das Icon öffnet sich diese in einem neuen Browsertab.

Weitere Informationen hierzu finden Sie unter Abschnitt 5.2.3.2.1, „Druckansichten“.

  Lesezeichen anlegen

Jede einzelne Detailseite kann auch direkt über einen Hyperlink erreicht werden. Mit Klick auf das Icon wird dieser Link in die Zwischenablage kopiert.

Weitere Informationen hierzu finden Sie unter Abschnitt 5.2.3.2.2, „Lesezeichen“.

    Blättern

Mit den grünen Pfeilen ganz oben rechts kann zwischen den auf der vorherigen Seite vorhandenen Issues gewechselt werden.

9.6.5.2. Eigenschaften

In dieser Ansicht ( Figure 9.32 ) werden verschiedene Attribute des Issues angezeigt und können bearbeitet werden, wenn der Benutzer die entsprechende Berechtigung hat.

Die Ansicht „Eigenschaften“

Abbildung 9.32. Die Ansicht Eigenschaften


Die Issue- ID ist ein Hyperlink zum entsprechenden Issue im Issue-Management-System.

9.6.5.3. Testfälle

In dieser Ansicht werden alle Testfälle aufgelistet, die mit diesem Issue verknüpft sind.

Die Ansicht „Testfälle“

Abbildung 9.33. Die Ansicht Testfälle


Mit Klick auf den Button Zuweisen werden Testfälle einem Issue zugewiesen. Es öffnet sich ein Dialog, in dem mehrere Testfälle auf einmal ausgewählt werden können.

Der Dialog „Testfälle zuordnen“

Abbildung 9.34. Der Dialog Testfälle zuordnen


Für Testfälle werden folgende Massenaktionen unterstützt:

  •   Entfernen

Die Detailseite eines Testfalls zeigt eine Liste aller verknüpften Issues. Weitere Informationen hierzu finden Sie unter Abschnitt 6.7.2.8, „Issues“.

9.6.5.4. Testsysteme

Die Seite listet alle dem Issue zugeordneten Testsysteme auf.

Möchten Sie die Testsysteme mit dem Issue verknüpfen, klicken Sie auf den Button Zuweisen und wählen Sie ein oder mehrere Testsysteme aus.

Für Testsysteme werden folgende Massenaktionen unterstützt:

  •   Entfernen

Die Detailseite eines Testsystems zeigt eine Liste aller verknüpften Issues. Weitere Informationen hierzu finden Sie unter Abschnitt 6.5.2.6, „Issues“.

Die Ansicht „Testsysteme“

Abbildung 9.35. Die Ansicht Testsysteme


Der Dialog „Testsysteme zuordnen“

Abbildung 9.36. Der Dialog Testsysteme zuordnen


9.6.5.5. Änderungen

Die Ansicht Änderungen zeigt die Änderungshistorie dieses Issues an.

Eine ausführliche Beschreibung der Ansicht Änderungen finden Sie unter Abschnitt 5.2.3.2.8, „Änderungshistorie“.

9.6.6. Issue - Details

Die Seite „Issue erstellen“

Abbildung 9.37. Die Seite Issue erstellen


Das erste Issue-Management-System des aktiven Projekts wird automatisch aus der Dropdown-Liste Issue-Management-System ausgewählt.

[Anmerkung] Anmerkung

Falls die Liste der Issue-Management-Systeme leer ist, muss mindestens ein Issue-Management-System konfiguriert und an das aktive Projekt angebunden werden. Die Konfiguration von Issue-Management-Systemen ist in Abschnitt 10.5.1, „Issue Management“ beschrieben. Abschnitt 6.1.2.6.1, „Issue Management“ enthält Anweisungen zum Hinzufügen eines Issue-Management-Systems zu einem Projekt.

Standardmäßig verwendet Klaros-Test­management die auf dem Anmeldebildschirm eingegebenen Anmeldedaten zur Authentifizierung der Benutzer mit dem Issue-Management-System. Bei Verwendung von Bugzilla wird auch die E-Mail/Passwort-Kombination des Benutzers ausprobiert, da die E-Mail üblicherweise der Anmeldename in Bugzilla ist. Wenn die bei der Anmeldung eingegebenen Anmeldedaten nicht funktionieren und das Issue-Management-System während der Sitzung noch nicht verwendet wurde, wird Klaros-Test­management neue Authentifizierungsinformationen in einem Dialogfenster anfordern.

[Wichtig] Token-basierte Authentifizierung (Jira Cloud instances, GitLab)

Klaros-Test­management unterstützt auch ein Token-basierte Authentifizierung. Verwenden Sie dazu einen leeren Benutzernamen und das Token als Passwort.

Einige Anbieter wie Jira und GitLab beschränken den Zugriff auf Token-basierte Authentifizierung. Die Authentifizierung über Benutzername und Passwort wird für diese Systeme nicht mehr unterstützt.

Beim Klick auf das Icon öffnet sich das externe Issue-Management-System in einem neuen Browser-Tab.

Eim Klick auf das Icon öffnet einen Dialog zum Ändern der Authentifizierungsinformationen.

Sobald ein Issue-Management-System ausgewählt wurde, wird eine Liste der Issue-Felder angezeigt. Die Anzahl und Bezeichnungen dieser Felder variieren je nach Art und Konfiguration des Issue-Management-Systems. Pflichtfelder sind farbig unterlegt.

[Anmerkung] Anmerkung

Um das Issue speichern zu können, müssen alle Pflichtfelder ausgefüllt sein.

Issue-Felder für jedes Issue-Management-System

Testfälle

Die Testfälle, mit denen dieser Issue verknüpft werden soll.

Testsysteme

Das Testsysteme, mit denen dieser Issue verknüpft werden soll.

Testfallstatus aktualisieren

Durch Aktivieren dieser Checkbox wird neue Dropdown-Liste geöffnet, in der der neue Status der verknüpften Testfälle ausgewählt werden kann.

9.6.6.1. Einen Issue in Bugzilla anlegen

Die Seite „Issue Details Bugzilla“

Abbildung 9.38. Die Seite Issue Details Bugzilla


9.6.6.2. Einen Issue in Github anlegen

Die Seite „Issue Details - GitHub“

Abbildung 9.39. Die Seite Issue Details - GitHub


9.6.6.3. Einen Issue in GitLab anlegen

Die Seite „Issue Details - GitLab“

Abbildung 9.40. Die Seite Issue Details - GitLab


9.6.6.4. Einen Issue in JIRA anlegen

Die Seite „Issue Details - JIRA“

Abbildung 9.41. Die Seite Issue Details - JIRA


9.6.6.5. Einen Issue in Mantis anlegen

Die Seite „Issue Details - Mantis“

Abbildung 9.42. Die Seite Issue Details - Mantis


9.6.6.6. Einen Issue in Redmine anlegen

Die Seite „Issue Details - Redmine“

Abbildung 9.43. Die Seite Issue Details - Redmine


9.6.6.7. Einen Issue in Trac anlegen

Die Seite „Issue Details - Trac“

Abbildung 9.44. Die Seite Issue Details - Trac


9.6.6.8. Einen Issue in YouTrack anlegen

Die Seite „Issue Details - YouTrack“

Abbildung 9.45. Die Seite Issue Details - YouTrack


9.6.7. Einen Issue verlinken

Issues können aus Klaros-Test­management heraus erstellt werden oder aus einem Issue-Management-System mit Testfällen und Testsystemen in Klaros-Test­management verknüpft werden.

Das „Issue verknüpfen“ Panel

Abbildung 9.46. Das Issue verknüpfen Panel


Um ein Issue mit einem Testfall oder Testsystem zu verknüpfen, muss zuerst ein Issue-Management-System ausgewählt werden. Ein Klick auf den Button Verknüpfen verknüpft den Issue mit der eingegebenen ID mit den ausgewählten Testfällen und Testsystemen.

System

Das Issue-Management-System, von dem aus Issues verknüpft werden sollen.

ID

Die ID des zu verknüpfenden Issues.

Beim Klick auf das Icon wird das Issue-Management-System nach dem Issue mit der eingegebene ID durchsucht. War die Suche erfolgreich, verknüpft ein Klick auf den Button Verknüpfen den Issue mit den ausgewählten Testfällen und Testsystemen.