Supporto tecnico pratico
Come segnalare un problema che qualcun altro può riprodurre
Crea un report tecnico chiaro con passaggi ripetibili, risultati attesi ed effettivi, confronti utili e dettagli dei dispositivi esaminati.
Ultima revisione: 2016
Rendi informativo il prossimo tentativo
Una buona segnalazione consente a un'altra persona di capire cosa è successo, cosa ci si aspettava e come tentare di fare la stessa cosa, senza dover identificare il bug o usare un vocabolario specialistico. "La pagina è rotta" è un punto di partenza; una breve sequenza ripetibile lo trasforma in qualcosa che il supporto può indagare.
Prima di riavviare o cancellare ripetutamente i dati, cattura il sintomo corrente e l'ora approssimativa, poiché tali azioni potrebbero modificare o rimuovere le prove. Se un'azione rischia un pagamento doppio, un messaggio o una modifica distruttiva, smetti di ripeterla e contatta l'assistenza tramite il canale appropriato.
Scrivi la più piccola sequenza utile
- Indica dove hai iniziato, utilizzando un indirizzo di pagina pubblico senza token privati.
- Elenca i passaggi effettivi in ordine, inclusi i nomi dei pulsanti o dei campi che hai visto.
- Descrivere il risultato atteso in linguaggio comune.
- Registra invece ciò che è successo, incluso l'errore esatto se è sicuro condividerlo.
- Dite se accade ogni volta, occasionalmente o solo in una condizione nota.
Separare l’osservazione dalla spiegazione. “Il pulsante rimane disabilitato dopo aver inserito un indirizzo” è un’osservazione. “Il tuo database non funziona” è un’ipotesi a meno che qualcuno non l’abbia effettivamente controllata.
Un esempio lavorato
Rapporto illustrativo, non un errore WAIU noto: “Sulla pagina QR, scelgo Sito web, incolo un indirizzo HTTPS e cambio il pattern. Mi aspetto che l’anteprima si aggiorni, ma invece rimane invariata. È successo tre volte in questo browser; ha funzionato in un secondo browser.”
Il report nomina una pagina, uno stato iniziale, delle azioni, un risultato atteso, il risultato osservato e un confronto utile; ha ancora bisogno delle versioni effettive e possibilmente di un indirizzo di esempio non sensibile, ma un'altra persona può ora tentare la stessa sequenza.
Se l'ordine è importante, includerlo. La modifica di un'impostazione prima di immettere il contenuto potrebbe comportarsi in modo diverso rispetto alla modifica successiva. Se il problema è lo scorrimento o l'input, confrontare la rotellina del mouse, la barra di scorrimento, il tocco o la tastiera, se del caso.
Modificare una variabile alla volta
| Confronto | Domanda che aiuta a indagare | Limite |
|---|---|---|
| Stesso browser, nuova pagina | Lo stato della pagina corrente ha importanza? | Un reload può conservare i cookie e lo spazio di archiviazione del sito. |
| Un altro browser | Il comportamento è associato a quel browser o profilo? | Le versioni, le impostazioni, le estensioni e le sessioni sono tutte diverse. |
| Un altro dispositivo | Il problema segue il dispositivo? | Anche lo schermo, il sistema operativo e la connessione potrebbero cambiare. |
| Un'altra rete consentita | Il percorso di rete sembra rilevante? | Può cambiare DNS, filtraggio e posizione apparente insieme. |
Una finestra privata è un confronto utile, non un test magico in camera bianca: può avere un comportamento di archiviazione ed estensione diverso e un sito può dipendere da una sessione che non hai più. Non cancellare tutti i dati del browser solo per rendere il rapporto più completo.
Aggiungi l'ambiente senza sopraffare il lettore
Uso Copiare i dettagli del supporto Esaminare il rapporto e scegliere se i dettagli della rete sono rilevanti. La versione del sistema operativo riportata potrebbe essere approssimativa perché i browser limitano alcune informazioni; includere separatamente una versione di sistema verificata, se necessario.
Per un problema di layout, menziona lo zoom, le dimensioni e l'orientamento della finestra. Per un problema di connessione, menziona Wi-Fi o Ethernet, lo stato e la temporizzazione della VPN. Per un problema di fotocamera, menziona il dispositivo selezionato e il messaggio di autorizzazione esatto. Aggiungi i dettagli che distinguono il caso, invece di incollare ogni impostazione che riesci a trovare.
Utilizzare un modello di report
Pagina o funzionalità: Ora e fuso orario: Stato iniziale: Passi da riprodurre: Risultato atteso: Risultato effettivo e errore esatto: Quanto spesso accade: Confronto utile e suo esito: Dettagli del browser/dispositivo esaminato: Screenshot allegato, con dettagli privati rimossi:
Uno screenshot dovrebbe supportare la sequenza, non sostituirla. Leggere Come preparare uno screenshot di supporto utileEvita di allegare i log degli sviluppatori o le esportazioni di rete senza averli esaminati: possono contenere sessioni, identificatori e contenuti personali.
Chiudere il ciclo dopo una correzione proposta
Ripeti i passaggi originali dopo una modifica concordata e comunica al supporto se il sintomo originale è scomparso, cambiato o rimasto. “Funziona ora dopo l’aggiornamento del browser” è utile; “risolto” senza la condizione perde informazioni.
Se non riesci più a riprodurlo, dillo piuttosto che inventare certezze: un chiaro rapporto parziale può ancora rivelare uno schema tra diversi utenti. Il toolkit del team di supporto Aiuta i team a inviare istruzioni coerenti in modo che i clienti sappiano quale strumento aprire e quale restituire.