Formulare

Benutzerdefinierte Formulare werden an folgenden Stellen in Betlehem Booking verwendet: - Anmeldeformular - Freizeitpass - Aktionen während Veranstaltungen

Formularverhalten

Die Formulare verhalten sich dabei im Wesentlichen gleich, folgende Unterschiede sind jedoch zu beachten:

  • Das Anmeldeformular beginnt mit den foldenden Formularfeldern, die Kerninformationen abfragen und nicht über den Formulareditor editierbar sind:
    • Vor- und Nachname
    • E-Mailadresse (optional, wenn Anmeldung aus dem Backend eingetragen wird)
    • Geburtsdatum (abschaltbar, dann keine Forcierung von Altersgrenzen)
    • Geschlecht (abschaltbar, dann keine Platzzuteilung nach Geschlechtern differenziert)
  • Das Anmeldeformular und Aktionen während Veranstaltungen sind als "Einweg-Formulare" konzipiert, d.h. Pflichtfelder sind hier direkt auszufüllen, ansonsten sind sie nicht absendbar. Der Freizeitpass hingegen ist für die Bearbeitung einen längeren Zeitraum gedacht, ein Speichern ist auch ohne das Ausfüllen aller Pflichtfelder möglich. Im Teilnehmerportal (für den Teilnehmer selbst) sowie im Bereich der Teilnehmerliste (für den Verwalter) kann der Fortschritt der Pflichtfelder eingesehen werden.

Eigenschaften von Formularfeldern

Formularfelder haben gewisse Eigenschaften, die teilweise nicht bei allen Datentypen verfügbar sind:

  • Feldname: Bezeichner: Bei allen Datentypen außer Trennlinie verfügbar
  • Platzhalter: Text, welcher im Eingabefeld vor einer Benutzereingabe angezeigt wird, kann als Ausfüllhinweis verwendet werden. Nur verfügbar bei ein- und mehrzeiligem Textfeld, Personalausweisnummer, Telefonnummer, Euro, Zahl, IBAN, BIC und Juleica-Nummer.
  • Texteingabe: Angezeigter Text. Nur verfügbar bei Infotext.
  • Pflichtfeld: Binäre Option. Verhalten bei Freizeitpass und anderen Formular unterschiedlich (siehe oben unter Formularverhalten). Verfügbar bei allen Datentypen außer Zwischenüberschrift, Intotext und Trennlinie.
  • Zielgruppe: Wählbar, ob das Formularfelder nur für Teilnehmer, nur für Mitarbeiter oder bei allen Anmeldungen angezeigt werden soll. Überall verfügbar.
  • Auswahloptionen: Optionen, aus denen Gewählt werden kann. Verfügbar bei Ein- und Mehrfachauswahl.
  • Abhängigkeit: Nur anzeigen, wenn gewisse Vorbedingungen erfüllt sind (siehe unten)

Datentypen

Im Folgenden werden die verfügbaren Datentypen beschrieben. Dabei sei folgendes erwähnt: Prinzipiell ließe sich (fast) jede Abfrage durch ein Freitextfeld abbilden, dabei würden aber gewisse Vorteile gezielt liegen lassen. Wo immer möglich, sollte ein spezialisierter Datentyp verwendet werden. Zum einen können diese (automatisiert) validiert werden, um Tippfehler (beispielsweise bei Personalausweisnummern oder IBANs) direkt bei der Eingabe zu erkennen. Zum Anderen werden gewisse Datenfelder an anderen Stellen direkt adäquat dargestellt (z.B. eine Telefonnummer als wählbarer Link). Details siehe dazu bei den jeweiligen Datentypen.

Generische Eingabefelder

Einzeiliges Textfeld

Einfachstes Feld, keine Restriktionen.

Mehrzeiliges Textfeld

Ebenfalls keine Restriktionen, für längere Texte gedacht.

Zahl

Arbiträres Zahlenfeld

Datum

Auswahl wird durch den lokalen Browserkalender dargestellt, d.h. sieht auf Mobiltelefonen anders aus als in Desktopbrowsern, um die unterschiedliche Eingabephilosophie zu berücksichtigen.

Auswahlfelder

Einfachauswahl (Radio-Buttons)

Der Teilnehmer kann eine von mehreren Optionen auswählen. Diese werden als sog. Radio-Buttons dargestellt (Kreise, bei denen die ausgewählte Optionen durch einen Punkt im Kreis sichtbar ist). Sofern in den Finanzoptionen die entsprechende Option aktiviert ist, können einzelne oder alle Optionen im Anmeldeformular (und nur da) mit einem Preis versehen werden, welcher bei Auswahl zum Teilnehmerpreis hinzugerechnet wird.

