Testdokumentation i mjukvarutestning (exempel)

Vad är testdokumentation?

Testdokumentation är en dokumentation av artefakter som skapats före eller under testning av programvara. Den hjälper testteamet att uppskatta nödvändiga arbetsinsatser, spåra resurser och framsteg samt säkerställa tillräcklig testtäckning. Testprotokollet och rapporterna är en komplett uppsättning dokument som låter dig beskriva och dokumentera testplanering, testdesign, testutförande och testresultat som hämtas från testaktiviteten.

👉 Anmäl dig till gratis live-mjukvarutestningsprojekt

Varför behovet av testformalitet?

För en nybörjare är det lätt att anta att testning handlar om att exekvera olika delar av koden ad hoc och verifiera resultaten. Men i verkligheten är testning en mycket formell aktivitet som dokumenteras i detalj. Testdokumentation gör planering, granskning och utförande av testning enkelt och verifierbart.

Graden av testformalitet beror på:

• Typen av applikation under test (AUT).
• Standarder som följs av din organisation.
• Utvecklingsprocessens mognad.

Testaktiviteter tar vanligtvis mellan 30% och 50% av den totala programvaruutvecklingsinsatsen. Dokumentationer hjälper till att identifiera förbättringar av testprocesser som kan tillämpas på framtida projekt.

Vilka typer av testdokumentation finns det?

Här är de viktiga typerna av testdokumentation:

”I praktiken skapas dessa dokument i olika skeden – från tidig planering (testpolicy, strategi) till utförande och avslut (fel- och sammanfattningsrapporter).”

Typer av testdokument	BESKRIVNING
Testpolicy	Det är ett övergripande dokument som beskriver principer, metoder och alla viktiga testmål för organisationen.
Testa strategi	Ett övergripande dokument som identifierar de testnivåer (typer) som ska köras för projektet.
Testplan	En testplan är ett komplett planeringsdokument som innehåller omfattning, tillvägagångssätt, resurser, schema etc. för testaktiviteter.
Krav Spårbarhetsmatris	Detta är ett dokument som kopplar kraven till testfallen.
Testscenario	Testscenario är en post eller händelse i ett programvarusystem som kan verifieras av ett eller flera testfall.
Testfall	Det är en grupp indatavärden, exekveringsförutsättningar, förväntade exekveringseftervillkor och resultat. Den är utvecklad för ett testscenario.
Testdata	Testdata är data som finns innan ett test körs. Den används för att köra testfallet.
Felanmälan	En felrapport är en dokumenterad rapport om alla fel i ett programvarusystem som inte utför sin förväntade funktion.
Testsammanfattningsrapport	Testsammanfattningsrapporten är ett övergripande dokument som sammanfattar utförda testaktiviteter samt testresultaten.

Vilka är de bästa metoderna för att uppnå testdokumentation?

I det här avsnittet ska vi lära oss om de bästa metoderna som hjälper till att uppnå testdokumentation med exempel som hjälper dig att förstå det bättre:

• Involvera QA tidigt i projektet: Inkludera QA-teamet från projektets början så att testdokumentationen utvecklas parallellt med produktdesign och krav.
  Exempelvis: QA samarbetar under sprintplaneringen för att utarbeta inledande testfall baserade på användarberättelser.
• Håll dokumenten uppdaterade: Skapa inte bara testdokument och glöm dem – uppdatera dem närhelst krav eller funktioner ändras.
  Exempelvis: När ett inloggnings-API ändras, uppdatera relaterade testfall och resultat omedelbart.
• Använd versionskontroll: Hantera och spåra alla ändringar i testdokument via versionshanteringssystem för att undvika förvirring och dataförlust.
  Exempelvis: Lagra testplaner i GitHub för att upprätthålla en tydlig versionshistorik och återställningsalternativ.
• Dokument för tydlighet och syfte: Registrera endast det som hjälper dig och dina intressenter att förstå testets framsteg och leveranser.
  Exempelvis: Inkludera testsammanfattningsrapporter som markerar godkända, misslyckade och blockerade testfall för ledningens granskning.
• Använd standardmallar: Följ ett konsekvent format – till exempel Excel- eller Word-mallar – för att göra det enklare att skapa och granska dokumentation.
  Exempelvis: Använd en standardmall för "testfall" med fält för ID, beskrivning, förutsättningar och förväntade resultat.
• Centralisera dokumentlagring: Förvara alla projektrelaterade dokument på en lättillgänglig plats för att säkerställa att teammedlemmar enkelt kan hänvisa till eller uppdatera dem.
  Exempelvis: Lagra testartefakter i en delad Google Drive mapp som är tillgänglig för hela QA- och utvecklingsteamet.
