Documentazione

Guide operative per tutte le funzionalità di TestFlowHub.

🧭 Primi passi📊 Dashboard📁 Progetti🗺️ Phase 1🎓 Onboarding AI📋 TestBook🕷️ Scraping⚡ Esecuzioni📈 Coverage♿ Accessibilità📄 Reports🔗 Integrazioni🛡️ Code Quality📦 Exports👤 Account
🧭

Primi passi

Come accedo e cambio workspace?

Accedi con le credenziali abilitate o con SSO, poi usa il selettore workspace in alto per cambiare contesto operativo.

  1. 1Apri la pagina di login e usa il metodo previsto dal tuo ente o team.
  2. 2Dopo l'accesso, controlla il workspace attivo nel selettore in header.
  3. 3Se devi lavorare su un altro workspace, selezionalo prima di aprire progetti o report.
  4. 4Se non vedi il workspace atteso, chiedi a un admin di verificare associazione e ruolo.
📊

Dashboard

Come leggo i KPI della Dashboard?

La Dashboard riassume stato globale di esecuzioni, pass rate, run accessibilità e violazioni critiche.

  1. 1Apri Dashboard dalla sidebar.
  2. 2Leggi prima i KPI alti: esecuzioni totali, pass rate globale, run accessibilità e violazioni critiche.
  3. 3Usa i grafici per capire trend e distribuzione progetti.
  4. 4Apri il progetto interessato se un dato aggregato richiede dettaglio.
📁

Progetti

Come creo un progetto?

Da Projects crea una scheda progetto con nome, descrizione, URL applicativo e configurazioni di automazione richieste.

  1. 1Apri Projects dalla sidebar.
  2. 2Usa il comando di creazione progetto.
  3. 3Compila nome, descrizione e URL base dell'applicativo da testare.
  4. 4Associa utenti e responsabilità prima di avviare TestBook o esecuzioni.
🗺️

Phase 1

Perché alcune tab progetto sono bloccate?

Le tab operative avanzate vengono sbloccate dopo chiusura Phase 1 e export handoff, per garantire governance e tracciabilità.

  1. 1Apri dettaglio progetto e controlla la tab Phase 1.
  2. 2Completa timeline, team, requisiti, analisi, TestBook v0 ed export.
  3. 3Quando la fase raggiunge design handoff, le tab operative (TestBook, Scraping, Accessibility, Executions, Coverage) diventano disponibili.
⚠️Il blocco evita esecuzioni su requisiti non approvati o non tracciati.
🎓

Onboarding AI

Come carico documenti in Onboarding AI?

La tab Documenti raccoglie fonti per wiki, Q&A e analisi: upload file, SharePoint e repository.

  1. 1Apri progetto e tab Onboarding AI.
  2. 2Vai a Documenti.
  3. 3Carica file supportati o scegli fonte SharePoint/repository se configurata.
  4. 4Attendi stato Indicizzato prima di usare fonte in wiki o analisi.
📋

TestBook

Come preparo un TestBook?

Il TestBook raccoglie casi di test, prerequisiti, step e risultati attesi. Va mantenuto leggibile e verificabile.

  1. 1Apri il progetto e seleziona la sezione TestBook.
  2. 2Crea o importa casi di test con titolo descrittivo.
  3. 3Per ogni caso indica prerequisiti, passi atomici e risultato atteso.
  4. 4Usa revisioni e versioni per congelare contenuti prima dell'esecuzione.
⚠️Evita step ambigui: ogni passo deve produrre un esito osservabile.

Come importo casi di test da Excel?

L'import consente anteprima, validazione e caricamento massivo di casi e step nel TestBook.

  1. 1Apri tab Test Book del progetto.
  2. 2Usa import e seleziona file nel formato previsto.
  3. 3Controlla anteprima: titoli, feature, step, dati e risultati attesi.
  4. 4Correggi righe non valide prima di confermare caricamento.
🕷️

Scraping

Come avvio una run di scraping?

Una run raccoglie pagine ed elementi interattivi; i risultati alimentano mapping e readiness automazione.

  1. 1Apri tab Scraping e sotto-tab Runs.
  2. 2Verifica disponibilità Selenium Grid se usi Selenium.
  3. 3Usa Quick Scan per prova rapida o run completa per discovery estesa.
  4. 4Monitora stato run e apri Results quando completata.
⚡

Esecuzioni

Come avvio una esecuzione?

