Convalida dei dati con i widget di input

Scoprite come convalidare i dati in Tulip utilizzando widget, pulsanti e trigger.

L'uso della convalida dei dati per gli input dell'operatore riduce i problemi di qualità e standardizza i moduli utilizzati nel processo. Se un utente inserisce un valore che non corrisponde ai requisiti di convalida, viene visualizzato un messaggio di errore. Inoltre, è possibile utilizzare una logica di attivazione per impedire all'operatore di continuare l'applicazione se i dati immessi non soddisfano i requisiti.

La convalida dei dati rende la costruzione delle app molto più semplice, con i seguenti vantaggi:

• Semplificare la gestione dei triggerRidurre la quantità e la complessità dei trigger per semplificare lo sviluppo e la manutenzione delle app. Dedicate meno tempo allo sviluppo delle app.
• Creazione di passi dinamiciAggiungete un controllo dinamico alle app attraverso la funzionalità di attivazione/disattivazione dei pulsanti, consentendo una maggiore interattività e flessibilità.
• Meno manutenzione delle appDedicate meno tempo alla revisione e alla comprensione delle app. Copiate e incollate i widget senza preoccuparvi delle implicazioni di attivazione.

È inoltre possibile fornire un'esperienza intuitiva dell'applicazione con pulsanti abilitati e disabilitati dinamicamente.

Regole di convalida disponibili per widget di input

Sebbene sia possibile utilizzare tutti i widget di input per la convalida dei dati, alcuni input dispongono di regole di convalida per impostare i parametri dei dati. La tabella seguente illustra le regole di convalida disponibili per ciascun Input Widget.

| Widget di input | Regole di convalida | | --- | --- | Casella di controllo | N/A | Testo | Contiene, Inizia con, Finisce con, Limite massimo di caratteri, Limite minimo di caratteri, È email, È URL | Multilinea | Contiene, Inizia con, Finisce con, Limite massimo di caratteri, Limite minimo di caratteri | File | N/A | Numero | Uguale, Non uguale, Maggiore di, Maggiore o uguale a, Minore di, Minore o uguale a, All'interno dell'intervallo (inclusivo), All'esterno dell'intervallo (esclusivo) | Singola selezione | N/A | Multiselezione | Minimo selezionato, Massimo selezionato | Datapicker | È, Prima, Dopo, All'interno dell'intervallo (inclusivo), All'esterno dell'intervallo (esclusivo) | Immagine | N/A | eSignature | N/A |

Creazione di regole di convalida

1. Selezionare un widget di input con regole di convalida disponibili (vedere la tabella precedente).
2. Nel riquadro contestuale, fare clic sull'icona + accanto a Regole di convalida.
3. Selezionare la regola da aggiungere al widget di input.

1. Selezionare un'origine dati per la regola di convalida. Può essere un valore statico o una variabile.

1. Fare clic sul pulsante + per aggiungere altre regole.

Riordino delle regole di convalida

L'ordine delle regole di convalida corrisponde al primo messaggio di errore presentato se il valore dei dati immessi non è corretto.

Negli esempi seguenti, i dati inseriti non rispettano entrambe le regole di convalida. Tuttavia, il messaggio di errore mostrato si riferisce alla prima regola configurata.

L'esempio 1"Contiene Tulipano" è la prima regola che fallisce, quindi il messaggio di errore appare di conseguenza.

L'esempio 2"Inizia con Hello" è la prima regola che fallisce, quindi il messaggio di errore appare di conseguenza.

In questo modo, i costruttori di applicazioni possono specificare la priorità dei messaggi di errore da presentare all'operatore. Per riordinare le regole di convalida, fare clic sull'icona dei sei puntini e trascinarla prima o dopo una regola.

Richiedere i dati di input

Contrassegnando le regole di convalida come obbligatorie, si aggiunge una regola che prevede che l'input debba essere completato dall'operatore per essere considerato valido. Questa opzione può essere utilizzata per tutti i tipi di widget di input. Quando un widget di input è contrassegnato come obbligatorio, nell'applicazione apparirà un asterisco rosso accanto al widget di input. Per fare ciò, attivate il cursore Segna richiesto, situato sotto l'intestazione della sezione Regole di convalida del pannello contestuale.

Prompt di errore della convalida dell'input

Il menu a tendina Formattazione errori nella sezione Regole di convalida del riquadro contestuale offre opzioni per la visualizzazione di un errore con i dati di input all'operatore quando l'applicazione è in esecuzione in Player.

Le tre opzioni di visualizzazione degli errori per l'operatore:

1. Mostra il messaggio di errore della regola di convalida* Contorna il campo di input in rosso e presenta un messaggio di errore all'operatore 2. Contorna solo il campo di input * Contorna il campo di input e presenta un messaggio di errore all'operatore. Delinea solo il campo di input* Delinea il campo di input in rosso 3. Nascondi errore * Non viene fornita alcuna indicazione di errore all'operatore. Nascondi errore* Non viene fornita alcuna indicazione visiva

Abilitazione e disabilitazione dinamica dei pulsanti

Decidete quando gli operatori possono premere un pulsante con i controlli dinamici. Quando un pulsante è disabilitato, viene visualizzato con colori attenuati e l'operatore non potrà premerlo.

È possibile utilizzare questo controllo anche sui widget della Firma elettronica.

I pulsanti possono essere abilitati o disabilitati dinamicamente impostando lo stato Abilitato nella sezione Interazione del riquadro contestuale per un pulsante selezionato. Per impostazione predefinita, lo stato di abilitazione di un pulsante è impostato su Sì.

Esistono alcuni modi per aggiungere un controllo dinamico per determinare lo stato di abilitazione di un pulsante: 1. Specificare una variabile booleana. Specificare una variabile booleana. Validità dell'input dell'utente sul passo con i widget di input che hanno regole di convalida. L'opzione Tutti i widget, che controlla se tutti gli input immessi soddisfano le regole di convalida.

1. Utilizzare un'espressione

Uso delle espressioni per attivare/disattivare i pulsanti

Se si desidera attivare o disattivare un pulsante in base a un sottoinsieme di widget, selezionare Usa espressione per scrivere una condizione personalizzata.

È necessario scrivere un'espressione che valuti una condizione booleana (vero o falso). Se si costruisce correttamente un'espressione valida, l'editor di espressioni lo indicherà in basso a sinistra.

Esempio 1L'esempio seguente utilizza l'operazione modulo per determinare se il valore inserito in un widget di input numerico è pari o dispari. Se il valore è dispari, il pulsante viene attivato. Se il valore è pari, il pulsante viene disabilitato.

Esempio 2L'uso delle espressioni può anche consentire di combinare insieme condizioni aggiuntive. Nell'esempio seguente, affinché il pulsante sia abilitato, il valore deve essere dispari e soddisfare le condizioni di convalida impostate sul widget di input numerico.

Il valore inserito di seguito fa sì che il pulsante sia disabilitato. Anche se il valore inserito è dispari, non soddisfa le regole di convalida del widget di input.

Il valore di input sottostante determina l'attivazione del pulsante, perché il valore immesso è sia dispari che conforme alle regole di convalida del widget di input.

Convalida del widget di input nei trigger

È possibile utilizzare la convalida dei widget di input come parte di una condizione If in un Trigger. Ciò consente ai costruttori di app di creare rapidamente una logica che non dipende 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 utilizzando i trigger.

Avete trovato quello che cercavate?

Potete anche andare su community.tulip.co per postare la vostra domanda o vedere se altri hanno affrontato una domanda simile!