Dokumentation

Erstellen Sie ein erweitertes Formular mit Bedingungen und Variablen


Erstellen eines komplexen Formulars mit Bedingungen und Variablen in Cadulis

Mit Cadulis können Sie weit mehr als nur einfache Dateneingaben vornehmen.
Komplexe Formulare ermöglichen es, die Felder an jeden Einsatzkontext anzupassen, Informationen automatisch einzufügen (über dynamische Variablen) und die Anzeige von Feldern abhängig von vorherigen Antworten zu steuern.

Diese Anleitung begleitet Sie Schritt für Schritt beim Erstellen eines erweiterten Formulars:

  • Bedingte Anzeige
  • Dynamische Variablen
  • Unsichtbare Felder

1. Zugriff auf das Formular eines Aktivitätstyps

  • Gehen Sie ins Menü Katalog
  • Klicken Sie auf einen bestehenden Aktivitätstyp (oder erstellen Sie einen neuen)
  • Auf der Seite „Informationen zum Aktivitätstyp“ klicken Sie auf:
    • Aktivitätsformular oder
    • Abschlussformular
  • Klicken Sie anschließend auf Feld hinzufügen

2. Hinzufügen eines Feldes mit bedingter Anzeige

  1. Wählen Sie einen Feldtyp aus (z. B. Textfeld)
  2. Geben Sie einen eindeutigen Code ein (z. B. satisfaction_client)
  3. Klicken Sie auf Feld hinzufügen

Sie werden zur Seite „Feld bearbeiten“ weitergeleitet:

  • Klappen Sie das Menü Anzeige aus
  • Klicken Sie auf Anzeigebedingungen

Im Pop-up:

  • Klicken Sie auf +
  • Geben Sie ein:
    • Zu testendes Feld: Liste der bereits erstellten Felder
    • Bedingungstyp: „Enthält“ / „Enthält nicht“
    • Vergleichswert: Wählen Sie einen vorhandenen Wert aus
  • Klicken Sie auf Bestätigen

Sie können anschließend einen logischen Operator UND / ODER festlegen, wenn mehrere Bedingungen vorhanden sind.

Beispiel

Wenn Sie ein Feld client_satisfait mit den Werten Ja / Nein haben,
können Sie ein Kommentarfeld nur anzeigen, wenn der Kunde „Nein“ antwortet.

3. Variablen in Felder einfügen

Variablen ermöglichen es, automatisch Informationen in einem Formular anzuzeigen:

  • Datum des Einsatzes
  • Name des Kunden
  • Adresse, Außendienstmitarbeiter, Abschlusskommentar …

Wo sie eingefügt werden können

  • Im Feld Beschreibung (Text, der über dem Feld angezeigt wird)
  • Im Feld Standardwert
  • Oder in einem Anzeigetextfeld

💡 Klicken Sie auf das Symbol „Ersetzungen“ in der Oberfläche, um alle verfügbaren Variablen zu entdecken.


Liste der verfügbaren Variablen

Variablen werden von geschweiften Klammern {...} umgeben und können eingefügt werden in:

  • Beschreibung
  • Standardwert
  • Anzeigetext

Sie sind in sichtbaren, bedingten oder versteckten Feldern verwendbar.

🔧 Systemvariablen

Code Zeigt an… Beispiel
{system.dateTimeNow} Aktuelles Datum und Uhrzeit Zeitstempel bei Unterschrift
{system.isEnvironmentProduction} ja / nichts Unterscheidung Test / Produktion

📆 Einsatzbezogene Variablen {intervention.*}

Beispiele:

  • {intervention.reference} – Einsatzreferenz
  • {intervention.date.dayOfWeek} – Wochentag
  • {intervention.title} – Einsatztitel
  • {intervention.durationSeconds} – Dauer in Sekunden
  • {intervention.businessUnit.name} – Zugehörige BU

🧭 Einsatzadresse

  • {intervention.address}
  • {intervention.address.zipCode} – Postleitzahl
  • {intervention.address.latitude} / {longitude} – GPS-Koordinaten

👥 Kunde {intervention.customer.*}

  • {intervention.customer.name} – Name
  • {intervention.customer.email} – E-Mail
  • {intervention.customer.custom.niveau_confiance} – Kundenindividuelle Felder

🙋 Außendienstmitarbeiter {intervention.assignedUsers.*}

  • {intervention.assignedUsers.name} – Vollständiger Name
  • {intervention.assignedUsers.email} – E-Mail

✅ Abschluss {intervention.report.*}

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

🔄 Verknüpfte Einsätze

  • {intervention.parent.date} – Datum des übergeordneten Einsatzes
  • {intervention.container.*} – Informationen einer „Container“-Mission

👤 Angemeldeter Benutzer {user.*}

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

4. Ein verstecktes Feld erstellen (für den Außendienstmitarbeiter nicht sichtbar)

Wählen Sie beim Hinzufügen eines Feldes Verstecktes Feld aus.

Dieses Feld ist:

  • Unsichtbar für den Außendienstmitarbeiter
  • Nutzbar in Exporten, Berichten oder für bedingte Logik

💡 Ideal, um Werte zwischen Aktivität und Abschluss zu übertragen, ohne die Benutzeroberfläche zu stören.


5. Erweiterte Tipps und inspirierende Anwendungsfälle

  • Zusammenfassungsfeld:
    Einsatz am {intervention.date} für {intervention.customer.name}

  • Standardmäßig Name des Außendienstmitarbeiters:
    Standardwert = {intervention.assignedUsers.name}

  • Symbol je nach Antwort:
    {condition,champ_sécurité,OK,✓,✗}

  • Anonymisierung einer Angabe:
    {ano,customer.email}


✅ Best Practices

✔️ Erstellen Sie zuerst Kontrollfelder (z. B. Ja / Nein), bevor Sie bedingte Felder anlegen
✔️ Vergeben Sie lesbare Codes für Ihre Felder (controle_securite)
✔️ Testen Sie Ihr Formular mit dem Button Testen
✔️ Verwenden Sie horizontale Trennlinien, um die Blöcke zu strukturieren