# Acceptanskriterier

## Vad det är

Acceptanskriterier är de villkor som en viss ändring måste uppfylla för att kunna godkännas. De
beskriver vad man kan observera under vissa förhållanden. ”Skicka en bokningsbekräftelse” namnger
en funktion. ”När en ledig tid har bokats visar bekräftelsen samma referens och starttid som
bokningsposten” gör en del av funktionen möjlig att kontrollera. Teamet kan fortfarande välja hur
bekräftelsen skapas.

Den brittiska regeringens handbok för digitala tjänster beskriver kriterier för en
användarberättelse som en lista över resultat att kontrollera för att se om tjänsten uppfyller
sitt syfte. Berättelsen beskriver personen och behovet. Kriterierna gör överenskommelsen konkret
nog för att kunna diskuteras, genomföras och kontrolleras. De kan även beskriva ett felfall, ett
tillgänglighetskrav eller ett villkor för driften, om det påverkar godkännandet. Olika villkor kan
behöva olika slags belägg.

En specifikation kan innehålla krav för många ändringar. Ett testfall beskriver ett konkret försök
som ger underlag för att bedöma ett eller flera kriterier. Definition of Done i Scrum beskriver de
kvalitetskrav som arbetet i ett inkrement behöver uppfylla. Acceptanskriterier gäller själva
ändringen. Ett team kan ställa generella krav på tangentbordsanvändning och för den nya
datumväljaren ange att man måste kunna boka och hitta tillbaka till en tid med tangentbordet.

## Varför det spelar roll

Bra kriterier synliggör olika förväntningar medan det fortfarande är lätt att justera planen. För
den som ansvarar för tjänsten kan en tid vara bokad så snart posten finns. Personen som bokar kan
vänta på ett mejl. Kundtjänsten kan behöva en referens för att hjälpa till om mejlet uteblir. Det
är olika resultat. Bestäm när systemet visar en bekräftelse och vad som händer om mejlleverantören
får ett fel.

Kriterierna anger vad någon ska observera. En person kan granska bekräftelsesidan och en annan
avbryta meddelandet under ordnade former. Båda vet vad som räknas som resultat. Tillgänglighet kan
kräva en genomgång med tangentbord utöver automatiska tester. En gräns för svarstid behöver en
känd miljö och en bestämd belastning. ”Systemet ska vara snabbt” lämnar frågan öppen för
oförenliga tolkningar.

Standarder och lagkrav gäller även när de inte står i berättelsen. Beskriv hur ett gemensamt krav
ska tolkas för den nya delen om teamet annars måste gissa. För en ovanlig kalender kan man ange de
handlingar som ska gå att göra med tangentbordet och hänvisa till den befintliga standarden. Det
håller kriteriet kort utan att lämna användarna i sticket.

## Så ser det ut i praktiken

Tänk på en tjänst där man bokar en tid och får en bekräftelse. Ett första utkast kan säga ”tiden
går att boka och ett mejl skickas”. Den som ansvarar för tjänsten kan tillsammans med en
utvecklare och en testare gå igenom tre försök. De här exemplen är påhittade. Verksamheten behöver
bestämma sina egna villkor.

- Om en tid klockan 14 är ledig i den angivna tidszonen skapas en bekräftad bokning. Referens,
  datum och klockslag på sidan överensstämmer med bokningsposten.
- Om någon redan har tagit tiden när begäran behandlas får besökaren veta det och kan gå tillbaka
  till lediga tider. Ingen ytterligare bokning skapas för den upptagna tiden.
- Om meddelandet misslyckas efter att bokningen bekräftats finns bokningen kvar. Referensen visas
  fortfarande och den som ansvarar för uppföljningen kan se felet.

Exemplen har ett utgångsläge, en handling och ett resultat som går att kontrollera. Gherkin
beskriver det med Givet, När och Så. Formen kan underlätta läsningen och knyta exemplen till
automatiska tester. En kort lista räcker också vid en enkel ändring. Ange vilken referens som ska
jämföras och vem som kan se resultatet. Att ett mejl har lämnat sändkön visar inte att det kommit
fram.

Gör det första försöket i det riktiga gränssnittet. Styr ordningen på förfrågningarna i det andra.
Framkalla felet när bokningen är sparad i det tredje. Anteckna förhållandena och observationerna
så att någon annan kan upprepa kontrollen. Vår [tillgänglighetsredogörelse](/sv/accessibility/)
visar ett liknande underlag. Den beskriver tangentbordskontroller och skiljer mellan vad som
observerats och vad som behöver undersökas mer.

## Var det går fel

Otydliga ord skjuter upp avgörandet. ”Felet hanteras på ett bra sätt” säger varken vad som visas
eller vilken handling som fortfarande går att utföra. Ange tillståndet, meddelandet, handlingen
och följden som ska förhindras. En skärmbild av varningen om en upptagen tid räcker inte för att
visa att ingen bokning sparades. Kontrollera även posten.

Ett kriterium kan låsa tekniken i förtid. ”Använd den nya kön” kan vara ett giltigt beslut om
arkitekturen. Det anger inte vad en besökare upplever när bekräftelsen dröjer. Dokumentera det
tekniska valet där skälen går att hitta och uttryck kriteriet som någonting som kan observeras.
Kräver en extern integration ett bestämt protokoll, ange källan och var gränsen går.

En lista kan å andra sidan växa till att beskriva en hel version. Dela upp arbetet efter resultat
och håll ett betydelsefullt felfall nära det tillhörande flödet. Kom överens om vilka regler som
gäller gemensamt och vem som kontrollerar ändringen. Visar ett försök att ett villkor saknas,
dokumentera varför kriteriet ändras och gör om berörda kontroller. Då går det att se vilken
överenskommelse som verkligen prövats.

## Läs mer

- [Brittiska regeringens handbok om användarberättelser och
  acceptanskriterier](https://www.gov.uk/service-manual/agile-delivery/writing-user-stories)
- [Gherkin-referensen för scenarier och exempel](https://cucumber.io/docs/gherkin/reference/)
- [Definition of Done i Scrumguiden](https://scrumguides.org/scrum-guide.html#definition-of-done)
- [W3C:s vägledning för att kontrollera
  tangentbordsanvändning](https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html)

<https://engineer.company/sv/glossary/acceptance-criteria/>
