Bedingungen, Verzweigungen und Verzögerungen

Mit den Schritten in der Gruppe Logik bestimmst du, in welche Richtung ein Flow läuft und wann: das "wenn" und das "warte kurz". Ein Beispiel: Wenn die Rechnung nach einer Woche noch offen ist, erstelle eine Aufgabe. Sie steuern die Aktionen danach. Nur Um eine Entscheidung bitten erstellt selbst etwas, nämlich eine Aufgabe.

Wenn / sonstLink zu diesem Abschnitt kopieren

Teilt den Flow anhand der Daten in zwei Wege. Es ist dasselbe Prinzip wie der Filter bei Nur wenn des Auslösers, nur mitten im Flow.

Der Schritt hat zwei Ausgänge: Ja (die Bedingungen treffen zu) und Nein (sie treffen nicht zu).

1. Füge einen Schritt Wenn / sonst hinzu
2. Klicke bei Bedingungen auf Bedingung hinzufügen
3. Wähle das Feld mit der Schaltfläche Variable, oder tippe den Pfad selbst ein, zum Beispiel invoice.paymentStatus
4. Wähle den Vergleich (ist, ist nicht, enthält, ist größer als, ist kleiner als, ist eines von, ist leer oder ist nicht leer) und gib den Wert ein
5. Verbinde den Ausgang Ja und gegebenenfalls Nein mit einem Folgeschritt

Ein Schritt Wenn / sonst braucht mindestens eine Bedingung. Sonst meldet Tillor Füge eine Bedingung hinzu. Bei mehreren Bedingungen wählst du zwischen Alle müssen zutreffen und Mindestens eine muss zutreffen. Die Vergleiche funktionieren wie bei Nur wenn beschrieben.

Du musst nicht beide Ausgänge verbinden. Führt ein Ausgang nirgendwohin, endet die Ausführung dort. Ein Flow, der nur bei Ja etwas tut, ist also völlig in Ordnung.

Du kannst auch Felder früherer Schritte verwenden. Nach einer API-Anfrage kannst du zum Beispiel response.status oder response.data.paymentStatus prüfen.

VerzweigungLink zu diesem Abschnitt kopieren

Wähle Verzweigung, wenn du mehr als zwei Wege brauchst. Der Schritt schaut auf den Wert eines Felds und wählt den passenden Zweig.

1. Wähle bei Feld das Feld, auf das du schauen willst, zum Beispiel occupation.occupationType
2. Klicke bei Zweige auf Zweig hinzufügen. Gib den Zweig (den Namen, der am Ausgang steht) und Gleich (den Wert, den das Feld haben muss) ein
3. Wiederhole das für jeden Zweig
4. Verbinde jeden Ausgang mit einem Folgeschritt

Jeder Zweig bekommt unter dem Schritt einen eigenen Ausgang. Dazu gibt es immer einen Ausgang Standard. Er wird genommen, wenn kein Zweig passt.

• Das Feld muss genau mit dem Wert übereinstimmen, auch in der Groß- und Kleinschreibung
• Passt mehr als ein Zweig, gewinnt der erste in der Liste
• Ein Zweig ohne Wert bei Gleich zählt nicht mit
• Du kannst höchstens 8 Zweige einstellen, plus Standard
• Ist das Feld leer oder existiert es nicht, läuft der Flow über Standard

Werte von Auswahlfeldern stehen in der Schreibweise von Tillor. Eine Belegung vom Typ Mietwohnwagen hat zum Beispiel den Wert RENTAL_CARAVAN, eine bezahlte Rechnung PAID.

VerzögerungLink zu diesem Abschnitt kopieren

Mit Verzögerung lässt du den Flow warten, bevor er weiterläuft. Das nutzt du für Dinge wie eine Woche später noch einmal nachsehen.

Bei Warten wählst du eine von zwei Arten.

Eine feste ZeitLink zu diesem Abschnitt kopieren

