> 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/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/validazione-dei-dati.md).
# Validazione dei dati
La piattaforma permette funzioni di validazione dei dati
## Obbligatorietà dei contenuti
Per rendere la compilazione di un campo obbligatoria, attiva la funzione "required" nella sezione "Validation"
## Dato presente una sola volta nel modulo
Per far sì che un dato possa essere inserito solo una volta durante la compilazione, nella sezione "Validation" del componente attiva la funzione "unique"
## Lunghezza minima e massima (datagrid)
Per i componenti [Datagrid](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-datagrid.md) puoi configurare la lunghezza minima e massima del testo inserito nel campo.
Nella sezione "Validation" del componente, compila le voci *Maximum length* e *Minimum length* con valori numerici.
Ricordati di inserire il messaggio di errore che compare all'utente alla voce "Custom error message".
## Verificare le date inserite
Una volta inserita la data, puoi [configurare il formato e verificare che il cittadino non possa inserire date nel passato](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/le-date.md#configurare-le-date).
## Verificare l'età di una persona
Durante la configurazione di una [data](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/le-date.md), nel caso in cui il servizio preveda l'inserimento di una data di nascita, puoi controllare che questa venga inserita correttamente.
Nella sezione "Validation" del componente, compila la voce "Custom validation" con il codice JavaScript di verifica, ad esempio prevedendo che venga inserita la data di nascita di un minorenne
```javascript
date = moment(input, 'DD/MM/YYYY')
if (date.isAfter(moment())) {
valid = "La data non può essere nel futuro"
} else {
if (moment().diff(date, 'years') > 18) {
valid = "L'età inserità non è quella di un minorenne"
}
}
```
## *Regular expression pattern*
Il *pattern* è una stringa che rappresenta una espressione regolare usata per verificare se il valore inserito in un campo rispetta certe regole di formato. È un modo per assicurarsi che, ad esempio, un campo email, telefono o codice postale abbia la struttura corretta.
Nella sezione "Validation" del componente (normalmente un [*Text field*](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-textfield.md)), compila la voce "Regular expression pattern" con la struttura prevista dal dato inserito
Ricordati di inserire il messaggio di errore che compare all'utente alla voce "Custom error message".
#### Esempi di pattern per casi d'uso comuni
Ogni servizio richiede formati diversi. Qui trovi alcuni pattern già pronti per i dati più frequenti nei moduli della Pubblica Amministrazione.
| Caso d'uso | Regular expression pattern | Cosa verifica |
| -------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Codice fiscale | `^[A-Za-z]{6}[0-9]{2}[A-Za-z]{1}[0-9]{2}[A-Za-z]{1}[0-9]{3}[A-Za-z]{1}$` | 16 caratteri nel formato standard: 6 lettere, 2 cifre, 1 lettera, 2 cifre, 1 lettera, 3 cifre, 1 lettera. |
| Partita IVA | `^[0-9]{11}$` | 11 cifre numeriche, senza lettere né spazi. |
| IBAN italiano | `^IT[0-9]{2}[A-Za-z][0-9]{10}[A-Za-z0-9]{12}$` | 27 caratteri: prefisso "IT", 2 cifre di controllo, 1 lettera (CIN), 10 cifre (ABI e CAB), 12 caratteri alfanumerici per il numero di conto. |
| CAP | `^[0-9]{5}$` | 5 cifre numeriche. |
**Come leggere un pattern:**
* `^` e `$` indicano l'inizio e la fine del testo: il valore inserito deve corrispondere per intero, non solo in parte;
* `[A-Za-z]` indica una lettera, maiuscola o minuscola;
* `[0-9]` indica una cifra numerica;
* `{n}` indica quante volte si ripete il carattere o il gruppo precedente;
* `[A-Za-z0-9]` indica un carattere alfanumerico, lettera o cifra.
## Lunghezza minima e massima del dato
Durante la configurazione di un componente [*Text field*](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-textfield.md), puoi configurare:
* la lunghezza del testo (1)
* il numero di parole (2).
Ricordati di inserire il messaggio di errore che compare all'utente alla voce "Custom error message".
## Verificare la provincia del richiedente
Per verificare l'indirizzo inserito da un utente in fase di richiesta, inserisci nel modulo un [nested form OC-Residenza](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form.md).
Successivamente, inserisci un campo Columns in cui inserire un [campo HTML ](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/lhtml.md)e un checkbox [obbligatorio](#obbligatorieta-dei-contenuti) e disabilitato.
Nella sezione "Contional" del campo Columns compila la voce "Advanced conditions" con il codice di controllo:
Qui trovi un codice di esempio per cui il richiedente viene bloccato quando la provincia inserita non è quella di Trento:
```
show =
data.sport_organization_address?.data.county?.length > 0 &&
data.sport_organization_address.data.county !== "TN"
```
## Verificare l'ISEE del richiedente
Per verificare il valore ISEE inserito da un utente in fase di richiesta, inserisci nel modulo [un nested form OC-ISEE](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form.md).
Successivamente, inserisci un campo Columns in cui inserire un [campo HTML](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/lhtml.md) e un checkbox [obbligatorio](#obbligatorieta-dei-contenuti) e disabilitato.
Una volta fatto, configura il codice json del componente Columns con il codice di controllo.
Qui trovi un codice di esempio per cui il richiedente viene bloccato quando l'importo ISEE inserito supera i 17.747,58
```
{
"label": "Columns",
"columns": [
{
"components": [
{
"label": "HTML",
"tag": "div",
"className": "alert alert-danger",
"attrs": [
{
"attr": "",
"value": ""
}
],
"content": "
Attenzione!
\nL'ISEE riportato è troppo alto. Non è possibile continuare la compilazione",
"refreshOnChange": false,
"key": "html9",
"type": "htmlelement",
"input": false,
"tableView": false
}
],
"width": 12,
"offset": 0,
"push": 0,
"pull": 0,
"size": "md",
"currentWidth": 12
},
{
"components": [
{
"label": "admitted",
"customClass": "d-none",
"tableView": false,
"clearOnHide": false,
"validate": {
"required": true
},
"key": "admitted",
"type": "checkbox",
"input": true,
"defaultValue": false
}
],
"size": "md",
"width": 12,
"offset": 0,
"push": 0,
"pull": 0,
"currentWidth": 12
}
],
"key": "columns2",
"customConditional": "importo = parseFloat(data.economic_situation_indicator.data.value.replace(\",\",\".\"))\nshow = (importo && importo > 17747.58) ? true : false ",
"type": "columns",
"input": false,
"tableView": false
}
```
---
# 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/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/le-funzioni/validazione-dei-dati.md?ask=&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.
.png?alt=media&token=b9845435-ccac-4e3b-8d90-80e57b913feb)
