Scénarios et fiches descriptives

Du diagramme au scénario

Le diagramme de cas d'utilisation dit le quoi. Reste le comment implémenter — par exemple Enregistrer un nouveau film. Un scénario décrit les étapes de l'interaction avec l'utilisateur permettant d'implémenter une fonctionnalité : depuis la sélection de la fonctionnalité (dans un menu, une fenêtre principale) jusqu'à ce que le besoin utilisateur associé soit satisfait.

Première idée de scénario : la responsable de la programmation sélectionne la fonctionnalité, le système affiche un formulaire (titre, image, description), elle renseigne et valide, le système ajoute le film. Deuxième idée : le système demande le chemin d'un fichier CSV et importe tous les films d'un coup. Dans le scénario, on fait des choix d'implémentation — c'est déjà de la conception de la solution.

Si tout ne se passe pas comme prévu

Quelles erreurs peuvent se produire sur l'import CSV ? Le fichier n'est pas un CSV (non — l'utilisateur l'a choisi via un sélecteur), l'utilisateur annule (non — il n'a rien à confirmer après), le CSV n'a pas le format attendu (oui). Chaque cas réel donne un scénario alternatif : à l'étape 4, le système affiche un message d'erreur explicatif et revient à l'étape 2.

La fiche descriptive

Document textuel qui accompagne le diagramme de cas d'utilisation — une fiche par cas d'utilisation, avec une structure prédéfinie et des règles d'écriture strictes.

Système : Système de gestion de cinéma
Cas d'utilisation : Enregistrer un nouveau film

Acteur principal : Responsable de la programmation (RP)
Déclencheur :
Autres acteurs :
Préconditions : aucune
Garanties en cas de succès : Le nouveau film est ajouté aux films connus.
Garanties minimales : Si le scénario n'aboutit pas, l'état du système
                      reste inchangé.

Scénario nominal :
1. La RP sélectionne la fonctionnalité « Enregistrer un nouveau film ».
2. Le système affiche un formulaire de saisie d'un chemin vers un
   fichier CSV.
3. La RP donne le chemin d'un fichier CSV au format prédéfini (titre,
   description, chemin vers une image).
4. Le système charge le fichier et ajoute les films aux films connus.

Scénario alternatif A : format de fichier CSV incorrect
   4(A). Le système affiche un message d'erreur expliquant l'erreur.
   5(A). La RP valide.
   6(A). Le système revient à l'étape 2 du scénario nominal.

Les champs : acteur principal (celui qui démarre le cas d'utilisation), déclencheur (si déclenchement automatique), autres acteurs, préconditions, garanties en cas de succès (qui correspondent à l'objectif utilisateur) et garanties minimales (ce qu'on garantit en cas d'erreur : typiquement, l'état du système reste inchangé).

Les règles du scénario nominal

1. La première étape est toujours « L'acteur sélectionne la fonctionnalité … ».
2. Ensuite, une alternance stricte acteur / système — un dialogue.
3. La dernière étape est toujours une étape système.
4. Rester abstrait : décrire le processus, pas la solution technique.

Cas particuliers

• Précondition : le service de parrainage cycliste — « Envoyer un message de présentation » n'est disponible qu'après avoir sélectionné un point de départ. La fonctionnalité n'existe pas pour l'utilisateur tant que la précondition n'est pas remplie.
• Acteur secondaire : le site de commerce — « Valider le panier » fait intervenir le service de paiement en ligne comme autre acteur (étapes 6-7), avec les alternatifs défaut de stock et défaut de paiement (annulation de la réservation).
• Déclencheur : le site Groupin — « Finaliser offre » démarre tout seul à la fin de la validité de l'offre : l'acteur principal est Temps, le scénario nominal se réduit alors à un bloc d'actions système.

Le lien avec l'IHM (BUT 1)

Scénario ≈ séquence d'interaction + schémas d'interface (cours R2.02) : textuel vs graphique, abstrait vs concret, accent sur le processus vs l'interaction. Fiche puis prototype : de l'abstrait vers le concret — ou l'inverse, du moment qu'on réfléchit à la solution en amont. Au DS : des fiches descriptives. À la SAé 3.02 : fiches et prototype, le lien entre les deux étant évalué.

A retenir

• un scénario : de la sélection de la fonctionnalité au besoin satisfait ;
• scénario nominal + scénarios alternatifs (les erreurs réelles) ;
• alternance acteur/système, rester abstrait, garantir l'état en cas d'erreur.