Documentatie van de software voor beheer, planning en optimalisatie van interventies

Een geavanceerd formulier maken met voorwaarden en variabelen


Een complex formulier maken met voorwaarden en variabelen in Cadulis

Met Cadulis kunt u veel verder gaan dan alleen het invoeren van gegevens.
Complexe formulieren maken het mogelijk om de velden aan te passen aan elke interventiecontext, informatie automatisch op te halen (via dynamische variabelen) en de weergave van velden te conditioneren op basis van eerdere antwoorden.

Deze gids begeleidt u stap voor stap bij het maken van een geavanceerd formulier:

  • Voorwaardelijke weergave
  • Dynamische variabelen
  • Onzichtbare velden

1. Toegang tot het formulier van een activiteitstype

  • Ga naar het menu Catalogus
  • Klik op een bestaand activiteitstype (of maak een nieuw aan)
  • Op de pagina “Informatie activiteitstype”, klik op de knop:
    • Activiteitenformulier of
    • Afsluitformulier
  • Klik vervolgens op Veld toevoegen

2. Een veld toevoegen met voorwaardelijke weergave

  1. Kies een veldtype (bijv. Tekstveld)
  2. Voer een unieke code in (bijv. satisfaction_client)
  3. Klik op Veld toevoegen

U wordt doorgestuurd naar de pagina “Veld bewerken”:

  • Vouw het menu Weergave uit
  • Klik op Weergavevoorwaarden

In de pop-up:

  • Klik op +
  • Vul in:
    • Te testen veld: lijst van reeds aangemaakte velden
    • Type voorwaarde: “Behoort tot” / “Behoort niet tot”
    • Vergelijkingswaarde: selecteer een bestaande waarde
  • Klik op Valideren

U kunt vervolgens een logische operator EN / OF instellen als er meerdere voorwaarden zijn.

Voorbeeld

Als u een veld client_satisfait heeft met de waarden Ja / Nee,
kunt u een commentaarveld alleen weergeven als de klant “Nee” antwoordt.

3. Variabelen invoegen in de velden

Met variabelen kunt u automatisch informatie weergeven in een formulier:

  • Datum van de interventie
  • Naam van de klant
  • Adres, uitvoerder, afsluitcommentaar…

Waar invoegen

  • In het veld Beschrijving (tekst boven het veld)
  • In het veld Standaardwaarde
  • Of in een veld Weergegeven tekst

💡 Klik op het pictogram “Vervangingen” in de interface om alle beschikbare variabelen te ontdekken.


Lijst van beschikbare variabelen

Variabelen worden omgeven door accolades {...} en kunnen worden ingevoegd in:

  • Beschrijving
  • Standaardwaarde
  • Weergegeven tekst

Ze zijn bruikbaar in zichtbare, voorwaardelijke of verborgen velden.

🔧 Systeemvariabelen

Code Toont… Voorbeeld
{system.dateTimeNow} Huidige datum en tijd Getekende tijdstempel
{system.isEnvironmentProduction} yes / niets Om test / productie te onderscheiden

📆 Variabelen gekoppeld aan de interventie {intervention.*}

Voorbeelden:

  • {intervention.reference} – Referentie van de interventie
  • {intervention.date.dayOfWeek} – Dag van de week
  • {intervention.title} – Titel van de interventie
  • {intervention.durationSeconds} – Duur in seconden
  • {intervention.businessUnit.name} – Geassocieerde BU

🧭 Interventieadres

  • {intervention.address}
  • {intervention.address.zipCode} – Postcode
  • {intervention.address.latitude} / {longitude} – GPS-coördinaten

👥 Klant {intervention.customer.*}

  • {intervention.customer.name} – Naam
  • {intervention.customer.email} – E-mail
  • {intervention.customer.custom.niveau_confiance} – Aangepaste klantvelden

🙋 Uitvoerder {intervention.assignedUsers.*}

  • {intervention.assignedUsers.name} – Volledige naam
  • {intervention.assignedUsers.email} – E-mail

✅ Afsluiting {intervention.report.*}

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

🔄 Gekoppelde interventies

  • {intervention.parent.date} – Datum van bovenliggende missie
  • {intervention.container.*} – Info van een “container”-missie

👤 Ingelogde gebruiker {user.*}

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

4. Een verborgen veld aanmaken (niet zichtbaar voor de uitvoerder)

Bij het toevoegen van een veld, selecteer Verborgen veld.

Dit veld zal:

  • Onzichtbaar zijn voor de uitvoerder
  • Beschikbaar zijn in exports, rapporten of voorwaardelijke logica

💡 Ideaal om waarden over te dragen tussen activiteit en afsluiting zonder de gebruikersinterface te verstoren.


5. Geavanceerde tips en inspirerende use-cases

  • Samenvattingsveld:
    Interventie van {intervention.date} voor {intervention.customer.name}

  • Standaard uitvoerdersnaam:
    Standaardwaarde = {intervention.assignedUsers.name}

  • Symbool afhankelijk van antwoord:
    {condition,champ_sécurité,OK,✓,✗}

  • Een gegeven anonimiseren:
    {ano,customer.email}


✅ Best practices

✔️ Maak eerst de controlevelden aan (bijv. Ja / Nee) vóór de voorwaardelijke velden
✔️ Geef uw velden leesbare codes (controle_securite)
✔️ Test uw formulier met de knop Testen
✔️ Gebruik horizontale scheidingslijnen om blokken te organiseren