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: aggiungeteun controllo dinamico alle app tramite la funzionalità di attivazione/disattivazione dei pulsanti, consentendo una maggiore interattività e flessibilità.
- Minore manutenzione delle app: dedicameno 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) |
| 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 |
| 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
- Selezionare un widget di input per il quale siano disponibili regole di convalida (vedere la tabella sopra).
- Nel riquadro di contesto, fare clic sull'icona + accanto a Regole di convalida.
- Seleziona la regola che desideri aggiungere al widget di input.
- Selezionare un'origine dati per la regola da convalidare. Può trattarsi di un valore statico o di una variabile.
- 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: «ContieneTulip» è la prima regola che non viene superata, quindi il messaggio di errore appare di conseguenza.
Esempio 2: “Iniziacon Hello” è la prima regola che non viene soddisfatta, quindi viene visualizzato il messaggio di errore corrispondente.
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.
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.
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.
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.
È possibile utilizzare questo controllo anche nei widget di firma elettronica.
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ì.
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
- 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'esempioriportato 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.
Esempio 2: L’usodelle 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.
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.
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.
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.
Le informazioni sulla validità dei widget possono anche essere memorizzate in variabili e record di tabella tramite i trigger.
Hai trovato quello che cercavi?
Puoi anche visitare community.tulip.co per pubblicare la tua domanda o verificare se altri hanno avuto un problema simile!