Ingrid Lorrane← Laboratório de QA
Laboratório de QA · Casos de teste

Escrita procedural de casos de teste

Da especificação à execução: um guia para documentar casos de teste com clareza, consistência e rastreabilidade.

Ingrid Lorrane · Guia técnico

1. Objetivo e aplicação

Este guia apresenta orientações para especificar casos de teste claros, rastreáveis e reproduzíveis, utilizando a escrita procedural. Aplica-se a projetos que incluem atividades de análise, projeto e execução de testes ao longo do ciclo de vida do software.

2. O que é a escrita procedural

A escrita procedural descreve, em uma sequência ordenada, as ações necessárias para executar um teste e os resultados esperados. O roteiro permite que outra pessoa reproduza o teste sem depender do conhecimento de quem o escreveu.

Uma boa especificação deixa claro o que deve ser validado, em quais condições, quais dados utilizar e como identificar se o comportamento observado está de acordo com o esperado.

3. Identificação dos cenários de teste

A identificação dos cenários começa pela análise da base de teste: requisitos, casos de uso, histórias de usuário, critérios de aceitação e riscos. A partir dessas informações, identificam-se os comportamentos que precisam ser validados.

  • Fluxo principal: execução esperada da funcionalidade.
  • Fluxos alternativos: caminhos válidos diferentes do principal.
  • Fluxos de exceção: erros, restrições e situações inválidas.

Priorize os cenários considerando o impacto e a probabilidade dos riscos. Nem todo cenário precisa ter o mesmo nível de detalhamento.

4. Nomenclatura e identificação

Cada caso de teste deve possuir um identificador único. A convenção abaixo é uma proposta de padronização para projetos que utilizam casos de uso (CSU) e casos de teste (CST).

TipoPadrãoObjetivo
AceitaçãoTSTAC[CSU].[CST]Validar se o sistema atende às necessidades e aos critérios de aceitação do negócio.
SistemaTSTSYS[CSU].[CST]Verificar o comportamento do sistema como um todo, incluindo requisitos funcionais e não funcionais aplicáveis.
IntegraçãoTSTIN[CSU].[CST]Verificar interfaces e interações entre componentes ou sistemas.

Exemplo: TSTAC002.01 – Acessar Tela de Cadastro de Cliente. O número 002 identifica o caso de uso e 01 identifica o caso de teste associado.

Os prefixos são uma convenção de projeto, não uma nomenclatura obrigatória do ISTQB. Os níveis de teste devem ser definidos conforme a estratégia adotada.

5. Importância da rastreabilidade

A rastreabilidade estabelece a relação entre a base de teste e os casos de teste. Ela permite identificar requisitos cobertos, lacunas e impactos de mudanças.

  • Cobertura: identificar requisitos que ainda precisam de testes.
  • Gestão de mudanças: localizar casos afetados por alterações.
  • Transparência: facilitar revisões e auditorias.

O identificador ajuda na organização, mas não substitui o vínculo explícito com os requisitos. Um caso de teste pode cobrir vários requisitos e um requisito pode exigir vários testes. A existência do vínculo, por si só, não garante cobertura completa.

6. Padrão de escrita

  • Inicie o nome com um verbo de ação no infinitivo: acessar, consultar, cadastrar, validar ou excluir.
  • Escreva sob a perspectiva do ator: “Consultar Calendário”, em vez de “Exibir Calendário”.
  • Utilize termos do negócio, especialmente nos testes de aceitação.
  • Adote iniciais maiúsculas nos títulos, exceto artigos, preposições e conjunções, conforme a convenção escolhida.
  • Evite expressões vagas como “verificar se funciona”. Defina o comportamento esperado de forma observável.

7. Convenções de nomenclatura

Uma convenção visual facilita a identificação dos elementos mencionados no roteiro. Neste guia, adoto os seguintes padrões:

ElementoConvençãoExemplo
Botão, link, menu, coluna e abaColchetes [ ]Acionar o botão [Novo]
Acionar o link [Editar Endereço]
Acessar o menu [Clientes/Cadastro]
Verificar a coluna [Nome]
Selecionar a aba [Endereço]
Campo<Nome do campo>Preencher o campo <Endereço>.
Opção ou valorAspas simplesSelecionar ‘Ativo’ no campo <Situação>.
Tela, mensagem ou referênciaAspas duplasVerificar se a tela “Cadastro de Cliente” foi exibida.
Conforme pré-condição “a”.

8. Detalhamento dos casos de teste

O detalhamento deve permitir que o teste seja executado de maneira consistente. A estrutura proposta reúne:

  • Objetivo: comportamento que será validado.
  • Pré-condições: estado, permissões e dados necessários antes da execução.
  • Pós-condições: estado esperado ao final do teste.
  • Roteiro: condições de entrada e saída, com ações e resultados esperados em sequência.
  • Informações complementares: data, tempo estimado de execução e complexidade, quando úteis.

Identifique as pré-condições por letras e numere as ações e verificações do roteiro. A numeração em intervalos de dez (10, 20, 30...) permite inserir passos posteriormente sem renumerar todo o roteiro. Detalhe fluxos alternativos e exceções em casos próprios quando isso facilitar a execução e o diagnóstico.

9. Exemplo completo

O exemplo a seguir utiliza um sistema fictício de gestão de clientes e apresenta a estrutura de três colunas: caso de teste, descrição e roteiro.

Exemplo ilustrativo — teste de aceitação
CASO DE TESTEDESCRIÇÃOROTEIRO
TSTAC002.01 – Acessar Tela de Cadastro de Cliente

Referência: CSU002 – Cadastrar Cliente (fictício).

Objetivo:
Validar a permissão de acesso à funcionalidade “Cadastro de Cliente”.

Pré-condições:
a - Estar autenticado no sistema.
b - Possuir permissão para cadastrar clientes.

Pós-condições:
Tela de cadastro de cliente acessada, sem criação de registro.

Data: 13/11/2026 (ilustrativa)
Tempo estimado: 00:15 (mm:ss)
Complexidade: Baixa

Condições de Entrada/Saída:

10 - Acessar o módulo de Gestão de Clientes, menu [Clientes/Cadastro].

20 - Verificar se a tela “Cadastro de Cliente” é exibida com sucesso, apresentando os campos de cadastro e o botão [Salvar].

Este caso valida apenas o acesso à tela. O cadastro efetivo, a ausência de permissão e as validações dos campos devem ser cobertos por outros casos de teste.

10. Armazenamento e gestão

Os casos de teste devem ser mantidos em um repositório centralizado, acessível à equipe e adequado ao processo do projeto. Ferramentas de documentação ou gestão de testes, como Confluence, podem ser utilizadas para esse fim.

Mantenha os casos versionados, com vínculos aos requisitos, histórico de alterações e revisão periódica. Registre os resultados das execuções separadamente da especificação para preservar o histórico e permitir a reutilização dos casos de teste.

← Voltar ao laboratório