Formularfelder

Für die Modellierung von Formularen stehen verschiedene Felder zur Verfügung. Alle Felder haben folgende Konfigurationen gemeinsam, die über den Edit Button geöffnet werden können:

Allgemein

• Key: Der Schlüssel, unter dem der Wert gespeichert wird.
• Titel: Der Titel des Formularfelds.
• Beschreibung: Ein Infotext, der über ein Tooltip am Formularfeld angezeigt werden kann.
• Readonly: Gibt an, ob der Bearbeiter das Feld nur lesen darf. !ACHTUNG! Wenn die Checkbox gesetzt wurde und der Haken entfernt wird, ist im Schema false als Wert hinterlegt. Dies kann dazu führen, dass readonly bei Objekten nicht richtig vererbt wird.
• Default: Der Wert, mit dem das Formular vorbefüllt wird.

Außer dem Allgemein Tab, gibt es noch weitere Einstellungsmöglichkeiten.

Optionen

In den Optionen können Oberflächenelemente konfiguriert und Übersetzungstexte konfiguriert werden.

• Dense: Gibt an, ob das Formularfeld schmaler angeordnet werden soll.
• Outlined: Gibt an, ob das Formularfeld mit einem Rahmen angezeigt werden soll.
• Standardgröße: Die Größe auf normalen Endgeräten.
• Größe auf kleinen Geräten: Die Größe auf mobilen Endgeräten.

Validierung

Validierungen schränken den Wertebereich der Eingabe ein.

• Pattern: Ein regulärer Ausdruck, der die Eingabe einschränkt.
• required: Gibt an, ob das Feld ein Pflichtfeld ist.
• min. Länge: Die minimale Länge der Eingabe.
• max. Länge: Die maximale Länge der Eingabe.

Die Validierungen können je nach Feldtyp variieren.

Textfeld

Ein Textfeld ist ein Feld, in das ein Text eingegeben werden kann. Dieses besteht aus einer Zeile.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Textarea

Eine Textarea ist ein Feld, in das ein Text eingegeben werden kann. Im Gegensatz zum Textfeld besteht dieses aus mehreren Zeilen.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

TIP

Für längere Inhalte, die "readonly" angezeigt werden sollen, ist dieses Feld zu empfehlen. Bei einem Text Input ist die Höhe des Felds häufig nicht ausreichend, um die komplette Eingabe anzuzeigen.

TIP

Es ist sinnvoll, bei einer Textarea die Regel maxLength zu konfigurieren, da die Datenbank eine Limitierung von 2000 Zeichen pro Feld hat.

Zahl

Ein Zahl ist ein Feld, in das eine Ganzzahl eingegeben werden kann.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Gleitkommazahl

In dieses Feld kann eine Gleitkommazahl eingegeben werden. Im Gegensatz zum Zahl Feld ist hier ein . als Trennzeichen erlaubt.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Checkbox

Eine Checkbox ist ein Feld, das einen Ja/Nein Wert repräsentiert.

TIP

Sollte vom Bearbeiter etwas bestätigt werden müssen, um das Formular abzuschließen, dann ist es sinnvoll, eine Checkbox in Kombination mit der "required" Regel zu verwenden. Diese eignet sich beispielsweise für AGBs oder Hinweistexte, die bestätigt werden müssen.

Datum

Über dieses Feld kann ein Datum eingegeben werden.

Anzeige

Im Formular wird das Feld wie folgt angezeigt.

Das Datum kann wahlweise über die Tastatur eingegeben oder über den Pop-Up-Kalender ausgewählt werden:

Zeit

Über dieses Feld kann eine Uhrzeit eingegeben werden.

Anzeige

Im Formular wird das Feld wie folgt angezeigt. Über das Kontextmenü kann die Uhrzeit ausgewählt werden:

Auswahl

In diesem Feld kann eine Auswahl aus vordefinierten Werten getroffen werden. Diese können bei der Erstellung im Kontextmenü hinzugefügt werden.

Einstellungen

Auswahlmöglichkeiten können über das Kontextmenü hinzugefügt werden.

• Titel: Anzeige im Formular
• Wert: Der Wert, der gespeichert wird

Zudem kann die Anzeige der Auswahlmöglichkeiten konfiguriert werden.

• select Die Auswahlmöglichkeiten werden als Dropdown angezeigt
• radio Die Auswahlmöglichkeiten werden als Radio Buttons angezeigt

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Mehrfachauswahl

Die Mehrfachauswahl ist eine Auswahlmöglichkeit, bei der mehrere Werte ausgewählt werden können.

Einstellungen

Die Einstellungsmöglichkeiten sind nahezu die gleichen wie bei der Auswahl. Es gibt lediglich einen Unterschied bei der Auswahl an Anzeigemöglichkeiten.

