Berechneter Wert und Variablen

Formularelement

Berechnete Werte sind Werte, die nicht direkt eingegeben wurden, sondern mittels eines JavaScripts aus den anderen Formularwerten berechnet werden.

Bedingungen ermöglichen es Ihnen, den Zustand einzelner Formularelemente in Abhängigkeit zur Benutzereingabe zu verändern.

Für die Vorbelegung von Eingabefeldern können Sie Variablen verwenden. Diese werden bei der Anzeige des Formulars durch einen Wert ersetzt.

Wiederkehrende allgemeine Formularelementeigenschaften werden bei den Formularelementen erläutert.

Eingabemaske
Eingabemaske

Bei diesem Element handelt es sich um einen Wert, der nicht direkt von dem Nutzenden eingegeben werden kann, sondern mittels eines JavaScripts aus den anderen Formularwerten berechnet wird.

Anzeigevariante
Hier können Sie durch die Variante „schmal“ eine entsprechende Darstellung des Feldes im Formuar realisieren.

JavaScript
Hier können Sie mit Hilfe von JavaScript die gewünschte Funktion erstellen. Mehr hierzu weiter unten.

Wert im Formular anzeigen
Durch Aktivierung dieser Option legen Sie fest, dass das Ergebnis der Berechnung im Formular angezeigt wird.

Sofortige Neuberechnung des Wertes im Browser
Durch Aktivierung dieser Option legen Sie fest, dass der Wert sofort neu berechnet wird, sobald der Anwender seine Eingaben ändert, die bei der Berechnung des Wertes verwendet werden. Die Berechnung erfolgt in diesem Fall browserseitig, das heißt ohne dass der Anwender das Formular absenden muss. Diese Option müssen Sie auch aktivieren, wenn Sie den Wert einer Bedingung verwenden.

JavaScript nutzen

Nachdem Sie das Element neu angelegt haben, enthält das Feld JavaScript die leere Methode calculate(). Dabei handelt es sich um eine JavaScript-Funktion, die bei jedem Absenden (Seitenwechsel und Klick auf den Absenden-Button) des Formulars ausgeführt wird. Innerhalb der Funktion können Sie die Berechnungslogik eingeben.

Folgende vordefinierte Funktionen werden von Webforms zur Verfügung gestellt:

  • parseAge(datumsformat, datum):
    Diese Funktion wandelt das eingegebene Datum in das aktuelle Alter der Person um. Als erster Parameter muss das zugrunde liegende Datumsformat und als zweiter das Datum (kann auch eine Variable eines Datumsfeldes im Formular sein) angegeben werden.
    Beispiel: parseAge("dd.MM.yyyy", "18.12.1969")
  • parseDate (datumsformat, datum):
    Diese Funktion wandelt die Eingabe in das Datumsformat um. Als erster Parameter muss das zugrunde liegende Datumsformat und als zweiter das Datum (kann auch eine Variable eines Datumsfeldes im Formular sein) angegeben werden.
    Beispiel: parseDate ("dd.MM.yyyy", "18.12.1969")
  • isEmptyList(technischerName):
    Mit dieser Funktion können Sie überprüfen, ob der/die Benutzer/Benutzerin in der angegebenen Auswahl etwas ausgewählt hat oder nicht. Als Parameter wird hier der technische Name der Auswahl (hier auswahl), welches Sie überprüfen wollen, benötigt.
    Beispiel: isEmptyList(auswahl)
  • isSelected(technischerName, wert):
    Mit Hilfe dieser Funktion können Sie überprüfen, ob der/die Benutzer/Benutzerin eine bestimmte Option einer Auswahl (Einfachauswahl, Mehrfachauswahl oder Dropdown-Liste) ausgewählt hat. Geben Sie als ersten Parameter den technischen Namen der Auswahl (hier auswahlliste2) und als zweiten den Wert der Option an.
    Beispiel: isSelected(auswahl, "ja")

Weiteres Beispiel:

Sie möchten das Alter einer Person zu einem angegebenen Geburtsdatum (Eingabefeld „geburtsdatum“) ausrechnen, um dieses anschließend in einer Bedingung zu verwenden, so erreichen Sie dies durch die folgende Funktion:

function calculate(){
  return parseAge("dd.MM.yyyy", geburtsdatum);
}

Sie können auch Ihre eigene Rechnung zusammensetzen, ein Beispiel dazu sehen Sie auf dem Bild rechts. Das Produkt aus den Eingabefeldern a und b soll berechnet werden.

Beispiel
Beispiel

Für die Vorbelegung von Eingabefeldern oder die Ausgabe in Mailversandaktionen können Sie Variablen verwenden. Diese werden bei der Anzeige des Formulars durch einen Wert ersetzt. So können Sie beispielsweise ein Feld mit dem aktuellen Datum vorbelegen, indem Sie die Variable ${clientDate} in das Feld für die Vorbelegung eintragen. Variablen müssen immer in der Form ${name-der-variablen} angegeben werden.

Alle Variablen können mit zusätzlichem Text oder anderen Variablen kombiniert werden. Folgende Variablen stehen Ihnen standardmäßig zur Verfügung.

Variable Beschreibung
date Datum in der Zeitzone UTC±0, an dem der Benutzer das Formular ausfüllt.
time Uhrzeit in der Zeitzone UTC±0, zu der der Benutzer das Formular ausfüllt.
serverDate Datum in der Zeitzone des Servers, an dem der Benutzer das Formular ausfüllt.
serverTime Uhrzeit in der Zeitzone des Servers, zu der der Benutzer das Formular ausfüllt.
clientDate Datum in der Zeitzone des Benutzer, an dem er das Formular ausfüllt.
clientTime Uhrzeit in der Zeitzone des Benutzers, zu der er das Formular ausfüllt.
timezone Zeitzone, die der Benutzer in seinem Browser eingestellt hat (Beispiel: Europe/London).
language Sprache, die der Benutzer in seinem Browser eingestellt hat. Diese wird in Form des Länderkürzels (de, en, etc.) angegeben.
ip IP-Adresse, die dem Computer des Benutzers von seinem Provider
zugewiesen wurde.
referer URL, von der aus die Webseite mit dem Formular aufgerufen wurde (auch als Herkunftsseite oder History beim Browser bekannt). Als Wert wird eine relative oder absolute URL angegeben.

Das Ausgabeformat richtet sich jeweils nach der vom Benutzer eingestellten Browser-Sprache (Beispiel für Deutsch: 30.04.2025, 15:59)

Möchten Sie beispielweise Datum und Uhrzeit als Vorbelegung eines Feldes verwenden, so können Sie dies durch folgenden Eintrag im Feld „Wert“ erreichen:
Eingabe: ${clientDate} ${clientTime} Uhr
Ausgabe: 22.06.2025, 13:36 Uhr

Mailversand: prüfen, ob Feld ausgefüllt worden ist

Sie können Variablen im Nachrichtentext des Mailversands so verwenden, dass sie nur dann ausgegeben werden, wenn sie vom Nutzer ausgefüllt worden sind. Hierfür muss folgende Syntax benutzt werden:

<#if formularfeldname!="">Feldname: ${formularfeldname}</#if>