Rule Builder #

Il Rule Builder di Primeforms consente di aggiungere logica condizionale ai moduli. Puoi usarlo per mostrare, nascondere, abilitare, disabilitare o rendere obbligatori campi ed elementi del form in base ai valori inseriti dall’utente.

Panoramica #

Il Rule Builder serve a creare regole del tipo:

Se una o più condizioni sono vere, esegui una o più azioni.

Questa funzione è utile per:

• mostrare solo i campi rilevanti
• semplificare la compilazione del modulo
• ridurre errori e campi inutili
• gestire obbligatorietà e comportamento dei campi in modo dinamico

Requisiti #

Prima di usare il Rule Builder, assicurati di avere:

• un modulo già creato
• i campi già aggiunti al form
• una struttura base già salvata

Le regole funzionano sui campi esistenti del modulo. Per questo motivo è consigliato completare prima la struttura del form e configurare poi la logica condizionale.

Come accedere al Rule Builder #

1. Apri il modulo da modificare
2. Vai all’area di gestione del form
3. Apri la sezione Rule Builder
4. Clicca su Nuova regola per creare una nuova condizione

Creare una regola #

Per creare una regola:

1. inserisci un nome identificativo
2. aggiungi una o più condizioni
3. scegli come combinare le condizioni
4. definisci una o più azioni
5. seleziona il target dell’azione
6. salva la regola
7. testa il comportamento del modulo

Struttura di una regola #

Ogni regola è composta da questi elementi:

• Nome: identifica la regola nel pannello
• Condizioni: definiscono quando la regola deve attivarsi
• Azioni: definiscono cosa deve succedere
• Target: indica il campo o l’elemento su cui agisce l’azione

Nome della regola #

Usa nomi descrittivi e facili da riconoscere. Esempi:

• Mostra telefono se ricontatto = sì
• Rendi obbligatoria partita IVA per aziende
• Nascondi budget per richieste generiche

Condizioni #

Una condizione confronta il valore di un campo con un valore definito nella regola.

Una condizione include normalmente:

• campo
• operatore
• valore

Esempio:

• Campo: Tipo cliente
• Operatore: è uguale a
• Valore: Azienda

Combinazione delle condizioni #

Se una regola contiene più condizioni, puoi combinarle in due modi:

• Tutte vere: la regola si attiva solo se tutte le condizioni risultano vere
• Almeno una vera: la regola si attiva se almeno una condizione risulta vera

Operatori comuni #

Gli operatori disponibili possono variare in base al tipo di campo. I più comuni sono:

• è uguale a
• non è uguale a
• contiene
• non contiene
• è vuoto
• non è vuoto
• maggiore di
• minore di

Azioni #

Le azioni definiscono il comportamento applicato quando la regola è verificata.

Azioni comuni:

• Show: mostra il target
• Hide: nasconde il target
• Enable: abilita il target
• Disable: disabilita il target
• Set Required: rende obbligatorio il target
• Remove Required: rimuove l’obbligatorietà
• Set Value: imposta un valore
• Copy Value: copia un valore da un campo a un altro

Target #

Il target è il campo o l’elemento su cui viene applicata l’azione.

Il campo usato nella condizione e il target dell’azione possono essere diversi.

Esempio:

• Condizione: Tipo cliente = Azienda
• Azione: mostra il campo Partita IVA

Validazione condizionale #

Il Rule Builder può essere usato anche per la validazione condizionale. Questo significa che un campo può diventare obbligatorio solo in determinate situazioni.

Esempio:

Se il campo “Tipo cliente” è uguale a “Azienda”, il campo “Partita IVA” diventa obbligatorio.

Questo approccio è utile quando:

• un campo non deve essere richiesto a tutti gli utenti
• vuoi mantenere il modulo più pulito
• devi raccogliere dati diversi in base alle risposte precedenti

Esempi di utilizzo #

Mostrare un campo solo in un caso specifico #

Condizione: Vuoi essere ricontattato? = Sì
Azione: mostra il campo Telefono

Rendere obbligatorio un campo solo per aziende #

Condizione: Tipo cliente = Azienda
Azione: rendi obbligatorio il campo Partita IVA

Nascondere un campo per utenti privati #

Condizione: Tipo cliente = Privato
Azione: nascondi il campo Ragione sociale

Mostrare un campo aggiuntivo per richieste commerciali #

Condizione: Tipo richiesta = Preventivo
Azione: mostra il campo Budget

Mostrare un campo tecnico solo quando serve #

Condizione: Tipo richiesta = Supporto tecnico
Azione: mostra e rendi obbligatorio il campo URL pagina

Buone pratiche #

• usa nomi chiari per ogni regola
• crea regole semplici e facili da testare
• evita regole duplicate o in conflitto
• controlla sempre che il target sia corretto
• testa il modulo completo prima della pubblicazione
• verifica anche submit, notifiche e integrazioni dopo aver aggiunto la logica condizionale

Errori comuni #

• condizioni configurate sul campo sbagliato
• target errato
• valori confrontati in modo non coerente
• campi obbligatori che vengono nascosti
• più regole che agiscono sullo stesso campo in modo opposto
• mancato test del comportamento reale del form

Note #

• Il comportamento effettivo delle regole dipende dai campi presenti nel modulo e dalla configurazione del form.
• Se una regola non produce l’effetto atteso, verifica prima condizione, operatore, valore e target.
• In moduli complessi è consigliato aggiungere le regole una alla volta e testarle progressivamente.

Quando usare il Rule Builder #

Usa il Rule Builder quando il modulo deve adattarsi in base alle scelte dell’utente. È particolarmente utile per:

• form di contatto avanzati
• moduli preventivo
• form B2B e B2C nello stesso flusso
• booking con opzioni variabili
• raccolta dati progressiva

Conclusione #

Il Rule Builder è lo strumento di Primeforms dedicato alla gestione della logica condizionale. Permette di costruire moduli più dinamici, più puliti e più facili da compilare, mostrando solo i campi necessari e applicando regole in base ai valori inseriti dall’utente.