# Guida rapida alla creazione di un servizio

Come abbiamo visto nel [capitolo precedente](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/una-checklist-per-la-realizzazione-di-un-servizio.md), la creazione completa di un servizio digitale può prevedere diversi passaggi di analisi, configurazione e verifica. Questo approccio garantisce un risultato molto accurato, ma può richiedere tempo.

Se il tuo obiettivo è digitalizzare rapidamente un procedimento già esistente, puoi semplificare il processo, concentrandoti solo sugli elementi essenziali. In questo modo potrai pubblicare il servizio in tempi brevi e contribuire più velocemente alla trasformazione digitale del tuo Ente.

Di seguito ti proponiamo un percorso pratico e snello per creare un servizio digitale con il service builder di OpenCity.

{% stepper %}
{% step %}

#### Non partire da zero: usa i template

Il primo passo è scegliere cosa digitalizzare. Perché ricostruire le fondamenta se hai già una casa pronta?

**Clona un servizio** **dal** [**catalogo**](/guida-alla-creazione-dei-servizi-digitali/il-catalogo-dei-servizi-digitali/catalogo-comuni.md) **di OpenCity Italia**!

I servizi presenti nel catalogo rappresentano infatti dei **template pronti all’uso**. Sono progettati secondo gli standard tecnici, normativi e di design della Pubblica Amministrazione e includono una struttura già organizzata di contenuti, componenti e flussi.

Partendo da questi modelli preconfigurati, l’Ente può **attivare e adattare rapidamente un servizio**, intervenendo solo sugli elementi specifici del proprio contesto amministrativo. In questo modo si riducono tempi e complessità di progettazione, mantenendo al tempo stesso coerenza, qualità e conformità agli standard della piattaforma.

{% hint style="info" %}
I servizi a catalogo, non inclusi nella configurazione di default, possono essere messi a disposizione contattando OpenCity LABS
{% endhint %}
{% endstep %}

{% step %}

#### Configura i dati minimi del servizio

Inserisci solo i dati minimi che identificano il servizio. Concentrati su:

* **Nome e Descrizione breve**: devono essere chiari e concisi;
* **Categoria**: per orientare il cittadino nel catalogo dei servizi dell'Ente;
* [**Tipologia di accesso**](/guida-alla-creazione-dei-servizi-digitali/le-configurazioni-del-servizio/indicare-il-tipo-di-autenticazione.md): definisci la modalità di autenticazione al servizio;
* [**Flusso**](/guida-alla-creazione-dei-servizi-digitali/le-configurazioni-del-servizio/identificare-il-flusso-di-lavoro.md): decidi se l'istanza dovrà essere approvata o meno.

<figure><img src="/files/p8GIKTsDCiXbbtSXencH" alt=""><figcaption><p>Dati minimi per la configurazione iniziale di un servizio digitale</p></figcaption></figure>

{% hint style="info" %}
Non cercare la perfezione subito: potrai rifinire questi e altri dettagli a ridosso della pubblicazione.
{% endhint %}
{% endstep %}

{% step %}

#### Elimina ciò che non serve

Se hai usato una copia, potresti ritrovarti con elementi superflui.

* **Elimina il superfluo**: se una pagina o un campo non serve, cancellalo senza timore. Un servizio snello è più facile da compilare per il cittadino e più veloce da gestire per te

<figure><img src="/files/82jFOOUWohzg5n75Mh8j" alt=""><figcaption><p>Eliminare pagine o componenti non necessari</p></figcaption></figure>
{% endstep %}

{% step %}

#### Costruisci con i componenti essenziali

