La rappresentazione dei casi d'uso sotto forma di diagramma è molto utile per avere una visione "dall'alto" delle funzionalità che dovranno essere implementate nel software che si intende realizzare, ma non fornisce sufficienti dettagli per consentire al progettista del sistema di capire in che modo saranno realizzate. Dal diagramma dei casi d'uso non vi è alcun modo di capire quale sia l'attore più importante, o quali azioni dovranno essere compiute per implementare un determinato caso d'uso.
La rappresentazione migliore per rappresentare queste importanti informazioni è la forma testuale e ciascun caso d'uso dovrebbe essere accompagnato da una descrizione.
In realtà lo standard UML non definisce in modo preciso quali informazioni debbano essere incluse nella descrizione di un caso d'uso, ma un buon punto di partenza potrebbe essere la tabella seguente.
| Nome |
Nome del caso d'uso |
| Requisito |
Il requisito che questo use case soddisfa in modo parziale o completo |
| Obiettivo nel contesto |
Descrizione dell'obiettivo del caso d'uso all'interno del sistema |
| Precondizioni |
Le condizioni che devono essere soddisfatte prima che il caso d'uso sia eseguito |
| Condizione per la terminazione con successo |
Descrizione della condizione per la terminazione con successo del caso d'uso |
| Condizione per la terminazione con fallimento |
Descrizione della condizione per la terminazione con fallimento del caso d'uso |
Attori principali
|
Gli attori principali che partecipano all'esecuzione del caso d'uso. Spesso coincidono con gli attori che scatenano l'esecuzione del caso d'uso o quelli che beneficiano direttamente del risultato dell'esecuzione.
|
| Attori secondari |
Gli attori che partecipano al caso d'uso ma che non sono quelli che ne causano l'esecuzione |
Evento scatenante
|
L'evento innescato da un attore che causa l'esecuzione del caso d'uso |
| Flusso principale |
La sequenza di azioni (passi) che descrivono l'esecuzione "normale" del caso d'uso |
| Estensioni |
La descrizione dei passi alternatevi a quelli descritti nel flusso principale
|
La tabella precedente è solo un esempio, ma è bene ricordare che non rappresenta un inutile documento supplementare al diagramma, al contrario completa il caso d'uso associato: in realtà senza la descrizione un caso d'uso risulta di scarsa utilità.
a5c0dbec-0249-4f3b-ba5b-03853c679b6a|1|1.0