Como escrever casos de uso eficazes
Publicados: 2015-08-21Como escrever casos de uso eficazes
Os casos de uso são amplamente usados para documentar a lógica de negócios e os processos do sistema. Mas há muitas opiniões sobre se eles são úteis e como devem ser estruturados. Em alguns projetos, os desenvolvedores nunca olham para os casos de uso dizendo que são verbosos ou que realmente não entendem muito deles. O que um analista de negócios pode fazer para tornar os casos de uso realmente eficazes?
A maioria de nós está ciente de que os casos de uso descrevem o processo de negócios e são as especificações para as interações entre o sistema e os atores para objetivos específicos. Um documento de caso de uso é diferente de um documento de requisitos e não é o mesmo que um documento de design.
Vejamos os dois exemplos de casos de uso para o requisito. Qual deles você acha que é melhor.
Exemplo 1
Detalhes do caso de uso | Comentários |
---|---|
Nome do caso de uso - Tickets de pedido | O nome é bom. Ele claramente dá uma indicação do que o caso de uso |
Objetivo – O cliente reserva com sucesso ingressos para a partida de futebol no site Descrição- O ator visita o site, visualiza o | O objetivo e a descrição são claramente mencionados. |
Atores - Cliente, Representante de Atendimento ao Cliente | Todos os outros detalhes do caso de uso , como Atores, | Fluxo Principal - Etapas
Casos de uso incluídos - Faça o pagamento – Gerar ID de Reserva Casos de uso estendidos – Gerar Nota de Falha de Pagamento - Imprimir Bilhete | As etapas no fluxo principal são claras, mas |
Fluxo alternativo -cancelar ingressos
Fluxo de exceção -Ingressos não disponíveis para partidas selecionadas/lugares selecionados 1. O sistema exibe uma mensagem de erro | Os fluxos alternativos e de exceção são detalhados. |
* O caso de uso pode ser mais detalhado em termos de referências e fluxos alternativos e de exceção. Este exemplo é para destacar o que deve ser englobado em um caso de uso bem escrito. |
Exemplo - 2
Detalhes do caso de uso | Comentários |
---|---|
Nome do caso de uso - Pedido de ingresso | O nome não é da perspectiva do usuário e parece uma definição de processo de negócios. |
Descrição – O ator visita o site, visualiza a programação, seleciona o jogo e os lugares, reserva o bilhete e efetua o pagamento do jogo de futebol | O objetivo do caso de uso está ausente. Designers, analistas de teste e desenvolvedores não entenderão por que essa funcionalidade deve ser desenvolvida. |
Atores - Cliente, Representante de Atendimento ao Cliente | Faltam as pré-condições. |
Etapas do fluxo principal
Casos de uso incluídos | Nas etapas do caso de uso, há algumas referências a elementos reais da interface do usuário que podem confundir o leitor. Fluxos alternativos são escritos dentro do fluxo principal, o que dificulta a compreensão de todo o processo. |
Este caso de uso carece de clareza e detalhamento e não ajudará a equipe a desenvolver a funcionalidade adequadamente. |
O que deve estar em um caso de uso | O que não deve estar em um caso de uso |
---|---|
|
. |
Algumas dicas a seguir para escrever casos de uso úteis:
- Escreva as etapas do caso de uso da perspectiva do ator.
- Os casos de uso não devem ter detalhes de design e arquitetura. Deve concentrar-se no processo de negócios.
- É melhor se as etapas no caso de uso forem escritas de forma ordenada no tempo
- Dependendo dos requisitos e da complexidade, decida se as operações CRUD (Criar, Ler, Atualizar e Excluir) precisam ser mantidas em casos de uso separados ou podem ser combinadas em um.
- É importante fornecer referências de e para fluxos alternativos, fluxos de exceção, casos de uso incluídos e casos de uso estendidos para que o design de negócios esteja completo.
- Escolha um modelo (definido pelo projeto, definido pela empresa ou qualquer um detalhado) e siga a estrutura para todos os casos de uso.
- É importante ter diagramas de casos de uso.
- No Agile, temos histórias de usuários para capturar requisitos. As histórias de usuários podem ser detalhadas usando casos de uso enxutos de maneira iterativa.
- As validações devem ser detalhadas.
Depois de escrever um caso de uso, faça essas perguntas e é um caso de uso eficaz se a resposta for “Sim” para todas as perguntas –
- O usuário saberá quando o fluxo de negócios presente no caso de uso for executado?
- Está claro quem executará qual etapa do caso de uso?
- A descrição da lógica de negócios é tal que haja informações suficientes para análise, projeto, desenvolvimento e teste?
- Existem referências adequadas do fluxo principal para os fluxos alternativos e de exceção?
- Existe um diagrama de caso de uso presente?
Os casos de uso são uma maneira eficaz de capturar requisitos e documentar formalmente os processos de negócios se estiverem bem escritos. Toda a equipe deve ser treinada para usar casos de uso para realizar suas tarefas. Casos de uso e diagramas de casos de uso são uma ótima maneira de discutir os processos de negócios com os clientes. É melhor ter um modelo de caso de uso padrão com diretrizes sobre como escrever casos de uso. Casos de uso escritos dessa forma serão valorizados por todos os membros da equipe do projeto e partes interessadas.