Dal progetto scegli i casi di test pronti, controlla configurazione browser/engine e avvia la run.

  1. 1Controlla che URL progetto e credenziali di test siano corretti.
  2. 2Seleziona set di casi o versione TestBook da eseguire.
  3. 3Avvia la run e monitora stato, log e risultati progressivi.
  4. 4In caso di errore tecnico, consulta log e screenshot prima di aprire difetto.

Come scelgo Selenium, Playwright o Cypress?

La scelta engine dipende da ambiente, tipo test, vincoli browser e supporto a funzionalità target.

  1. 1Usa Selenium quando serve compatibilità grid o scenari enterprise consolidati.
  2. 2Usa Playwright quando servono stabilità moderna, browser multipli e diagnosi robuste.
  3. 3Usa Cypress per flussi web same-origin dove runner e applicazione sono compatibili.
  4. 4Confronta durata e success rate nella pagina Engine Comparison.
📈

Coverage

Come leggo la readiness automazione?

Coverage misura quanto TestBook e mapping elementi sono pronti per generazione ed esecuzione automatica.

  1. 1Apri tab Coverage del progetto.
  2. 2Leggi summary card: ready, partial, low confidence e non mappati.
  3. 3Controlla tabella casi e step con problemi.
  4. 4Ritorna a Scraping per migliorare mapping quando necessario.
♿

Accessibilità

Come interpreto una violazione WCAG critica?

Una violazione critica può impedire accesso o completamento del compito a utenti con disabilità. Va trattata come priorità alta.

  1. 1Apri il report accessibilità del progetto.
  2. 2Filtra per impatto critical o serious.
  3. 3Leggi regola, nodo interessato e pagina.
  4. 4Condividi evidenza con chi corregge UI o markup.
  5. 5Riesegui audit dopo la correzione per chiudere evidenza.
⚠️Per contesti PA, conserva report esportati e data della verifica come evidenza di conformità.
📄

Reports

Come uso Reports Accessibilità?

Reports aggrega run completate, grafici impatto, violazioni per pagina, trend e download HTML/CSV.

  1. 1Apri Reports dalla sidebar.
  2. 2Seleziona tab Accessibilità, progetto e run completata.
  3. 3Leggi KPI e grafici prima della tabella aggregata.
  4. 4Scarica HTML dettagliato per revisione o CSV per analisi.
🔗

Integrazioni

Come collego Jira?

Da Integrations configura board e credenziali Jira per creare o sincronizzare issue collegate a test e risultati.

  1. 1Apri Integrations dalla sidebar.
  2. 2Verifica che le credenziali Jira siano presenti e valide.
  3. 3Associa board o progetto Jira al progetto TestFlow.
  4. 4Durante analisi fail, crea issue solo dopo aver verificato evidenza e riproducibilità.
🛡️

Code Quality

Come leggo Code Quality?

Code Quality usa snapshot Sonar per mostrare quality gate, bug, vulnerabilità, code smell e coverage codice.

  1. 1Apri progetto e tab Code Quality.
  2. 2Controlla quality gate prima delle singole metriche.
  3. 3Leggi bug e vulnerabilità con priorità rispetto ai code smell.
  4. 4Verifica data ultimo snapshot per evitare decisioni su dati vecchi.
📦

Exports

Come consulto lo storico export?

La tab Exports centralizza file generati, stato, formato, scadenza e possibilità di download o rigenerazione.

  1. 1Apri progetto e tab Exports.
  2. 2Filtra per tipo export o stato se lista è lunga.
  3. 3Scarica file completati ancora disponibili.
  4. 4Rigenera export scaduti quando la funzione lo consente.
👤

Account

Come cambio tema chiaro, scuro o sistema?

Da Impostazioni puoi scegliere tema chiaro, scuro o sistema; la scelta resta salvata nel browser.

  1. 1Apri Settings dalla sidebar.
  2. 2Nella sezione Tema scegli Chiaro, Scuro o Sistema.
  3. 3Verifica leggibilità su pagine operative che usi più spesso.

Come collego account SSO?

Account connessi permette di collegare provider come Microsoft, GitHub, Atlassian o Google se abilitati.

  1. 1Apri Settings.
  2. 2Vai ad Account connessi.
  3. 3Premi Collega sul provider abilitato.
  4. 4Completa consenso sul provider esterno.
⚠️Non scollegare l'ultimo metodo di accesso se non hai password alternativa configurata.