Testdokumentasjon i programvaretesting (eksempel)

Hva er testdokumentasjon?

Testdokumentasjon er dokumentasjon av artefakter som er opprettet før eller under testing av programvare. Det hjelper testteamet med å estimere nødvendig innsats, spore ressurser og fremdrift, og sikre tilstrekkelig testdekning. Testrapporten og -rapportene er en komplett samling dokumenter som lar deg beskrive og dokumentere testplanlegging, testdesign, testutførelse og testresultater som er hentet fra testaktiviteten.

👉 Meld deg på gratis live programvaretestingsprosjekt

Hvorfor behovet for testformalitet?

For en nybegynner er det lett å anta at testing er å kjøre de ulike delene av koden på ad hoc-basis og verifisere resultatene. Men i den virkelige verden er testing en svært formell aktivitet og dokumenteres i detalj. Testdokumentasjon gjør planlegging, gjennomgang og utførelse av testing enkel og verifiserbar.

Graden av testformalitet avhenger av:

• Typen applikasjon under testing (AUT).
• Standarder som følges av organisasjonen din.
• Utviklingsprosessens modenhet.

Testaktiviteter tar vanligvis mellom 30% og 50% av den totale programvareutviklingsinnsatsen. Dokumentasjon bidrar til å identifisere forbedringer av testprosesser som kan brukes i fremtidige prosjekter.

Hva er typene testdokumentasjon?

Her er de viktigste typene testdokumentasjon:

«I praksis opprettes disse dokumentene på ulike stadier – fra tidlig planlegging (testpolicy, strategi) til utførelse og avslutning (feil- og sammendragsrapporter).»

Typer testdokumenter	Tekniske beskrivelser
Testpolicy	Det er et dokument på overordnet nivå som beskriver prinsipper, metoder og alle viktige testmål for organisasjonen.
Test strategi	Et dokument på overordnet nivå som identifiserer testnivåene (typene) som skal utføres for prosjektet.
Testplan	En testplan er et komplett planleggingsdokument som inneholder omfanget, tilnærmingen, ressursene, tidsplanen osv. for testaktivitetene.
Krav Sporbarhetsmatrise	Dette er et dokument som kobler kravene til testtilfellene.
Testscenario	Testscenario er et element eller en hendelse i et programvaresystem som kan verifiseres av ett eller flere testtilfeller.
Testsak	Det er en gruppe av inngangsverdier, utførelsesforutsetninger, forventede utførelses-etterbetingelser og resultater. Den er utviklet for et testscenario.
Testdata	Testdata er data som finnes før en test utføres. De brukes til å utføre testtilfellet.
Feilmelding	En feilrapport er en dokumentert rapport om enhver feil i et programvaresystem som ikke utfører sin forventede funksjon.
Testsammendragsrapport	Testsammendragsrapporten er et dokument på overordnet nivå som oppsummerer utførte testaktiviteter samt testresultatene.

Hva er de beste fremgangsmåtene for å oppnå testdokumentasjon?

I denne delen skal vi lære om beste praksis som bidrar til å oppnå testdokumentasjon med eksempler som hjelper deg å forstå det bedre:

• Involver kvalitetssikring tidlig i prosjektet: Inkluder QA-teamet fra prosjektets begynnelse, slik at testdokumentasjonen utvikles sammen med produktdesign og krav.
  Eksempel: QA samarbeider under sprintplanlegging for å utarbeide innledende testtilfeller basert på brukerhistorier.
• Hold dokumentene oppdatert: Ikke bare lag testdokumenter og glem dem – oppdater dem når krav eller funksjoner endres.
  Eksempel: Når et påloggings-API endres, må du oppdatere de relaterte testtilfellene og resultatene umiddelbart.
• Bruk versjonskontroll: Administrer og spor alle endringer i testdokumenter gjennom versjonskontrollsystemer for å unngå forvirring og datatap.
  Eksempel: Lagre testplaner i GitHub for å opprettholde en tydelig versjonshistorikk og alternativer for tilbakerulling.
• Dokument for klarhet og formål: Registrer bare det som hjelper deg og interessentene dine å forstå testfremdriften og leveransene.
  Eksempel: Inkluder testsammendragsrapporter som fremhever beståtte, mislykkede og blokkerte testtilfeller for ledelsens gjennomgang.
• Bruk standardmaler: Følg et konsistent format – for eksempel Excel- eller Word-maler – for å gjøre det enklere å opprette og gjennomgå dokumentasjon.
  Eksempel: Bruk en standard «testtilfellemal» med felt for ID, beskrivelse, forutsetninger og forventede resultater.
• Sentraliser dokumentlagring: Oppbevar alle prosjektrelaterte dokumenter på ett tilgjengelig sted, slik at teammedlemmene enkelt kan se i eller oppdatere dem.
  Eksempel: Lagre testartefakter i en delt Google Drive mappe tilgjengelig for hele QA- og utviklingsteamet.
• Inkluder tilstrekkelige detaljer: Unngå vag eller ufullstendig informasjon; detaljert dokumentasjon forbedrer forståelsen og reduserer feil under testutførelse.
  Eksempel: I stedet for «Sjekk pålogging», skriv «Bekreft brukerpålogging med gyldig legitimasjon omdirigerer til dashbordet».

Når bør du lage testdokumentasjon for programvaretesting?

Her er noen av hovedpunktene for når du bør lage testdokumentasjon for programvaretesting:

• Planleggingsfase: Før testkjøringen starter, må du tydelig definere omfang, mål og teststrategi.
• Testforberedelse: Under testplanlegging, for å effektivt etablere tidslinjer, ressurser og miljøkrav.
• Kravanalyse: Etter kravanalysen, for å sikre fullstendig dekning av funksjonelle og ikke-funksjonelle spesifikasjoner.
• Designstandardisering: Før utforming av testtilfeller, for å standardisere formater og opprettholde sporbarhet på tvers av alle dokumenter.
• Scenariodokumentasjon: Under testdesign, for å dokumentere scenarier, input, forventede output og testdatadetaljer.
• Utførelsesberedskap: Før testutførelse, for å bekrefte at testmiljøet, verktøyene og dokumentasjonen er klare til bruk.
• Ettervurdering: Etter testing, for å registrere resultater, feil og lærdommer for prosessforbedring.

Hvilke typer maler kreves for testdokumentasjon?

Her er noen av malene du trenger for testdokumentasjon i programvaretesting:

Malnavn	verktøy
Testplanmal	Microsoft Word, Google Docs, eller Confluence for samarbeidende redigering og versjonskontroll
Testcase-mal	TestRail, Zephyr (i JIRA), Xray eller Excel/Google Sheets for strukturert testhåndtering
Testscenariomal	JIRA, TestLink eller Google Sheets for å dokumentere testforhold på høyt nivå
Mal for sporbarhetsmatrise for krav (RTM)	Excel, Google Sheets eller TestRail for å kartlegge krav til testtilfeller
Mal for feilrapport	JIRA, Bugzilla eller Azure DevOps for feillogging og sporing
Mal for testsammendragsrapport	Samløp, Google Docs, eller TestRail for å samle testresultater og analysere

Fordeler og ulemper med testdokumentasjon

Pros

• Hovedgrunnen til å lage testdokumentasjon er enten å redusere eller fjerne usikkerheter rundt testaktivitetene. Det bidrar til å fjerne tvetydigheter, som ofte oppstår når det gjelder tildeling av oppgaver.
• Dokumentasjon tilbyr ikke bare en systematisk tilnærming til programvaretesting, men det fungerer også som opplæringsmateriell for ferskere i programvaretestingsprosessen.
• Det fungerer som en god markedsførings- og salgsstrategi for å vise frem testdokumentasjon for å vise frem en moden testprosess.
• Testdokumentasjon hjelper deg med å tilby kunden et kvalitetsprodukt innenfor bestemte tidsfrister.
• In Engineering programvare, testdokumentasjon hjelper også med å konfigurere eller sette opp programmet gjennom konfigurasjonsdokumentet og brukerhåndbøkene.
• Testdokumentasjon hjelper deg med å forbedre åpenheten med klienten.

Ulemper

• Kostnaden for dokumentasjonen kan overstige verdien da den er svært tidkrevende.
• Mange ganger er det skrevet av folk som ikke kan skrive godt eller som ikke kan stoffet.
• Det er slitsomt å holde styr på endringer som klienten ber om og oppdatere tilsvarende dokumenter.
• Dårlig dokumentasjon gjenspeiler direkte produktets kvalitet, da det kan oppstå misforståelser mellom klienten og organisasjonen.

Vanlige feil å unngå i testdokumentasjon

Her er de vanligste feilene du bør unngå i testdokumentasjon:

1. Unngå å skrive uklare eller tvetydige beskrivelser av testtilfeller.
2. Ikke hopp over å dokumentere testforutsetninger og avhengigheter.
3. Glem aldri å inkludere forventede resultater for hver test.
4. Unngå inkonsekvent formatering på tvers av ulike testdokumenter.
5. Ikke bruk vage eller ikke-målbare testmål.
6. Utelat aldri versjonskontroll for oppdateringer av testdokumentasjon.
7. Unngå å duplisere informasjon på tvers av flere testartefakter.
8. Ikke glem å gjennomgå dokumentasjonen for nøyaktighet og fullstendighet.

Spørsmål og svar