> 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/un-esempio-pratico-creare-una-lista-di-candidati-alle-elezioni.md).

# Un esempio pratico: creare una lista di candidati alle elezioni

Qui trovi un esempio di dataset utilizzato per elencare i candidati alle elezioni comunali

{% hint style="info" %}
Sulla piattaforma demo di OpenCity Italia, puoi vedere un [esempio pratico](https://www.comune.bugliano.pi.it/Amministrazione/Documenti-e-dati/Dataset/Elezioni-comunali-2025-Candidati-Liste-e-Curricula) di dataset dedicato ai candidati alle elezioni comunali
{% endhint %}

## Crea il dataset

Accedi alla [pagina dedicata ai dataset](/sito-web/modello-comuni/pubblicare-dati-e-statistiche-del-comune-dataset.md#vai-alla-sezione-amministrazione) e procedi alla [creazione del contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-un-nuovo-contenuto.md).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-16052d511b6ec4513e67cd5d6bcdafad0a9289c1%2Fimage%20(76).png?alt=media" alt=""><figcaption></figcaption></figure>

## Struttura le informazioni del dataset

Nel campo "Risorsa strutturata" del contenuto, importa le definizioni dei campi caricando il Google Sheet delle farmacie (es. <https://docs.google.com/spreadsheets/d/1vrxdVuMsIGwPgUqC4OjJ8hp6JTtbu18C5PEsWQKVC7U/edit?usp=sharing>)

{% hint style="info" %}
Puoi utilizzare il fac-simile allegato in precedenza anche per altre liste di utenti.
{% endhint %}

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-bb385f63cd3a81659371d6987ba557f66eeb4c3c%2Fimage%20(77).png?alt=media" alt=""><figcaption></figcaption></figure>

Successivamente, modifica le definizioni dei campi importati

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-fcfc3af1e416b47ae01dfa655bd217740b778802%2Fimage%20(62).png?alt=media" alt=""><figcaption></figcaption></figure>

## Indicare il link al curriculum del candidato

{% hint style="warning" %}
Per indicare i link ai curricula dei candidati, è necessario che:

* i curricula siano stati pubblicati nella sezione "Documenti e dati" del sito;
* i link siano presenti nel file impostato e costruiti come quelli del [file di esempio](https://docs.google.com/spreadsheets/d/1vrxdVuMsIGwPgUqC4OjJ8hp6JTtbu18C5PEsWQKVC7U/edit?usp=sharing).
  {% endhint %}

Se vuoi inserire il link al curriculum del candidato, inserisci un campo "Curriculum" di tipo ""URL con etichetta (elemento html a con href)"

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-1352279b22ec8f30ca93fea5e6f132590abe8fbc%2Fimage%20(63).png?alt=media" alt=""><figcaption></figcaption></figure>

## Configura le impostazioni di visualizzazione

Una volta modificati i campi, configura le impostazioni di visualizzazione.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-6499f271645eac5e75b5a309ffa3bc36cab4720a%2Fimage%20(64).png?alt=media" alt=""><figcaption></figcaption></figure>

Nella sezione "Visualizzazioni", seleziona la voce "Tabella".

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-089527569c63ed9b128e502f1c4d91e7051bc074%2Fimage%20(65).png?alt=media" alt=""><figcaption></figcaption></figure>

## Indica i filtri di ricerca

Nella sezione "Filtri di ricerca" indica i filtri utilizzabili dal cittadino per la ricerca dei contenuti del dataset.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-7d202763bbadb0a01b9a95f2e8e2aa55384c1974%2Fimage%20(66).png?alt=media" alt=""><figcaption></figcaption></figure>

Per attivare la ricerca per parola chiave, abilita la funzione "Mostra motore di ricerca"

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-b6efeae56e265f9ead0d554175a432b254a702bf%2Fimage%20(67).png?alt=media" alt=""><figcaption></figcaption></figure>

## Configura la tabella

Nella sezione "Tabella", seleziona i campi mostrati all'interno della tabella.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-f44d3edb3ee1de196144a729b59d053c180f64b3%2Fimage%20(68).png?alt=media" alt=""><figcaption></figcaption></figure>

## Importa i dati del file

Una volta [pubblicato il contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/pubblicare-un-contenuto.md), clicca su "Importa da Google Sheet" per importare i dati del file.

<div><figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-e245e589cff5f3bc7b798ca5193b049f05484a87%2Fimage%20(69).png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-a553be337eacdce836014bc7fad6fb5d51176654%2FScreenshot%20(2).png?alt=media" alt=""><figcaption></figcaption></figure></div>

Successivamente, indica il foglio del file da cui devono essere importate le informazioni (1) e clicca su "Importa" (2).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-0985c328bbb7353ac79d11bc06f029c7f067d626%2Fimage%20(70).png?alt=media" alt=""><figcaption></figcaption></figure>

Nel caso in cui si tratti di un aggiornamento dei dati, attiva la voce "Elimina tutti i tuoi dati esistenti".

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-bd00e5c1a385d20def423d1136953dab9647a3c3%2Fimage%20(1190).png?alt=media" alt=""><figcaption></figcaption></figure>

### Attivare l'aggiornamento automatico

Durante l'importazione, puoi attivare la funzione di aggiornamento automatico dei contenuti: questo ti permette di modificare direttamente il file, senza doverlo importare ogni volta in caso di modifica.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-8e04343b155efb9db835aada13b2b4dd346050a7%2Fimage%20(71).png?alt=media" alt=""><figcaption></figcaption></figure>

Se attivata, la funzione ti permette di indicare la frequenza di aggiornamento (1) e la data e l'ora di inizio (2).

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-5c82cc4a3c09f7f70dab5d1661f4b5987219d24e%2Fimage%20(72).png?alt=media" alt=""><figcaption></figcaption></figure>

## Usare il dataset

Una volta importato il file, i dati presenti verranno mostrati nel dataset, strutturati in base alle configurazioni fatte sul contenuto.

<figure><img src="https://3823931934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfYDGLbEkTaK5gywjDOEN%2Fuploads%2Fgit-blob-80de2765248f72e8354527025df406de1015c8d7%2Fimage%20(73).png?alt=media" alt=""><figcaption></figcaption></figure>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.opencityitalia.it/sito-web/modello-comuni/pubblicare-dati-e-statistiche-del-comune-dataset/un-esempio-pratico-creare-una-lista-di-candidati-alle-elezioni.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.