Procedura per il caricamento dei dataset open data e metadati sul portale del comune di Palermo

Questo breve manuale descrive le procedure che i referenti tecnici e tematici open data degli uffici devono seguire passo passo per caricare i dataset nel portale del comune di Palermo https://opendata.comune.palermo.it.

Riferimenti per il caricamento

Ciro Spataro - c.spataro@comune.palermo.it - tel. 091.7407340

Settore Direzione Generale - Servizio Innovazione - UO “Transizione al digitale”

Il portale open data comunale

Il portale https://opendata.comune.palermo.it/ è il portale open data del comune di Palermo operativo dal dicembre 2017.

Il portale è conforme allo standard nazionale DCAT_AP_IT delle Linee Guida nazionali AGID per la valorizzazione del patrimonio informativo pubblico. Essere “conforme allo standard nazionale DCAT_AP_IT” per un portale istituzionale, significa che i dataset del portale open data del comune di Palermo sono automaticamente esposti nel portale nazionale open data https://www.dati.gov.it/ upe sempre automaticamente vengono esposti nel portale europeo dei dati in formato aperto http://europeandataportal.eu.

Le procedure di caricamento dei dataset e dei metadati rispetto alla vecchia versione del portale sono mutate anche se non sono stravolte, e procedere al caricamento con il nuovo pannello di controllo risulta anche un’attività più semplice.

Accesso al pannello di controllo

Per accedere al pannello di controllo, abilitante al caricamento dei dataset e dei metadati, andare al link https://www.comune.palermo.it/admin/ (figura 1).

Cliccando sulla freccia rossa si aprono i campi per l’inserimento del numero della matricola e della password.

La password è quella che il referente comunale open data ha ricevuto dal webmaster e che è stata utilizzata per i precedenti caricamenti di dataset sulla vecchia versione del portale open data.

IMG1

(figura 1)

A questo punto si apre il pannello di controllo (figura 2)

IMG2

(figura 2)

Si clicca su “Gestione Opendata” (figura 3)

IMG3

(figura 3)

E si apre questa schermata con il puls pulsante “Gestione Metadato” e sotto “Gestione Opendata” (figura 4)

IMG4

(figura 4)

Inserimento dei metadati del dataset

Premessa: come nella vecchia versione del pannello di caricamento dei dataset, anche nella nuova versione si costruisce prima il metadato che accompagna il dataset e successivamente si carica il dataset come allegato.

Si clicca “Gestione Metadato” (figura 5) e si apre un pannello in cui è possibile già vedere i dataset caricati.

Quindi è possibile cominciare a creare un NUOVO metadato, cliccando sul tasto azzurro “Nuovo”.

IMG5

(figura 5)

Si inizia, quindi a compilare i campi per la formazione dei metadati (figura 6).

Campo TAG

Nella pagina del metadato, particolare attenzione deve essere posta nella compilazione del campo TAG. Bisogna inserire le parole di TAG, separate da virgola , e seguite da uno spazio, poi di nuovo la parola del TAG, seguita da , e seguita da spazio, e così via nel caso si debbano inserire due o più tag.

Una volta terminata la compilazione dei campi dei metadati, si clicca in basso su “Conferma immissione”.

IMG6

(figura 6)

Caricamento del dataset

Conclusa la fase di caricamento dei metadati, cioè le informazioni per spiegare cosa il dataset contiene al suo interno, si passa alla fase finale di caricamento del dataset.

Per attivare il caricamento, si parte dal catalogo dei titoli dei dataset elencati nella schermata (figura 7) che si presenta subito dopo aver concluso la fase di inserimento dei metadati.

Quindi si seleziona il titolo specifico del dataset che già abbiamo editato nella fase precedente e si clicca nel logo a forma di nuvoletta di colore azzurro con la freccia verso l’alto.

IMG7

(figura 7)

Si procede a cliccare sul tasto nero “Allegati metadato” (figura 8)

IMG8

(figura 8)

Si apre un’altra schermata (figura 9) e si procede a cliccare sul tasto azzurro “Nuovo

IMG9

(figura 9)

