Skip to Content

Formulare

Nicht jede Information stammt von einem Sensor oder einem automatisierten System. Manchmal braucht man den menschlichen Faktor — und genau dafür gibt es das Formular-Widget. Betrachten Sie es als Ihr digitales Klemmbrett in IronFlock. Verwenden Sie es immer dann, wenn Sie Daten manuell erfassen möchten, zum Beispiel:

  • Ausschusszählung an der Produktionslinie erfassen
  • Messwerte eines analogen pH-Sensors eintragen
  • Inspektionsnotizen während eines Fabrikrundgangs protokollieren
Forms widget demo

Wie Formulare funktionieren

Wenn jemand ein Formular absendet, werden die Daten in einer dafür vorgesehenen Tabelle in der Datenbank Ihrer App gespeichert. Jedes Feld im Formular entspricht einer Spalte in dieser Tabelle, und alle Felder werden beim Absenden gemeinsam als neue Zeile gespeichert.

Was Sie im Formular-Widget konfigurieren:

  • Einen Titel für das Formular
  • Ein oder mehrere Felder, jeweils mit Beschriftung, Eingabetyp und der Tabellenspalte, in die geschrieben werden soll
  • Optionale Validierungsregeln und Standardwerte pro Feld
  • Optionale Texte für die Buttons (Button Labels), etwa Speichern statt Submit, und eine Seite, die nach dem Speichern geöffnet wird (Post-Submit Navigation)

Verfügbare Feldtypen: Dropdown (Auswahl aus einer Liste), Text, Zahl, Checkbox und Datum/Uhrzeit-Auswahl.

Felder anordnen

Standardmäßig nimmt jedes Feld eine ganze Zeile ein, eines unter dem anderen. Ein langes Formular lässt sich leichter ausfüllen, wenn zusammengehörige Felder nebeneinander stehen und unter Überschriften gruppiert sind:

  • Width: Jedes Feld kann eine ganze Zeile, drei Viertel, zwei Drittel, die Hälfte, ein Drittel oder ein Viertel einer Zeile einnehmen. Die Felder füllen jede Zeile von links nach rechts, und ein Feld, das nicht mehr hineinpasst, beginnt die nächste Zeile. Legen Sie unter Field Layout eine Default Field Width fest, um allen Feldern dieselbe Breite zu geben, und ändern Sie dann einzelne Felder nach Bedarf.
  • Start a New Row: Das Feld beginnt eine neue Zeile, auch wenn es noch neben das vorherige passen würde.
  • Abschnitte: Ein Feld vom Typ section fügt eine Überschrift mit einem optionalen Hinweis darunter ein. Es fasst die folgenden Felder bis zum nächsten Abschnitt zu einer Gruppe zusammen. Seine Field Width in Group legt die Breite all dieser Felder auf einmal fest, und sein Conditional Display blendet die ganze Gruppe ein oder aus, zum Beispiel Einstellungen, die nur für eine Maschinenart gelten.
  • Density: Neue Formulare beginnen mit Compact, also mit kleineren Feldern für Desktop-Boards, die mit der Maus bedient werden. Wählen Sie Comfortable für die größeren Felder, die sich für Touchscreens eignen.

Das Formular passt sich dem verfügbaren Platz an. In einer kleinen Kachel oder auf einem Smartphone werden die Felder schrittweise breiter, bis sie in einer einzigen Spalte untereinander stehen, sodass jedes Feld lesbar bleibt. Minimum Field Width legt fest, wie schmal ein Feld werden darf, bevor das geschieht.

Wo landen die Daten?

Jede Formularübermittlung fügt eine neue Zeile zur Tabelle hinzu. So erhalten Sie eine vollständige Historie aller Einträge — nichts wird überschrieben oder geht verloren.

Stellen Sie sicher, dass Sie alle erforderlichen Felder konfigurieren, damit jede neue Zeile vollständig und konsistent ist.

Den aktuellen Stand im Blick behalten

Wenn Sie Formulare verwenden, um den aktuellen Zustand von Maschinen oder Anlagen zu verfolgen — wie das neueste Inspektionsergebnis pro Maschine — kann IronFlock Ihnen nur den neuesten Eintrag für jedes Element anzeigen. Der App-Entwickler aktiviert dies, indem er der Tabelle mitteilt, welche Spalten eine Entität identifizieren, zum Beispiel den Maschinennamen.

Wenn dies eingerichtet ist, aktivieren Sie den latest-Schalter in den Filtereinstellungen eines Widgets, und das Widget zeigt nur die aktuelle Zeile pro Maschine oder Anlage an. IronFlock ermittelt bei jedem Lesen der Tabelle durch das Widget neu, welche Zeile das ist, und jede neue Übermittlung ersetzt die Zeile des Elements auf dem Board, sobald sie eintrifft — eine verspätete oder korrigierte Übermittlung lässt auf dem Board also niemals einen veralteten Wert stehen. Die gesamte Übermittlungshistorie bleibt weiterhin verfügbar, falls Sie sie überprüfen möchten.

In einer solchen Tabelle braucht ein Formular ein Feld für die Spalten, die die Entität identifizieren, und sonst nur für die Spalten, die es bearbeitet. Jede Übermittlung behält den aktuellen Wert jeder Spalte, die das Formular nicht schreibt. Die Felder des Formulars werden immer geschrieben: Ein geleertes Zahlenfeld leert seine Spalte, ein geleertes Textfeld speichert leeren Text, und ein durch eine Anzeigebedingung ausgeblendetes Feld leert seine Spalte. Ein Feld mit Standardwert schreibt den Standardwert, statt die Spalte leer zu lassen.

Einen Datensatz aus einer Tabelle bearbeiten

Damit Benutzer einen vorhandenen Datensatz öffnen und ändern können, kombinieren Sie eine Tabelle mit einem Formular auf derselben Seite:

  1. Geben Sie der Tabelle eine Spalte vom Typ Edit button, gebunden an die Spalte, die den Datensatz identifiziert, etwa den Maschinennamen, und setzen Sie ihren URL Parameter Key, zum Beispiel edit. Jede Zeile zeigt dann ein Stift-Symbol. Ein Klick schreibt den Schlüssel der Zeile in die URL der Seite (?edit=press-1), so wie ein Filter-Widget seinen Parameter setzt.
  2. Fügen Sie derselben Seite ein Formular hinzu, schalten Sie seinen Form Open Button ein und setzen Sie Open on URL parameter auf denselben Namen. Auf einem Board zeigt das Formular keinen eigenen Button: Es öffnet sich als Dialog, sobald die URL den Parameter enthält, und schließt sich wieder, wenn der Benutzer speichert oder abbricht, wodurch der Parameter aus der URL entfernt wird.
  3. Binden Sie den Pre-filled Value jedes Feldes an die Spalte des Datensatzes, mit einem Filter auf der identifizierenden Spalte, dessen Wert aus dem Filterparameter edit kommt, und eingeschaltetem Latest-Schalter. Das Feld, das die identifizierende Spalte schreibt, ist ein Hidden Field mit derselben Bindung, damit das Speichern denselben Datensatz trifft. Wie im vorigen Abschnitt behält jede Spalte, die das Formular nicht schreibt, ihren Wert.

Der Dialog zeigt einen Fortschrittsbalken, bis die Werte des Datensatzes eingetroffen sind. Mit eingeschaltetem latest-Schalter zeigt die Tabelle die gespeicherte Änderung, sobald sie abgelegt ist. Eine als Lesezeichen gespeicherte URL mit dem Parameter öffnet den Dialog sofort, und der Zurück-Button des Browsers schließt ihn.

Ein separates Formular mit eigenem Öffnen-Button legt weiterhin neue Datensätze an. Außerhalb eines Boards, in der Vorschau des Widget-Editors, behält ein Formular seinen Button, damit Sie es ausprobieren können.

Daten löschen

IronFlock verfolgt auch beim Löschen einen Append-Only-Ansatz. Anstatt eine Zeile zu entfernen, sendet ein Formular einen neuen Eintrag, der den Datensatz in der deleted-Spalte der Tabelle als gelöscht markiert, einer booleschen Spalte, die der App-Entwickler der Tabelle hinzufügt. Einen eigenen Löschen-Button gibt es dafür nicht: Ein Löschformular ist ein Formular, auf dessen Absenden-Button Löschen steht.

So können Benutzer einen Datensatz mit Rückfrage aus einer Tabelle löschen:

  1. Geben Sie der Tabelle eine zweite Spalte vom Typ Edit button, gebunden an die Spalte, die den Datensatz identifiziert, mit dem URL Parameter Key delete und dem Icon delete.
  2. Fügen Sie derselben Seite ein Formular hinzu, schalten Sie seinen Form Open Button ein, setzen Sie Open on URL parameter auf delete und geben Sie ihm einen Titel wie „Diesen Datensatz löschen?“. Setzen Sie unter Button Labels das Submit Label auf Löschen und das Cancel Label auf Behalten, und wählen Sie eine rote Highlight Color.
  3. Geben Sie dem Formular genau zwei Felder, beide mit eingeschaltetem Hidden Field: eines, das die identifizierende Spalte schreibt, mit einem Pre-filled Value, der wie beim Bearbeitungsformular oben gebunden ist, aber nach dem Parameter delete filtert, und eine Checkbox, die die deleted-Spalte schreibt, mit eingeschaltetem Default Value.

Ein Klick auf das Löschen-Symbol einer Zeile öffnet den Dialog, und Löschen speichert den Schlüssel des Datensatzes mit deleted auf true. Um einen Datensatz stattdessen auf seiner eigenen Detailseite zu löschen, legen Sie dasselbe Formular dort an und setzen seine Post-Submit Navigation auf die Listenseite, zum Beispiel /machines.

Widgets, die die Datensätze auflisten, kombinieren den latest-Schalter mit einem Filter auf die deleted-Spalte (deleted ist leer oder false). Ein gelöschter Datensatz verschwindet vom Board, sobald der Eintrag eintrifft, und bleibt für Historie und Audit-Zwecke in der Datenbank erhalten. Eine View oder Transformation ist dafür nicht nötig; siehe Soft Delete von Datensätzen. Damit ein Bearbeitungsformular einen gelöschten Datensatz wiederherstellt, geben Sie ihm eine versteckte Checkbox auf die deleted-Spalte, deren Default Value ausgeschaltet ist.

Formulare, die mit einer Version des Formular-Widgets vor 2.0 erstellt wurden, haben die Einstellungen Show Delete Button und Delete-Flag Column. Version 2.0 hat sie nicht mehr: Wenn Sie ein solches Formular auf Version 2.0 oder neuer umstellen, bauen Sie sein Löschen wie hier beschrieben neu auf.

Zusammenfassung

Mit dem Formular-Widget erhalten Sie:

  • Einfache manuelle Dateneingabe direkt vom Board
  • Automatische Historienverfolgung für jede Übermittlung
  • Saubere Muster zur Anzeige des aktuellen Zustands und zum Ausblenden gelöschter Datensätze
  • Bearbeitung vorhandener Datensätze aus einer Tabelle heraus, in einem Dialog auf derselben Seite

Alles ohne Ihr IronFlock-Board zu verlassen.

Last updated on