Flex-Module im Formular

Allgemeines

Das Template “Formular” hat zum Teil eigene Flex-Module, die für kein anderes Template in Imperia existieren. Diese werden im Folgenden beschrieben. Information über die allgemeinen Flex-Module finden Sie im Bereich Flex-Module.

Hinweis: Viele Flex-Module für das Formular verfügen über weitere Optionen, die auf dem zweiten Reiter sichtbar werden. Hier können meist optionale Einstellungen vorgenommen werden.

Datenschutzhinweis

Das Template “Formular” ist nicht dafür geeignet, Online-Anträge oder Übermittlungen im Sinn von E-Government zu erstellen. Sprechen Sie gegebenenfalls vor einer Umsetzung Ihre Anforderungen mit der Landesredaktion ab. Für solche Anwendungsfälle sind entweder eigene Online-Anwendungen zu nutzen oder der IKT-Basisdienst “Digitaler Antrag” zu verwenden. Hinweise zu den Anforderungen an Online-Anwendungen finden Sie auch in den Vorgaben der Landesredaktion.

Auswahlfeld

Mit einem Auswahlfeld können Sie den Nutzer*innen eine Liste von Auswahlmöglichkeiten zum Anklicken vorgeben. Es kann eine Einfach- oder eine Mehrfachauswahl gewählt werden.

FormFormular für das "Auswahlfeld" im Edit - Felder sind im Text beschrieben.

Formular-Flex-Modul "Auswahlfeld"

Flex-Inhalt

Titel / Überschrift

Als Erstes sollten Sie einen aussagekräftigen Titel für das Formularfeld eintragen. Einen solchen Titel braucht jedes Formularfeld, damit die Nutzer*innen sofort verstehen, welche Information abgefragt wird.
Ohne einen Titel kommt es zu Fehlermeldungen.

Auswahlfeld: Einfachauswahl Typ “Select”

Hier können die Nutzer*innen nur exakt eine Option wählen. Mit dem Select-Feld generieren Sie eine ausklappbare Liste an Optionen.

Auswahlfeld: Einfachauswahl Typ “Radiobuttons”

Auch hier kann nur exakt eine Option gewählt werden. Die Optionen sind alle direkt sichtbar. Sie können auswählen, ob die Optionen nebeneinander oder untereinander dargestellt werden.

Auswahlfeld: Mehrfachauswahl Typ “Multiselect”

Hier können die Nutzer*innen mehrere oder auch alle Felder auswählen.
Mit dem Multiselect-Feld generieren Sie eine ausklappbare Liste an Optionen. Den User*innen wird am Feld eine kleine Hilfe angezeigt.

Auswahlfeld: Mehrfachauswahl Typ “Checkboxes”

Die Optionen sind alle direkt sichtbar und es können mehrere oder auch alle gewählt werden. Sie können auswählen, ob die Optionen nebeneinander oder untereinander dargestellt werden.

Auswahloptionen

Geben Sie hier eine durch Zeilenumbrüche unterteilte Liste von Optionen vor. Der Wert, der dabei dem Nutzer angezeigt wird, wird Ihnen auch beim Absenden des Formulars übermittelt.

Wenn andere Werte in der E-Mail oder der Datenbank stehen sollen, verwenden Sie bitte folgende Syntax: Übermittelter Wert:Angezeigter Wert

Um einen Doppelpunkt für die Ausgabe zu erzeugen, müssen Sie diesen so schreiben: \:

Pro Auswahlfeld kann die Liste der zu “übermittelnden Werte” keine Doppelungen enthalten. Die Auswahl “Äpfel, Äpfel, Birnen” wird z.B. auf “Äpfel, Birnen” gekürzt.

Formular im Edit:Formular im Edit für die weiteren Einstellungen für das "Auswahlfeld", Formularfelder werden im Text beschrieben.

Weitere Einstellung im "Auswahlfeld"

Reiter "Weitere Einstellungen"

Standardwert / Vorgabe

Sie können den Feldern einen Standardwert mitgeben, der beim Aufruf der Seite bereits ausgewählt ist. Nutzer*innen können diesen aber jederzeit verändern. Wenn Sie bei den Auswahloptionen eine Unterscheidung zwischen übermitteltem und angezeigtem Wert haben, reicht beim Standardwert die Eintragung des übermittelten Werts.
Wenn Sie bei Checkboxen und dem Multiselect mehrere Einträge vorauswählen möchten, geben Sie diese mit Komma (ohne Leerzeichen) getrennt ein.