Wähle Für eine feste Zeit und gib bei Dauer eine Anzahl und eine Einheit ein: Sekunden, Minuten, Stunden, Tage oder Wochen. Sekunden sind nicht exakt. Der Flow kann ein paar Sekunden später weiterlaufen.

Eine Verzögerung von 0 bewirkt nichts, deshalb meldet Tillor Eine Verzögerung von 0 bewirkt nichts.

Bis zu einem DatumLink zu diesem Abschnitt kopieren

Wähle Bis zu einem Datum, wenn die Wartezeit von einem Datum aus den Daten abhängt, etwa dem Fälligkeitsdatum einer Rechnung oder dem Enddatum einer Reservierung.

Beispiele:

• Datum invoice.dueDate, Danach, Versatz 1 Tag: Der Flow läuft einen Tag nach dem Fälligkeitsdatum weiter
• Datum reservation.checkIn, Davor, Versatz 2 Tage: Der Flow läuft zwei Tage vor der Anreise weiter

Liegt dieser Zeitpunkt schon in der Vergangenheit oder ist das Datum leer, läuft der Flow sofort weiter.

Was während des Wartens passiertLink zu diesem Abschnitt kopieren

• Die Ausführung bekommt den Status Wartet. Auf dem Tab Ausführungen steht, wann sie weiterläuft (Geht weiter …). Lange Wartezeiten, etwa Wochen, sind kein Problem
• Nach der Verzögerung liest Tillor die Daten erneut, damit die Schritte danach den aktuellen Stand sehen. Siehe unten
• Pausierst du die Automatisierung während des Wartens, stoppt die Ausführung, sobald die Wartezeit vorbei ist. Sie läuft nicht weiter und bekommt den Status Abgebrochen. Schaltest du die Automatisierung ein, bevor die Wartezeit vorbei ist, läuft die Ausführung ganz normal weiter
• Löschst du die Automatisierung, stoppen die wartenden Ausführungen
• Änderst du den Flow, während eine Ausführung wartet, arbeitet diese Ausführung mit dem Flow, wie er war, als sie startete

Daten werden erneut gelesenLink zu diesem Abschnitt kopieren

Eine Ausführung merkt sich die Daten des Moments des Ereignisses, liest die dazugehörigen Datensätze aber erneut, bevor sie weiterläuft. Das sind der Datensatz des Ereignisses (zum Beispiel die Rechnung) und die Datensätze, auf die er verweist (zum Beispiel der Kunde).

Ein Beispiel: Eine Automatisierung schickt eine Erinnerung für eine Rechnung, wartet 7 Tage und prüft dann mit Wenn / sonst, ob invoice.paymentStatus nicht PAID ist. Wurde die Rechnung in dieser Woche bezahlt, sieht die Bedingung die bezahlte Rechnung und der Flow läuft über Nein.

Es gibt zwei Ausnahmen:

• Existiert der Datensatz nicht mehr, weil zum Beispiel eine Belegung gelöscht wurde, behält die Ausführung die Kopie vom Moment des Ereignisses
• Daten, die ein früherer Schritt geliefert hat, etwa die Antwort einer API-Anfrage, werden nicht erneut abgerufen. Willst du solche Daten nach einer Verzögerung aktualisieren, mache eine neue API-Anfrage

Jetzt geöffnet?Link zu diesem Abschnitt kopieren

Prüft, ob deine Organisation gerade geöffnet ist, und teilt den Flow in Geöffnet und Geschlossen. Es gibt nichts einzustellen. Tillor nutzt die Zeiten unter Einstellungen > Öffnungszeiten, mit Saisonzeiträumen, Feiertagen und Ausnahmen. Siehe Organisationseinstellungen.

Nutze es zum Beispiel, um außerhalb der Öffnungszeiten einen anderen Text zu senden oder eine Aufgabe zu erstellen. Willst du lieber warten, bis du wieder geöffnet hast, nutze Bis zur Öffnung warten. Willst du warten, bis du schließt, nutze Bis zur Schließung warten.

Bis zur Öffnung wartenLink zu diesem Abschnitt kopieren

