Critères d’acceptation

Ce que c'est

Les critères d’acceptation sont les conditions que doit remplir un
changement précis pour être validé. Ils disent ce qu'on pourra
observer dans une situation donnée. « Envoyer une confirmation de
rendez-vous » nomme une fonction. « Quand un créneau libre est
réservé, la confirmation indique la référence et l'heure de début
inscrites dans la réservation » permet de vérifier une partie du
comportement. La manière de produire la confirmation reste à la
décision de l'équipe.

Le manuel de services numériques du gouvernement britannique
présente les critères d'un récit utilisateur comme une liste de
résultats à vérifier pour savoir si le service a rempli son rôle. Le
récit présente la personne concernée et son besoin. Les critères
rendent l'accord assez concret pour être discuté, réalisé et
vérifié. Un critère peut porter sur un échec, une exigence
d'accessibilité ou une contrainte d'exploitation lorsque ce point
compte pour valider le changement. Les moyens de vérification
peuvent varier selon le critère.

Plusieurs documents jouent ici des rôles distincts. Une
spécification peut poser des exigences pour une série de
changements. Un cas de test décrit une exécution qui fournit des
éléments de vérification pour un ou plusieurs critères. La
Définition de Fini de Scrum indique les mesures de qualité que doit
respecter le travail intégré à un Incrément. Les critères
d’acceptation portent sur un changement particulier. L'accès au
clavier peut être une exigence commune, et la possibilité de
réserver puis de consulter un créneau au clavier une condition
propre au changement.

Pourquoi c'est important

Des critères précis révèlent les désaccords tant qu'il est encore
facile de changer de direction. Pour la personne responsable du
service, la réservation peut être acquise dès qu'un enregistrement
existe. La personne qui a pris le rendez-vous peut attendre de
recevoir un courriel. L'assistance peut avoir besoin d'une référence
pour aider quelqu'un lorsque le courriel se perd. Il s'agit de
résultats différents. Choisir le moment où l'on affiche la
confirmation et définir la conduite à tenir si l'envoi échoue évite
de découvrir le désaccord après la mise en service.

Les critères donnent aussi une cible à la vérification. Une personne
peut examiner l'écran de confirmation et une autre interrompre
l'envoi du message. Chacune sait ce qui compterait comme résultat.
L'accessibilité peut demander un parcours au clavier en plus d'un
contrôle automatique. Pour vérifier un délai, il faut un
environnement connu et une charge de référence. Écrire « le système
sera rapide » laisse au contraire plusieurs interprétations
possibles.

Les normes et le droit s'appliquent même lorsqu'ils ne sont pas
copiés dans un récit. Lorsqu'une interprétation doit être choisie
pour le changement, précisons-la. Dans le cas d'un sélecteur de
dates inhabituel, on peut nommer les actions qui doivent rester
possibles au clavier et citer la norme commune. Le critère reste
court, sans laisser l'équipe deviner ce qu'il faut vérifier.

À quoi cela ressemble en pratique

Imaginons un service qui permet de réserver un rendez-vous et de
recevoir une confirmation. Une première version peut indiquer « le
rendez-vous peut être réservé et un courriel est envoyé ». Le
responsable du service, la personne qui développe et celle qui
vérifie peuvent examiner trois tentatives précises. Ce sont des
exemples fictifs. Les conditions retenues appartiennent à l'équipe
en charge du service.

  * Si un créneau de 14 h est disponible dans le fuseau indiqué, une
seule réservation est confirmée. L'écran indique une référence, une
date et une heure qui correspondent à l'enregistrement.

  * Si le créneau a déjà été pris au moment où le service traite la
demande, l'écran indique son indisponibilité et permet de revenir
aux créneaux libres. Aucune réservation supplémentaire n'est créée
pour ce créneau.

  * Si l'envoi du message échoue après la confirmation de la
réservation, le rendez-vous reste confirmé. La référence reste
visible à l'écran et l'échec est signalé à la personne qui devra y
donner suite.

Les exemples indiquent un état de départ, une action et un résultat
vérifiable. Gherkin exprime cette structure avec Étant donné, Quand
et Alors. Elle peut faciliter la lecture et le lien avec des tests
automatisés. Une liste courte suffit également pour un changement
simple. Dans les deux cas, précisons quelle référence comparer et
depuis quel point de vue observer le résultat. La sortie d'une file
d'envoi ne démontre pas qu'un courriel a été reçu.

On exécute la première tentative sur l'écran réel, puis on maîtrise
l'ordre des demandes pour la deuxième. Dans la troisième, on
provoque l'échec après la validation de la transaction. Consigner
ces observations permet à une autre personne de refaire la
vérification. Notre déclaration d’accessibilité fournit un exemple
de preuve de ce type. Elle décrit les vérifications au clavier et
distingue ce qui a été observé de ce qui demande encore un examen.

Où les problèmes surviennent

Les termes vagues repoussent la décision jusqu'à la fin. « L'erreur
est gérée correctement » ne précise pas ce que la personne voit et
peut encore faire. Nommons l'état, le message, l'action disponible
et l'effet à empêcher. Dans le cas de la réservation, une capture de
l'alerte ne suffit pas. Il faut également regarder si le dossier de
réservation a changé.

Un critère peut aussi imposer trop tôt une technique. « Utiliser la
nouvelle file » peut correspondre à une décision valable, sans
expliquer ce qui se passe lorsqu'une confirmation tarde. Documentons
la décision d'architecture et formulons séparément le comportement à
observer. Si une intégration externe impose un protocole, citons sa
source et indiquons la limite où il s'applique.

À l'inverse, une liste peut devenir si vaste qu'elle décrit toute
une version. Séparons le travail par résultat, en gardant le cas
d'échec important à côté du parcours correspondant. Convenons des
contraintes communes et de la personne responsable de la
vérification du changement. Si un essai découvre une condition
oubliée, indiquons la raison de sa modification et répétons les
vérifications concernées. Le dossier gardera l'accord qui a
effectivement été vérifié.

Pour aller plus loin

  * Manuel du gouvernement britannique sur les récits utilisateurs
et leurs critères

  * Référence Gherkin pour rédiger des scénarios

  * Définition de Fini dans le Guide Scrum

  * Guide du W3C pour vérifier l'utilisation au clavier

hCette page sur le Web	URL:https://engineer.company/fr/glossary/acceptance-criteria/	engineer.company	70