Priorität

Mit der Priorität des Eingabefeldes legen Sie fest, ob dieses Feld optional oder obligatorisch ist. Wenn es ein Pflichtfeld wird, erscheint für die Nutzer*innen automatisch ein Sternchen hinter dem Namen und über dem Formular wird ein Hinweis zum Ausfüllen der Pflichtfelder angezeigt.

ID

Bei einer Verwendung des Formulars mit einer Datenbank kann es sinnvoll sein, eine spezielle ID zu verwenden. Diese darf nur aus Buchstaben und Ziffern sowie Unterstrichen bestehen und auf einer Seite nur einmalig verwendet werden. Beim E-Mailversand kann in der E-Mail auch die ID angezeigt werden.

Optionsgruppen

Bei Select- und Multiselect-Feldern können Sie den Inhalt der Liste auch durch Zwischenüberschriften in Optionsgruppen unterteilen lassen. Gerade bei längeren Listen erhöht das stark die Lesbarkeit. Eine Optionsgruppe wird automatisch beim Wechsel des Anfangsbuchstabens der Optionen erzeugt. Eine selbst gewählte Unterteilung ist nicht möglich.

Hilfetext

Es ist möglich, zu jedem Feld einen kurzen Hilfetext einzutragen. Wenn ein Hilfetext eingetragen wurde, erscheint neben dem Titel ein Fragezeichen-Symbol. Wenn Nutzer*innen mit der Maus auf das Fragezeichen-Symbol klicken, wird die Hilfe als Overlay auf der rechten Seite angezeigt.

Auswahlfeld mit Langbeschreibung

Beim Auswahlfeld mit Langbeschreibung handelt es sich um eine spezielle Form eines Auswahlelements. Die Idee dabei ist, für jede Option einen eigenen Teaser mit einem ggf. längeren Text anzulegen. Bei diesem Formularelement können mehrere Module zu einer Frage zusammengefasst und entsprechend ausgewertet werden.

Alle eingesetzten Module für eine Frage müssen dieselbe ID haben. Wenn Sie mehrere Fragen mit einer Langbeschreibung haben, müssen je Frage unterschiedliche IDs verwendet werden.

Redaktioneller Hinweis

Wenn Sie mehrere Auswahlfelder mit Langbeschreibung verbinden, können diese nicht als Pflichtfelder gekennzeichnet werden. Mit der Kennzeichnung als Pflichtfeld müssen alle Antworten aktiviert werden, es kann keine Auswahl getroffen werden. Wenn Sie den Nutzer*innen eine Auswahl als Pflichtfeld anbieten möchten, nutzen Sie bitte das Modul “Auswahlfeld”.

Formular für die Langbeschreibung des Auswahlfeldes, Formularfelder werden im Text beschrieben.

Flex-Modul - Auswahlfeld Langbeschreibung

Reiter "Flex-Inhalt"

Titel

Der Titel ist der eigentliche Auswahltext, der beim Absenden des Formulars übertragen wird. Hier sollte also ein, für den oder die Bearbeiter*in, aussagekräftiger Titel festgelegt werden.

ID

Dieses Modul funktioniert nur, wenn das Feld ID gefüllt wurde. Durch die Verwendung derselben ID werden alle zusammengehörigen Module zu einer gemeinsamen Frage oder Auswahlmöglichkeit verbunden. Eine ID darf nur aus Buchstaben (ohne Umlaute) und Ziffern bestehen. Wenn also Ihre Frage aus 3 Auswahlfeldern besteht, benötigen diese 3 Module eine identische ID.

Typ des Auswahlfeldes

Beim Typ des Auswahlfeldes stehen hier nur Radiobuttons (Einfachauswahl) und Checkboxen (Mehrfachauswahl) zur Verfügung. Die anderen Optionen des Auswahlfeldes können den Beschreibungstext nicht darstellen. Für alle Felder mit derselben ID muss hier dieselbe Auswahl getroffen werden.

Beschreibungstext

Der Beschreibungstext wird zusätzlich zum Auswahltext angezeigt. Dieser Text wird beim Absenden des Formulars nicht übertragen und eignet sich für längere Erklärungen. Im Beschreibungstext kann die Textformatierung mit Textile verwendet werden.

