Selezionare la risorsa semantica

Seleziona la risorsa semantica che intendi validare scegliendo tra: ontologia, un vocabolario controllato o uno schema dati. È possibile caricare un file in formato Turtle (.ttl) tramite l’interfaccia del validatore, scegliendolo dal proprio dispositivo o da una sorgente specificata.

Clicca su “Upload” per selezionare il file Turtle (.ttl) da caricare all’interno del validatore.

 

Immagine descrittiva della schermata di caricamento

Nota bene

Prima di procedere con la validazione della risorsa, è necessario verificare che la risorsa semantica sia conforme alle regole definite nella Guida al Catalogo .

Validazione della risorsa semantica

Dopo aver selezionato e caricato la risorsa semantica, è possibile procedere con la validazione.

Clicca su “Valida documento” per avviare il processo di controllo del file Turtle caricato. Il validatore analizzerà la risorsa per individuare eventuali errori o warning nei metadati, restituendo un report dettagliato dell’esito.

Immagine descrittiva della pagina di validazione delle risorse semantiche

Nota Bene

Si consiglia di esaminare attentamente i messaggi restituiti al termine della validazione per correggere eventuali criticità prima della pubblicazione della risorsa.

Possibili esiti

Una volta che si è proceduto con la validazione del documento, il sistema potrebbe segnalare tre possibili esiti:

  • Errore
  • Warning
  • Esito positivo

Errore

In caso di errore durante la validazione, il sistema segnala automaticamente la presenza di problemi nel file.

Immagine descrittiva di esempio di errore di validazione

Nota

Quando viene rivelato un errore, il validatore mostrerà una lista numerata di errori e una breve descrizione dell’errore rilevato
Inoltre, è possibile scaricare la lista completa degli errori riscontrati, utile per effettuare un’analisi approfondita e correggere il file Turtle.

Nota bene: i messaggi di Errore sono “bloccanti”. Qualora siano presenti degli errori non risolti, il processo di harvesting non sarà in grado di acquisire i metadati della risorsa e pertanto tale risorsa non sarà caricata sul catalogo.
Si segnala inoltre che, mentre i Warning vengono restituiti tutti congiuntamente, i messaggi di errore vengono restituiti uno alla volta. In altre parole, se sono presenti più errori, il validatore restituirà solo il primo. Risolto l’errore, sarà necessario caricare nuovamente il file Turtle (.ttl) e verificare l’assenza o la presenza di ulteriori errori.

Esito "Warning"

Durante la validazione, oltre gli errori, il validatore può segnalare anche dei warning, ovvero avvisi che indicano potenziali problemi o mancanze nel file Turtle.

Immagine descrittiva di un esempio di warning relativo alla validazione

Nota

La lista dei warning mostra i problemi rilevati che, pur non impedendo la validazione del documento, possono compromettere la completezza o la correttezza dei metadati. Ogni warning fornisce informazioni tra cui:

  • L’URI della risorsa coinvolta;
  • La proprietà mancante o non riconosciuta;
  • La risorsa a cui si riferisce il problema.

Nota bene: i messaggi di avvertimento (warning) non sono bloccanti. Il processo di harvesting sarà in grado di acquisire i metadati. Tuttavia, è consigliabile, ma non obbligatorio, procedere con la risoluzione degli avvertimenti segnalati.

Esito positivo

Quando la validazione della risorsa semantica viene completata senza errori, il sistema restituisce un esito positivo, indicando che il file Turtle è conforme alle regole previste.
In caso di successo:

  • Non verranno segnalati errori nel documento;
  • Potrebbero comparire eventuali warning, che non impediscono la validazione ma suggeriscono miglioramenti.

 

Immagine descrittiva dell’esito positivo di validazione

Vai allo strumento

Domande Frequenti

Questo tipo di errore si incontra quando non sono esplicati tutti i campi obbligatori previsti dalla dcat_ap_it. L’errore indica che per la risorsa che è stata sottoposta al processo di validazione manca una proprietà/nodo/attributo.
Ad esempio, se nella risorsa manca la proprietà rightsHolder il validatore restituirà l’errore:
Cannot find node 'http://purl.org/dc/terms/rightsHolder' for resource […]
La proprietà che genera l’errore è specificata nel testo stesso dell’errore restituito dal validatore.
Sarà necessario intervenire sul file turtle, individuando nei metadati la presenza e la correttezza della proprietà rightsHolder, come ad esempio, per l’Istituto Nazionale di Statistica:
rightsHolder <https://w3id.org/italia/data/public-organization/ISTAT>;

Questo tipo di errore è spesso associato a quelli visti nella FAQ 1.
Se ad esempio l’errore riguarda il rightsHolder, sarà necessario intervenire sul file turtle, individuando nei metadati la presenza e la correttezza della proprietà rightsHolder, come ad esempio, per l’Istituto Nazionale di Statistica:
rightsHolder <https://w3id.org/italia/data/public-organization/ISTAT>;

Sì, solo i messaggi di Errore sono “bloccanti”. Qualora siano presenti degli errori non risolti, il processo di harvesting non sarà in grado di acquisire i metadati della risorsa e pertanto tale risorsa non sarà caricata sul catalogo. Al contrario, i messaggi di avvertimento (warning) non sono bloccanti. Il processo di harvesting sarà in grado di acquisire i metadati. Tuttavia, è consigliabile, ma non obbligatorio, procedere con la risoluzione degli avvertimenti segnalati.