En god feilrapport gjør problemet mulig å gjenskape og rettingen mulig å kontrollere. Oppgi filversjon, teststeg, konsekvens og hva som skal være oppfylt når funnet lukkes.
Når en integrasjon stopper, trenger utvikleren et presist utgangspunkt. Hvilken bruker var innlogget? Hvilken side ble åpnet? Hva forventet testeren å se? Svarene gjør det mulig å følge hendelsen gjennom systemene og finne hvor den avviker fra forventet oppførsel.
Identifiser filen som er testet
Oppgi pluginens navn, versjon og filnavn. Ta med SHA-256 når gjennomgangen gjelder en ZIP-fil. Dette fingeravtrykket gjør det mulig å kontrollere at testeren og utvikleren arbeider med identisk filinnhold. Det er særlig nyttig dersom en pakke er endret underveis i gjennomgangen.
I dette oppsettet er innloggingsbroen AI Desk Bridge 1.0.6. Opplysningene under identifiserer ZIP-filen som ble brukt i demoen. Vurderingen av kodens sikkerhet krever en egen gjennomgang av denne filen.
Beskriv stegene frem til feilen
En brukbar rapport kan begynne slik: Logg inn i WordPress. Velg AI Desk i menyen. Vent på arbeidslisten. Noter deretter at skjermen blir stående på «Avklarer tilgang», og oppgi tidspunktet for forsøket. Nå finnes det en konkret hendelse som kan sammenholdes med nettleserens nettverkssvar og relevante logger.
Ta med forventet resultat og faktisk resultat i rapporten. Beskriv også konsekvensen for brukeren, for eksempel at artikkellisten er utilgjengelig. Da blir både funksjonen og betydningen av feilen tydelig.
Følg tilgangen gjennom systemene
I denne demoen lyktes innloggingen. Et senere kvoteoppslag ble avvist fordi demobrukeren manglet organisasjonsmedlemskap i AI Desk. Nettlesertesten gjorde det mulig å avgrense feilen til dette oppslaget. Brukeren ble knyttet til en egen demoorganisasjon, og arbeidslisten kunne deretter åpnes.
Hendelsen viser verdien av å undersøke hvert steg i rekkefølge. Ved en ny tilgangsfeil må årsaken fastslås ut fra svarene i det aktuelle forsøket. Samme ventetekst kan kreve en annen retting.
Avtal hvordan rettingen skal godkjennes
Et lukkekriterium beskriver resultatet testeren skal kunne se etter endringen. I dette tilfellet var kriteriet at nettleseren kom forbi tilgangssjekken og viste Direct med artikkellisten. Kontroll av hele dette forløpet ga relevant dokumentasjon på rettingen.
En etterprøvbar rapport følger dermed en enkel kjede: gjenskap problemet, finn årsaken, gjennomfør rettingen og kontroller resultatet. Lagre utfallet sammen med versjonen som ble testet. Det gir begge parter et felles grunnlag for å lukke funnet.
