Costruttore di regole

Introduzione

Rule Builder ti consente di aggiungere logica condizionale ai tuoi moduli in modo rapido e intuitivo senza utilizzare una singola riga di codice. Devi semplicemente aggiungere una serie di condizioni da soddisfare per implementare una serie di azioni come nascondere/mostrare elementi HTML, abilitare/disabilitare campi, copiare valori di campi, saltare pagine ed eseguire calcoli.

Per accedere al Rule Builder devi andare su Form Manager , fare clic sul Azioni corrispondente al modulo su cui lavorerai, quindi su Regole condizionali .

Requisiti

Prima di utilizzare il generatore di regole, il modulo deve avere almeno un campo. In caso contrario, verrà visualizzato un messaggio di avviso.

Nessuna limitazione

Non hai alcuna limitazione per creare regole condizionali. È possibile creare tutte le regole, condizioni, sottocondizioni e azioni necessarie.

Aggiungi la tua prima regola

Per questo esempio, dovresti creare un modulo di contatto con quattro campi:

• Nome (campo di testo)
• E-mail (campo e-mail)
• Messaggio (area testo)
• Pulsante (con testo Invia)

Quindi, vai a Gestione moduli, individua il modulo, fai clic sul pulsante Azioni, quindi su Regole condizionali.

1. Una volta in questo generatore di regole del modulo, la prima cosa che noterai è un pannello vuoto con il pulsante Aggiungi regola. Fai clic su questo pulsante per creare la tua prima regola.
2. Quindi vedrai due righe, la prima si riferisce alle condizioni e la seconda alle azioni.
3. Fare clic sul pulsante Aggiungi condizione e verrà visualizzato il primo campo del modulo, seguito da una dichiarazione. Nel nostro esempio, il primo campo del modulo è un campo di testo con l'etichetta "Nome", quindi il generatore di regole mostrerà la condizione'Name' 'is present' .
4. Ora fai clic sul pulsante Aggiungi azione e nota che vengono visualizzati diversi elenchi di selezione. Il primo elenco mostra l'azione da eseguire (Per questo esempio lasciare in 'Mostra'); il secondo mostra il Tipo di risultato (Per questo esempio lasciare 'Campo') e il terzo, l'etichetta del primo campo: 'Nome'. Per questo esempio, lo cambierai con "Invia" (il testo "Invia" si riferisce al pulsante).
5. Infine, in alto a destra di questa regola vedrai un piccolo avviso arancione "Modifiche non salvate" e accanto un pulsante verde con l'icona Controlla. Fare clic su questo pulsante per salvare questa regola. L'avviso scomparirà.

Hai creato la tua prima regola.

Se vedi il tuo modulo, noterai che il pulsante è scomparso, ma se inserisci un testo nel campo "Nome", il pulsante appare.

Dovresti essere consapevole che alcune regole sono soddisfatte in modo bidirezionale; cioè, se la condizione è stata soddisfatta, l'azione verrà eseguita. Ma, se la condizione non è stata soddisfatta, verrà eseguita l'azione opposta (Mostra <=> Nascondi, Abilita <=> Disabilita, Matematica <=> Ripristina su O).

Puoi aggiungere ulteriori regole facendo clic sul pulsante "Aggiungi regola", ma queste non verranno salvate finché non premi il pulsante verde. Ricorda che ogni regola verrà archiviata separatamente.

Nota: per eliminare una regola , fare clic sul pulsante rosso con l'icona del cestino. Inoltre, se desideri interrompere l'esecuzione di una regola per un certo periodo, puoi disattivarla e attivarla quando ne hai bisogno.

Anatomia della regola

Una regola condizionale è composta da tre parti: Nome/Descrizione, Condizioni e Azioni.

Nome/Descrizione

La prima parte ci permette di descrivere la logica condizionale. Usa solo poche parole per nominare o descrivere ciò che vuoi ottenere con questa regola. (Opzionale. Lunghezza massima: 255)

Condizioni

È la seconda parte di una regola, si trova all'inizio e consente di specificare il campo o i campi che devono essere valutati, come tipo di valutazione.

• Tipo di condizione : il tipo di condizione indica quante condizioni devono essere soddisfatte per eseguire l'azione. Può essere: Tutti, Nessuno o Nessuno. L'impostazione predefinita è Tutto.
• Condizione: La dichiarazione si riferisce a un campo del modulo e deve essere compilata. Si compone di 3 parti.
  • Nome : il nome del campo modulo su cui si basa la condizione.
  • Operatore : l'operatore di confronto utilizzato per valutare la condizione.
  • Valore : è un valore arbitrario che l'utente deve inserire nel modulo. Il modo in cui verranno definiti i valori varierà in base al tipo di campo e al tipo di operatore.
• Condizioni multiple : puoi aggiungere più condizioni a una regola. Il tipo di condizione indicherà se devono essere soddisfatte tutte (AND), se presenti (OR) o nessuna.
• Gruppo di condizioni : oltre alle condizioni, una regola può contenere un gruppo di condizioni. Un gruppo di condizioni differisce da una condizione che consente di modificare il tipo di condizione. Pertanto una regola può essere di tipo Tutte (AND), ma il gruppo può essere di tipo Qualsiasi (OR).
• Processo di valutazione : il processo di valutazione delle condizioni è top-down. Cioè, le condizioni all'inizio verranno valutate prima di quelle che sono alla fine, in ordine decrescente.

