# Roteiro Tutorial TestPlans

## 1. Introdução - ao Azure DevOps – Test Plans
Roteiro de Vídeo: "Introdução ao Azure DevOps – Test Plans, Acesso ao azure "
[Introdução] genérica

(Aqui aparece o(a) apresentador(a))
E aí, pesoal! Tudo bem? Eu sou o Artur e hoje vamos explorar juntos o Test Plans no Azure DevOps.
Você vai aprender como criar e executar testes de forma prática, além de conferir boas práticas para deixar suas evidências bem registradas e organizadas. Bora lá?

PREMISSA > Ter acesso ao azure

### Parte 1: Acesso ao Azure DevOps
VIDEO: https://drive.google.com/file/d/1cuSnrYsS_TkrKr0ksJQ7tLj7xdjRv4li/view?usp=drive_link
(Aqui aparece o(a) apresentador(a)
Pra começar, é só acessar o portal do Azure DevOps.
(aqui aparece a tela)
Você pode usar qualquer navegador e entrar no endereço: dev.azure.com/locaweb.
Depois de fazer o login, você já vai ver o seu dashboard com os projetos disponíveis.

(Aqui aparece o(a) apresentador(a)
Ah! Se você ainda não tem acesso ao Azure DevOps, é só procurar seu líder direto e solicitar a liberação, beleza?

Premissa >
(Aqui aparece o(a) apresentador(a)
Importante destacar:

Provavelmente você já tenha o módulo Test Plans habilitado.
Se não encontrar a opção é importante verificar se o módulo está habilitado no projeto.
Caso contrário, a habilitação precisa ser feita por um Team Lead ou pelo Admin do Projeto no Azure DevOps.

Parte 2:
(Aqui aparece o(a) apresentador(a)
O que é o Módulo Test Plans?
(corta para exibição da tela, mostrando a opção 'Test Plans' no Azure DevOps.)

Apresentador(a):

De forma simples:

O Test Plans no Azure DevOps é a área onde você gerencia todo o ciclo de vida dos testes — desde a criação dos planos de teste até a execução e o acompanhamento dos bugs encontrados.

## 2.Roteiro de Vídeo: "Executar testes funcionais – Test Plans, Test Suites e Execução de Testes"
### Parte 2: Como Instalar e Configurar o Plugin Test & Feedback
VIDEO: https://drive.google.com/file/d/1JGouMD0x2v65BQL-fp8Fyo_dIhA__ead/view?usp=drive_link
(Aqui aparece o(a) apresentador(a))
Agora, a gente vai instalar e configurar o plugin Test & Feedback.

Esse plugin facilita muito a execução dos testes e a coleta de evidências — tudo direto do seu navegador.

(Transição para a tela do navegador)

Primeiro passo: vá até o marketplace do seu navegador e procure por Test & Feedback.

Quando encontrar, é só clicar em Instalar.

(Tela mostrando a instalação sendo feita, mostrando a extensão já instalada e começando a configurar.)

(Aqui aparece o(a) apresentador(a))

Com a extensão instalada, vamos fazer a configuração inicial:
(transição mostrando a tela)
Marque a opção Connected.
No campo Server URL, informe: https://dev.azure.com/locaweb/
Depois, selecione o seu Team. Por exemplo: chapter-qualidade team.
(Tela mostrando a finalização da configuração)

(Aqui aparece o(a) apresentador(a))
Importante:
Essa configuração precisa ser feita só uma única vez.
Mesmo que você mude de squad depois, não precisa reconfigurar o plugin, beleza?

### Parte 2.1: O que são os Test Suites?
VIDEO: https://drive.google.com/file/d/1SfJtcTicc374dbTMdO-8BMXIC-fiFTwk/view?usp=drive_link

Cena:
(Aqui aparece o(a) apresentador(a))

Agora que já configuramos tudo, vamos entender como organizar os testes dentro do Test Plans.
No Azure DevOps, a gente usa o que chamamos de Test Suites.
Eles funcionam como pastas — agrupando os testes por contexto e funcionalidades diferentes.

(transição para a tela)
Aqui na tela, você vê como organizamos nossa estrutura de pastas:
Cada Suite representa um contexto específico, uma ação do sistema e seus cenários de teste.
(Pode dar um zoom leve ou highlight nos exemplos.)

Cena:
(Apresentador(a) volta, reforçando a lógica.)

Para escrever os cenários de testes utilizamos a Linguagem gherkin Por exemplo:
- Dado: define a situação ou condição inicial para o teste.
- Quando: descreve a ação ou interação esperada.
- Então: descreve o comportamento esperado após essa ação.

Cena:
(Apresentador(a) narrando e na tela montando um exemplo)

Vamos ver um exemplo:

"Dado que possuo um plano de hospedagem ativo e um dominio válido"

"Quando informar dominio válido E instalar"

"Então apresenta mensagem de sucesso E nova hospedagem é listada ativando"

(Tela mostrando esse exemplo montado corretamente no Azure DevOps — nome do cenário, funcionalidade e steps.)

Repare que o nome da funcionalidade vem primeiro, seguido pelo nome do cenário e depois os passos descritos. Esse padrão ajuda muito na organização e na leitura dos testes.

### Parte 3: Como Iniciar a Execução de um Teste Através do Plugin Test & FeedBack
VIDEO: https://drive.google.com/file/d/1WL5QMD2OxCi1UAS-EfKxLFRCE2rSu7t_/view?usp=drive_link

(Aqui entra o(a) apresentador(a))
Agora que você já viu como é a estrutura dos testes, bora ver como executar na prática?

(Transição para a tela do Azure DevOps — mostrando a listagem dos cenários de teste.)

Com o Test & Feedback configurado, o processo é simples:

- Acesse a suite de testes.
- Escolha o cenário que você quer executar.
- Clique com o botão direito sobre o cenário.
- Depois, vá em Run > Run for web application.

Cena:
(Tela mostrando o plugin Test & Feedback aberto, com a janela de execução.)

Quando a janela do plugin abrir, você vai ver os steps do seu teste organizados:

- Primeiro o DADO,
- Depois o QUANDO,
- E por fim o ENTÃO.

Pra cada step, você pode clicar e ir executando conforme o previsto.

Cena:
(Tela demonstrando o início da coleta de evidências.)

A partir do momento em que você executa o teste, já pode começar a coletar as evidências.
E o plugin facilita muito isso:

- Você pode tirar prints,
- Gravar vídeos,
- E até anexar arquivos, se necessário.

(Mostrar um exemplo rápido clicando nas opções de coleta.)

(Aqui entra o(a) apresentador(a))
Mas calma, que a gente vai entrar nos detalhes de como fazer isso direitinho na próxima parte!

### Parte 4 (As boas praticas vao ser faladas junto com o 5.1): Boas Práticas para Coleta de Evidências

ESSE VIDEO É O MESMO DO PROXIMO TOPICO 5.1 Test Pass: https://drive.google.com/file/d/1Fmu9O-Vdsrj79fFp17_lJ0k13ElPwqzs/view?usp=drive_link

Cena:
(Tela mostrando o plugin Test & Feedback aberto, enquanto o(a)apresentador(a)fala e demonstra os recursos.)

Vamos falar agora sobre algumas boas práticas pra coleta de evidências usando o Test & Feedback.
O plugin oferece várias formas de capturar o que acontece durante a execução dos testes:
-Você pode fazer capturas de tela com anotações embutidas.
-Gravar vídeos da tela, com ou sem áudio.
-Capturar o log de ações do usuário — como um passo a passo automático.

(Mostrando cada função enquanto fala.)

Além disso, você pode:

- Adicionar comentários diretamente no teste,
- Criar bugs a partir da execução,
- E até associar o teste a um bug existente.

(Mostrando um exemplo de criação de bug ou comentário.)

(Volta o(a)apresentador (a) na tela)
Ah! E um ponto importante:

O plugin também contabiliza o tempo de execução dos testes, gerando métricas que ajudam no acompanhamento.
E não tem limite: você pode adicionar quantos prints, vídeos ou anexos forem necessários.

Agora, algumas dicas importantes pra garantir que suas evidências sejam realmente úteis:

- Tire quantos prints forem necessários pra comprovar o resultado do teste.
- Sempre capture a tela cheia — no Test & Feedback, é só usar a função de "full screen".
- Grave vídeos somente quando necessário — tipo quando aparece uma mensagem rápida que some em segundos.
- Adicione comentários relevantes, principalmente quando encontrar alguma inconformidade.

Esses comentários podem incluir:
- Dados de request,
- Login e senha (se forem testes internos),
- Ou qualquer detalhe que um print sozinho não consiga mostrar.
(Tela mostrando um exemplo de comentário bem feito.)

Cena:
(Tela mostrando o final da execução de um teste.)

E, pra fechar:
Sempre lembre de selecionar o status final do teste — se passou ou não.
(Mostrando o campo de seleção de status na prática.)

(Volta o(a) apresentador(a) na tela)
Se você esquecer de marcar, o plugin entende que o teste falhou e já coloca como Fail automático.
Aí já viu, né? Acaba gerando retrabalho depois.

### Parte 5: Execução de Testes Pass, Fail, Block, Not Applicable, Pause.
#### 5.1 Pass test

VIDEO: https://drive.google.com/file/d/1Fmu9O-Vdsrj79fFp17_lJ0k13ElPwqzs/view?usp=drive_link

Cena:
(Tela mostrando testes em andamento com diferentes status: Active)

Aqui vamos executar um teste de sucesso.
Selecione o cenário que sera executado, clique com o botão direito do mouse > run > run for web application.
Com o test & feedback aberto, selecione o step que deseja coletar as evidencias
E Aqui vamos coletar evidencias
Após todas as evidencias coletadas, marque como pass test

#### 5.2 Fail test

VIDEO: https://drive.google.com/file/d/1FWBGixqReZk1tZHyTfAaZsB0tWxIXrzE/view?usp=drive_link

Cena:
(Tela mostrando testes em andamento com diferentes status: pass e o resto active)

Aqui vamos executar um teste de Falha.
Selecione o cenário que sera executado, clique com o botão direito do mouse > run > run for web application.
Com o test & feedback aberto, selecione o step que deseja coletar as evidencias
E Aqui vamos coletar evidencias
Veja que o resultado esperado náo foi atendido, ou seja encontramos uma inconformidade e precisamos abrir um bug

Na parte superior possui uma opção chamada "create bug"
Ao clicar sera aberto um card do tipo bug, veja que o bug já vem preenchido com tudo que foi feito até o momento.

Porém é necessário informar o titulo do bug, system info (Aqui pode entrar detalhes, como request do servidor, response, login e senha utilizado no teste)

o Critério de aceite, deve dizer qual é o resultado esperado após a correção do bug
E o tipo de ambiente sysint ou produção.

Após salvar o bug, vamos voltar para o test plans.
marque o teste como fail test e depois salve e feche, pronto.

#### 5.3 Block test

VIDEO: https://drive.google.com/file/d/1A6iEu_3KBabR6FE_my6s12hTfOzyPD-T/view?usp=drive_link

Cena:
(Tela mostrando testes em andamento com diferentes status: pass, fail o resto active)

Aqui vamos executar um teste de blocked.
Normalmente o cenário bloqueado é um cenário que não pode ser executado devido algum bug existente

clique com o botão direito do mouse em cima do cenário > run > run for web application.
Marque o teste como blocked test

E na parte superior clique em adicionar a um bug existe.
Informe o numero do bug e salve.

#### 5.4 pause test

VIDEO: https://drive.google.com/file/d/13-ciZOjPZaK2C_EO7zlc5FT3uNeR7zSu/view?usp=drive_link

Cena:
(Tela mostrando testes em andamento com diferentes status: pass, fail, blocked o resto active)

Aqui vamos executar um teste que possui processos assincronos.
Selecione o cenário que sera executado, clique com o botão direito do mouse > run > run for web application.
Com o test & feedback aberto, selecione o step que deseja coletar as evidencias
E Aqui vamos coletar evidencias
Como esse cenário possui processos assincronos, podemos pausar o teste e retomar ele quando o processo finalizar.

Com o processo finalizado, vamos retonar com o teste de onde paramos.

clique com o botão direito do mouse > resume test > Resume for web application.

Veja que todas as evidencias continuam salvas, e voce pode concluir a coleta.
Com as evidencias finalizadas, marque como pass test e salve.

#### 5.5 Not Applicable

https://drive.google.com/file/d/1QI1OMm0EQnGbheOW-uZDep9EloF5lO3h/view?usp=drive_link

Cena:
(Tela mostrando testes em andamento com diferentes status: pass, fail, blocked, pause e not aplicable)

Aqui temos um teste que foi planejado e que por algum motivo não pode ser executado.

clique com o botão direito do mouse > mark outcome > not applicable.
Clique duas vezes sobre o teste, clique na run.
E agora é hora de detalhar o motivo da não execução.

- Problemas de ambiente, um cenário que houve alteração de regras. (importante que aqui tenha justificativa para não execução). Sempre solitar que o PO registre isso em algum card.

### Cena final

Cena:
(Apresentador(a) em quadro para encerramento.)

E é isso!

Nosso tutorial sobre como utilizar o módulo Test Plans no Azure DevOps fica por aqui.

Lembre-se: seguir as boas práticas de coleta de evidências e gerenciar corretamente os status dos testes faz toda a diferença na qualidade das entregas.

Obrigado por acompanhar!
Bora garantir a qualidade dos nossos projetos.
Te vejo no próximo tutorial!