Lässt den Flow bis zur nächsten Öffnungszeit pausieren und läuft danach weiter. Ist deine Organisation schon geöffnet? Dann läuft der Flow sofort weiter. Es gibt nichts einzustellen.

• Die Öffnungszeit kommt aus Einstellungen > Öffnungszeiten, in der Zeitzone deiner Organisation
• Gibt es im kommenden Monat keine einzige Öffnungszeit, läuft der Flow sofort weiter, statt weiter zu warten
• Während des Wartens bekommt die Ausführung den Status Wartet. Was dabei passiert, steht unter Verzögerung

Bis zur Schließung wartenLink zu diesem Abschnitt kopieren

Lässt den Flow bis zur nächsten Schließzeit pausieren und läuft danach weiter. Ist deine Organisation schon geschlossen? Dann läuft der Flow sofort weiter. Es gibt nichts einzustellen.

• Die Schließzeit kommt aus Einstellungen > Öffnungszeiten, in der Zeitzone deiner Organisation
• Aneinander anschließende Blöcke, etwa 9:00–12:00 und 12:00–17:00, zählen als ein Stück. Der Flow wartet bis zum Ende dieses Stücks
• Während des Wartens bekommt die Ausführung den Status Wartet. Was dabei passiert, steht unter Verzögerung

Höchstens einmal pro ZeitraumLink zu diesem Abschnitt kopieren

Lässt den Flow nur durch, wenn er diesen Schritt für denselben Datensatz innerhalb des Zeitraums noch nicht passiert hat. So schickst du einem Kunden nicht jeden Tag dieselbe Erinnerung.

Der Schritt hat zwei Ausgänge: Fortfahren, wenn der Flow im Zeitraum noch nicht hier durchkam, und Bereits ausgeführt, wenn doch. Verbinde Bereits ausgeführt mit einem anderen Schritt oder lass ihn leer, damit die Ausführung dort endet.

Beachte Folgendes:

• Nur Ausführungen derselben Automatisierung zählen mit, und nur, wenn sie über Fortfahren durch diesen Schritt kamen
• Verbindest du Gelöscht mit nichts, stoppt Tillor die wartenden Flows dieses Datensatzes und löscht die Aufgaben, die der Flow erstellt hat und die nur der Flow abschließen konnte. Verbindest du den Ausgang, läuft der Flow dort weiter
• Startet der Flow ohne Datensatz, etwa bei Jeden Tag zu einer Uhrzeit, gib bei Pro selbst eine Variable ein. Ohne diesen Wert ist jede Ausführung neu und der Schritt hält nichts auf
• Die Ausführung, die gerade läuft, zählt selbst nicht mit

Ein Beispiel: Zeitraum 7 Tage und Pro {invoice.customerId} lässt pro Kunde höchstens einmal pro Woche eine Erinnerung durch, auch wenn dieser Kunde mehrere überfällige Rechnungen hat.

Datensatz nachschlagenLink zu diesem Abschnitt kopieren

Lädt einen Datensatz anhand seiner ID, damit die Schritte danach seine Felder nutzen können. Das ist praktisch, wenn das Ereignis nur eine ID mitgibt, etwa die Nachricht in einem Posteingangsgespräch.

Der Schritt hat zwei Ausgänge: Gefunden und Nicht gefunden. Existiert der Datensatz nicht oder ist die ID leer, läuft der Flow über Nicht gefunden.

Nach Gefunden stehen die Felder des Datensatzes in Variablen, die mit found und dann dem Typ beginnen: {foundCustomer.firstName}, {foundInvoice.displayId}, {foundReservation.checkIn}, {foundTerrain.name}, {foundInboxMessage.direction}. Die anderen Typen heißen foundOccupation, foundPayment, foundTask, foundAccessMethod, foundNfcTag, foundMeter und foundInboxThread. Auch die Datensätze, auf die er verweist, sind dabei, eine Ebene tief, etwa {foundReservation.customer.firstName}. Alles steht in der Liste hinter der Schaltfläche Variable.

