Zum Hauptinhalt springen

Auswahlaufgabe

Mit dem Schritt Auswahlaufgabe lässt du einen Benutzer oder eine Gruppe eine oder mehrere Zeilen aus einer Liste auswählen – Datensätze oder einfache Werte – und machst mit der Auswahl 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:

  • Datensätze finden liefert die offenen Bestellungen eines Kreditors; der Einkäufer wählt die aus, die freigegeben werden, und eine For-Each-Schleife gibt sie frei.
  • Ein Webservice liefert mögliche Liefertermine; die Vertriebsassistenz entscheidet sich für einen.
  • Zu einer eingehenden E-Mail passen mehrere Kontakte; jemand aus dem Service wählt den richtigen.

Schritt konfigurieren​

Beschreibung​

Die Beschriftung des Schritts auf der Arbeitsfläche – und der Betreff der Aufgabe im Eingang. Benenne sie also wie die Aufgabe: Bestellungen zur Freigabe auswählen.

Anweisungen​

Was ausgewählt werden soll und warum – steht auf der Aufgabenkarte über der Liste. SmartFields werden beim Erstellen der Aufgabe aufgelöst.

Zuweisen an​

Benutzer, Aufgabengruppe oder Benutzer, der den Flow gestartet hat.

Benutzer, der den Flow gestartet hat gibt die Aufgabe dem Benutzer, unter dem der Flow läuft – praktisch in einem Flow, den du selbst startest, um auszuwählen, womit der Flow weiterarbeitet. Solange du den Flow im Fortschrittsdialog verfolgst, braucht das Erledigen gar keine Lizenz. Läuft der Flow im Hintergrund oder schließt du die Aufgabe und erledigst sie später im Aufgabeneingang, musst du wie bei jeder anderen Auswahlaufgabe für AutoFlow Tasks aktiviert sein.

Zugewiesen an​

Bei Benutzer und Aufgabengruppe: der Benutzername oder der Code der Aufgabengruppe. Wähle ihn über die Suche, gib ihn ein oder füge ein SmartField ein, das ihn enthält. Ein unbekannter oder deaktivierter Benutzer stoppt den Flow mit einem Fehler. Wer eine Auswahlaufgabe erledigt, muss für AutoFlow Tasks aktiviert sein – die Statuszeile des Schritts warnt dich, wenn der Benutzer es nicht ist oder niemand in der Gruppe.

Auswählen aus​

Die Liste, aus der ausgewählt wird, als SmartField:

  • Datensätze – eine Referenz, ein Array von Referenzen oder ein Iterable, zum Beispiel die results von Datensätze finden. Jeder Datensatz wird eine Zeile. Tabelle zeigt, aus welcher Tabelle die Datensätze stammen.
  • Werte – eine Liste von Werten, etwa aus dem Parser. Jeder Wert wird eine Zeile; kommt ein Wert zweimal vor, sind es zwei Zeilen.

AutoFlow erkennt, was du gewählt hast, und bietet darunter die passenden Einstellungen an.

Mehrfachauswahl​

Aus: Es wird genau eine Zeile ausgewählt. Ein: beliebig viele, dazu Alle angezeigten auswählen für die Zeilen, die die Suche gerade zeigt.

Bei leerer Liste​

Hat die Liste keine Zeilen, entsteht keine Aufgabe. Bei Schritt schlägt fehl stoppt der Flow mit einem Fehler, bei Ohne Ergebnisse weiter läuft er mit count = 0 weiter.

Fälligkeitsdatum​

Optional. Ein Datum oder ein SmartDate wie [@calc({{today}}, "+5D")@]. Überfällige Aufgaben werden im Eingang hervorgehoben, und Benutzer können Erinnerungen und Sammelmails bekommen.

Spalten (Datensätze)​

Was die Liste zu jedem Datensatz zeigt: eine Beschriftung als Spaltenüberschrift und einen Wert – SmartText, der mit der Liste beginnt, zum Beispiel {{find_results.No}} und {{find_results.Description}}. Andere SmartFields und Text dürfen dazukommen, solange die Liste vorkommt. Ohne Spalten zeigt die Liste den Primärschlüssel jedes Datensatzes.

Spaltenbeschriftung (Werte)​

Die Überschrift über den Werten. Leer: der Name der Liste.

Die Aufgabenkarte​

Die Karte zeigt die Anweisungen und die Liste, dazu ein Suchfeld, das die Zeilen über alle Spalten filtert. Ein Klick auf eine Zeile wählt sie aus; bei Mehrfachauswahl hebt ein zweiter Klick die Auswahl wieder auf. Über das Symbol am Ende einer Datensatzzeile öffnest du die Karte des Datensatzes und kannst ihn vor der Auswahl prüfen. Erledigen ist möglich, sobald eine Zeile ausgewählt ist.

Die Zeilen zeigen die Werte von dem Moment, in dem die Aufgabe erstellt wurde. Wurde ein Datensatz inzwischen gelöscht, ist seine Zeile ausgegraut und lässt sich nicht auswählen.

Eine Aufgabe fasst höchstens 1.000 Zeilen. Ist die Liste länger, bekommt die Aufgabe die ersten 1.000, und Karte und Ausführungsprotokoll nennen, wie viele Zeilen die Liste hatte. Grenze die Liste dann im Schritt davor ein, etwa mit einem Filter in Datensätze finden.

Outputs​

OutputInhalt
resultsdie ausgewählten Zeilen: bei Datensätzen eine Referenz – results ist der erste, results[0], results[1], … sind alle, in der Reihenfolge der Liste, genau wie bei Datensätze finden; bei Werten die Werte selbst
countwie viele Zeilen ausgewählt wurden
completedBywer die Aufgabe erledigt hat
taskeine Referenz auf die Aufgabe selbst – etwa um sie mit dem Beleg zu verknüpfen oder darüber zu berichten

Um jeden ausgewählten Datensatz abzuarbeiten, setze nach dem Schritt eine For-Each-Schleife über results. Willst du die ausgewählten Zeilen in einem Text aufzählen – etwa in einer E-Mail –, nimm einen {#for #}-Block über {{results}}; das klappt mit Datensätzen und mit Werten.

Wo der Schritt verfügbar ist​

In Flows, die nicht auf einen Menschen warten können – die Beleg- und Seiten-Auslöser, die Bericht-Auslöser und Sub-Flows –, steht der Schritt nicht zur Verfügung; siehe Wie ein Flow wartet.