Dokumentation

Formulare

Plugin-Formulare für Manager-Aktionen und geführte Eingaben.

Allgemein

Plugin-Formulare sind normale simplebis-Formulare, die einem Plugin zugeordnet werden. Sie werden im Plugin-Editor unter Formulare angelegt und können anschließend von Plugin-Funktionen verwendet werden, zum Beispiel als Aktion auf einer Datentyp-Übersichtsseite.

Einstellungen

Plugin-Formulare verwenden die Formularlogik des Systems. Dadurch stehen die üblichen Formularfelder, Validierungen und Formular-Einstellungen zur Verfügung. Beim Speichern setzt simplebis automatisch Environment und Plugin-Zuordnung.

Zusätzlich kann Formular-Code vor dem Speichern ausgeführt werden. Der Code erhält die eingegebenen Formulardaten und kann bei Bedarf eine Manager-Aktualisierung auslösen. Wenn der Code einen Fehler zurückgibt, wird dieser im Manager angezeigt.

Verwendung im Manager

Ein Plugin-Formular kann als Aktion eines Plugin-Datentyps eingebunden werden. Klickt ein Benutzer auf diese Aktion, öffnet der Manager das Formular in einem Modal. Nach dem Speichern kann die umgebende Manager-Ansicht neu geladen werden, wenn das Formular dies anfordert.

Dadurch eignen sich Plugin-Formulare für geführte Eingaben, Sammelaktionen, kleine Assistenten oder Aktionen, die nicht direkt an einen einzelnen Datensatz gebunden sind.

Beispiele

Beispiele sind ein Formular zum Generieren mehrerer Datensätze, ein Formular zum Starten einer externen Synchronisation mit Zusatzdaten, ein Assistent zum Erstellen einer Kampagne oder ein internes Prüf- und Freigabeformular.