Eine zweite Suche desselben Typs ersetzt die erste. Achtung bei Aufgabe: Das nutzt denselben Namen foundTask wie Aufgabe suchen, und die letzte von beiden gewinnt. Dasselbe gilt für Dokument und foundDocument von Dokument suchen.

Variablen zuordnenLink zu diesem Abschnitt kopieren

Kopiert Werte in neue Variablennamen, damit spätere Schritte eine einzige Form nutzen können. Praktisch, wenn ein Flow über Eingehender Webhook ({body.…}) und über Rechnung überfällig ({invoice.…}) startet.

Der Schritt hat einen Ausgang: Weiter. Ist die Quelle genau eine Variable in geschweiften Klammern, zum Beispiel {foundInvoice}, kopiert Tillor den ganzen Datensatz (das Objekt). Sonst füllt Tillor die Quelle als Text ein, etwa Rechnung {foundInvoice.displayId} in meta.label.

Ein typischer Webhook-Test: Eingehender Webhook → Datensatz nachschlagen (Rechnung, ID {body.invoiceId}) → Variablen zuordnen (invoice ← {foundInvoice}) → dieselben Bedingungen und Genehmigung wie beim Zeitplan-Auslöser.

Code ausführenLink zu diesem Abschnitt kopieren

Führt ein Stück TypeScript auf den Variablen des Flows aus und speichert das Ergebnis als neue Variable. Für Logik, die du nicht in Feldern und Bedingungen unterbringst: welche Unteraufgaben entstehen sollen, einen Betrag oder ein Datum berechnen, einen Webhook-Body umformen.

Der Schritt hat einen Ausgang: Weiter. So funktioniert es:

• Der Code sieht nur die Variablen, die er nennt. Eine Variable, die der Flow nicht hat, ist null; ein Datum kommt als Text (2026-07-01T10:00:00.000Z)
• Formatierungen und Datumsverschiebungen ({bedrag|currency}, {datum + 1 day}) funktionieren hier nicht: Berechne sie im Code
• Gib eine Liste, einen Text, eine Zahl oder ein Objekt zurück. Ein Objekt liest du danach pro Feld: {result.total}
• Der Code kann nichts abrufen oder senden: kein Internet, keine Datenbank. Er rechnet nur. Zu langes Rechnen (mehr als 50 ms) wird abgebrochen
• Wirft der Code einen Fehler, stoppt die Ausführung mit diesem Fehler und der Zeilennummer. Du siehst sie auf dem Tab Ausführungen
• Rechts neben dem Code siehst du sofort, was er im Beispiel zurückgibt; beim Testen läuft er mit

Ein Beispiel: Nach der Abreise willst du Unteraufgaben, die von der Parzelle abhängen. Setze einen Schritt Code ausführen mit:

const tasks = ["Plaats vegen", "Sanitair"];
if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren");
return tasks;

Fülle danach bei Aufgabe erstellen das Feld Unteraufgaben nur mit {result}: Jeder Text in der Liste wird zu einer Unteraufgabe.

Für jedesLink zu diesem Abschnitt kopieren

Führt die Schritte nach Für jedes einmal für jedes Element einer Liste aus, zum Beispiel für jede offene Rechnung eines Kunden. Der Flow selbst läuft über Fertig weiter.

Der Schritt hat zwei Ausgänge mit eigener Bedeutung:

• Für jedes führt zu den Schritten, die du pro Element ausführen willst
• Fertig ist der Weg, auf dem der Flow selbst weiterläuft

So funktioniert es:

• Jedes Element bekommt eine eigene Ausführung, die die Schritte nach Für jedes bis zum Ende dieses Zweigs durchläuft. Du siehst sie auf dem Tab Ausführungen, der nur die letzten 20 zeigt
• Das Element steht in der Variable item, zum Beispiel {item.id}. Variablen des Ereignisses und früherer Schritte bleiben verfügbar
• Der Flow wartet nicht, bis die Elemente fertig sind. Direkt nachdem sie gestartet wurden, läuft er über Fertig weiter. Ein Ergebnis eines Elements kannst du also in den Schritten nach Fertig nicht verwenden
• Es werden höchstens 100 Elemente verarbeitet, die ältesten zuerst. Stehen mehr in der Liste, werden die übrigen nicht verarbeitet
• Ist die Liste leer oder das Feld Von leer, startet nichts und der Flow läuft sofort über Fertig weiter
• Offene Rechnungen eines Kunden sind gebuchte Rechnungen, bei denen noch etwas offen ist. Gebuchte Reservierungen eines Kunden sind Reservierungen mit dem Status Gebucht

Ein Beispiel: Eine Rechnung wird überfällig und du willst für jede offene Rechnung dieses Kunden einen Zahlungslink erstellen. Wähle Offene Rechnungen eines Kunden, gib bei Von {invoice.customerId} ein und setze hinter Für jedes einen Schritt Zahlungslink erstellen mit {item.id} als Rechnung.

Warten bisLink zu diesem Abschnitt kopieren

Prüft Bedingungen immer wieder, bis sie zutreffen, oder hört nach einer Zeit auf. Nutze es, wenn du nicht weißt, wann etwas passiert, aber worauf du wartest, zum Beispiel bis eine Rechnung bezahlt ist.

Der Schritt hat zwei Ausgänge: Erfüllt (die Bedingungen treffen zu) und Zeit abgelaufen (die Wartezeit ist vorbei, ohne dass sie zutrafen).

Beachte Folgendes:

• Die erste Prüfung geschieht sofort. Treffen die Bedingungen schon zu, läuft der Flow direkt über Erfüllt weiter. Hast du keine Bedingung eingegeben, trifft es immer zu
• Bei jeder Prüfung liest Tillor die Datensätze des Ereignisses erneut, wie bei einer Verzögerung. Eine Bedingung wie invoice.paymentStatus ist PAID sieht die Zahlung also, sobald sie da ist
• Ein Intervall unter 5 Minuten wird zu 5 Minuten
• Während des Wartens bekommt die Ausführung den Status Wartet. Fürs Pausieren und Ändern des Flows gilt dasselbe wie bei Verzögerung

Auf ein Ereignis wartenLink zu diesem Abschnitt kopieren

Lässt den Flow pausieren, bis in Tillor etwas passiert, zum Beispiel dass die Rechnung bezahlt wurde.

Der Schritt hat zwei Ausgänge: Empfangen (das Ereignis kam) und Zeit abgelaufen (die Wartezeit ist vorbei, ohne Ereignis). Ist Nur für denselben Datensatz an, kommt ein dritter Ausgang hinzu, Gelöscht. Den nutzt du, wenn der Datensatz des Flows gelöscht wurde, während der Flow wartete.

Beachte Folgendes:

• Bei eingeschaltetem Nur für denselben Datensatz zählt zum Beispiel nur die Zahlung der Rechnung, mit der der Flow startete. Schaltest du es aus, lässt jedes Ereignis dieses Typs den Flow weiterlaufen
• Verbindest du Gelöscht mit nichts, stoppt Tillor die wartenden Flows dieses Datensatzes und löscht die Aufgaben, die der Flow erstellt hat und die nur der Flow abschließen konnte. Verbindest du den Ausgang, läuft der Flow dort weiter
• Startet der Flow ohne Datensatz, etwa bei Jeden Tag zu einer Uhrzeit, zählt jedes Ereignis dieses Typs
• Ein Ereignis, das ein Schritt einer Automatisierung selbst auslöst, zählt ebenfalls. Wartende Flows laufen also auch aufgrund von Arbeit von Workflow weiter
• Nach Empfangen stehen die Daten des Ereignisses, auf das du gewartet hast, in den Variablen, ohne die Kollegin oder den Kollegen, die oder der es ausgelöst hat. Wartest du auf invoice:paid, liefert {invoice.paymentStatus} danach den neuen Stand
• Während des Wartens bekommt die Ausführung den Status Wartet. Fürs Pausieren und Ändern des Flows gilt dasselbe wie bei Verzögerung