{% hint style="warning" %}
Il componente [**OC - Richiedente con API key `applicant`** ](https://docs.opencityitalia.it/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/precompilazione-dei-dati#tabella-di-configurazione-del-once-only)è indispensabile per la creazione delle pratiche. Senza questo componente, la piattaforma non è in grado di creare le pratiche e il servizio non funzionerà correttamente.
{% endhint %}

Aggiungi i campi necessari per raccogliere le informazioni. Per ogni componente, ti basta definire l'**etichetta (label)** e se il campo è **obbligatorio**.

In più, nel caso dei componenti "radio button" e "select" dovrai inserire anche i **valori** che il cittadino potrà selezionare.

<figure><img src="/files/jbFgKkKDGLXNDCv2AKui" alt=""><figcaption><p>Come inserire un componente radio</p></figcaption></figure>

{% hint style="info" %}
Sebbene il Service Builder metta a disposizione molti componenti diversi, per un servizio rapido ed efficace ti consigliamo di puntare sui seguenti:

* [**Text Field (Campo di testo)**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-textfield.md): per raccogliere informazioni brevi;
* **Checkbox (Casella di controllo)**: per l'accettazione di termini e dichiarazioni;
* [**Select (Menu a tendina)**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/la-select.md): ideale per scegliere una voce da un elenco lungo;
* [**Radio Button (Bottone di scelta)**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/impostare-le-scelte-utente-select-boxes-e-radio-button.md): perfetto per opzioni esclusive (per esempio, Sì/No);
* [**Nested Form (Classi dati standard)**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form.md): per raccogliere dati in modo sempre uguale di servizio in servizio;
* [**File Sdc (Caricamento file)**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/inserire-allegati-il-file-sdc.md): per permettere al cittadino di allegare documenti o scansioni.
  {% endhint %}
  {% endstep %}

{% step %}

#### Gestisci la logica con semplicità

Un errore comune è lasciarsi trasportare dal desiderio di prevedere ogni minima eccezione o complessità tecnica sin da subito. Per ottenere un risultato rapido ed efficace, ti consigliamo di mantenere il flusso **il più lineare possibile**: un servizio snello non è solo più veloce da creare, ma è anche più facile da compilare per il cittadino.

{% hint style="info" %}
Se il servizio che hai in mente richiede controlli particolari o [logiche di comparsa](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/relazione-tra-i-dati-i-conditional.md) articolate, non incastrarti nei tecnicismi: chiedici aiuto! Questo ti permetterà di delegare la complessità, risparmiare tempo prezioso e goderti il traguardo di un servizio online in tempi record.
{% endhint %}
{% endstep %}

{% step %}

#### Configura integrazioni, notifiche e permessi

Per rendere il servizio davvero efficiente e "senza carta", configura gli ultimi dettagli tecnici:

1. [**Protocollazione**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/la-protocollazione-delle-pratiche-di-un-servizio.md): per automatizzare la registrazione dell'istanza;
2. [**Pagamenti**](/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-pagamenti-associati-al-servizio.md): se previsti, collega il modulo al sistema di pagamento PagoPA;
3. **Comunicazione**: imposta i [messaggi automatici](/guida-alla-creazione-dei-servizi-digitali/le-configurazioni-del-servizio/impostare-i-messaggi-al-cittadino.md) e l'[integrazione con l'App IO](/guida-alla-creazione-dei-servizi-digitali/le-configurazioni-del-servizio/configurare-app-io.md) per tenere il cittadino sempre aggiornato;
4. [**Permessi**](/guida-alla-creazione-dei-servizi-digitali/le-funzioni-generali-delladmin/abilitare-gli-operatori.md): abilita gli operatori alla gestione delle istanze.

<figure><img src="/files/qG1aWdxOAu6n2YBYhYrE" alt=""><figcaption><p>Le ultime configurazioni</p></figcaption></figure>

{% hint style="info" %}
Se le configurazioni si fanno complicate, non esitare a contattarci. Saremo felici di darti supporto per mettere online il tuo servizio e festeggiare insieme questo nuovo passo verso la digitalizzazione
{% endhint %}
{% endstep %}

{% step %}

#### Mettiti nei panni del cittadino

Prima di andare online, esegui un test. Usa la funzione di anteprima o accedi al servizio come farebbe un cittadino e compila il modulo.

* *Le domande sono chiare?*
* *Il flusso è scorrevole?*
* *Qualcosa sembra ripetitivo?*

Se tutto fila liscio, sei quasi al traguardo.
{% endstep %}

{% step %}

#### Scrivi la scheda informativa

Il servizio è pronto, ma ha bisogno di essere documentato sul tuo sito web.

* Se sul sito esiste già una pagina dedicata, aggiungi semplicemente il pulsante di accesso;
* Se manca, crea una scheda informativa che spieghi il servizio e fornisca tutte le informazioni necessarie.
  {% endstep %}

{% step %}

#### Pubblica il servizio

Pubblica il tuo nuovo servizio digitale. In pochissimo tempo, hai trasformato un processo burocratico in un servizio digitale moderno e hai reso la vita più facile a centinaia o migliaia di cittadini!
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

```
GET https://docs.opencityitalia.it/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/guida-rapida-alla-creazione-di-un-servizio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.