Testdokumentation im Softwaretest (Beispiel)

Was ist Testdokumentation?

Die Testdokumentation ist eine Dokumentation von Artefakten, die vor oder während des Softwaretests erstellt werden. Sie hilft dem Testteam, den erforderlichen Aufwand abzuschätzen. tracDie Testressourcen und -fortschritte werden überwacht und eine angemessene Testabdeckung sichergestellt. Die Testprotokolle und -berichte bilden ein vollständiges Dokumentenpaket, mit dem Testplanung, Testdesign, Testdurchführung und Testergebnisse beschrieben und dokumentiert werden können.

👉 Melden Sie sich für ein kostenloses Live-Softwaretestprojekt an

Warum ist eine formale Prüfung notwendig?

Für Einsteiger liegt die Annahme nahe, dass Testen bedeutet, verschiedene Codeabschnitte willkürlich auszuführen und die Ergebnisse zu überprüfen. In der Praxis ist Testen jedoch ein sehr formaler Prozess, der detailliert dokumentiert wird. Die Testdokumentation erleichtert die Planung, Überprüfung und Durchführung von Tests und gewährleistet deren Nachvollziehbarkeit.

Der Grad der Testformalität hängt ab von:

• Die Art der zu testenden Anwendung (AUT).
• Von Ihrer Organisation befolgte Standards.
• Die Reife des Entwicklungsprozesses.

Testaktivitäten dauern typischerweise zwischen 30% und 50% des gesamten Softwareentwicklungsaufwands. Dokumentationen helfen dabei, Verbesserungspotenziale im Testprozess zu identifizieren, die in zukünftigen Projekten angewendet werden können.

Welche Arten von Testdokumentation gibt es?

Hier sind die wichtigsten Arten der Testdokumentation:

„In der Praxis werden diese Dokumente in verschiedenen Phasen erstellt – von der frühen Planung (Testrichtlinien, Strategie) bis zur Durchführung und zum Abschluss (Fehler- und Zusammenfassungsberichte).“

Arten von Testdokumenten	Beschreibung
Testrichtlinie	Es handelt sich um ein übergeordnetes Dokument, das die Prinzipien, Methoden und alle wichtigen Testziele der Organisation beschreibt.
Teststrategie	Ein übergeordnetes Dokument, das die für das Projekt durchzuführenden Testebenen (Testtypen) festlegt.
Versuchsplan	Ein Testplan ist ein vollständiges Planungsdokument, das den Umfang, die Vorgehensweise, die Ressourcen, den Zeitplan usw. der Testaktivitäten enthält.
Voraussetzungen: TracStabilitätsmatrix	Dies ist ein Dokument, das die Anforderungen mit den Testfällen verknüpft.
Testszenario	Testszenario ist ein Element oder Ereignis eines Softwaresystems, das durch einen oder mehrere Testfälle überprüft werden kann.
Testfall	Es handelt sich um eine Gruppe von Eingabewerten, Ausführungsvoraussetzungen, erwarteten Ausführungsnachbedingungen und Ergebnissen. Es wurde für ein Testszenario entwickelt.
Testdaten	Testdaten sind Daten, die vor der Ausführung eines Tests vorhanden sind. Sie werden verwendet, um den Testfall auszuführen.
Fehlerbericht	Ein Fehlerbericht ist ein dokumentierter Bericht über jeden Fehler in einem Softwaresystem, der dazu führt, dass dieses seine erwartete Funktion nicht erfüllt.
Zusammenfassender Testbericht	Der Testzusammenfassungsbericht ist ein übergeordnetes Dokument, das die durchgeführten Testaktivitäten sowie die Testergebnisse zusammenfasst.

Was sind die besten Vorgehensweisen zur Erstellung einer Testdokumentation?

In diesem Abschnitt lernen wir die besten Vorgehensweisen kennen, die zur Erstellung einer Testdokumentation beitragen, und erhalten Beispiele, die Ihnen das Verständnis erleichtern:

• Die Qualitätssicherung frühzeitig in das Projekt einbeziehen: Beziehen Sie das QA-Team von Projektbeginn an ein, damit die Testdokumentation parallel zur Produktentwicklung und den Anforderungen entsteht.
  Ejemplo: Die Qualitätssicherung arbeitet während der Sprintplanung mit, um auf Basis der User Stories erste Testfälle zu entwerfen.
• Dokumente auf dem neuesten Stand halten: Erstellen Sie Testdokumente nicht einfach und vergessen Sie sie dann – aktualisieren Sie sie immer dann, wenn sich Anforderungen oder Funktionen ändern.
  Ejemplo: Wenn sich eine Login-API ändert, aktualisieren Sie umgehend die zugehörigen Testfälle und Ergebnisse.
• Verwenden Sie die Versionskontrolle: Verwalten und tracAlle Änderungen an Testdokumenten müssen über Versionskontrollsysteme erfasst werden, um Verwirrung und Datenverlust zu vermeiden.
  Ejemplo: Speichern Sie Testpläne in GitHub, um eine übersichtliche Versionshistorie und Rollback-Optionen zu gewährleisten.
• Dokument zur Verdeutlichung und Zweckmäßigkeit: Dokumentieren Sie nur das, was Ihnen und Ihren Stakeholdern hilft, den Testfortschritt und die Ergebnisse zu verstehen.
  Ejemplo: Fügen Sie zusammenfassende Testberichte bei, in denen bestandene, fehlgeschlagene und blockierte Testfälle hervorgehoben werden, zur Überprüfung durch das Management.
• Standardvorlagen verwenden: Verwenden Sie ein einheitliches Format – zum Beispiel Excel- oder Word-Vorlagen –, um die Erstellung und Überprüfung der Dokumentation zu vereinfachen.
  Ejemplo: Verwenden Sie eine Standard-Testfallvorlage mit Feldern für ID, Beschreibung, Vorbedingungen und erwartete Ergebnisse.
• Zentralisieren Sie die Dokumentenspeicherung: Bewahren Sie alle projektbezogenen Dokumente an einem leicht zugänglichen Ort auf, damit die Teammitglieder sie problemlos einsehen oder aktualisieren können.
  Ejemplo: Speichern Sie Testartefakte in einem gemeinsamen Google Drive Ordner, auf den das gesamte QA- und Entwicklerteam Zugriff hat.
• Fügen Sie ausreichend Details hinzu: Vermeiden Sie vage oder unvollständige Informationen; eine detaillierte Dokumentation verbessert das Verständnis und reduziert Fehler bei der Testausführung.
  Ejemplo: Statt „Anmeldung prüfen“ schreiben Sie „Überprüfen Sie die Benutzeranmeldung mit gültigen Anmeldeinformationen und die Weiterleitung zum Dashboard wird erfolgreich fortgesetzt“.

Wann sollte man eine Testdokumentation für Softwaretests erstellen?

Hier einige wichtige Punkte, wann Sie Testdokumentation für Softwaretests erstellen sollten:

• Planungsphase: Vor Beginn der Testdurchführung müssen Umfang, Ziele und Teststrategie klar definiert werden.
• Test-Vorbereitungen: Während der Testplanung, um Zeitpläne, Ressourcen und Umgebungsanforderungen effizient festzulegen.
• Anforderungsanalyse: Nach der Anforderungsanalyse, um eine vollständige Abdeckung der funktionalen und nicht-funktionalen Spezifikationen sicherzustellen.
• Designstandardisierung: Vor dem Entwurf von Testfällen, um Formate zu standardisieren und zu pflegen tracVerwendbarkeit über alle Dokumente hinweg.
• Szenario-Dokumentation: Während der Testplanung, um Szenarien, Eingaben, erwartete Ausgaben und Details zu den Testdaten zu dokumentieren.
• Ausführungsbereitschaft: Vor der Testausführung muss die Einsatzbereitschaft der Testumgebung, der Werkzeuge und die Genauigkeit der Dokumentation überprüft werden.
• Auswertung nach der Auswertung: Nach dem Testen werden Ergebnisse, Fehler und Erkenntnisse zur Prozessverbesserung dokumentiert.

