Zum Hauptinhalt springen

Formularaufgabe

Mit dem Schritt Formularaufgabe lässt du einen Benutzer oder eine Gruppe ein Formular ausfüllen – Text, Zahlen, Datumsangaben, Auswahllisten, Datensätze und Tabellen mit mehreren Zeilen – und machst mit den Eingaben weiter. Der Flow wartet, bis die Aufgabe erledigt ist – wenn nötig Stunden oder Tage. Wie Benutzer, Gruppen, der Aufgabeneingang und das Warten funktionieren, steht unter AutoFlow Tasks.

Typische Anwendungsfälle:

  • Aus einer eingehenden E-Mail entsteht ein neuer Debitor; jemand aus dem Vertrieb ergänzt Zahlungsbedingungen, Verkäufer und Kreditlimit, bevor der Flow den Debitor anlegt.
  • Eine Einkaufsrechnung kommt ohne Bestellung; der Einkäufer trägt Kostenstelle, Projekt und einen Kommentar ein – das Rechnungs-PDF steht neben dem Formular.
  • Ein Servicebericht braucht seine Positionen: Der Techniker erfasst die verbauten Teile, eine Zeile pro Teil, und eine For-Each-Schleife legt die Artikel-Buch.-Blattzeilen an.

Schritt konfigurieren​

Beschreibung​

Die Beschriftung des Schritts auf der Arbeitsfläche – und der Betreff der Aufgabe im Eingang. Benenne sie also wie die Aufgabe: Debitordaten ergänzen.

Anweisungen​

Was ausgefüllt werden soll und warum – steht auf der Aufgabenkarte über dem Formular. SmartFields werden beim Erstellen der Aufgabe aufgelöst.

Zuweisen an, Zugewiesen an, Fälligkeitsdatum​

Wie bei der Auswahlaufgabe: Benutzer oder Aufgabengruppe, der Benutzername bzw. Gruppencode (oder ein SmartField, das ihn enthält) und ein optionales Fälligkeitsdatum oder SmartDate. Wer eine Formularaufgabe erledigt, muss wie bei der Auswahlaufgabe für AutoFlow Tasks aktiviert sein.

Abschnitte​

Optional. Ein Abschnitt fasst Felder unter einer Überschrift zusammen:

EinstellungBedeutung
Beschriftungdie Überschrift auf der Aufgabenkarte
Nameso spricht der Flow den Abschnitt an; bleibt er leer, wird er aus der Beschriftung gebildet
ArtNormal – Felder untereinander; Repeater – eine Tabelle, die Zeile für Zeile ausgefüllt wird
Zeilen ausnur Repeater: eine Liste (Datensätze oder Werte, zum Beispiel die results von Datensätze finden) – pro Eintrag eine vorbelegte Zeile
Zeilen hinzufügen/löschennur Repeater: ob Zeilen ergänzt und gelöscht werden dürfen; aus, bleiben die vorbelegten Zeilen, wie sie sind

Felder ohne Abschnitt stehen oben im Formular in einem Abschnitt ohne Überschrift.

Felder​

Eine Zeile pro Feld:

EinstellungBedeutung
Abschnittder Name des Abschnitts; leer = der Abschnitt oben
Beschriftungdie Beschriftung auf der Aufgabenkarte
Nameder Name des Outputs – Buchstaben und Ziffern, höchstens 20 Zeichen; bleibt er leer, wird er aus der Beschriftung gebildet
TypText, Mehrzeiliger Text, Ja/Nein, Ganze Zahl, Dezimalzahl, Datum, Datum und Uhrzeit, Dropdown oder Datensatz
Pflichtfelddie Aufgabe lässt sich erst erledigen, wenn das Feld ausgefüllt ist
VorbelegungSmartText, mit dem das Feld startet. In einem Repeater beginnt er mit Zeilen aus des Abschnitts, zum Beispiel {{find_results.Name}}, und wird für jede Zeile aufgelöst
Wertenur Dropdown: die Werte zur Auswahl, getrennt durch ; oder Zeilenumbrüche. Ein Eintrag, der ein SmartField mit einer Liste ist – etwa {{parser_codes}} –, fügt jeden Wert der Liste ein
Eigene Wertenur Dropdown: es darf auch ein Wert eingegeben werden, der nicht in der Liste steht
Tabelle, Filternur Datensatz: die Tabelle, aus der gewählt wird, und ein optionaler Filter auf ihre Felder (Werte dürfen SmartFields sein)

Ein Datensatz-Feld bietet die Datensätze seiner Tabelle an, die zum Filter passen – höchstens 1.000, ermittelt beim Erstellen der Aufgabe. Gefunden wird einer, indem man einen Teil seiner Nummer oder seines Namens tippt. Vorbelegen lässt er sich mit einem SmartField, das einen Datensatz enthält, etwa {{trigger_customer}}.

