Smart School · Guida alla verifica

Validatore PA per scuole e Comuni: come usarlo e leggere i report

Smart School offre una verifica online dei siti pubblici basata sul software open source PA Website Validator NG. Questa guida aiuta a scegliere le opzioni e a interpretare i controlli sui modelli di sito di Designers Italia.

Il servizio è gestito da Smart School ed è indipendente: non è un servizio ufficiale dell’Agenzia per l’Italia Digitale (AgID). Il report descrive i controlli automatici eseguiti e non costituisce una certificazione o un’asseverazione.

Avvia una verifica

Come avviare una verifica

  1. Scegli il sito e il profilo

    Nel modulo seleziona Scuola oppure Comune e inserisci l’URL completo del sito pubblico, compreso https:// o http://.

  2. Imposta l’accuratezza e avvia

    Il sito deve essere raggiungibile da Internet. Dopo aver avviato la scansione, resta sulla pagina: l’analisi può richiedere alcuni minuti.

  3. Apri il report e approfondisci

    Al termine viene mostrato il collegamento al report. Consulta i dettagli dei controlli, le pagine analizzate e gli eventuali errori prima di intervenire sul sito.

Il servizio esegue una scansione alla volta. Se è occupato, attendi che la verifica in corso termini e riprova.

Scuola e Comune hanno controlli diversi

La scelta del tipo di ente determina il profilo di verifica. Seleziona Scuola per i siti degli istituti scolastici e Comune per i siti delle amministrazioni comunali. Il nome del dominio non sostituisce questa scelta.

Nei report delle scuole i codici sono C.SC.* per i criteri di conformità e R.SC.* per le raccomandazioni. Nel profilo Comune i controlli del sito includono codici C.SI.* e R.SI.*.

La verifica delle prestazioni ha un ruolo diverso nei due profili: R.SC.3.1 è una raccomandazione per le scuole; C.SI.4.1 è un criterio di conformità per i Comuni. Consulta il codice del controllo e la documentazione del modello selezionato.

Nei nuovi report NG il profilo è indicato nell’intestazione. Nell’archivio i report sono separati fra scuole e Comuni.

Quale accuratezza scegliere

L’accuratezza regola il campionamento delle pagine individuate dal validatore. Un campione più ampio può richiedere più tempo; il numero effettivo di pagine dipende dalla struttura del sito e dai collegamenti riconosciuti.

  • Minima (min): usa il campionamento più ridotto, utile per una prima verifica.
  • Suggerita (suggested): è l’opzione preselezionata nel modulo.
  • Alta (high): amplia il campione delle pagine individuate.
  • Completa (all): non applica il limite di campionamento alle pagine raccolte dal validatore.

“Completa” riguarda il campione di pagine raccolto: non garantisce l’esplorazione di ogni URL del sito né rende automatiche le verifiche che richiedono un esame manuale.

Criteri, raccomandazioni e informazioni

Il riepilogo del report NG riguarda i criteri di conformità verificati automaticamente. Le raccomandazioni e le verifiche informative compaiono separatamente e non concorrono all’esito generale.

I criteri descrivono i requisiti del modello; le raccomandazioni segnalano ulteriori aspetti da migliorare. Le verifiche informative riportano elementi da approfondire e possono non avere un punteggio o un esito di superamento.

Apri le sezioni del report per leggere il codice, la descrizione e i dettagli delle singole verifiche. La voce Diagnostica Lighthouse completa, quando presente, offre altre informazioni tecniche su prestazioni e accessibilità: i suoi punteggi non sostituiscono l’esito dei criteri del modello.

Per orientarti nel formato consulta la documentazione ufficiale su report e risultati.

Che cosa significano gli esiti

  • Superato / OK: il controllo ha dato esito positivo sulle pagine analizzate. Un OK generale riguarda i criteri automatici del report.
  • Non superato / KO: almeno un controllo ha rilevato una condizione che non soddisfa il requisito. Leggi le pagine e le evidenze indicate nel dettaglio.
  • Errore / X: un problema ha impedito di completare una verifica. Approfondisci l’errore, ad esempio una pagina non raggiungibile, prima di interpretare il risultato.

Un controllo in errore non dimostra da solo che il requisito sia rispettato o violato. Dopo una correzione, una nuova scansione aiuta a verificare il cambiamento; tempi di risposta e disponibilità del sito possono variare fra le esecuzioni.

Report pubblici, JSON e classifiche storiche

I risultati pubblicati si trovano negli archivi delle scuole e negli archivi dei Comuni. Puoi cercare il dominio, aprire l’HTML e scaricare il file JSON associato, quando disponibile.

Il formato JSON dei nuovi report NG raccoglie i controlli nell’oggetto audits. La proprietà specificScore, quando presente, distingue esito positivo (1), negativo (0) e errore (-1). Le voci informative possono esserne prive.

Le classifiche storiche delle scuole e le classifiche storiche dei Comuni usano il formato e i punteggi del precedente validatore. Non includono i nuovi report NG e i rispettivi punteggi non sono direttamente confrontabili.

Ogni report descrive una scansione eseguita in un momento preciso: considera la data e la versione del validatore quando consulti un risultato.

Quali verifiche restano da fare

Il validatore riconosce gli elementi e le pagine che riesce a raggiungere e analizzare. Contenuti dinamici, collegamenti non riconosciuti, pagine protette o errori di rete possono limitare la scansione.

I controlli automatici aiutano a individuare problemi, ma non esauriscono la valutazione di accessibilità, correttezza e qualità dei contenuti o tutti i requisiti della misura 1.4.1. La documentazione dei modelli prevede anche verifiche parzialmente automatizzate e manuali.

Usa il report per programmare gli interventi e confronta sempre le evidenze con il sito e con le fonti ufficiali. Un risultato positivo non certifica la conformità complessiva né garantisce l’esito di una procedura di asseverazione.

Fonti e documentazione

Smart School mette a disposizione l’interfaccia online e gli archivi. Il motore di analisi è PA Website Validator NG, il cui codice sorgente è pubblicato nel repository Italia.

Per informazioni sul servizio puoi contattare Smart School.

Domande frequenti

Devo installare un programma?

Per usare questo servizio online basta il browser. La scansione viene eseguita dal server di Smart School; per avviarla dalla pagina è necessario JavaScript.

Posso verificare un sito locale o una pagina con login?

Il modulo è destinato a siti pubblici raggiungibili da Internet. La modalità locale non è disponibile nell’interfaccia e il modulo non richiede credenziali di accesso.

Perché vedo una raccomandazione non superata ma un esito generale OK?

L’esito generale riguarda i criteri di conformità verificati automaticamente. Le raccomandazioni, comprese le prestazioni per le scuole, sono presentate separatamente.

Il report certifica la conformità del mio sito?

No. È un resoconto dei controlli automatici del validatore. Per una valutazione completa occorre svolgere anche le verifiche previste dalla documentazione ufficiale che il software non esegue.

Come condivido un risultato?

Apri il report nell’archivio e condividi il suo collegamento. Per analizzare i dati con altri strumenti puoi scaricare il JSON associato, quando disponibile.