Welche Arten von Vorlagen werden für die Testdokumentation benötigt?

Hier sind einige der Vorlagen, die Sie für die Testdokumentation im Softwaretesting benötigen:

Vorlagenname	Zubehör
Testplanvorlage	Microsoft Word, Google Docs oder Confluence für die gemeinsame Bearbeitung und Versionskontrolle
Testfallvorlage	TestRail, Zephyr (in JIRA), Xrayoder Excel/Google Tabellen für strukturiertes Testmanagement
Testszenario-Vorlage	JIRA, TestLink oder Google Blätter zur Dokumentation von Testbedingungen auf hohem Niveau
Anforderung TracEfficiency Matrix (RTM) Vorlage	Excel, Google Laken oder TestRail für Karteping Anforderungen an Testfälle
Vorlage für einen Fehlerbericht	JIRA, Bugzilladen Azure DevOps für die Fehlerprotokollierung und tracBooking
Vorlage für einen zusammenfassenden Testbericht	Zusammenfluss, Google Docs oder TestRail zur Zusammenstellung der Testergebnisse und zur Analyse

Vor- und Nachteile der Testdokumentation

Vorteile

• Der Hauptgrund für die Erstellung von Testdokumentationen besteht darin, Unklarheiten bezüglich der Testaktivitäten zu reduzieren oder zu beseitigen. Sie trägt dazu bei, Mehrdeutigkeiten zu vermeiden, die häufig bei der Aufgabenverteilung auftreten.
• Die Dokumentation bietet nicht nur einen systematischen Ansatz Softwaretest, dient aber auch als Schulungsmaterial für Neueinsteiger im Softwaretestprozess.
• Es dient als gute Marketing- und Vertriebsstrategie, die Testdokumentation zu präsentieren, um einen ausgereiften Testprozess zu demonstrieren.
• Die Testdokumentation hilft Ihnen dabei, dem Kunden innerhalb bestimmter Zeitvorgaben ein qualitativ hochwertiges Produkt anzubieten.
• In Software EngineeringDie Testdokumentation hilft auch bei der Konfiguration bzw. Einrichtung des Programms mithilfe des Konfigurationsdokuments und der Bedienungsanleitungen.
• Die Testdokumentation hilft Ihnen, die Transparenz gegenüber dem Kunden zu verbessern.

Nachteile

• Die Kosten der Dokumentation können ihren Wert übersteigen, da sie sehr zeitaufwändig ist.
• Oft werden sie von Leuten geschrieben, die nicht gut schreiben können oder sich mit dem Stoff nicht auskennen.
• Keeping tracDie vom Kunden gewünschten Änderungen umzusetzen und die entsprechenden Dokumente zu aktualisieren, ist anstrengend.
• Mangelhafte Dokumentation wirkt sich direkt auf die Qualität des Produkts aus, da es zu Missverständnissen zwischen dem Kunden und dem Unternehmen kommen kann.

Häufige Fehler, die in der Testdokumentation vermieden werden sollten

Hier sind die häufigsten Fehler, die Sie in einer Testdokumentation vermeiden sollten:

1. Vermeiden Sie unklare oder mehrdeutige Testfallbeschreibungen.
2. Die Dokumentation der Testvoraussetzungen und -abhängigkeiten darf nicht vernachlässigt werden.
3. Vergessen Sie nie, die erwarteten Ergebnisse für jeden Test anzugeben.
4. Vermeiden Sie uneinheitliche Formatierungen in verschiedenen Testdokumenten.
5. Verwenden Sie keine vagen oder nicht messbaren Testziele.
6. Die Versionskontrolle für Aktualisierungen der Testdokumentation darf niemals vernachlässigt werden.
7. Vermeiden Sie die Duplikation von Informationen in mehreren Testartefakten.
8. Vernachlässigen Sie nicht die Überprüfung der Dokumentation auf Richtigkeit und Vollständigkeit.

Häufig gestellte Fragen