Der ultimative Leitfaden zur Fehlerberichterstattung, den Sie nicht verpassen sollten

Die Fehlerberichterstattung ist eine Fähigkeit, welche Ihre volle Konzentration, Präzision, Klarheit und ein tiefes Verständnis des Entwicklungsprozesses erfordert. In diesem umfassenden Leitfaden, der auf erfahrene Fachleute wie Sie zugeschnitten ist, gehen wir auf die wichtigsten Punkte ein, auf die viele bei der Dokumentation und Kommunikation von Fehlern stoßen. Am Ende dieses Artikels werden wir Sie mit wichtigem Wissen und hocheffizienten Strategien ausstatten, wie man einen Fehlerbericht schreibt.

Die Fehlerberichterstattung bei Softwaretests ist die Dokumentierung und das Kommunizieren von Fehlern, die in Softwareanwendungen oder -systemen gefunden wurden. Beim Testen der Software unter verschiedenen Gesichtspunkten werden Sie auf Probleme, Störungen oder unerwartetes Verhalten stoßen, die von den Benutzern einfach als Bugs bezeichnet werden. Sie reichen von kleineren, oberflächlichen Mängeln bis zu kritischen Funktionsproblemen, welche die Benutzerfreundlichkeit stark beeinträchtigen.

Wenn Sie einen Fehlerbericht erstellen, müssen Sie eine klare und detaillierte Beschreibung liefern, einschließlich der Schritte zur Reproduktion des Fehlers, Systeminformationen und anderer relevanter Daten. Dieser Bericht sollte den Entwicklern, den Projektmanagern und anderen an der Entwicklung Beteiligten zur Verfügung gestellt werden.

Fehlerberichte sind eine wichtige Brücke zwischen Test- und Entwicklungsteams und stellen sicher, dass das Entwicklungsteam erkannte Probleme effektiv versteht und behebt. Ein gut geschriebener Fehlerbericht hilft den Entwicklern, das Problem zu verstehen und liefert wichtige Informationen, die eine effiziente Diagnose und Behebung des Problems erleichtern, wie es oft in Software zur Fehlerverfolgung der Fall ist. Eine effektive Fehlerberichterstattung ist für die Aufrechterhaltung der Softwarequalität, die Einhaltung von Projektfristen und die Förderung der Zusammenarbeit zwischen Test- und Entwicklungsteams von entscheidender Bedeutung.

Die Frage „Was ist ein guter Fehlerbericht?“ kann auch umformuliert werden als „Welche Eigenschaften sollte ein gut ausgearbeiteter Fehlerbericht haben?“ Hier sind also die Kriterien, die Sie bei der Erstellung und Bewertung von Fehlerberichten anwenden sollten:

