Zum Inhalt springen

Grund für das Schließen und Wiedereröffnen von Issues

Benutzer müssen je Projekttyp einen Grund angeben, wenn ein Issue geschlossen oder wiedereröffnet wird. Der Grund steht in der Historie und in der Issue-Liste.

Veröffentlicht 4 Min. Lesezeit .md

Verschwindet ein Issue aus der Liste der offenen Issues, lautet die nächste Frage meist: „Warum?" Wurde es in der Umfrage behoben, war es gar kein Fehler, oder wurde es für diese Welle bewusst akzeptiert? Manche Teams und Kunden brauchen diese Antwort für jedes Issue dokumentiert. SurveyTester kann einen Grund verlangen, wenn ein Issue geschlossen, wiedereröffnet oder beides wird. Der Grund wird mit der Änderung in der Issue-Historie gespeichert und ist in der Issue-Liste und im Issue selbst sichtbar.

Warum das ohne SurveyTester schwierig ist

  • Der Status sagt, dass ein Issue geschlossen wurde, nicht warum. Ein behobenes Issue sieht genauso aus wie ein verworfenes. Wochen später, beim Sign-off oder im Kundenreview, weiß niemand mehr, was was war.
  • Kommentare sind freiwillig. Die Bitte „Schreibt beim Schließen bitte einen Kommentar" hält eine Woche. Eine Regel, die das Werkzeug durchsetzt, gilt in jedem Projekt.
  • Issues werden an vielen Stellen geschlossen. In SurveyTester schließt sich ein Issue über die Checkbox Erledigt, den Schalter im Issue-Dialog, einen Klassifizierungswert, der das Issue schließt, oder die Sammelbearbeitung. Wird der Grund nur an einer dieser Stellen abgefragt, bleiben Lücken.
  • Auch das Wiedereröffnen zählt. Ein Issue, das nach dem Schließen zurückkommt, sagt etwas über die Korrektur aus. Der Grund fürs Wiedereröffnen ist oft interessanter als der fürs Schließen.

So funktioniert es

Die Anforderung gehört zum Projekttyp (dem Klassifizierungs-Feldset, das ein Projekt verwendet). Zwei unabhängige Einstellungen legen fest, ob beim Schließen und beim Wiedereröffnen ein Grund nötig ist.

Ist eine Einstellung aktiv, fragt jede Statusänderung im Projekt zuerst nach dem Grund:

  • die Checkbox Erledigt in der Issue-Liste,
  • der Schalter Erledigt im Issue-Dialog,
  • ein Klassifizierungswert mit Problem schließen (z. B. Status = Behoben), in der Liste und im Issue-Dialog. Ein Wert, der das Issue wieder öffnet, fragt nach dem Grund fürs Wiedereröffnen.
  • die Sammelbearbeitung mehrerer Issues,
  • ein neues Issue, das bereits geschlossen angelegt würde.

Der Dialog lässt sich mit leerem Text nicht bestätigen. Abbrechen lässt alles, wie es war: Das Issue behält seinen Status, und der Klassifizierungswert wird nicht gespeichert. Weil die Prüfung auch auf dem Server läuft, wird eine Statusänderung ohne Grund nie gespeichert, auch nicht aus einem veralteten Browser-Tab.

Platzhalter: Screenshot des Dialogs „Grund für das Schließen" in der Issue-Liste - ein Textfeld mit eingegebenem Grund, die Schaltflächen „Abbrechen" und „Issue schließen"
Der Grund wird abgefragt, bevor das Issue geschlossen wird

Schritt für Schritt

1. Anforderung für einen Projekttyp aktivieren

  1. Öffnen Sie Administration → Projekttypen und wählen Sie den Projekttyp.
  2. Aktivieren Sie unter dem Namen des Projekttyps Benutzer müssen beim Schließen eines Issues einen Grund angeben.
  3. Braucht auch das Wiedereröffnen einen Grund, aktivieren Sie zusätzlich Benutzer müssen beim Wiedereröffnen eines Issues einen Grund angeben.

Die Einstellung gilt sofort für alle Projekte dieses Projekttyps. Bestehende Issues werden nicht verändert. Beim Duplizieren eines Projekttyps werden die Einstellungen mitkopiert.

Platzhalter: Screenshot von Administration > Projekttypen mit den zwei Checkboxen unter dem Namen des Projekttyps
Die beiden Einstellungen eines Projekttyps

2. Ein Issue schließen

Setzen Sie in der Issue-Liste das Häkchen bei Erledigt, schalten Sie das Issue im Issue-Dialog auf erledigt, oder wählen Sie einen Klassifizierungswert, der das Issue schließt. Der Dialog für den Grund öffnet sich. Geben Sie den Grund ein und klicken Sie auf Issue schließen.

3. Mehrere Issues auf einmal schließen

Markieren Sie die Issues in der Liste und verwenden Sie die Sammelbearbeitung. Schließt oder öffnet die Änderung Issues, fragt SurveyTester einmal und speichert denselben Grund bei jedem Issue, dessen Status sich tatsächlich ändert. Bereits geschlossene Issues bleiben unberührt.

4. Die Gründe lesen

  • Issue-Liste: Fügen Sie über die Spaltenauswahl die Spalte Grund für das Schließen hinzu. Sie zeigt den letzten Grund, markiert als Geschlossen oder Wiedereröffnet, mit Benutzer und Datum. Fahren Sie mit der Maus über einen langen Grund, um ihn vollständig zu lesen.
  • Issue-Dialog: Der Abschnitt Grund für das Schließen listet jedes Schließen und Wiedereröffnen des Issues mit Grund auf, das neueste zuerst.
  • Issue-Historie: Jede Statusänderung zeigt ihren Grund unter dem alten und neuen Wert.
Platzhalter: Screenshot der Issue-Liste mit der Spalte „Grund für das Schließen" - eine Zeile „Geschlossen: in Umfrageversion 3 behoben", eine andere „Wiedereröffnet: auf Französisch noch falsch"
Der letzte Grund in der Issue-Liste
Platzhalter: Screenshot des Issue-Dialogs mit dem Abschnitt „Grund für das Schließen" und zwei Einträgen (Geschlossen und Wiedereröffnet) mit Benutzer und Datum
Alle Gründe eines Issues

Gut zu wissen

  • Automatische Änderungen brauchen keinen Grund. Ändert SurveyTester einen Issue-Status selbst (Issues aus Auto-Detect-Befunden, Importe oder ein Administrator ändert, welche Klassifizierungswerte ein Issue schließen), erscheint kein Dialog. Die Historie zeigt stattdessen einen Hinweis wie Automatisch geändert (AutoDetect).
  • Status und Klassifizierung bleiben synchron. Hat ein Projekttyp Klassifizierungswerte, die ein Issue schließen, wird der Status weiterhin aus diesen Werten abgeleitet. Der Grund wird genau bei dieser Änderung gespeichert, sodass Status, Klassifizierung und Grund immer zusammenpassen.
  • Issues aus der Browser-Erweiterung werden nicht blockiert. Ein Grund wird gespeichert, wenn einer angegeben ist.
  • Nur Statusänderungen nach dem Aktivieren der Einstellung haben einen Grund. Ältere Schließungen zeigen keinen.

Siehe auch: Klassifizierungsfelder