Nota: le condizioni " Appartiene a " e " Non appartiene a " possono analizzare più valori separati da "|", ciò consente di confrontare il valore del campo con più valori, se uno di essi corrisponde l'azione verrà eseguita.

Azioni

L'ultima parte di una regola indica l'azione da eseguire se le condizioni sono soddisfatte. Come condizioni, le azioni hanno un modo dichiarativo semplice da comprendere.

Un’azione è composta fondamentalmente da tre parti:

• Tipo di azione:
  • Mostra/Nascondi
  • Abilita / Disabilita
  • Copia : consente di copiare il valore di un campo o di un altro elemento o un valore statico e incollarlo automaticamente in un altro campo. Un ottimo esempio di dove ciò è utile è su un modulo in cui potresti raccogliere un indirizzo di spedizione e fatturazione. L'utente finale può inserire il proprio indirizzo di spedizione e selezionare l'opzione Copia per compilare automaticamente i campi dell'indirizzo di fatturazione con gli stessi dati. Un altro caso d'uso comune è utilizzare un valore vuoto statico per cancellare un campo utilizzando la logica condizionale.
  • Matematica : consente l'addizione/sottrazione/moltiplicazione/divisione/resto dei campi e mostra il risultato in un altro campo o elemento HTML.
  • Valuta : consente la valutazione delle espressioni matematiche (formule) e di impostare il risultato in un altro campo. È anche compatibile con il calcolo delle date. Ad esempio, se vuoi calcolare la moltiplicazione di due campi e dividere questo valore per 10, utilizzerai la seguente formula:{{number_1}} * {{number_2}} / 100 . Tieni presente che la valutazione delle espressioni matematiche non funziona con azioni opposte. Puoi leggere l'elenco completo dei calcoli avanzati supportati dal Rule Builder grazie alle eccellenti Math.js e date-fns .
  • Formato numero : consente di formattare un numero in diversi modi e senza alcuna codifica. Ad esempio, per assegnare il formato valuta a un numero: 10130,25 utilizzare il seguente formato "$0,0,00" e il numero verrà ora visualizzato come $10.130,25. Inoltre, per impostazione predefinita, il formato prenderà le impostazioni internazionali della lingua che hai selezionato nella configurazione del modulo, quindi ad esempio, se la lingua del modulo è il tedesco, otterremo: €10 130,25. Puoi leggere l'elenco completo dei formati supportati dal Rule Builder grazie all'eccellente libreria Numeral.js .
  • Formato testo : consente di selezionare più campi per creare una nuova stringa di testo formattata e impostare il risultato in un altro campo o elemento HTML. Per esempio. Per generare automaticamente un indirizzo email, seleziona un campo Nome e inserisci il seguente formato {{0}} @example.com, quindi seleziona il campo Email in cui verrà visualizzato l'indirizzo email. Puoi utilizzare token numerici per identificare la posizione del campo nell'elenco dei campi oppure puoi utilizzare l'ID campo o l'alias campo, nel nostro esempio: {0}@example.com o {{text_1234}} @example.com o {{name}} @example.com dovrebbe funzionare.
  • Salta : consente di definire a quale pagina andare quando si passa alla pagina successiva. Questa azione deve essere utilizzata solo in un modulo a più fasi.
  • Modulo: consente di impostare azioni relative al modulo:
    • 'Invia': per inviare il modulo.
    • 'Reimposta': per reimpostare il modulo.
    • 'Pagina successiva': Per andare alla pagina successiva.
    • 'Pagina precedente': Per andare alla pagina precedente.
• Bersaglio: Varierà a seconda del tipo di azione. Può essere di due tipi:
  • Campo
  • Elemento
• Nome:
  • Se l'obiettivo è Campo sarà il nome del campo.
  • Se il target è Element sarà tra diversi elementi HTML selezionati da jQuery. Ad esempio:
    • '#abc': la destinazione è l'elemento HTML con 'abc' come ID.
    • '.abc': l'obiettivo sono tutti gli elementi HTML con 'abc' come classe CSS.
• Azioni opposte : per impostazione predefinita, le azioni opposte sono state abilitate perché aiutano la creazione di regole condizionali comuni e le rendono più logiche. Ad esempio, se dopo aver soddisfatto una condizione voglio mostrare un campo, chiaramente non soddisfacendo la condizione voglio mantenere questo campo nascosto. Tuttavia, ci sono occasioni in cui la disabilitazione delle azioni opposte può essere utile. Quando ciò si verifica, verrà eseguita solo l'azione descritta nella regola.

Tieni presente che l'uso degli elementi richiede una conoscenza base di jQuery, ma offre grandi vantaggi. Ad esempio, potresti creare un'azione per nascondere tutti i campi del modulo;'Hide' 'Element' '.form-group' .

Nota: puoi identificare l'ID e la classe CSS dei campi del modulo utilizzando la scheda Codice del Generatore di moduli .

Convalida condizionale

Puoi omettere la convalida di un campo obbligatorio utilizzando le regole condizionali in due modi:

1. Quando il campo è nascosto.
2. Quando il campo appartiene ad una pagina che è stata saltata.

Ad esempio, se un campo viene creato con il Generatore di moduli e nelle regole condizionali è definito che questo campo deve essere visualizzato solo se un altro campo soddisfa una condizione e la condizione non è soddisfatta, allora il primo campo non sarà più richiesto (sarà non essere convalidato dal server).

Nota: per utilizzare la convalida condizionale, la convalida lato client deve essere disabilitata. (Vedi Impostazioni modulo -> Nessuna convalida) )