Formatos de Casos de Uso

O nível de detalhe exigido nos casos de uso difere de projeto para projeto, e mesmo entre casos de uso e cenários dentro do mesmo projeto. Um formato de caso de uso que funciona em uma situação pode ser totalmente inadequado para outra. O segredo para maximizar a eficiência e a eficácia é capturar a quantidade certa de detalhe para cada caso de uso e cenário específicos. (Veja [ADO04] para mais informações sobre formatos de casos de uso).

Alguns casos de uso precisam de maior grau de detalhe. Se os autores estiverem usando um template, então eles preencherão todos, ou quase todos, os campos para cada caso de uso. Os casos de uso de maior grau de detalhe são mais adequados para funcionalidades complexas, sem precedentes e de segurança crítica, tais como sistemas de controle de vôo, centrais telefônicas, etc, onde o risco de uma interpretação errada seja alto.

Outros casos de uso precisam de menos detalhes. Se os autores estiverem usando um template, então eles poderão deixar a maioria dos campos em branco. Os casos de uso menor grau de detalhe são mais adequados para funcionalidades bem conhecidas, menos complexas e de segurança não tão crítica, onde a maioria dos Stakeholders tem uma sólida experiência no domínio do problema e o risco de uma interpretação errada seja baixo. Nestes casos, descrições resumidas simples ou descrições passo-a-passo são o suficiente.

Além disso, nem todos os cenários são criados de forma igual. No mesmo caso de uso, alguns cenários são muito bem compreendidos e uma descrição resumida é suficiente para garantir uma interpretação inequívoca. Outros cenários podem exigir mais detalhes para capturar o comportamento essencial de forma inequívoca.

Finalmente, como explicado na Guideline: Detalhar Casos de Uso e Cenários, faz sentido escrever casos de uso iterativamente. Começando com os detalhes básicos, você pode identificar os vários caminhos alternativos e de erro que o caso de uso possa seguir, de forma que você possa avaliá-los, reorganiza-los ou eliminá-los, e então, elaborar ou completar os detalhes dos cenários restantes.

Escreva os casos de uso e os cenários em um ou mais dos seguintes formatos, progressivamente, até chegar ao nível de detalhe desejado:

• Visão geral do modelo de caso de uso: Um formato para entender a visão contextual
• Descrições resumidas de Casos de Uso: Um formato para escrever casos de uso de forma resumida
• Descrições passo-a-passo: Um formato para escrever casos de uso menos formais e de baixa cerimônia
• Altamente Detalhado: Um formato para escrever casos de uso mais formais e de alta cerimônia

Visão geral do modelo de caso de uso

Crie uma visão geral do modelo de caso de uso que capture os atores e os casos de uso associados.

• Comece identificando os atores que irão utilizar o sistema e, em seguida, identifique pelo menos uma meta para cada um. Atores sem metas indicam que você não definiu adequadamente o sistema. O ator está fora do âmbito do sistema, não pertence ao sistema nem faz parte de um outro ator.
• Da mesma forma, metas sem atores podem indicar que o sistema é muito complexo e que você está tentando realizar muita coisa, ou que não tenham sido adequadamente definidos todos os atores necessários. Avalie cuidadosamente os atores sem meta e as metas sem atores para ver se você está apenas esquecendo algum detalhe, ou se eles não pertencem ao sistema.
• Remova do modelo os atores e metas não associados.

Às vezes, essa visão geral pode fornecer informações suficientes para servir como modelo de caso de uso, quando se tratar de equipes de projeto muito pequenas, com grande comunicação e baixa cerimônia. Geralmente, a visão geral do modelo de caso de uso é o primeiro passo de identificação dos casos de uso e dos limites do sistema.

Descrições resumidas de Casos de Uso

Escreva de duas a quatro sentenças por caso de uso, capturando os tratamentos de extensões e as atividades essenciais.

• Expanda os casos de uso de alta prioridade escrevendo de duas a quatro sentenças para cada entrada na lista.
• Descreva resumidamente o cenário principal e as extensões mais importantes de cada caso de uso.
• Inclua informações suficientes para eliminar a ambigüidade, no mínimo, do cenário principal.

Descrições passo-a-passo

Escreva a descrição passo-a-passo que descreve a interação entre os atores e o sistema.

• Os principais cenários são detalhados para descrever a interação
• Eventos estimuladores são especificados
• As informações trocadas são descritas

Altamente Detalhado

Complete todas as seções do template Especificação de Caso de Uso.

• O cenário principal é detalhado
• Todos os fluxos alternativos são identificados e detalhados
• Os requisitos especiais estão completos e inequívocos
• As Pré e Pós-condições são especificadas