Pubblicare un dato aperto non significa semplicemente rendere disponibile un file online. Perché un dataset possa essere realmente utilizzato da cittadini, imprese, ricercatori e altre amministrazioni deve essere correttamente strutturato, comprensibile, aggiornabile, documentato e facilmente riutilizzabile.

La Cassetta degli Attrezzi aiuta le Pubbliche Amministrazioni ad affrontare questo percorso in modo progressivo, fornendo indicazioni pratiche per:

• individuare e selezionare i dati da valorizzare;
• verificarne qualità, completezza e aggiornamento;
• organizzare correttamente dati e metadati;
• preparare dataset in formati aperti e riutilizzabili;
• pubblicare i dati sul portale regionale;
• rappresentare e valorizzare le informazioni attraverso grafici, mappe e altri strumenti digitali.

Il percorso è coerente con uno degli obiettivi centrali di Opentusk: supportare le amministrazioni nella produzione, pubblicazione e riutilizzo degli Open Data e contribuire alla crescita del patrimonio informativo pubblico regionale.

Per pubblicare dati di qualità è utile partire da una base comune: capire cosa rende un dato realmente aperto, utile e riutilizzabile, prima ancora di entrare negli aspetti tecnici della pubblicazione. La sezione introduce in modo semplice i principi fondamentali degli Open Data e i criteri FAIR – Findable, Accessible, Interoperable e Reusable, mostrando come si traducono concretamente nel lavoro di una Pubblica Amministrazione: scegliere formati aperti, descrivere correttamente i dati attraverso i metadati, utilizzare licenze adeguate, prestare attenzione alla privacy e programmare l'aggiornamento dei dataset.

È il punto di partenza della Cassetta degli Attrezzi: acquisita questa cornice, le guide successive accompagnano l'amministrazione nella scelta del dataset da pubblicare, nella preparazione di un CSV di qualità e nella pubblicazione su dati.puglia.it.

1. Capire gli Open Data e i principi FAIR

Il punto di partenza per comprendere perché pubblicare dati aperti e cosa rende un dataset realmente utile e riutilizzabile. La guida introduce i principi FAIR – Findable, Accessible, Interoperable e Reusable – e li collega alle attività concrete di una Pubblica Amministrazione: formati aperti, metadati, licenze, qualità, privacy e aggiornamento dei dati.

Scarica la guida “Capire gli Open Data e i principi FAIR”

2. Prima di iniziare: quale dataset pubblicare

Una guida per capire da quali dati partire prima di costruire il file da pubblicare. Aiuta l'amministrazione a individuare i dataset di propria competenza, valutarne disponibilità e qualità, verificare eventuali criticità legate alla privacy, controllare se dati analoghi sono già disponibili e individuare un template di riferimento. La guida utilizza anche il Paniere regionale dei dataset, costruito attraverso i laboratori territoriali e la consultazione pubblica di Opentusk, come punto di partenza per individuare i dati maggiormente richiesti dal territorio.

Scarica la guida “Prima di iniziare: quale dataset pubblicare”

3. Consulta il Paniere regionale dei dataset

Per aiutare le amministrazioni a individuare i dati da cui partire, Opentusk mette a disposizione una raccolta aggiornata dei dataset di interesse per il territorio pugliese. Gli elenchi integrano i fabbisogni emersi durante la consultazione pubblica realizzata nel 2023 con le nuove richieste raccolte nel corso del percorso Road to Hackathon Opentusk 2026, offrendo così una vista aggiornata dei dati che cittadini, imprese, Pubbliche Amministrazioni e altri attori del territorio hanno indicato come rilevanti. 

Scarica l'allegato 1 – Dataset di competenza dei Comuni

L'allegato rappresenta uno strumento operativo per verificare quali dataset possano essere nella disponibilità del proprio ente, individuare quelli di propria competenza e valutare progressivamente quali dati strutturare, aprire e pubblicare.

4. Template di riferimento

Per supportare le amministrazioni comunali nella strutturazione dei dati, sono stati predisposti specifici Template di riferimento per i dataset di competenza comunale:

Scarica template di riferimento Allegato 1 per i dataset di competenza dei Comuni

Questo documento riprende i dataset presenti nel relativo allegato e propone, dove possibile, una struttura di riferimento per la loro organizzazione, indicando i principali campi da utilizzare, la relativa descrizione e una riga di intestazione utilizzabile per la predisposizione del dataset. I template sono stati elaborati a partire dall'analisi di dataset analoghi già pubblicati sui portali nazionali e regionali, con l'obiettivo di offrire alle amministrazioni una base concreta da cui partire e favorire una maggiore omogeneità e confrontabilità dei dati pubblicati. Le strutture proposte non sono obbligatorie né esaustive: rappresentano un riferimento operativo che ogni ente può adattare alle caratteristiche e alla disponibilità dei propri dati.

Per facilitare ulteriormente il lavoro delle amministrazioni, sono inoltre disponibili i template in formato CSV relativi ai dataset per i quali è stata definita una struttura di riferimento. 

Scarica template CSV – Comuni

5. Come costruire un buon CSV

Una guida pratica per trasformare i dati già disponibili nell'ente – ad esempio un foglio Excel, una tabella, un elenco o un'estrazione da un gestionale – in un dataset strutturato e pronto per la pubblicazione. La guida illustra le principali regole per organizzare correttamente righe e colonne, uniformare date e valori, gestire i dati mancanti, evitare gli errori più comuni e salvare correttamente il file in formato CSV.

Scarica la guida “Come costruire un buon CSV”

6. Pubblicare su dati.puglia.it

Una volta preparato il dataset, questa guida accompagna l'amministrazione nel processo di pubblicazione sul portale Open Data della Regione Puglia.
Descrive il percorso dall'adesione dell'ente al portale fino alla compilazione dei metadati, al caricamento del CSV, alla pubblicazione e al successivo aggiornamento del dataset.

Scarica la guida “Pubblicare su dati.puglia.it”

7. Guida rapida: checklist e regole di naming

Uno strumento sintetico da tenere a disposizione mentre si lavora. Raccoglie in poche pagine le principali checklist di controllo del CSV e dei metadati, insieme alle regole per nominare correttamente file e colonne prima della pubblicazione.

Scarica la “Guida rapida”

10. Come organizzare l'ente per pubblicare

Pubblicare Open Data in modo continuativo non è solo una questione tecnica: è necessario capire chi fa cosa all'interno dell'amministrazione. La guida propone un modello organizzativo essenziale, chiarendo le funzioni da presidiare per scegliere i dati, prepararli e pubblicarli in maniera sostenibile nel tempo, con particolare attenzione al ruolo dell'RTD e degli uffici coinvolti.

Scarica la guida “Come organizzare l'ente per pubblicare”

La Cassetta degli Attrezzi accompagna la tua amministrazione lungo tutte le principali fasi del percorso Open Data: dalla scelta dei dataset alla loro preparazione e pubblicazione, fino all’organizzazione delle attività necessarie per mantenerli aggiornati nel tempo.

Le guide e gli strumenti disponibili possono essere utilizzati in sequenza o in base alle esigenze dell’ente, per rendere il processo più semplice, strutturato e replicabile.

Metti a valore i dati della tua amministrazione e contribuisci a far crescere il patrimonio Open Data della Puglia, clicca qui.