Formular für die weiteren Einstellungen im Auswahlfeld Langbeschreibung

Formular im Edit - Auswahlfeld Langbeschreibung - Weitere Einstellungen

Reiter "Weitere Einstellungen"

Priorität des Eingabefeldes

Mit der Priorität des Eingabefeldes legen Sie fest, ob dieses Feld optional oder obligatorisch ist. Wenn es ein Pflichtfeld wird, erscheint für die Nutzer*innen automatisch ein Sternchen hinter dem Titel und über dem Formular wird ein Hinweis zum Ausfüllen der Pflichtfelder angezeigt. Für alle Felder mit derselben ID muss hier dieselbe Auswahl getroffen werden.

Bitte nutzen Sie die Option “obligatorisch” nur für einzeln stehende Flex-Module. Wenn Sie mehrere Flex-Module zu einer Frage zusammenziehen, sollten die Felder “optional” sein.

Standardwert / Vorgabe

Bei den Auswahlfeldern mit Langbeschreibung können Sie auswählen, welches der zu einer Frage gehörenden Module als Standardwert vorausgewählt werden soll. Bei einer Einfachauswahl ist dies nur für eine Antwort pro ID möglich, bei einer Mehrfachauswahl für beliebig viele Antworten.

Hilfetext

Es ist möglich, zu jedem Feld einen kurzen Hilfetext einzutragen. Wenn ein Hilfetext eingetragen wurde, erscheint neben dem Titel ein Fragezeichen. Wenn Nutzer*innen mit der Maus auf das Fragezeichen-Symbol klicken, wird die Hilfe als Overlay auf der rechten Seite angezeigt.

Anzeigeart des Beschreibungstextes

Es gibt die Möglichkeit für den Beschreibungstext verschiedene Verhalten zu wählen. Bei der Anzeigeart des Beschreibungstextes können Sie zwischen folgenden Optionen wählen:

  • Text wird beim Berühren mit Mauszeiger angezeigt – Wenn sich der Nutzer mit der Maus über dem Titel befindet, wird der Beschreibungstext angezeigt.
  • Text immer anzeigen – Der Beschreibungstext wird immer unter dem Titel angezeigt.
  • Text wird beim Anklicken angezeigt – Wenn der Nutzer auf den Titel klickt und mit der Maus auf dem Titel verharrt, wird der Beschreibungstext angezeigt.
  • Text wird aufgeklappt – Hinter dem Titel wird ein Link (Text wählbar) angezeigt. Wenn Nutzer*innen dort klicken, klappt der Beschreibungstext auf und bleibt bis zum Schließen sichtbar.

Aus Sicht der Barrierefreiheit sollte entweder die Option “Text immer anzeigen” oder “Text wird aufgeklappt” gewählt werden. Die beiden anderen Varianten sind nicht barrierefrei.

Hinweis für ausklappbaren Beschreibungstext

Hier kann der Linktext für die Option “Text wird aufgeklappt” beim vorherigen Selectfeld festgelegt werden. Wenn keine Eingabe durchgeführt wurde, wird das Wort “Details” angezeigt.

Formular für einen Blocktrenner, Formularfelder werden im Text erklärt.

Formular im Edit - Blocktrenner

Blocktrenner

Dieses Modul erzeugt einen neuen Formularblock. Sie können optional auch eine neue Blocküberschrift einfügen.

Der Block ist durch die Überschrift und den Beginn einer neuen grauen Box erkennbar.

Bitte denken Sie aber daran, wenn Sie Blocküberschriften verwenden, dass trotzdem jedes einzelne Eingabefeld im Formular immer noch eine eigene Überschrift (“Titel”) bekommen muss.

Eingabefeld

Mit dem Flex-Modul “Eingabefeld” geben Sie Nutzer*innen die Möglichkeit, eine direkte (Text-) Eingabe im Formular vorzunehmen. Dabei können Sie bestimmen, welche Art von Eingaben Nutzer*innen tätigen können.

Formular im Edit - Eingabefeld Inhalt

Eingabefeld Inhalt

Reiter "Flex-Inhalt"

Titel

Vergeben Sie einen aussagekräftigen Titel. Wenn kein Titel vergeben wird, kommt es zu Fehlermeldungen