1. Prägnanz: Ein effektiver Fehlerbericht ist kurz und bündig, vermeidet unnötige Floskeln und konzentriert sich auf die wesentlichen Informationen, um das Problem schnell zu verstehen.
2. Klarheit: Ein Fehlerbericht sollte eine klare und einfache Sprache verwenden, um das Problem zu beschreiben, und keinen Raum für Zweideutigkeiten oder Fehlinterpretationen lassen.
3. Relevanz: Ein hochwertiger Fehlerbericht enthält nur die Informationen, die sich auf den Fehler beziehen. Unzusammenhängende Details können Entwickler von der Identifizierung des Kernproblems ablenken.
4. Objektivität: Fehlerberichte sollten keine persönlichen Meinungen oder Vermutungen enthalten, sondern nur sachliche Informationen.
5. Benutzerzentrierte Perspektive: Ein guter Fehlerbericht hebt hervor, wie sich der Fehler auf die Benutzererfahrung auswirkt und wie wichtig es ist, das Problem zu lösen.
6. Effiziente Struktur: Der Fehlerbericht sollte eine Zusammenfassung, Beschreibung, Reproduktionsschritte, erwartete und tatsächliche Ergebnisse, Umgebung usw. enthalten.
7. Beweise: Fügen Sie, wann immer möglich, Beweise für den Fehlerbericht bei, z. B. Screenshots, Videos, Protokolle oder Fehlermeldungen. Dies stärkt die Glaubwürdigkeit des Berichts und hilft, den Fehler zu reproduzieren.
8. Bewusstsein für den Kontext: Ein effektiver Fehlerbericht zeigt ein Verständnis für den Kontext der Anwendung, einschließlich ihrer Funktionalitäten, Anwendungsfälle und Systemarchitektur.
9. Pünktlichkeit: Eine qualitativ hochwertige Fehlermeldung wird umgehend nach der Entdeckung des Fehlers eingereicht, wodurch sich die Chancen erhöhen, dass das Problem schneller behoben wird.
10. Gemeinsamer Geist: Betrachten Sie die Fehlerberichterstattung als eine gemeinsame Anstrengung zur Verbesserung der Softwarequalität und nicht als Schuldzuweisung. Verwenden Sie die richtige Sprache, um eine positive Arbeitsbeziehung zwischen Testern und Entwicklern zu fördern.
11. Liebe zum Detail: Einige kleine Details mögen unbedeutend erscheinen oder etwas zu lang sein, um sie zu schreiben, können aber entscheidend sein, um die Ursache des Fehlers zu identifizieren (und nicht falsch zu identifizieren).
12. Fehlerklassifizierung: Kategorisieren Sie den Fehler nach seiner Art, etwa nach Funktions-, Leistungs- oder Benutzerfreundlichkeitsproblemen. Dies hilft den Entwicklern, Prioritäten zu setzen und verschiedene Arten von Fehlern effizient zu bekämpfen.
13. Nachbereitung und Kommunikation: Setzen Sie sich mit den Entwicklern in Verbindung, um zusätzliche Informationen bereitzustellen oder bestimmte Punkte im Fehlerbericht zu klären. Seien Sie offen für Diskussionen und arbeiten Sie gemeinsam an einer Lösung.
14. Wissensaustausch: Nutzen Sie Fehlerberichte, um Wissen unter den Teammitgliedern auszutauschen und so das kollektive Verständnis für die Anwendung und mögliche Probleme zu verbessern.
15. Einfühlungsvermögen: Erkennen Sie, dass auch die Entwickler nach Spitzenleistungen streben, und ein einfühlsamer Umgang mit Fehlerberichten kann zu einem konstruktiveren und positiveren Entwicklungsprozess führen.

Die wichtigsten Merkmale eines Fehlerberichts enthalten wesentliche Elemente, die Ihrem Team helfen, das gemeldete Problem zu verstehen, zu reproduzieren und effektiv zu beheben. Hier sind die wichtigsten Merkmale, die jeder Fehlerbericht enthalten sollte:

1. Titel: Fassen Sie das Thema in einem klaren, prägnanten und dennoch beschreibenden Titel zusammen.
2. Beschreibung: Fügen Sie eine kurze Beschreibung des Fehlers hinzu, um zu sagen, was defekt ist und wie weit verbreitet und/oder schwerwiegend das Problem ist.
3. Schritte zur Reproduktion: Fügen Sie eine Schritt-für-Schritt-Anleitung zur Reproduktion des Fehlers hinzu und helfen Sie den Entwicklern, das Problem zu reproduzieren.
4. Erwartete Ergebnisse: Geben Sie klar an, wie das erwartete Verhalten aussehen sollte, wenn der Fehler nicht vorhanden wäre.
5. Tatsächliche Ergebnisse: Beschreiben Sie, was in der Anwendung passiert, wenn der Fehler auftritt.
6. Informationen zur Umgebung: Geben Sie relevante Informationen über die Umgebung an, wie das Betriebssystem, die Browserversion und den Gerätetyp.
7. Anhänge: Fügen Sie Bildschirmfotos, Videos oder andere Medien hinzu, die den Fehler visuell demonstrieren.
8. Reproduktionsrate: Geben Sie die Reproduktionsrate an, um den Entwicklern zu zeigen, wie häufig der Fehler auftritt.
9. Schweregrad und Priorität: Geben Sie den Schweregrad des Fehlers (z. B. kritisch, wichtig, geringfügig) und seine Priorität (z. B. hoch, mittel, niedrig) auf der Grundlage der wahrgenommenen geschäftlichen Auswirkungen und der Dringlichkeit an.
10. Informationen zur Isolierung: Helfen Sie bei der Eingrenzung der Grundursache, indem Sie angeben, ob der Fehler nur in bestimmten Szenarien oder Umgebungen reproduzierbar ist.
11. Zusätzlicher Kontext: Geben Sie weitere relevante Zusammenhänge an, z. B. die Schritte, die zu dem Fehler führten, verwandte Fehler oder jüngste Änderungen an der Codebasis, die Ihrer Meinung nach das Problem verursacht haben könnten.
12. Protokolle und Fehlermeldungen: Fügen Sie ggf. relevante Protokolle oder Fehlermeldungen bei, die den Entwicklern bei der Diagnose des Problems helfen können.
13. Zuweisung: Geben Sie die Person oder das Team an, das für die Behebung des Fehlers verantwortlich ist.
14. Informationen zum Meldenden: Identifizieren Sie die Person, die den Fehler gemeldet hat, damit Sie bei Bedarf weitere Fragen stellen oder den Fehler klären können.
15. Status und Fortschritt: Halten Sie den Fehlerbericht mit dem aktuellen Status des Fehlers und den erzielten Fortschritten auf dem Laufenden.

Hier finden Sie eine schrittweise Anleitung zum Schreiben eines Fehlerberichts:

Schritt 1: Beobachten Sie den Fehler

Testen Sie die Anwendung gründlich und ermitteln Sie alle unerwarteten Verhaltensweisen, Fehler oder Probleme.

Schritt 2: Reproduzieren Sie den Fehler

Versuchen Sie, den Fehler in einer kontrollierten Umgebung zu reproduzieren. Notieren Sie sich die genauen Schritte, um das Problem wiederherzustellen.

Schritt 3: Sammeln Sie Informationen

Sammeln Sie relevante Details über den Fehler, einschließlich des Betriebssystems, des Browsers, des Geräts, der Anwendungsversion und anderer relevanter Umgebungsinformationen.

Schritt 4: Definieren Sie den Fehler

Schreiben Sie einen klaren und beschreibenden Titel, der den Fehler kurz und bündig zusammenfasst.

Schritt 5: Beschreiben Sie den Fehler

Geben Sie eine detaillierte Beschreibung des Fehlers, in der Sie erklären, was passiert ist, wo er aufgetreten ist und welche Auswirkungen er auf die Anwendung hat.

Schritt 6: Geben Sie die erwarteten Ergebnisse an

Geben Sie klar an, wie das erwartete Verhalten aussehen soll, wenn der Fehler nicht vorhanden wäre.

Schritt 7: Beziehen Sie die tatsächlichen Ergebnisse ein

Beschreiben Sie das tatsächliche Verhalten, das beim Auftreten des Fehlers beobachtet wurde, und wie es sich von den erwarteten Ergebnissen unterscheidet.

Schritt 8: Bringen Sie visuelle Beweise an

Machen Sie Screenshots, Videos oder andere visuelle Beweise, die den Fehler zeigen.

Schritt 9: Geben Sie den Schweregrad und die Priorität des Fehlers an

Bewerten Sie den Schweregrad des Fehlers (z. B. kritisch, schwerwiegend, geringfügig) auf der Grundlage seiner Auswirkungen auf die Anwendung und legen Sie die Prioritäten für die Fehlerbehebung fest (z. B. hoch, mittel, gering).

Schritt 10: Beziehen Sie zusätzlichen Kontext ein

Fügen Sie alle anderen relevanten Informationen hinzu, die den Entwicklern helfen können, den Fehler besser zu verstehen, wie z. B. verwandte Arbeitsabläufe oder aktuelle Änderungen in der Codebasis.

Schritt 11: Isolieren Sie den Fehler