Formular anzeigen​

Formular anzeigen zeigt das Formular so, wie es die Person sieht, die die Aufgabe erhält – mit Anweisungen, Abschnitten und Vorschau. Probiere die Felder aus und klicke auf Eingaben prüfen, um zu sehen, ob sie das Formular vervollständigen; gespeichert wird nichts. Werte aus früheren Schritten und Zeilen aus Listen gibt es beim Einrichten noch nicht – sie werden beim Erstellen der Aufgabe eingesetzt.

Vorschau​

Optional. Eine Vorschau neben dem Formular, die den Eingaben folgt:

  • HTML – HTML mit SmartFields. Neben den Outputs früherer Schritte kannst du die eigenen Felder des Formulars verwenden, so benannt, wie spätere Schritte sie sehen: {{<schritt>_<feld>}}, zum Beispiel {{form_customer.Name}} für ein Datensatz-Feld. Auch die Zeilen eines Repeaters kannst du zeigen – durchlaufe sie mit {#for {{form_lines}} #}…{{form_lines.item}}…{#endfor#}; außerhalb einer Schleife ist {{form_lines.item}} die erste Zeile, {{form_linesCount}} die Zeilenzahl. Während du den Schritt einrichtest, stehen die eigenen Felder des Formulars im SmartField-Bereich und in der SmartField-Auswahl wie die Outputs früherer Schritte bereit – ein Repeater mit seinen Spalten.
  • Dokument – ein Verweis auf einen Eingangsbelegsanhang oder ein AutoFlow-Dokument. Das kann eines der Datensatz-Felder des Formulars sein – dann zeigt die Vorschau das Dokument, das gewählt wurde.

Eine Vorschau, die die Zeilen eines Repeaters auflistet:

<h3>Auftrag für {{form_customer.Name}}</h3>
<table>
{#for {{form_lines}} #}
<tr><td>{{form_lines.item}}</td><td>{{form_lines.quantity}}</td></tr>
{#endfor#}
</table>
<p>{{form_linesCount}} Zeilen</p>

Der HTML-Editor schließt Tags beim Tippen und rückt innerhalb ein; Formatieren (oder Umschalt+Alt+F) bringt das ganze HTML in Form, {#for#}- und {#if#}-Blöcke eingeschlossen.

Die Aufgabenkarte​

Die Karte zeigt die Anweisungen, darunter die Abschnitte mit ihren Feldern und – falls eingerichtet – rechts daneben die Vorschau. Ein Repeater ist eine Tabelle; mit Zeilen hinzufügen/löschen fügt + Zeile hinzufügen eine Zeile an, ✕ löscht eine. Erledigen prüft zuerst die Pflichtfelder und markiert die leeren. Ein Datum oder eine Zahl, die sich nicht lesen lässt, ein Dropdown-Wert, der nicht angeboten wird (sofern eigene Werte nicht erlaubt sind), oder ein Datensatz, der nicht in der Liste steht, wird mit einer Meldung abgelehnt; die Karte bleibt offen.

Aus dem Eingang geöffnet, ist die Karte schmaler und zeigt die Vorschau unter dem Formular; Groß anzeigen öffnet die Vorschau im großen Viewer.

Entwürfe​

Ein Formular muss nicht in einem Zug ausgefüllt werden. Entwurf speichern sichert, was bisher eingegeben ist – auch wenn Pflichtfelder noch leer sind –, und die Aufgabe bleibt offen. Auch beim Schließen der Karte werden Änderungen als Entwurf gespeichert. Wer die Aufgabe als Nächstes öffnet, macht dort weiter: du selbst später oder ein Kollege, an den die Aufgabe weitergegeben oder vertreten wurde. Die Statuszeile zeigt, wer den Entwurf wann gespeichert hat. Mit dem Erledigen verschwindet der Entwurf.

Outputs​

OutputInhalt
<feld>jedes Feld eines normalen Abschnitts, unter seinem Namen: ein Datensatz-Feld ist eine Referenz auf den gewählten Datensatz, alles andere ein Wert – true/false, 12, 1.25, 2026-11-02, 2026-11-02T09:30:00
<abschnitt>jeder Repeater: seine Zeilen – <abschnitt> ist die erste, <abschnitt>[0], <abschnitt>[1], … sind alle. Jede Zeile hat die Spalten als Felder, zum Beispiel {{form_lines.quantity}}
<abschnitt>Countwie viele Zeilen der Repeater hat
completedBywer die Aufgabe erledigt hat
taskeine Referenz auf die Aufgabe selbst

Um mit den Zeilen zu arbeiten, durchläufst du <abschnitt> mit einer For-Each-Schleife und liest die aktuelle Zeile mit Aufgaben-Repeater lesen – dessen Outputs sind die Spalten, direkt auswählbar.