Einfachauswahl (Dropdown)

Wie die Einfachauswahl (Radio-Buttons), allerdings wird hier eine Auswahlliste angezeigt, die erst beim Anklicken/Antippen vollständig sichtbar wird. Eignet sich ggf. bei Auswahlen mit einer Vielzahl von Optionen.

Mehrfachauswahl

Wie die Einfachauswahl (Radio-Buttons), allerdings Darstellung durch Checkboxen, von denen mehrere ausgewählt werden können. Bei Pflichtfeldern ist mindestens eine Option zu wählen.

Designelement

Zwischenüberschrift

Designelement.

Trennlinie

Designelement, kein Formularfeld. Kann verwendet werden, um Sinnabschnitte im Formular abzugrenzen.

Infotext

Dient dazu, Beschreibungen / Belehrungen im Formularfeld unterzubringen.

Spezielle Datentypen

Postalische Adresse

Hierbei werden drei Einzelfelder im Formular angezeigt: Straße/Hausnummer, Postleitzahl, Ort; gespeichert werden die drei Daten jedoch als zusammenhängender Datenpunkt. Die Postleitzahl wird als Zeichenkette, nicht als Zahl behandelt, da Postleitzahlen in Deutschland führende Nullen haben und im angrenzenden Ausland (z.B. NL) Buchstaben enthalten können.

Datenfelder diesen Datentyps werden u.A. an folgenden Stellen verwendet:

  • Verwendung als Rechnungsadresse
  • Verwendung in Fördermittelanträgen
  • Ermittelung des Reisepreis bei Wohnortabhänigen Preismodelln (hierbei wird gegen eine Liste von Postleitzahlen abgeglichen)
  • Ausgabe als Zugehörigkeit zu einem Bundesland (PLZ-Listen für die Bundesländer sind in Betlehem Booking hinterlegt)

Die Adresse wird dabei je nach Ausgabezweck passend formatiert, d.h. ein- oder mehrzeilig.

Telefonnummer

Bei der Eingabe werden die Daten als Telefonnummer interpretiert, d.h. es werden adäquate Leerzeichen zur Trennung von Vorwahl und Rufnummer eingefügt etc.

Alle Telefonnummern werden intern im internationalen Rufnummernformat abgespeichert (+, dann die Ländervorwahl und die Telefonnummer). Wird eine Telefonnummer ohne Ländervorwahl eingegeben, wird beim Abspeichern die deutsche Ländervorwahl (+49) hinzugefügt. Dies hat das Ziel, dass beim Anrufen einer Nummer aus dem Ausland (bei Auslandsfreizeiten) immer der Gesprächspartner im richtigen Land angerufen wird und nicht unerwünscht eine im derzeitigen Aufenthaltsland.

In digitalen Anzeigen (Teilnehmerliste, Notfallansicht) werden Telefonnummern als tel-URL ("anklickbare Telefonnummer") angezeigt, um ein direktes Anwählen zu ermöglichen.

Personalausweis / Reisepass

Eine Eingabe in dieses Feld wird darauf überprüft, ob sie eine gültige (deutsche) Ausweisnummer eines Personalausweises oder Reisepasses darstellt, nur solche korrekten Nummern werden akzeptiert.

Wichtig: Es wird nur überprüft, ob die Nummer in sich korrekt ist (Prüfziffer passt zum Rest der Nummer). Ob die Nummer zum gegebenen Teilnehmer gehört, sie einen Ausweis repräsentiert und wenn ja, dieser gültig ist, wird nicht überprüft.

Kontakt-/Telefonliste

Dynamisches Feld, bei dem so viele Paare aus Name/Beschreibung und Telefon angegeben werden können wie gewünscht. Die Telefonnummernfelder werden dabei wie bei einzelnen Telefonnummern behandelt.

Kann z.B. dafür verwendet werden, Notfallkontakte für eine mehrtägige / mehrwöchige Freizeit abzufragen, da hier ein einzelner Notfallkontakt nicht immer während der gesamten Zeit erreichbar ist.

Staatsangehörigkeit

Dropdownmenü mit allen Ländern nach ISO 3166-1. Steht standardmäßig auf Deutsch.

IBAN

IBAN (Internationale Kontonummern) werden als solche formatiert (Leerzeichen alle 4 Zeichen) und mit ihrer Prüfsumme validiert. Eine ungültige IBAN wird nicht akzeptiert.