• select Die Auswahlmöglichkeiten werden als Dropdown angezeigt
• checkbox Die Auswahlmöglichkeiten werden als Checkboxen angezeigt
• switch Die Auswahlmöglichkeiten werden als Switch Buttons angezeigt

Dateien

Über dieses Feld können Dateien hochgeladen und angezeigt werden.

Für folgende Dateitypen kann der Input eine Preview anzeigen:

• jpeg

• png

• pdf

Der Upload ist standardmäßig auf max. 10 Dateien mit je max. 10MB beschränkt. Diese Beschränkungen können konfiguriert werden.

Einstellungen

• Dateipfad Über den Dateipfad kann der Pfad angegeben werden, in dem die Dateien gespeichert werden sollen oder aus dem Dateien geladen werden sollen.
  • Das Datei-Upload-Feld zeigt jeweils nur Dateien aus dem angegebenen Ordner an. Dateien aus Unterordnern werden nicht angezeigt.
• Eindeutiger Identifikator Erzeugt einen eindeutigen Identifikator, der an den Dateipfad angehängt wird. Diese Einstellung sollte in Objektlisten verwendet werden.

Konfiguration

Das Datei-Upload-Feld benötigt eine zusätzliche Konfiguration im Usertask des Prozesses, damit Dateien gespeichert und gelesen werden können.

In den Inputparametern S3 Pfade für Schreibrechtigungen (app_file_paths) und S3 Pfade für Leseberechtigungen (app_file_paths_readonly) müssen im Usertask der oder die Ordner angegeben werden, auf die der User zugreifen darf. Wird ein Datei-Upload-Feld bei Prozessstart verwendet, müssen die beiden Parameter als Prozessconfig gesetzt werden. Ordnernamen können als Semikolon-separierte Liste angegeben werden ( z.B. ordner1;ordner2).

Weitere Informationen zur Konfiguration von Prozessen finden Sie unter:

• Benutzeraufgaben
• Prozesskonfiguration

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

WARNING

Das Datei-Upload-Feld (multi-file input) wird immer in voller Breite (12 Spalten) angezeigt. Auch wenn die Breite des Feldes konfiguriert werden kann wird es trotzdem in voller Breite angezeigt. Dieser Fehler ist bekannt und kann aktuell nicht behoben werden (siehe (opens new window)).

Benutzerauswahl

Über dieses Feld können Benutzer in der Benutzerverwaltung durchsucht und ausgewählt werden.

Einstellungen

• LDAP-Gruppen Über die LDAP-Gruppen kann die Auswahl der Benutzer in der Oberfläche eingegrenzt werden.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Mehrfache Benutzerauswahl

Über dieses Feld können mehrere Benutzer ausgewählt werden. Bei den Einstellungsmöglichkeiten unterscheidet es sich nicht von der Benutzerauswahl.

Schalter

Bei diesem Feld handelt es sich um einen Schalter, der einen Ja/Nein Wert repräsentiert. Dieser unterscheidet sich lediglich in der Anzeige von der Checkbox.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Liste

Über dieses Feld können primitive Datentypen in einer Liste gespeichert und angezeigt werden.

Einstellungen

• Typ Der Typ der Liste, kann zwischen String und Integer gewählt werden.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

Markdown

Über dieses Feld kann ein Markdown-Text eingegeben oder angezeigt werden.

TIP

Dieses Feld wird häufig verwendet, um in Verbindung mit einem default Wert und readonly dem Benutzer formatierte Inhalte anzuzeigen.

Anzeige

Im Formular wird das Feld wie folgt angezeigt:

DMS-Input

Über dieses Feld können die Metadaten von einem DMS-Objekt abgerufen und angezeigt werden.

Einstellungen

• Objektklasse Über die Objektklasse wird das DMS-Objekt ausgewählt, von dem die Metadaten abgerufen werden sollen. Es muss eine Objektklasse ausgewählt werden. Die folgenden Objektklassen stehen zur Auswahl:
  • Sachakte
  • Vorgang
  • Eingang
  • Ausgang
  • Intern
  • Schriftstueck
• Default Über den Default-Wert kann eine Liste an COOs oder Links zu Objekten angegeben werden. Die Metadaten werden beim Öffnen des Formulars aus dem DMS geladen.
• Minimale Anzahl an Objekten Über dieses Feld wird definiert, wie viele Objekte mindestens über den Input übergeben werden müssen. Der DMS-Input kann somit als Pflichtfeld deklariert werden.
• Maximale Anzahl an Objekten Über dieses Feld wird definiert, wie viele Objekte maximal über den Input übergeben werden dürfen.

Anzeige

Im Formular wird das Feld wie folgt angezeigt: