Come documentare i passaggi di un test QA con screenshot

Questa guida spiega come raccogliere prove tramite screenshot durante l'esecuzione di un test QA. Definirai l'obiettivo, registrerai prerequisiti e dati di prova, scriverai passaggi verificabili, acquisirai le prove, assegnerai un esito e completerai il verbale di esecuzione.

In breve: un verbale QA collega ogni azione pianificata a un risultato atteso e giustifica l'esito finale, superato, non superato o bloccato, con le prove di quella precisa esecuzione.

Definisci un solo obiettivo di test

L'obiettivo indica il comportamento da controllare e la condizione necessaria per il successo. Dedica ogni verbale a un solo risultato, così un errore rimanda a un'area chiara del prodotto.

Per esempio, «Verificare che un utente Free possa esportare un documento Action Capture in PNG» è verificabile. «Provare le esportazioni di Action Capture» combina diversi formati, stati del piano e percorsi di errore che richiedono casi separati.

Assegna un ID stabile quando il test verrà ripetuto. L'ID collega esecuzioni future, regressioni e segnalazioni di difetti senza dipendere da un titolo che potrebbe cambiare.

Registra prerequisiti e dati di prova

I prerequisiti rendono ripetibile l'esecuzione. Elenca versione del prodotto, sistema operativo, piano o stato dell'account, permessi, flag delle funzioni, documento predisposto e qualsiasi dato richiesto prima del primo passaggio.

Usa dati di prova precisi invece di chiedere genericamente di «inserire informazioni valide». Se un valore può esporre credenziali o dati di un cliente, crea un dato di esempio sicuro e indica dove reperirlo.

Una configurazione compatta può avere questo aspetto:

Ambiente: macOS 15.5, Shotomatic 1.8.2
Stato account: Free
Permessi: Screen Recording consentito
Dati di prova: documento Action Capture con tre pagine
Schermata iniziale: editor Document, prima pagina selezionata

Scrivi i passaggi con i risultati attesi

Ogni passaggio deve abbinare una sola azione al risultato che il tester deve controllare. In questo modo, un lungo elenco di azioni non rimanda tutte le verifiche alla fine.

Usa istruzioni dirette:

1. Apri il menu Export. Atteso: PNG e JPG sono disponibili.
2. Seleziona PNG. Atteso: si apre la finestra di salvataggio.
3. Scegli la cartella di prova e salva. Atteso: viene creato un file PNG per ogni pagina.
4. Apri i file esportati. Atteso: le pagine seguono l'ordine del documento e corrispondono all'editor.

Evita di riunire più interazioni in un solo passaggio. Se un passaggio composto non riesce, non è chiaro quale azione abbia causato il risultato.

Acquisisci le prove nei punti utili

Le prove utili dimostrano uno stato rilevante per la decisione sul test. Acquisisci la configurazione iniziale, le opzioni legate al piano, il risultato finale e qualsiasi comportamento inatteso.

Non serve uno screenshot per ogni clic. L'apertura di un menu può richiedere una prova quando il test verifica i formati disponibili; la scelta di una normale cartella, invece, potrebbe non aggiungere nulla.

Action Capture può raccogliere una sequenza clic per clic quando il test segue un percorso nell'interfaccia. In seguito, controlla le pagine e conserva soltanto gli stati che giustificano il risultato. Le sessioni Free consentono 5 passaggi salvati e tutti i formati di esportazione dei documenti. Pro elimina il limite e aggiunge Blur, Click Marker e Step Numbers.

Registra i risultati effettivi senza riscrivere la storia

Il risultato effettivo deve descrivere ciò che è accaduto in questa esecuzione. Non cambiare il risultato atteso per farlo coincidere con un errore e non modificare i passaggi pianificati durante il test senza registrare la deviazione.

Usa uno di questi tre esiti chiari:

• Superato: tutti i risultati richiesti corrispondono.
• Non superato: almeno un risultato richiesto non corrisponde.
• Bloccato: non è stato possibile decidere perché un prerequisito o un altro difetto ha impedito l'esecuzione.

Quando il test non riesce, indica il primo punto di controllo non corrispondente e collega una segnalazione di bug separata. Questa può contenere il percorso minimo di riproduzione, l'ambiente, la frequenza e le prove diagnostiche senza appesantire il caso di test riutilizzabile.

Usa questo verbale di esecuzione QA

La struttura seguente separa la definizione riutilizzabile del test dal risultato di una singola esecuzione:

ID caso di test:
Obiettivo:

Ambiente:
Prerequisiti:
Dati di prova:

Passaggi e risultati attesi:
1. Azione:
   Atteso:
2. Azione:
   Atteso:

Data di esecuzione:
Tester:
Build provata:

Risultato effettivo:
Esito: Superato / Non superato / Bloccato
Prove:
Difetto collegato:
Note o deviazioni:

È una struttura di documentazione da copiare nel sistema QA già usato dal tuo team. Shotomatic non la importa come modello di progetto.

Controlla le prove e approva

La revisione finale verifica che le prove appartengano all'esecuzione indicata. Controlla build, stato dell'account, data, ordine delle pagine e risultato esportato prima che un'altra persona usi il verbale per approvare un rilascio.

Elimina gli screenshot duplicati e proteggi i dati di prova privati. Se i file verranno conservati separatamente dal sistema di gestione dei test, collega nomi file o titoli delle pagine all'ID del caso. Prima di condividere il verbale, esegui un ultimo controllo e ripercorrilo come farebbe il lettore.

Un verbale QA è completo quando chi lo esamina può capire che cosa è stato provato, ripetere la configurazione, confrontare risultati attesi ed effettivi e comprendere l'esito finale. Usa Action Capture per raccogliere una sequenza di test basata sui clic. Se le prove partono da un problema già osservato e non da un test pianificato, consulta Come documentare un bug con screenshot passo passo sul Mac.