Stellen Sie fest, ob der Fehler spezifisch für bestimmte Module oder Bedingungen ist.

Schritt 12: Weisen Sie den Fehler zu

Geben Sie an, welche Person oder welches Team für die Behebung des Fehlers verantwortlich ist.

Schritt 13: Reichen Sie den Fehlerbericht ein

Senden Sie den Fehlerbericht an das entsprechende System zur Fehlerverfolgung oder an das Entwicklungsteam.

Schritt 14: Fassen Sie nach, und arbeiten Sie zusammen

Führen Sie Folgegespräche mit den Entwicklern, stellen Sie bei Bedarf zusätzliche Informationen zur Verfügung und arbeiten Sie gemeinsam an der Behebung des Fehlers.

Schritt 15: Überprüfen Sie die Korrektur

Sobald der Fehler behoben ist, überprüfen Sie die Lösung und geben Sie eine Rückmeldung im Fehlerbericht.

Nachfolgend finden Sie ein Beispiel für einen Fehlerbericht, das alles zeigt, was Sie in Ihren Bericht aufnehmen sollten. Obwohl es ein einfaches Beispiel ist, können Sie es auch als Vorlage für einen Fehlerbericht verwenden:

Titel: Suchfunktionalität gibt keine Ergebnisse zurück

Beschreibung: Bei Verwendung der Suchfunktion auf der Website werden keine Suchergebnisse angezeigt, auch nicht für gültige und häufig verwendete Schlüsselwörter.

Schritte zum Reproduzieren:

1. Gehen Sie auf die Homepage (https://www.ourwebsite.com).
2. Wählen Sie die Suchleiste in der oberen rechten Ecke der Seite.
3. Geben Sie das Stichwort „Produkt“ in die Suchleiste ein.
4. Klicken Sie auf die Schaltfläche „Suchen“ oder drücken Sie die Taste „Enter“.

Erwartete Ergebnisse:

Auf der Suchergebnisseite sollte eine Liste von Produkten angezeigt werden, die mit dem Stichwort „Produkt“ in Zusammenhang stehen.

Tatsächliche Ergebnisse:

Nach der Suche bleibt die Seite mit den Suchergebnissen leer, und es werden keine Produkte angezeigt.

Informationen zur Umgebung:

• Betriebssystem: Windows 10
• Browser: Google Chrome Version 94.0.4606.81 (offizielles Build) (64-bit)

Screenshots: (Fügen Sie entsprechende Screenshots bei, welche die leere Suchergebnisseite zeigen)

Schweregrad und Priorität des Fehlers:

Schweregrad: Major

Priorität: Hoch

Zusätzlicher Kontext:

• Dieses Problem tritt durchgängig auf allen Seiten der Website auf.
• Die Suchfunktion funktionierte bis zu einer Aktualisierung der Website vor zwei Tagen einwandfrei.
• Es werden keine Fehlermeldungen angezeigt; die Suchseite ist einfach leer.

Informationen zur Isolierung:

Das Problem scheint nicht mit bestimmten Benutzerkonten oder dem Anmeldestatus zusammenzuhängen, da es sowohl bei angemeldeten als auch bei Gastbenutzern auftritt.

Zugewiesen an:

Entwicklungsteam

Informationen für die Berichterstattung:

QS-Tester, John Doe (john.doe@example.com)

Status und Fortschritte:

• Berichtet am: DD/MM/YYYY
• Das Entwicklungsteam untersucht das Problem.

Hier ist eine Liste einiger bekannter und hoch angesehener Fehlerberichtstools, die von Entwicklern und Testern verwendet werden:

1. Jira ist ein weit verbreitetes Fehlerwerkzeug, das von Atlassian entwickelt wurde. Es bietet umfangreiche Anpassungsmöglichkeiten und lässt sich gut mit anderen Entwicklungstools integrieren, kann aber den eigentlichen QS-Lebenszyklus nicht bewältigen und kann mit seinen umfangreichen Funktionen und Konfigurationen für Nichttechniker eine Herausforderung darstellen.
2. Bugzilla ist ein Open-Source-System zur Fehlerberichterstattung, das eine einfache Schnittstelle zur Berichterstattung und Verwaltung von Fehlern bietet. Während Bugzilla die Fehlerberichterstattung für kleinere Teams effektiv handhaben kann, stößt es auf Leistungsprobleme oder Komplexitätsprobleme, wenn es für umfangreiche Projekte auf Unternehmensebene mit einer großen Anzahl von Fehlern und Benutzern verwendet wird.
3. Mantis Bug Tracker ist ein weiteres Open-Source-Tool zur Fehlerverfolgung, mit einer benutzerfreundlichen Oberfläche und einer Reihe von Funktionen für die Fehlerverwaltung, aber es hat eine begrenzte Anzahl von Integrationen mit anderen Entwicklungs- und Projektmanagement-Tools.
4. YouTrack wurde von JetBrains entwickelt, das für seine leistungsstarken Such- und Filterfunktionen bekannt ist. Die Konfiguration von Arbeitsabläufen und Einstellungen zur Anpassung an spezifische Teamprozesse kann jedoch eine steilere Lernkurve und mehr Zeitaufwand erfordern als bei einfacheren Tools zur Fehlerverfolgung.

Wenn Sie jedoch eine All-in-One Software für die Fehlerverfolgung suchen, die den Anforderungen von Unternehmen und den gesetzlichen Vorschriften entspricht, ist aqua cloud die Lösung, die Sie suchen. Mit aqua können Sie Ihre Bemühungen um die Verfolgung von Problemen unterstützen:

• Erstellen Sie eine Fehlerbehebungspipeline mit definierten Workflows, um den Lebenszyklus der Fehler effektiv zu verwalten.

• Nutzen Sie die native Integration von aqua mit Capture für einfache Fehlerberichte und Testaufzeichnungen mit nur einem Klick. Die Erfassung umfasst eine Videoaufzeichnung, ein mit einem Zeitstempel versehenes Aktionsprotokoll, DevTools-Daten und Hardware-/OS-Informationen für umfassende Fehlerberichte.

• Sparen Sie Zeit bei der Korrekturvalidierung, indem Sie schnell sehen, welche Fehler seit der letzten Ausführung des Testfalls als behoben markiert wurden.
• Nutzen Sie die KI von aqua, um doppelte Fehler automatisch zu erkennen und zu beseitigen und so die Anzahl der gemeldeten Fehler um bis zu 20 % zu reduzieren.
• Erstellen von Testfällen mit aqua Copilot: aqua Copilot bietet einen rationalisierten Ansatz für die Erstellung von Testfällen, insbesondere für Randfälle, und generiert automatisch Testszenarien, einschließlich Randfällen, was Zeit spart und eine vollständige Testabdeckung gewährleistet.
• Involvieren Sie auch Nichttechniker in die Fehlerberichte, indem Sie intuitive Fehler-Vorlagen für die einfache Weitergabe von Problemen einrichten.

• Sparen Sie Zeit beim regulären Testen, indem Sie aqua-Testfälle mit Capture ausführen, was eine nahtlose Erstellung von Fehlertickets ohne Unterbrechung des Testprozesses ermöglicht.

Effektive Fehlerberichterstattung ist eine wichtige Fähigkeit für leitende Tester und QS-Ingenieure, um eine qualitativ hochwertige Softwarelieferung zu gewährleisten. In diesem umfassenden Leitfaden wurden die wichtigsten Grundsätze und bewährten Verfahren zur Erstellung aussagekräftiger Fehlerberichte untersucht. Sie können Arbeitsabläufe straffen und die Effizienz der Fehlerbehebung verbessern, indem Sie Klarheit und Zusammenarbeit in den Vordergrund stellen und Tools wie aqua cloud nutzen. Kontinuierliches Lernen und die Förderung einer offenen Kommunikationskultur treiben Software-Exzellenz voran und führen zu einer Zukunft, in der jeder gemeldete Fehler eine Chance für den Fortschritt darstellt. Viel Spaß bei der Fehlerberichterstattung!