Typ des Eingabefeldes

Beim Typ des Eingabefeldes können Sie zwischen regulären oder typisierten Feldern auswählen. Bei den regulären Feldern ist eine Freitexteingabe möglich. Die typisierten Felder zwingen die Nutzer*innen bestimmte formale Vorgaben einzuhalten. Wenn ein Feld mit einer Formvorgabe gewählt wird, wird automatisch unter dem Feld ein Eingabebeispiel angezeigt.

Hier ist – etwas versteckt – auch die beliebte Option des Datei-Uploads zu finden: Wenn Sie als Typ “Datei” angegeben haben, können Sie den Benutzer*innen ermöglichen, eine Datei (Textdokument, Foto etc.) auszuwählen, die mit dem Formularinhalt mitgeschickt wird. Die Datei wird dann dem eingereichten Datensatz (der E-Mail oder dem Datenbankeintrag) angehängt. Die Größe einer einzelnen Datei ist automatisch auf 10 MB begrenzt. Insgesamt dürfen bei allen Formular-Typen alle Anhänge nicht mehr als 16 MB groß sein.

Formular im Edit - Weitere Einstellungen für Eingabefeld, Beschreibung im Text

Formular im Edit - Weitere Einstellungen

Reiter "Weitere Einstellungen"

Priorität

Mit der Priorität des Eingabefeldes legen Sie fest, ob dieses Feld optional oder obligatorisch ist. Wenn es ein Pflichtfeld wird, erscheint für die Nutzer*innen automatisch ein Sternchen dahinter und über dem Formular wird ein Hinweis zum Ausfüllen der Pflichtfelder angezeigt.

Hilfe

Es ist möglich, zu jedem Feld einen kurzen Hilfetext einzutragen. Wenn ein Hilfetext eingetragen wurde, erscheint neben dem Titel ein Fragezeichen. Wenn Nutzer*innen mit der Maus auf das Fragezeichen-Symbol klicken, wird die Hilfe als Overlay auf der rechten Seite angezeigt.

Platzhalter / Placeholder

Zu jedem Eingabefeld können Sie einen Beispielwert als Platzhalter angeben. Der Platzhalter wird im Eingabefeld des Formulars so lange angezeigt, bis die Benutzer*innen etwas im Formularfeld eintragen. Wenn das Formularfeld nicht durch Nutzer*innen ausgefüllt wird, wird der Inhalt des Platzhalters beim Senden des Formulars nicht übertragen.

ID

Bei einer Verwendung des Formulars mit einer Datenbank kann es sinnvoll sein, eine spezielle ID zu verwenden. Diese darf nur aus Buchstaben und Ziffern sowie Unterstrichen bestehen und auf einer Seite nur einmalig verwendet werden. Beim E-Mailversand kann in der E-Mail auch die ID angezeigt werden.

Standardwert / Vorgabe

Sie können den Feldern einen Standardwert mitgeben, der beim Aufruf der Seite bereits eingetragen ist. Nutzer*innen können diesen aber jederzeit verändern. Der Wert, der hier eingetragen wird, ist ein Standardwert des Feldes und wird wie eine Eingabe der Nutzer*innen beim Versand behandelt. Der Wert muss daher dem im Reiter Inhalt gewählten Typ formal entsprechen.

  • Wenn Sie als Typ des Eingabefeldes “Datum” oder “Zeit” angegeben haben, können Sie im Feld “Standardwert” mit dem Schlüsselwort now oder today die Standardeinstellung auf das aktuelle Datum oder die aktuelle Zeit setzen.
  • Wenn Sie als Typ des Eingabefeldes “URL” angegeben haben, muss als Standardwert eine vollständige URL hinterlegt werden, wie “https://www.berlin.de/beispielseite”. Ist das nicht der Fall, erhält der Nutzer beim Absenden eine Fehlermeldung.

maximale Zeichenanzahl

Haben Sie ein mehrzeiliges Eingabefeld ausgewählt, können Sie eine maximale Zeichenanzahl festlegen und auswählen, ob ein Zeichenzähler angezeigt werden soll. Zur Wahrung der Barrierefreiheit sollte der Zeichenzähler angeschaltet werden, wenn eine Zeichenanzahl eingestellt wurde. Bei angeschaltetem Zeichenzähler und eingetragener Zeichenanzahl wird heruntergezählt, wie viele Zeichen noch durch den oder die Nutzer*in eingegeben werden kann.