Si apre la schermata (figura 10) e si continua selezionando il campo a destra –Seleziona un valore

IMG10

(figura 10)

Si apre la schermata (figura 11) e si seleziona il formato di dataset da caricare.

Nella stessa schermata si procede a inserire un breve testo nel campo NOTE. Si può anche scrivere il titolo del dataset, lo stesso titolo utilizzato nella parte precedente per la titolazione del dataset.

Una volta effettuate queste due operazioni si clicca sul tasto in basso a destra “Conferma immissione

IMG11

(figura 11)

La schermata successiva (figura 12) si apre con un messaggio: “Inserimento avvenuto con successo”.

Quindi si passa all’ultima operazione che è quella di caricamento del file sul pannello di controllo.

Si clicca sul tasto in basso a destra “Carica allegato” e si seleziona dal pc il file da caricare.

Nota

Il nome del file deve essere scritto in minuscolo e senza alcun carattere particolare (come “_” , “/” , “,” “;”, ecc). E’ consigliabile usare una parola breve, tanto il pannello di controllo provvederà in automatico a rinominare il file una volta caricato online.

Una volta ultimato il caricamento del file, esso è reso immediatamente visibile nel portale online open data.

IMG12

(figura 12)

Nota

da tenere presente prima della procedura di caricamento del dataset nel pannello “allegati”

Nel pannello di caricamento del dataset a destra c’è un’icona a forma di nuvoletta di colore azzurro (figura 13).

Cliccando su questa icona si ha la visualizzazione del dataset.

IMG13

(figura 13)

Se la procedura di caricamento non è andata a buon fine cliccando su questa icona (a forma di nuvoletta di colore azzurro) verrà restituito un messaggio di errore “Not Found” come di seguito in figura 14:

IMG14

(figura 14)

Attenzione

Una volta effettuato il caricamento del dataset sul pannello di controllo può capitare che lo stesso caricamento non sia andato a buon fine, in questo caso non viene visualizzato il messaggio di: file caricato con il nome xxxxxxx.CSV.

Significa che il dataset, in formato CSV, non supera la validazione del pannello di caricamento.

Il dataset in formato CSV

Se il formato del dataset è di tipo CSV è auspicabile impostare come separatore di campi, il “punto e virgola” ; al fine di permettere la validazione con esito positivo dello stesso dataset da parte del software che gestisce il caricamento online sul portale open data del comune.

Suggerimento

Un buon articolo che tratta l’argomento del file in formato CSV è disponibile a questo link. (File CSV: cosa sono, come si aprono e come crearli. Impariamo cosa sono i file CSV, come sono strutturati e quali strumenti abbiamo a disposizione per aprirli e crearne di nuovi).

Al fine di ottenere un file CSV con il “punto e virgola” ; come separatore dei campi è possibile vedere questo brevissimo tutorial:

LibreOffice Calc: cambiare il separatore del CSV

Nel fare questa operazione, disabilitare l’interpretazione del tipo campo all’apertura del CSV (impostare come «testo» tutti campi del CSV), come si vede nel video di seguito:

LibreOffice Calc: disabilitare l'interpretazione del tipo campo all'apertura del CSV

Validazione dei formati CSV prima del caricamento

Importante

Al fine di evitare quanto sopra indicato è consigliabile, prima di effettuare il caricamento del dataset nel pannello di controllo, sottoporre il dataset ad una validazione da far fare ad un validatore online. Ecco due esempi di validatori online:

  • https://csvlint.io (si procede, quindi, a caricare il file CSV in questo sito, seguendo le indicazioni del sito. Premendo il tasto VALIDATE si avrà la restituzione degli eventuali errori con la riga in cui si trovano tali errori, se presenti nel dataset).
  • https://try.goodtables.io.

I due siti permettono di identificare e correggere eventuali errori nel dataset in formato CSV e solo in seguito si continua con il caricamento nel pannello di controllo del portale open data.

Supporto nelle procedure di caricamento

[Per eventuali problemi riscontrati in questa procedura di validazione del dataset, si potrà sempre fare riferimento, per aiuto, a Ciro Spataro c.spataro@comune.palermo.it - tel. 0917407340]