--- title: "Convalida dei dati per i widget di immissione" slug: "data-validation-with-input-widgets" updated: 2026-10-22T09:46:22Z published: 2026-10-22T09:46:22Z canonical: "support.tulip.co/data-validation-with-input-widgets" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Convalida dei dati per i widget di immissione *Scopri come convalidare i dati in Tulip utilizzando widget, pulsanti e trigger.* L’utilizzo della convalida dei dati per gli input degli operatori riduce i problemi di qualità e standardizza i moduli utilizzati nel processo. Se un utente inserisce un valore che non soddisfa i requisiti di convalida, verrà visualizzato un messaggio di errore. Inoltre, è possibile utilizzare la logica dei trigger per impedire a un operatore di proseguire nell’utilizzo dell’app se i dati inseriti non soddisfano i requisiti. La convalida dei dati rende lo sviluppo delle app molto più fluido, con i seguenti vantaggi: - **Semplifica la gestione dei trigger**: riduci il numero e la complessità dei trigger per ottimizzare lo sviluppo e la manutenzione delle app. Dedica meno tempo allo sviluppo delle app. - **Creazione di passaggi dinamici: aggiungete**un controllo dinamico alle app tramite la funzionalità di attivazione/disattivazione dei pulsanti, consentendo una maggiore interattività e flessibilità. - **Minore manutenzione delle app: dedica**meno tempo alla revisione e alla comprensione delle app. Copia e incolla i widget senza preoccuparti delle implicazioni relative ai trigger. È inoltre possibile **offrire un'esperienza d'uso intuitiva grazie ai pulsanti abilitati e disabilitati dinamicamente**. ## Regole di convalida disponibili per ogni widget di input Sebbene sia possibile utilizzare qualsiasi widget di input per la convalida dei dati, alcuni input dispongono di regole di convalida per impostare i parametri dei dati. La tabella sottostante illustra le regole di convalida disponibili per ciascun Input Widget. | Widget di input | Regole di convalida | | --- | --- | | Casella di selezione | N/A | | Testo | Contiene, Non contiene, Inizia con, Finisce con, Limite massimo di caratteri, Limite minimo di caratteri, È un indirizzo e-mail, È un URL (come indicato [qui](https://url.spec.whatwg.org/)) | | Multiriga | Contiene, Inizia con, Finisce con, Limite massimo di caratteri, Limite minimo di caratteri, Non contiene | | File | N/A | | Numero | Uguale a, Non uguale a, Maggiore di, Maggiore o uguale a, Minore di, Minore o uguale a, All'interno dell'intervallo (incluso), Al di fuori dell'intervallo (escluso), [Decimali esatti](/r230/docs/numbers-and-numeric-precision) | | Selezione singola | N/A | | Selezione multipla | Minimo selezionato, Massimo selezionato | | Selettore dati | È, Prima di, Dopo, All'interno dell'intervallo (incluso), Fuori dall'intervallo (escluso), Entro o prima di, Entro o dopo | | Immagine | N/A | | Firma elettronica | N/A | ## Crea una regola di convalida 1. Selezionare un widget di input per il quale siano disponibili regole di convalida (vedere la tabella sopra). 2. Nel riquadro di contesto, fare clic sull'icona **+** accanto a **Regole di convalida**. 3. Seleziona la regola che desideri aggiungere al widget di input. ![Validation Rules side pane ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Validation%20Rules%20Context%20Pane%20ex.png) 1. Selezionare un'origine dati per la regola da convalidare. Può trattarsi di un valore statico o di una variabile. ![Validation rules configuration ex](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Validation%20rules%20configuration%20ex.png) 1. Fare clic sul pulsante **+** per aggiungere ulteriori regole. ### Riorganizza le regole di convalida L'ordine delle regole di convalida corrisponde al primo messaggio di errore visualizzato se il valore dei dati inseriti non soddisfa i requisiti. Negli esempi riportati di seguito, i dati inseriti non soddisfano entrambe le regole di convalida. Tuttavia, il messaggio di errore visualizzato si riferisce alla prima regola configurata. **Esempio 1: «Contiene**Tulip» è la prima regola che non viene superata, quindi il messaggio di errore appare di conseguenza. ![Validation Rule Order Ex1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Validation%20Rule%20Order%20Ex1.png) **Esempio 2: “Inizia**con Hello” è la prima regola che non viene soddisfatta, quindi viene visualizzato il messaggio di errore corrispondente. ![Validation Rule Order Ex2](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Validation%20Rule%20Order%20Ex2.png) Ciò consente agli sviluppatori di app di specificare la priorità dei messaggi di errore da mostrare a un operatore. Per riordinare le regole di convalida, fare clic sull’icona **con i sei puntini** e trascinarla prima o dopo una regola. ![Reorder Validation Rules](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Reorder%20Validation%20Rules.gif) ### Rendere obbligatori i dati di input Contrassegnando le regole di convalida come obbligatorie, si aggiunge una regola secondo cui l’operatore deve completare l’inserimento affinché il dato sia considerato valido. È possibile utilizzare questa opzione per tutti i tipi di widget di input. Quando un widget di input è contrassegnato come obbligatorio, nell’app apparirà un asterisco rosso accanto al widget stesso. Per farlo, attivare il cursore **“Contrassegna come obbligatorio”** situato sotto l’intestazione della sezione **“Regole di convalida”** nel pannello laterale. ![Validation rules mark required](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Validation%20rules%20mark%20required.png) ### Messaggi di errore di convalida dell’input Il menu a tendina **"Formattazione degli errori** " all'interno della sezione " **Regole di convalida** " del pannello laterale offre opzioni relative alla modalità di visualizzazione degli errori relativi ai dati inseriti da parte dell'operatore quando l'app è in esecuzione nel Player. ![Validation rules error formatting](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Validation%20rules%20error%20formatting.png) Le tre opzioni per la visualizzazione degli errori all’operatore: 1. **Mostra messaggio di errore della regola di convalida** * Evidenzia il campo di immissione in rosso e mostra un messaggio di errore all’operatore 2. **Evidenzia solo il campo di immissione** * Evidenzia il campo di immissione in rosso 3. **Nascondi errore** * Nessuna indicazione visiva fornita ## Abilitare e disabilitare dinamicamente i pulsanti Decidete quando gli operatori possono premere un pulsante tramite i controlli dinamici. Quando un pulsante è disabilitato, viene visualizzato con colori attenuati e l’operatore non potrà premerlo. ![Enabled vs disabled buttons](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Enabled%20vs%20disabled%20buttons.png) È possibile utilizzare questo controllo anche nei widget di firma elettronica. ![Enabled vs disabled eSignature](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Enabled%20vs%20disabled%20eSignature.png) I pulsanti possono essere abilitati o disabilitati dinamicamente impostando lo **stato Abilitato** nella sezione **Interazione** del pannello laterale relativo al pulsante selezionato. Per impostazione predefinita, lo stato di abilitazione di un pulsante è impostato su **Sì**. ![button side pane enabled state yes](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/button%20context%20pane%20enabled%20state%20yes.png) Esistono diversi modi per aggiungere un controllo dinamico che determini lo stato di abilitazione di un pulsante: 1. Specificare una variabile booleana; 2. Verificare la validità dell’input dell’utente nel passaggio con widget di input dotati di regole di convalida; 3. L’opzione **“Tutti i widget”**, che verifica se tutti gli input inseriti soddisfano le regole di convalida ![Button side pane enabled state all widgets](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Button%20context%20pane%20enabled%20state%20all%20widgets.png) 1. Utilizzare un’espressione ### Utilizzare le espressioni per abilitare/disabilitare i pulsanti Se desideri abilitare o disabilitare un pulsante in base a un sottoinsieme di widget, seleziona " **Usa espressione** " per scrivere una condizione personalizzata. È necessario scrivere un'espressione che restituisca una condizione booleana (vero o falso). Se si costruisce correttamente un'espressione valida, l'editor delle espressioni lo indicherà in basso a sinistra. **Esempio 1: L'esempio**riportato di seguito utilizza l'operazione modulo per determinare se il valore inserito in un widget di immissione numerica è dispari o pari. Se il valore è dispari, il pulsante sarà abilitato. Se il valore è pari, il pulsante sarà disabilitato. ![enable-disable buttons expressions ex1(1)](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/enable-disable%20buttons%20expressions%20ex1%281%29.png) **Esempio 2: L’uso**delle espressioni consente inoltre di combinare tra loro condizioni aggiuntive. Nell’esempio riportato di seguito, affinché il pulsante sia abilitato, il valore deve essere dispari e soddisfare le condizioni di convalida impostate sul widget di immissione numerica. ![enable-disable buttons expressions ex2(1)](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/enable-disable%20buttons%20expressions%20ex2%281%29.png) Il valore di input riportato di seguito comporta la disabilitazione del pulsante. Anche se il valore inserito è dispari, non soddisfa le regole di convalida del widget di immissione. ![enable-disable buttons expressions ex2 invalid input](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/enable-disable%20buttons%20expressions%20ex2%20invalid%20input.png) Il valore inserito di seguito fa sì che il pulsante sia abilitato, poiché il valore inserito è sia dispari sia conforme alle regole di convalida del widget di immissione. ![enable-disable buttons expressions ex2 valid input](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/enable-disable%20buttons%20expressions%20ex2%20valid%20input.png) ## Convalida del widget di input nei trigger È possibile utilizzare la convalida del widget di input come parte di una condizione **"If"** in un trigger. Ciò consente agli sviluppatori di app di creare rapidamente una logica che non dipenda dai valori specifici inseriti dagli operatori, ma dalla validità di tali valori. ![Input validation trigger ex1](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Input%20validation%20trigger%20ex1.png) Le informazioni sulla validità dei widget possono anche essere memorizzate in variabili e record di tabella tramite i trigger. ![Input validation trigger ex2](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Input%20validation%20trigger%20ex2.png) --- Hai trovato quello che cercavi? Puoi anche visitare [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) per pubblicare la tua domanda o verificare se altri hanno avuto un problema simile! **Input Widget** **Input widgets** are a set of **Widgets** specifically designed for users to enter information. Input widgets must be associated with a location where the user input is stored.