> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/sito-web/modello-comuni/pubblicare-dati-e-statistiche-del-comune-dataset.md). # Pubblicare dati e statistiche del Comune (Dataset)
Dataset **Dataset** è la classe che rappresenta raccolte di dati pubblicate dall'ente in formato aperto, consultabili e scaricabili dai cittadini. Identificatore > dataset | Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile | | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------ | ----------- | | Titolo (title) | Titolo del dataset. Si raccomanda di inserire un testo semplice e corto. Esempi di titoli di dataset –> «Contratti del Sistema Pubblico di Connettività (SPC)» oppure «Luoghi ed eventi della cultura». | Linea di testo (ezstring) | X | X | | Descrizione breve (abstract) | Descrizione del dataset. Si raccomanda di fornire una breve descrizione dei contenuti principali del dataset. Evitare di utilizzare un linguaggio ricco di riferimenti normativi. Utilizzare invece un linguaggio semplice che possa aiutare qualsiasi utente a identificare il contenuto del dataset. Esempi–> «Il dataset contiene i dati sui contratti del Sistema Pubblico di Connettività (SPC) relativi al Lotto 1 dell’anno 2007.» | Blocco di testo (eztext) | X | X | | Categorie tematiche (theme) | Temi di cui tratta il dataset | Tags (eztags) | X | X | | Formato (format) | Formato del file di distribuzione del dataset. Per i formati si richiede l'uso del vocabolario controllato disponibile in | Tags (eztags) | X | X | | Licenza (license) | Selezionare la licenza, valida per tutti i dati raccolti in questo dataset | Tags (eztags) | X | X | | Risorse (resources) | | Matrice (ezmatrix) | | X | | Risorsa (download\_url) | Link per scaricare la risorsa | URL (ezurl) | | | | Risorsa (download\_file) | File contenente il dataset | File multipli (ocmultibinary) | | X | | Risorsa strutturata (csv\_resource) | | CSV Dataset (opendatadataset) | | | | Data di ultima modifica (modified) | Data di ultima modifica dei dati contenuti nel dataset | Data (ezdate) | X | X | | Titolare (rights\_holder) | Sulla base anche di quanto indicato all’art.2 lettera i) del D. Lgs. n. 36/2006, il titolare del dataset è la pubblica amministrazione o l’organismo di diritto pubblico che ha originariamente formato per uso proprio o commissionato ad altro soggetto pubblico o privato il documento che rappresenta il dato, o che ne ha la disponibilità. Il titolare è pertanto responsabile della gestione complessiva del dataset in virtù dei propri compiti istituzionali.Si fa presente che, nell’ambito della presente ontologia, l’accezione di documento suddetta può essere intesa riferita al dataset. E' bene evitare di specificare nomi di singole persone. | Relazioni oggetti (ezobjectrelationlist) | X | X | | Frequenza di aggiornamento (accrualperiodicity) | Utilizzare il vocabolario controllato europeo: | Tags (eztags) | X | X | | Altro identificatore (identifier) | Identificatore univoco del dataset nell'archivio comunale | Linea di testo (ezstring) | | X | | Copertura geografica (spatial) | Indicare a quali aree geografiche si riferiscono i dati | Comuni italiani (openpacomuniitaliani) | X | X | | Data di rilascio (issued) | Data ufficiale di rilascio (pubblicazione) del dataset | Data (ezdate) | | X | | Estensione temporale (temporal) | Periodo di tempo a cui i dataset si riferiscono | Relazioni oggetti (ezobjectrelationlist) | | X | | Autore/i del dataset (creator) | una o più entità (organizzazione/i) che hanno materialmente prodotto il Dataset. Evitare di indicare nomi di singole persone | Relazioni oggetti (ezobjectrelationlist) | | X | | Editore (publisher) | Organizzazione che è responsabile di rendere disponibile il dataset | Relazioni oggetti (ezobjectrelationlist) | | X | | Standard di conformità (conforms\_to) | | Tags (eztags) | | X | | Lingua (language) | | Tags (eztags) | X | X | | Versione (version\_info) | | Linea di testo (ezstring) | | X | | Punti di contatto (contact\_point) | Contatto da usare per avere maggiori informazioni sul dataset | Relazioni oggetti (ezobjectrelationlist) | | X | | Parole chiave (keyword) | Parole chiave che definiscono meglio le tematiche trattate dal dataset. Usare la virgola per separarle | Linea di testo (ezstring | | X |
{% hint style="warning" %} Per poter creare un Dataset, è necessario che ti sia stato concesso il [permesso apposito](/sito-web/la-piattaforma/accedere-alla-piattaforma/attribuzione-dei-permessi.md#modificare-il-sistema-di-permessi). {% endhint %} ## Vai alla sezione "Amministrazione" Collocati nella sezione "Amministrazione" (1) e scegli la sotto-sezione "Documenti e dati" (2). Una volta qui, scegli la categoria "Dataset" (3)
## Crea il Dataset Dopo aver scelto la categoria, procedi alla [creazione del contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-un-nuovo-contenuto.md).
Inserisci un titolo che sia semplice e comprensibile per il cittadino (max. 60 caratteri).
Successivamente, compila la descrizione breve del contenuto. Per essere efficace, la descrizione breve **non deve superare i 160 caratteri**.
## Specifica la licenza di distribuzione {% hint style="warning" %} Sul sito comunale i dati, documenti, immagini e informazioni devono essere pubblicati con licenza aperta. In applicazione del [principio open by default](https://docs.italia.it/italia/design/lg-design-servizi-web/it/versione-corrente/requisiti.html#licenze) e salvo dove diversamente specificato (compresi i contenuti incorporati di terzi), i dati, i documenti e le informazioni pubblicati sul sito devono essere taggati con la licenza **CC-BY 4.0.** {% endhint %} Indica la corretta licenza di distribuzione: selezionala dal menù ad albero tramite barra di selezione (1) o cercala manualmente tra le opzioni disponibili (2)
## Struttura il dataset Per organizzare il dataset, devi prima di tutto strutturare il file di ingresso e importare le definizioni dei vari campi da file CSV o Google Spreadsheet.
Una volta fatto, clicca su "Modifica la definizione dei campi" e struttura le informazioni da riportare sul dataset.
Per ogni campo del Dataset, puoi modificare il nome (1) e selezionare la tipologia dal menù a tendina (2)
Successivamente clicca su "Modifica le impostazioni di visualizzazione" per configurare la rappresentazione dei dati ("Visualizzazioni").
Sempre qui, puoi modificare i filtri utilizzabili dagli utenti.
Alla fine, nella sezione "Tabella", indica: * i campi da mostrare (1); * il tipo di visualizzazione della tabella (2); * l'ordinamento (3).
Una volta pubblicato il contenuto, **da interfaccia di front-end** importa i dati da file CSV o Google Sheet.
## Specifica il tema Seleziona dal menù ad albero i temi di riferimento del Dataset.
## Indica il formato di distribuzione Specifica in quale formato stai mettendo a disposizione il contenuto.
## Scegli il titolare Designa il titolare del contenuto [creando una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il Dataset e una [Unità organizzativa](/sito-web/modello-comuni/gestire-lorganigramma-del-comune.md).
## Frequenza di aggiornamento e copertura geografica Seleziona dal menù ad albero la frequenza di aggiornamento del Dataset (1) e specifica la copertura geografica del contenuto tramite il menù a tendina (2)
## Indica la lingua Specifica la lingua con cui metti a disposizione il contenuto
## Pubblica il contenuto Una volta compilati i campi obbligatori, [pubblica il contenuto](https://app.gitbook.com/o/-MRQtav6dxPB0RkAwAX7/s/fYDGLbEkTaK5gywjDOEN/~/changes/14/funzioni-generali/pubblicare-un-contenuto) sul sito web.
Dataset **Dataset** è la classe che rappresenta raccolte di dati pubblicate dall'ente in formato aperto, consultabili e scaricabili dai cittadini. Identificatore > dataset | Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile | | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------ | ----------- | | Titolo (title) | Titolo del dataset. Si raccomanda di inserire un testo semplice e corto. Esempi di titoli di dataset –> «Contratti del Sistema Pubblico di Connettività (SPC)» oppure «Luoghi ed eventi della cultura». | Linea di testo (ezstring) | X | X | | Descrizione breve (abstract) | Descrizione del dataset. Si raccomanda di fornire una breve descrizione dei contenuti principali del dataset. Evitare di utilizzare un linguaggio ricco di riferimenti normativi. Utilizzare invece un linguaggio semplice che possa aiutare qualsiasi utente a identificare il contenuto del dataset. Esempi–> «Il dataset contiene i dati sui contratti del Sistema Pubblico di Connettività (SPC) relativi al Lotto 1 dell’anno 2007.» | Blocco di testo (eztext) | X | X | | Categorie tematiche (theme) | Temi di cui tratta il dataset | Tags (eztags) | X | X | | Formato (format) | Formato del file di distribuzione del dataset. Per i formati si richiede l'uso del vocabolario controllato disponibile in | Tags (eztags) | X | X | | Licenza (license) | Selezionare la licenza, valida per tutti i dati raccolti in questo dataset | Tags (eztags) | X | X | | Risorse (resources) | | Matrice (ezmatrix) | | X | | Risorsa (download\_url) | Link per scaricare la risorsa | URL (ezurl) | | | | Risorsa (download\_file) | File contenente il dataset | File multipli (ocmultibinary) | | X | | Risorsa strutturata (csv\_resource) | | CSV Dataset (opendatadataset) | | | | Data di ultima modifica (modified) | Data di ultima modifica dei dati contenuti nel dataset | Data (ezdate) | X | X | | Titolare (rights\_holder) | Sulla base anche di quanto indicato all’art.2 lettera i) del D. Lgs. n. 36/2006, il titolare del dataset è la pubblica amministrazione o l’organismo di diritto pubblico che ha originariamente formato per uso proprio o commissionato ad altro soggetto pubblico o privato il documento che rappresenta il dato, o che ne ha la disponibilità. Il titolare è pertanto responsabile della gestione complessiva del dataset in virtù dei propri compiti istituzionali.Si fa presente che, nell’ambito della presente ontologia, l’accezione di documento suddetta può essere intesa riferita al dataset. E' bene evitare di specificare nomi di singole persone. | Relazioni oggetti (ezobjectrelationlist) | X | X | | Frequenza di aggiornamento (accrualperiodicity) | Utilizzare il vocabolario controllato europeo: | Tags (eztags) | X | X | | Altro identificatore (identifier) | Identificatore univoco del dataset nell'archivio comunale | Linea di testo (ezstring) | | X | | Copertura geografica (spatial) | Indicare a quali aree geografiche si riferiscono i dati | Comuni italiani (openpacomuniitaliani) | X | X | | Data di rilascio (issued) | Data ufficiale di rilascio (pubblicazione) del dataset | Data (ezdate) | | X | | Estensione temporale (temporal) | Periodo di tempo a cui i dataset si riferiscono | Relazioni oggetti (ezobjectrelationlist) | | X | | Autore/i del dataset (creator) | una o più entità (organizzazione/i) che hanno materialmente prodotto il Dataset. Evitare di indicare nomi di singole persone | Relazioni oggetti (ezobjectrelationlist) | | X | | Editore (publisher) | Organizzazione che è responsabile di rendere disponibile il dataset | Relazioni oggetti (ezobjectrelationlist) | | X | | Standard di conformità (conforms\_to) | | Tags (eztags) | | X | | Lingua (language) | | Tags (eztags) | X | X | | Versione (version\_info) | | Linea di testo (ezstring) | | X | | Punti di contatto (contact\_point) | Contatto da usare per avere maggiori informazioni sul dataset | Relazioni oggetti (ezobjectrelationlist) | | X | | Parole chiave (keyword) | Parole chiave che definiscono meglio le tematiche trattate dal dataset. Usare la virgola per separarle | Linea di testo (ezstring | | X |
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.opencityitalia.it/sito-web/modello-comuni/pubblicare-dati-e-statistiche-del-comune-dataset.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.