Euro

Es ist nur eine Eingabe von Zahlen mit zwei Nachkommastellen möglich.

BIC

BIC (Internationale Bankleitzahlen) sind in der Länge auf 11 Zeichen begrenzt (gültige BICs haben 8 oder 11 Zeichen). Eine Prüfsummenvalidierung ist hier nicht verfügbar.

Juleica-Nummer

Numerische Eingabe (wird nicht als Zahl interpretiert, da führende Nullen möglich). Zur Validierung siehe Juleica-Validierung.

Spezielle Datenfelder

Abfrage Geschwisterrabatt

Sofern das Preismodell "Einheitlicher Kostenbeitrag mit Geschwisterrabatt und speziellem Mitarbeiterpreis" gewählt wurde, ist in der Anmeldung zwingend eine Abfrage, ob dieser Rabatt in Anspruch genommen werden soll, hinzuzufügen. Die Fragestellung ist frei formulierbar, die Antwortmöglichkeiten lauten immer "Ja" und "Nein".

Preisauswahl

Sofern das Preismodell "Auswählbarer Kostenbeitrag mit speziellem Mitarbeiterpreis" gewählt wurde, ist in der Anmeldung eine Abfrage nach dem gewählten Preis hinzuzufügen. Die auswählbaren Preise ergeben sich aus der Konfiguration in den Finanzoptionen.

Weitere Spezialoptionen

Je nach Sonderanforderungen können weitere Datentypen sichtbar sein, die z.B. für gewisse kundenspezische Erweiterungen/Förderanträge genutzt werden müssen. Diese sind nicht an dieser Stelle, sondern in den jeweiligen Leistungsbeschreibungen.

Abhängigkeiten

Nicht in jedem Fall muss das gesamte Formular ausgefüllt werden. In vielen Fällen sind gewisse Formularfelder nur dann relevant, wenn gewisse Bedingungen erfüllt sind. Beispiele dafür können sein:

  • Es gibt eine Abfrage, ob eine finanzielle Unterstützung benötigt wird, um den Teilnehmerbeitrag zu stemmen. Nur wenn diese Abfrage positiv ist, ist eine Begründung für eine solche Bedürftigkeit notwendig.
  • Es gibt eine Abfrage zu einer Workshopwahl bei einer Veranstaltung. Nur wenn am Workshop Kanufahren teilgenommen wird, wird die Kleidergröße für die Schwimmweste benötigt. Bei der Teilnahme an einem Bandworkshop hingegen ist die Frage relevant, welches Instrument gespielt wird.

Dabei haben Abhängigkeiten folgende Struktur:

  • Sie haben einen Namen
  • Sie haben eine oder mehrere Bedingungen, die erfüllt werden können. Diese Bedingungen beziehen sich auf Felder im Formularfelder. Als Quellfelder für Bedingungen stehen dabei Auswahlfelder (sowohl Einfach- als auch Mehrfachauswahlen) sowie auf ihnen aufbauende Felder (z.B. die Abfrage nach einem Geschwisterrabatt) zur Verfügung. Eine Bedingung besteht dabei jeweils aus einem Quellfeld und einem Wert für diesen.
  • Sie haben die Einstellung, ob die Abhängigkeit als Ganzes erfüllt ist, wenn mindestens eine Bedingung erfüllt ist oder ob sie erst dann als Ganzes erfüllt ist, wenn alle Bedingungen erfüllt sind.

Formularfelder wiederum können dann so konfiguriert werden, dass sie nur sichtbar sind, wenn eine Abhängigkeit erfüllt ist. Dabei gilt, dass eine abhängiges Pflichtfeld nur dann ein verpflichtend ist, wenn es sichtbar (seine Vorbedingung also erfüllt) ist. So kann im zweiten obigen Beispiel die Kleidergröße verpflichtend werden, wenn der Kanuworkshop gewählt ist, andernfalls wird sie jedoch gar nicht abgefragt.

Während der Erstellung können auch Abhängigkeitskonstellationen erstellt werden, die unsinnig oder irreführend sind (beispielsweise ein abhängiges Feld, welches im Fomular weiter oben steht als das Feld, von dem es abhängig ist oder ein Feld, welches nur für Mitarbeiter sichtbar sein soll und von einem Feld abhängen soll, welches wiederum nur für Teilnehmer sichtbar ist). Solche Fälle führen unmittelbar zu Warnungen bzw. Fehlern, so dass sie direkt korrigiert werden können.