Documentazione

Crea un modulo avanzato con condizioni e variabili


Creare un modulo complesso con condizioni e variabili in Cadulis

Con Cadulis, puoi andare ben oltre la semplice raccolta di dati.
I moduli complessi permettono di adattare i campi a ogni contesto di intervento, di richiamare automaticamente informazioni (tramite variabili dinamiche) e di condizionare la visualizzazione dei campi in base alle risposte precedenti.

Questa guida ti accompagna passo dopo passo nella creazione di un modulo avanzato:

  • Visualizzazione condizionale
  • Variabili dinamiche
  • Campi invisibili

1. Accedere al modulo di un tipo di attività

  • Vai al menu Catalogo
  • Clicca su un tipo di attività esistente (o creane uno nuovo)
  • Nella pagina “Informazioni tipo di attività”, clicca sul pulsante:
    • Modulo attività oppure
    • Modulo di chiusura
  • Poi clicca su Aggiungi un campo

2. Aggiungere un campo con visualizzazione condizionale

  1. Scegli un tipo di campo (es.: Area di testo)
  2. Inserisci un codice univoco (es.: soddisfazione_cliente)
  3. Clicca su Aggiungi un campo

Verrai reindirizzato alla pagina “Modifica un campo”:

  • Espandi il menu Visualizzazione
  • Clicca su Condizioni di visualizzazione

Nella pop-up:

  • Clicca su +
  • Compila:
    • Campo da testare: elenco dei campi già creati
    • Tipo di condizione: “Fa parte di” / “Non fa parte di”
    • Valore di confronto: seleziona un valore esistente
  • Clicca su Conferma

Puoi poi definire un operatore logico E / O se sono presenti più condizioni.

Esempio

Se hai un campo cliente_soddisfatto con i valori Sì / No,
puoi visualizzare un campo commento solo se il cliente risponde “No”.

3. Inserire variabili nei campi

Le variabili permettono di visualizzare automaticamente informazioni in un modulo:

  • Data dell’intervento
  • Nome del cliente
  • Indirizzo, operatore, commento di chiusura…

Dove inserirle

  • Nel campo Descrizione (testo visualizzato sopra il campo)
  • Nel campo Valore predefinito
  • Oppure in un campo Testo visualizzato

💡 Clicca sull’icona “Sostituzioni” nell’interfaccia per scoprire tutte le variabili disponibili.


Elenco delle variabili disponibili

Le variabili sono racchiuse tra parentesi graffe {...} e possono essere inserite in:

  • Descrizione
  • Valore predefinito
  • Testo visualizzato

Sono utilizzabili in campi visibili, condizionali o nascosti.

🔧 Variabili di sistema

Codice Visualizza… Esempio
{system.dateTimeNow} Data e ora attuali Firma con data e ora
{system.isEnvironmentProduction} yes / niente Per distinguere test / produzione

📆 Variabili legate all’intervento {intervention.*}

Esempi:

  • {intervention.reference} – Riferimento dell’intervento
  • {intervention.date.dayOfWeek} – Giorno della settimana
  • {intervention.title} – Titolo dell’intervento
  • {intervention.durationSeconds} – Durata in secondi
  • {intervention.businessUnit.name} – BU associata

🧭 Indirizzo dell’intervento

  • {intervention.address}
  • {intervention.address.zipCode} – CAP
  • {intervention.address.latitude} / {longitude} – Coordinate GPS

👥 Cliente {intervention.customer.*}

  • {intervention.customer.name} – Nome
  • {intervention.customer.email} – Email
  • {intervention.customer.custom.niveau_confiance} – Campi personalizzati cliente

🙋 Operatore {intervention.assignedUsers.*}

  • {intervention.assignedUsers.name} – Nome completo
  • {intervention.assignedUsers.email} – Email

✅ Chiusura {intervention.report.*}

  • {intervention.report.status} – OK / KO
  • {intervention.report.comment} – Commento finale

🔄 Interventi collegati

  • {intervention.parent.date} – Data della missione principale
  • {intervention.container.*} – Info di una missione “contenitore”

👤 Utente connesso {user.*}

  • {user.firstName} / {user.lastName}
  • {user.email}

4. Creare un campo nascosto (non visibile per l’operatore)

Durante l’aggiunta di un campo, seleziona Campo nascosto.

Questo campo sarà:

  • Invisibile per l’operatore
  • Utilizzabile in esportazioni, report o logica condizionale

💡 Ideale per trasferire valori tra attività e chiusura senza disturbare l’interfaccia utente.


5. Suggerimenti avanzati e casi d’uso ispiranti

  • Campo riepilogativo:
    Intervento del {intervention.date} per {intervention.customer.name}

  • Nome dell’operatore predefinito:
    Valore predefinito = {intervention.assignedUsers.name}

  • Simbolo in base alla risposta:
    {condition,champ_sécurité,OK,✓,✗}

  • Anonimizzare un dato:
    {ano,customer.email}


✅ Buone pratiche

✔️ Crea prima i campi di controllo (es. Sì / No) prima dei campi condizionali
✔️ Dai codici leggibili ai tuoi campi (controllo_sicurezza)
✔️ Testa il tuo modulo con il pulsante Testa
✔️ Usa separatori orizzontali per organizzare i blocchi