Testprotokoll im Softwaretest: Aufbau, Inhalte und Beispiel
Ein Test ist erst dann etwas wert, wenn sich später nachvollziehen lässt, was genau geprüft wurde und mit welchem Ergebnis. Genau dafür gibt es das Testprotokoll. Es ist der Nachweis, dass getestet wurde, die Grundlage für Fehlerberichte und am Ende die Basis für die Freigabeentscheidung. Dieser Artikel zeigt, was in ein Testprotokoll gehört, wie ein Beispiel aussieht und worin es sich vom Testbericht unterscheidet.
Was ist ein Testprotokoll? Definition
Das ISTQB-Glossar beschreibt das Testprotokoll (englisch test log) als chronologische Aufzeichnung relevanter Details der Testausführung. Gemeint ist: Während ein Tester einen Testfall durchführt, hält er fest, wann er was mit welcher Softwareversion in welcher Umgebung getan hat, welches Ergebnis er erwartet und welches er tatsächlich erhalten hat.
In der Praxis werden die Begriffe nicht immer sauber getrennt. Manche Teams sprechen von Testnachweis, Testdurchführungsprotokoll oder Testlaufprotokoll und meinen dasselbe. Wichtig ist der Kern: Das Testprotokoll dokumentiert die Durchführung, nicht die Planung. Was getestet werden soll, steht im Testfall und im Testkonzept. Was beim Testen tatsächlich passiert ist, steht im Testprotokoll.
Wozu dient ein Testprotokoll?
- Nachvollziehbarkeit: Auch Wochen später ist klar, welche Version mit welchen Daten geprüft wurde.
- Fehleranalyse: Entwickler sehen, unter welchen Bedingungen ein Fehler auftrat, und können ihn schneller nachstellen.
- Nachweis bei der Abnahme: Auftraggeber, Fachbereich oder Prüfer erhalten belastbare Belege statt der Aussage „wurde getestet“.
- Vergleich von Testläufen: Hat ein Testfall vor zwei Releases noch bestanden und schlägt jetzt fehl, deutet das auf eine Regression hin.
- Grundlage für den Testbericht: Aus vielen Testprotokollen fasst das Testmanagement den Status für Projektleitung und Management zusammen.
Was gehört in ein Testprotokoll?
Bewährt hat sich eine Gliederung in einen Kopfteil mit den Rahmenbedingungen und einen Ergebnisteil pro Testfall oder Testschritt.
Kopfteil: Rahmenbedingungen des Testlaufs
- Testobjekt und Version: Anwendung, Build- oder Versionsnummer. Ohne exakte Version ist ein Protokoll kaum verwertbar.
- Testumgebung: zum Beispiel Testsystem, Browser, Betriebssystem oder Gerät. Hintergründe dazu im Artikel Testumgebung aufbauen.
- Testlauf oder Testzyklus: etwa „Regressionstest Release 4.2“ oder „Abnahmetest Runde 1“.
- Datum und Uhrzeit der Durchführung.
- Tester: wer den Test durchgeführt hat.
Ergebnisteil: pro Testfall und Testschritt
- Testfall-ID und Titel als Verweis auf den geplanten Testfall.
- Verwendete Testdaten: konkrete Werte, zum Beispiel ein Testkunde oder eine Bestellnummer.
- Erwartetes Ergebnis laut Testfall.
- Tatsächliches Ergebnis: was wirklich passiert ist, möglichst konkret.
- Status: bestanden, fehlgeschlagen, blockiert oder nicht durchgeführt.
- Fehler-ID: Verweis auf das Ticket, wenn eine Abweichung gemeldet wurde.
- Nachweise: Screenshots, Logauszüge oder Dateien, wo sie zur Bewertung nötig sind.
- Bemerkung: Auffälligkeiten, die keinen Fehler darstellen, aber erwähnenswert sind.
Wie der zugrunde liegende Testfall aufgebaut wird, beschreibt der Beitrag Testfälle schreiben.
Testprotokoll-Beispiel: ein Testfall aus der Praxis
Das folgende Beispiel zeigt ein schlankes Testprotokoll für einen manuellen Funktionstest in einem Webshop. Die Werte sind ein fiktives Beispiel.
Kopfteil
- Testobjekt: Webshop, Version 4.2.0 (Build 118)
- Umgebung: Testsystem „Staging“, Chrome auf Windows 11
- Testlauf: Regressionstest Release 4.2
- Datum / Tester: 12.03., 10:15 Uhr / M. Beispiel
Testfall TF-031: Gutschein wird im Warenkorb verrechnet
- Testdaten: Testkunde „kunde-07“, Artikel im Wert von 80,00 €, Gutscheincode „TEST10“ (10 € Rabatt)
- Schritt 1: Artikel in den Warenkorb legen. Erwartet: Warenkorb zeigt 80,00 €. Tatsächlich: 80,00 €. Bestanden.
- Schritt 2: Gutscheincode eingeben und bestätigen. Erwartet: Hinweis „Gutschein eingelöst“, Summe 70,00 €. Tatsächlich: Hinweis erscheint, Summe bleibt 80,00 €. Fehlgeschlagen, Fehler BUG-214, Screenshot angehängt.
- Schritt 3: Zur Kasse gehen. Blockiert durch BUG-214.
- Gesamtstatus TF-031: fehlgeschlagen
Das Beispiel zeigt zwei typische Punkte: Das tatsächliche Ergebnis wird konkret beschrieben, nicht nur als „funktioniert nicht“. Und Schritte, die wegen eines Fehlers nicht sinnvoll ausführbar sind, werden ausdrücklich als blockiert markiert, statt sie einfach wegzulassen.
Testprotokoll und Testbericht: der Unterschied
Die beiden Begriffe werden oft verwechselt. Das Testprotokoll erfasst die Durchführung im Detail und lückenlos, meist pro Testfall. Es richtet sich an Tester und Entwickler. Der Testbericht fasst die Ergebnisse vieler Testprotokolle zusammen: Wie viele Testfälle wurden durchgeführt und bestanden, welche Fehler sind offen, welche Risiken bestehen, und kann aus Sicht des Tests eine Freigabe empfohlen werden? Er richtet sich an Projektleitung, Fachbereich und Management und wird in der Regel vom Testmanagement erstellt.
Kurz gesagt: Das Testprotokoll beantwortet „Was ist bei diesem Test passiert?“, der Testbericht „Wie steht es um die Qualität und können wir live gehen?“.
Testprotokolle bei manuellen und automatisierten Tests
Bei automatisierten Tests erzeugen Testwerkzeuge und CI-Pipelines die Protokolle in der Regel selbst. Die Herausforderung ist hier eher, die Ergebnisse lesbar aufzubereiten und dauerhaft abzulegen. Bei manuellen Tests entsteht das Protokoll dagegen durch den Tester, idealerweise direkt während der Durchführung in einem Testmanagement-Tool, alternativ in einer strukturierten Tabelle.
Für explorative Tests ohne vorab geschriebene Testfälle reichen Sitzungsnotizen: Ziel der Testsitzung, geprüfte Bereiche, Dauer, gefundene Fehler und offene Fragen. Auch das ist ein Testprotokoll, nur in freierer Form.
Tipps für aussagekräftige Testprotokolle
- Sofort protokollieren: Wer erst am Ende des Tages aus dem Gedächtnis dokumentiert, verliert Details.
- Version und Umgebung exakt angeben: „aktuelle Version“ ist nach dem nächsten Deployment wertlos.
- Blockiert ist nicht fehlgeschlagen: Wenn ein Test wegen eines anderen Fehlers oder einer ausgefallenen Schnittstelle nicht durchführbar war, ist das kein Fehler der geprüften Funktion. Die Unterscheidung macht den Teststatus ehrlich.
- Nachweise gezielt einsetzen: Ein Screenshot bei jeder Abweichung hilft, ein Screenshot bei jedem bestandenen Schritt bläht das Protokoll meist nur auf, es sei denn, die Abnahme verlangt es.
- Datenschutz beachten: Screenshots und Logs sollten keine echten personenbezogenen Daten enthalten. Lässt sich das nicht vermeiden, klären Sie die Verarbeitung vorab mit dem Auftraggeber und dem Datenschutz. Mehr dazu im Artikel Testdatenmanagement.
- Versioniert ablegen: Protokolle früherer Testläufe sind wertvoll, etwa beim Vergleich von Regressionstests über mehrere Releases.
Testprotokolle bei der Abnahme
Besonders wichtig werden Testprotokolle beim Abnahmetest. Hier entscheidet der Auftraggeber, ob die Software den vereinbarten Abnahmekriterien entspricht. Vollständige Protokolle machen diese Entscheidung nachvollziehbar und helfen später, wenn Fragen zu Gewährleistung oder Nachbesserung aufkommen. Vereinbaren Sie deshalb schon im Testkonzept, welche Angaben und Nachweise die Protokolle enthalten sollen.
Wenn Ihnen im Projekt die Zeit oder das Personal für eine saubere Testdokumentation fehlt, kann ein externer Testdienstleister helfen. Als Softwaretest-Dienstleister in Hamburg führen wir manuelle Softwaretests durch, dokumentieren die Testdurchführung nachvollziehbar und liefern am Ende einen Testbericht mit Freigabeempfehlung, remote, hybrid oder vor Ort in Hamburg und deutschlandweit.
Fazit
Ein gutes Testprotokoll ist kein bürokratischer Selbstzweck. Es macht Tests nachvollziehbar, beschleunigt die Fehlerbehebung und liefert den Nachweis, auf den sich eine Abnahme stützen kann. Mit einem klaren Kopfteil, konkreten tatsächlichen Ergebnissen, einem ehrlichen Status je Testfall und gezielten Nachweisen reicht oft schon eine schlanke Vorlage.
Häufige Fragen zum Testprotokoll
Was ist der Unterschied zwischen Testprotokoll und Testbericht?
Das Testprotokoll dokumentiert die Durchführung einzelner Tests im Detail: Version, Umgebung, Schritte, erwartete und tatsächliche Ergebnisse sowie den Status. Der Testbericht fasst die Ergebnisse vieler Testprotokolle zusammen, zeigt offene Fehler und Risiken und enthält in der Regel eine Empfehlung zur Freigabe.
Wer erstellt das Testprotokoll?
Das Testprotokoll erstellt die Person, die den Test durchführt, also in der Regel der Tester. Bei automatisierten Tests erzeugt das Testwerkzeug das Protokoll. Den Testbericht auf Basis der Protokolle erstellt meist das Testmanagement.
Gibt es eine Vorlage für ein Testprotokoll?
Eine verbindliche Vorlage gibt es nicht. Für den Einstieg reicht eine Tabelle mit den Spalten Testfall-ID, Testschritt, erwartetes Ergebnis, tatsächliches Ergebnis, Status, Fehler-ID und Bemerkung, ergänzt um einen Kopfteil mit Testobjekt, Version, Umgebung, Datum und Tester. In größeren Projekten übernimmt ein Testmanagement-Tool diese Struktur.
Nachvollziehbare Softwaretests für Ihr Projekt
Wir testen Ihre Software manuell und strukturiert, dokumentieren die Testdurchführung nachvollziehbar und liefern einen Testbericht mit Freigabeempfehlung aus Testsicht.
Jetzt Erstgespräch vereinbarenMehr zu unserer Leistung: Softwaretest & Qualitätssicherung in Hamburg →