Wertebereich für Datumsfelder

Bei Datumsfeldern (Typ des Eingabefeldes – Datum (TT.MM.JJJJ)) kann ein Wertebereich für die Jahre festgelegt werden. Wenn hier keine Eingaben getroffen wurden, hat der Nutzer die Auswahl an +10 Jahre und -10 Jahre von heute aus gesehen. Die Eingabe eines Wertebereichs ist sinnvoll, wenn bspw. eine Anmeldung mit Geburtsdatum erfolgen soll. Dann kann hier ein Bereich (bspw. 1930 – 2030) eingetragen werden.

Formular für den Erklärungstext

Formular im Edit - Erklärungstext

Erklärungstext

Mit diesem Modul können Sie innerhalb des Formulars zusätzliche Erklärungstexte einfügen. In diesem Modul ist Textile-Syntax möglich.

Formular im Edit - IP Adresse

Formular im Edit - IP-Adresse

IP-Adresse

Mit diesem Modul können Sie die gekürzte oder verschlüsselte IP-Adresse des Absenders mit übertragen.

Mit der verschlüsselten IP-Adresse können Sie die Original-Adresse nicht mehr erkennen, aber bei mehreren Anfragen überprüfen, ob sie von derselben IP-Adresse kamen.

Zusätzlich kann eine Kennzeichnung nach IPs aus dem Landesnetz und aus dem normalen Internet erfolgen. Eine Aufschlüsselung nach Behörden ist nicht möglich.

Datenschutzhinweis für das Modul

Die IP-Adresse ist eine personenbeziehbare Information, daher wird diese nur gekürzt oder verschlüsselt gespeichert. Wenn Sie die Information über die IP nicht zwingend benötigen, sollten Sie das Modul komplett weglassen. Wenn Sie die Information benötigen, sollten Sie ggf. die Nutzer*innen auf die Übertragung der IP hinweisen, da diese das Feld nicht direkt sehen. Bitte besprechen Sie die nötigen Hinweise mit den für Sie zuständigen Datenschutzbeauftragten.

Formular zur Einstellung eines Seitenumbruchs im fertigen Formular

Formular im Edit - Seitenumbruch

Seitenumbruch

Bitte dieses Modul nicht mehr benutzen, da es perspektivisch ausgebaut wird.

Formular zum Anlegen eines versteckten Formularfeldes

Formular im Edit - Verstecktes Formularfeld

Verstecktes Formularfeld

Mit einem versteckten Formularfeld können Sie zusätzliche Informationen versenden, die Nutzer*innen beim Ausfüllen des Formulars aber nicht direkt sehen. Hier können Sie z.B. für sich selber Notizen zum Formular hinterlegen.

Der Text dieser Felder ist im Quelltext der Formularseite sichtbar. Nutzer*innen können sich die Inhalte anzeigen lassen, z.B. über Browserinformationen. Vertrauen Sie daher diesem Feld keine geheimen Informationen an!

Bei einer Verwendung des Formulars mit einer Datenbank kann es sinnvoll sein, eine spezielle ID zu verwenden. Diese darf nur aus Buchstaben und Ziffern sowie Unterstrichen bestehen und auf einer Seite nur einmalig verwendet werden. Beim E-Mailversand kann in der E-Mail auch die ID angezeigt werden.

Formular zum Anlegen einer "Vorgangsnummer"

Formular im Edit - Vorgangsnummer

Vorgangsnummer

Mit diesem Modul können Sie eine einfache, fortlaufende Vorgangsnummer in Ihr Formular einsetzen lassen. Der mittlere Teil wird dabei automatisch aus dem Datum gebildet. Sie können aber optional ein Präfix und ein Suffix für die Vorgangsnummer festlegen.

Beispiel:
BO-2017-07-29-09-56-TEST

Bei einer Verwendung des Formulars mit einer Datenbank kann es sinnvoll sein, eine spezielle ID zu verwenden. Diese darf nur aus Buchstaben und Ziffern sowie Unterstrichen bestehen und auf einer Seite nur einmalig verwendet werden. Beim E-Mailversand kann in der E-Mail auch die ID angezeigt werden.