• Inkludera tillräckliga detaljer: Undvik vag eller ofullständig information; detaljerad dokumentation förbättrar förståelsen och minskar fel under testkörning.
  Exempelvis: Istället för ”Kontrollera inloggning” skriver du ”Verifiera användarinloggning med giltiga inloggningsuppgifter omdirigerar till instrumentpanelen”.

När bör man skapa testdokumentation för programvarutestning?

Här är några viktiga punkter om när du bör skapa testdokumentation för programvarutestning:

• Planeringsfas: Innan testkörningen påbörjas, för att tydligt definiera omfattning, mål och teststrategi.
• Provförberedelse: För att effektivt fastställa tidslinjer, resurser och miljökrav under testplaneringen.
• Kravanalys: Efter kravanalysen, för att säkerställa fullständig täckning av funktionella och icke-funktionella specifikationer.
• Designstandardisering: Innan testfall utformas, för att standardisera format och upprätthålla spårbarhet i alla dokument.
• Scenariodokumentation: Under testdesignen, för att dokumentera scenarier, indata, förväntade utdata och testdatadetaljer.
• Exekveringsberedskap: Innan testkörning, för att verifiera att testmiljön, verktygen och dokumentationen är beredskapda.
• Efterutvärdering: Efter testning, för att dokumentera resultat, defekter och lärdomar för processförbättring.

Vilka typer av mallar krävs för testdokumentation?

Här är några av de mallar du behöver för testdokumentation inom mjukvarutestning:

Mallnamn	verktyg
Testplanmall	Microsoft Word, Google Docs, eller Confluence för gemensam redigering och versionshantering
Testfallsmall	TestRail, Zephyr (i JIRA), Xray eller Excel/Google Sheets för strukturerad testhantering
Testscenariomall	JIRA, TestLink eller Google Sheets för att dokumentera testförhållanden på hög nivå
Mall för spårbarhetsmatris för krav (RTM)	Excel, Google Sheets eller TestRail för att mappa krav till testfall
Mall för felrapport	JIRA, Bugzilla eller Azure DevOps för felloggning och spårning
Testsammanfattningsrapportmall	Sammanflöde, Google Docs, eller TestRail för att sammanställa testresultat och analysera

För- och nackdelar med testdokumentation

Fördelar

• Den främsta anledningen till att skapa testdokumentation är att antingen minska eller ta bort eventuella osäkerheter kring testaktiviteterna. Det hjälper till att undanröja oklarheter som ofta uppstår när det gäller fördelning av uppgifter.
• Dokumentation erbjuder inte bara ett systematiskt förhållningssätt till mjukvarutestning, men det fungerar också som utbildningsmaterial för nybörjare i mjukvarutestprocessen.
• Det fungerar som en bra marknadsförings- och försäljningsstrategi för att visa upp testdokumentation och visa upp en mogen testprocess.
• Testdokumentation hjälper dig att erbjuda kunden en kvalitetsprodukt inom specifika tidsfrister.
• In Mjukvaruutveckling, testdokumentation hjälper också till att konfigurera eller ställa in programmet genom konfigurationsdokumentet och användarmanualerna.
• Testdokumentation hjälper dig att förbättra transparensen med klienten.

Nackdelar

• Kostnaden för dokumentationen kan överstiga dess värde eftersom den är mycket tidskrävande.
• Många gånger är den skriven av människor som inte kan skriva bra eller som inte kan materialet.
• Att hålla reda på ändringar som kunden begär och uppdatera motsvarande dokument är tröttsamt.
• Dålig dokumentation återspeglar direkt produktens kvalitet, eftersom missförstånd kan uppstå mellan klienten och organisationen.

Vanliga misstag att undvika i testdokumentation

Här är de vanligaste misstagen du bör undvika i testdokumentation:

1. Undvik att skriva otydliga eller tvetydiga beskrivningar av testfall.
2. Hoppa inte över att dokumentera testförutsättningar och beroenden.
3. Glöm aldrig att inkludera förväntade resultat för varje test.
4. Undvik inkonsekvent formatering mellan olika testdokument.
5. Använd inte vaga eller icke-mätbara testmål.
6. Utelämna aldrig versionskontroll för uppdateringar av testdokumentation.
7. Undvik att duplicera information över flera testartefakter.
8. Försumma inte att granska dokumentationen för att säkerställa att den är korrekt och fullständig.

Vanliga frågor