Um eine Entscheidung bittenLink zu diesem Abschnitt kopieren

Erstellt eine Aufgabe mit Schaltflächen, die du selbst festlegst, und wartet, bis jemand eine Schaltfläche wählt. So baust du einen Moment ein, in dem ein Mensch mitschaut, zum Beispiel bevor der Flow einen Kunden sperrt oder eine Rechnung bucht. Jede Option ist eine Schaltfläche auf der Aufgabe und ein Ausgang des Schritts.

Optionen einstellenLink zu diesem Abschnitt kopieren

1. Klicke bei Optionen auf Option hinzufügen und gib den Namen ein, zum Beispiel Genehmigen. Dieser Name steht auf der Schaltfläche und am Ausgang
2. Klicke auf das farbige Feld links vom Namen (Symbol und Farbe), um eine Farbe und ein Symbol zu wählen. Ein Symbol ist nicht Pflicht
3. Schalte Notiz verlangen ein, wenn die Kollegin oder der Kollege bei dieser Wahl einen Grund angeben soll
4. Schalte Bestätigung verlangen ein, wenn zuerst bestätigt werden soll. Du gibst dann einen Bestätigungstitel und einen Bestätigungstext ein und wählst bei Schweregrad zwischen Info, Warnung oder Destruktiv. In diesen Texten kannst du Variablen verwenden
5. Wiederhole das für jede Option. Du kannst höchstens 8 Optionen anlegen

Ist die Liste noch leer, legt die Schaltfläche Genehmigen / Ablehnen sofort zwei Optionen an: ein grünes Genehmigen und ein rotes Ablehnen. Jede Option braucht einen Namen, sonst meldet Tillor Jede Option braucht einen Namen. Ohne Optionen meldet Tillor Füge mindestens eine Option hinzu.

AusgängeLink zu diesem Abschnitt kopieren

Der Schritt hat einen Ausgang pro Option, mit dem Namen und der Farbe dieser Option, plus immer Zeit abgelaufen.

Beachte Folgendes:

• Die Schaltflächen stehen auf der Aufgabenkarte, in der Aufgabenliste und in der Aufgabe selbst. Eine solche Aufgabe hat kein Häkchen: Du kannst sie nicht einfach abschließen, nur eine Schaltfläche wählen. Nach der Wahl steht die Aufgabe auf Abgeschlossen und es steht dabei, welche Option gewählt wurde. Siehe Aufgaben mit Auswahlschaltflächen
• Wählen kann, wer der Aufgabe zugewiesen ist, auch über eine Gruppe, sowie Administratoren. Weist du niemanden zu, kann jeder wählen, der die Aufgabe sieht
• Die Aufgabe bekommt die Priorität Hoch. Sie läuft auf den Namen Workflow
• Wird die Aufgabe gelöscht, bevor jemand gewählt hat, läuft der Flow über Zeit abgelaufen weiter. Nach Zeit abgelaufen wegen der Wartezeit bleibt die Aufgabe bestehen
• Spätere Schritte können {approvalTask.id}, {approval.decision}, {approval.label}, {approval.note} und {approval.decidedBy.name} verwenden. {approval.label} ist der Name der gewählten Option und {approval.note} die Notiz, die die Kollegin oder der Kollege eingegeben hat
• Während des Wartens bekommt die Ausführung den Status Wartet. Fürs Pausieren und Ändern des Flows gilt dasselbe wie bei Verzögerung

Was passiert danach?Link zu diesem Abschnitt kopieren

• Ein Ausgang, den du nicht verbindest, lässt die Ausführung dort enden.
• Bei einem Warteschritt bekommt die Ausführung den Status Wartet und läuft später weiter. Eine pausierte Automatisierung stoppt wartende Ausführungen, sobald die Wartezeit vorbei ist.
• Nach einer Wartezeit liest Tillor die Daten erneut, damit die Schritte den aktuellen Stand sehen.

Probleme?Link zu diesem Abschnitt kopieren