Warunki, rozgałęzienia i opóźnienia

Krokami z grupy Logika decydujesz, w którą stronę idzie przepływ i kiedy: to "jeśli" i to "poczekaj chwilę". Przykład: jeśli faktura po tygodniu nadal jest otwarta, utwórz zadanie. Kroki te sterują akcjami, które następują po nich. Tylko Poproś o decyzję sam coś tworzy, czyli zadanie.

Jeśli / w przeciwnym razieKopiuj link do tej sekcji

Rozdziela przepływ na dwie drogi na podstawie danych. To ta sama zasada co filtr w Tylko gdy wyzwalacza, tyle że w środku przepływu.

Krok ma dwa wyjścia: Tak (warunki są spełnione) i Nie (nie są spełnione).

1. Dodaj krok Jeśli / w przeciwnym razie
2. Przy Warunki kliknij Dodaj warunek
3. Wybierz pole przyciskiem Zmienna albo wpisz ścieżkę samodzielnie, na przykład invoice.paymentStatus
4. Wybierz porównanie (jest, nie jest, zawiera, jest większe niż, jest mniejsze niż, jest jednym z, jest puste albo nie jest puste) i wpisz wartość
5. Połącz wyjście Tak i ewentualnie Nie z kolejnym krokiem

Krok Jeśli / w przeciwnym razie potrzebuje co najmniej jednego warunku. W przeciwnym razie Tillor pokazuje Dodaj warunek. Przy kilku warunkach wybierasz między Wszystkie muszą być spełnione a Wystarczy jeden spełniony. Porównania działają tak, jak opisano przy Tylko gdy.

Nie musisz łączyć obu wyjść. Jeśli wyjście prowadzi donikąd, wykonanie kończy się w tym miejscu. Przepływ, który coś robi tylko przy Tak, jest więc w porządku.

Możesz też używać pól z wcześniejszych kroków. Po Żądaniu API możesz na przykład sprawdzić response.status albo response.data.paymentStatus.

RozgałęzienieKopiuj link do tej sekcji

Wybierz Rozgałęzienie, gdy potrzebujesz więcej niż dwóch dróg. Krok patrzy na wartość jednego pola i wybiera pasującą gałąź.

1. Przy Pole wybierz pole, któremu chcesz się przyjrzeć, na przykład occupation.occupationType
2. Przy Gałęzie kliknij Dodaj gałąź. Wpisz Gałąź (nazwę, która pojawi się na wyjściu) i Równa się (wartość, jaką ma mieć pole)
3. Powtórz to dla każdej gałęzi
4. Połącz każde wyjście z kolejnym krokiem

Każda gałąź dostaje własne wyjście pod krokiem. Poza tym zawsze jest wyjście Domyślne. Jest używane, gdy żadna gałąź nie pasuje.

• Pole musi dokładnie odpowiadać wartości, łącznie z wielkością liter
• Jeśli pasuje więcej niż jedna gałąź, wygrywa pierwsza na liście
• Gałąź bez wartości przy Równa się się nie liczy
• Możesz ustawić maksymalnie 8 gałęzi, plus Domyślne
• Jeśli pole jest puste albo nie istnieje, przepływ idzie przez Domyślne

Wartości pól wyboru mają zapis używany w Tillor. Zajęcie typu przyczepa do wynajęcia ma na przykład wartość RENTAL_CARAVAN, a opłacona faktura PAID.

OpóźnienieKopiuj link do tej sekcji

Krokiem Opóźnienie każesz przepływowi poczekać, zanim pójdzie dalej. Używasz go do rzeczy takich jak sprawdź jeszcze raz po tygodniu.

Przy Czekaj wybierasz jeden z dwóch sposobów.

Przez określony czasKopiuj link do tej sekcji

Wybierz Przez określony czas i wpisz przy Czas trwania liczbę oraz jednostkę: sekundy, minuty, godziny, dni albo tygodnie. Sekundy nie są dokładne. Przepływ może ruszyć kilka sekund później.

Opóźnienie równe 0 nic nie robi, dlatego Tillor pokazuje Opóźnienie równe 0 nic nie robi.

Do datyKopiuj link do tej sekcji

Wybierz Do daty, gdy czas oczekiwania zależy od daty z danych, takiej jak termin płatności faktury albo data zakończenia rezerwacji.

Przykłady:

• Data invoice.dueDate, Po, Przesunięcie 1 dzień: przepływ rusza dzień po terminie płatności
• Data reservation.checkIn, Przed, Przesunięcie 2 dni: przepływ rusza dwa dni przed przyjazdem

Jeśli ta chwila jest już w przeszłości albo data jest pusta, przepływ rusza od razu.

Co dzieje się podczas czekaniaKopiuj link do tej sekcji

• Wykonanie dostaje status Oczekuje. Na karcie Uruchomienia widać, kiedy ruszy dalej (Wznowienie …). Długie czasy oczekiwania, na przykład tygodnie, nie są problemem
• Po opóźnieniu Tillor czyta dane ponownie, żeby kolejne kroki widziały aktualny stan. Zobacz niżej
• Jeśli wstrzymasz automatyzację podczas czekania, wykonanie zatrzyma się po upływie czasu oczekiwania. Nie pójdzie dalej i dostanie status Anulowane. Jeśli włączysz automatyzację, zanim czas oczekiwania minie, wykonanie normalnie ruszy dalej
• Jeśli usuniesz automatyzację, oczekujące wykonania się zatrzymają
• Jeśli zmienisz przepływ, gdy wykonanie czeka, to wykonanie dokończy się według przepływu takiego, jaki był w chwili startu

Dane są czytane ponownieKopiuj link do tej sekcji

Wykonanie zapamiętuje dane z chwili zdarzenia, ale przed ruszeniem dalej czyta ponownie powiązane z nimi rekordy. Chodzi o rekord zdarzenia (na przykład fakturę) i rekordy, do których ten rekord się odwołuje (na przykład klienta).

Przykład: automatyzacja wysyła przypomnienie o fakturze, czeka 7 dni, a potem sprawdza krokiem Jeśli / w przeciwnym razie, czy invoice.paymentStatus nie jest PAID. Jeśli faktura została opłacona w ciągu tego tygodnia, warunek zobaczy opłaconą fakturę i przepływ pójdzie przez Nie.

Są dwa wyjątki:

• Jeśli rekord już nie istnieje, na przykład dlatego, że zajęcie zostało usunięte, wykonanie zachowuje kopię z chwili zdarzenia
• Dane, które zwrócił wcześniejszy krok, takie jak odpowiedź Żądania API, nie są pobierane ponownie. Jeśli chcesz mieć takie dane odświeżone po opóźnieniu, wykonaj nowe Żądanie API

Teraz otwarte?Kopiuj link do tej sekcji

Sprawdza, czy Twoja organizacja jest w tej chwili otwarta, i rozdziela przepływ na Otwarte i Zamknięte. Nie ma tu nic do ustawienia. Tillor korzysta z godzin w UstawieniaGodziny otwarcia, z okresami sezonowymi, świętami i wyjątkami. Zobacz Ustawienia organizacji.

Użyj tego na przykład, żeby poza godzinami otwarcia wysłać inny tekst albo utworzyć zadanie. Jeśli wolisz poczekać, aż znów będziesz otwarty, użyj Czekaj do otwarcia. Jeśli chcesz poczekać do zamknięcia, użyj Czekaj do zamknięcia.

Czekaj do otwarciaKopiuj link do tej sekcji

Zatrzymuje przepływ do najbliższej godziny otwarcia, a potem idzie dalej. Twoja organizacja jest już otwarta? Wtedy przepływ rusza od razu. Nie ma tu nic do ustawienia.

• Godzina otwarcia pochodzi z UstawieniaGodziny otwarcia, w strefie czasowej Twojej organizacji
• Jeśli w ciągu następnego miesiąca nie ma żadnej godziny otwarcia, przepływ rusza od razu zamiast czekać w nieskończoność
• Podczas czekania wykonanie dostaje status Oczekuje. Co się wtedy dzieje, opisano przy Opóźnieniu

Czekaj do zamknięciaKopiuj link do tej sekcji

Zatrzymuje przepływ do najbliższej godziny zamknięcia, a potem idzie dalej. Twoja organizacja jest już zamknięta? Wtedy przepływ rusza od razu. Nie ma tu nic do ustawienia.

• Godzina zamknięcia pochodzi z UstawieniaGodziny otwarcia, w strefie czasowej Twojej organizacji
• Bloki, które łączą się ze sobą, na przykład 9:00–12:00 i 12:00–17:00, liczą się jako jeden odcinek. Przepływ czeka do końca tego odcinka
• Podczas czekania wykonanie dostaje status Oczekuje. Co się wtedy dzieje, opisano przy Opóźnieniu

Najwyżej raz na okresKopiuj link do tej sekcji

Przepuszcza przepływ tylko wtedy, gdy dla tego samego rekordu nie przeszedł on przez ten krok w danym okresie. Dzięki temu nie wyślesz klientowi codziennie tego samego przypomnienia.

Krok ma dwa wyjścia: Kontynuuj, jeśli przepływ nie przeszedł tędy w tym okresie, i Już wykonano, jeśli przeszedł. Połącz Już wykonano z innym krokiem albo zostaw je puste, żeby wykonanie kończyło się w tym miejscu.

Zwróć uwagę na to:

• Liczą się tylko wykonania tej samej automatyzacji i tylko wtedy, gdy przeszły przez ten krok wyjściem Kontynuuj
• Jeśli nie połączysz Usunięto z niczym, Tillor zatrzyma oczekujące przepływy tego rekordu i usunie zadania, które przepływ utworzył i które tylko on mógł zakończyć. Jeśli połączysz to wyjście, przepływ pójdzie tam dalej
• Jeśli przepływ startuje bez rekordu, na przykład przy Codziennie o danej godzinie, wpisz zmienną samodzielnie przy Na. Bez tej wartości każde wykonanie jest nowe i krok niczego nie powstrzymuje
• Wykonanie, które właśnie trwa, samo się nie liczy

Przykład: Okres 7 dni i Na {invoice.customerId} przepuszcza przypomnienie najwyżej raz w tygodniu na klienta, nawet jeśli ten klient ma kilka przeterminowanych faktur.

Wyszukaj rekordKopiuj link do tej sekcji

Ładuje rekord na podstawie jego ID, żeby kolejne kroki mogły używać jego pól. Przydaje się, gdy zdarzenie przekazuje tylko ID, jak wiadomość w rozmowie skrzynki.

Krok ma dwa wyjścia: Znaleziono i Nie znaleziono. Jeśli rekord nie istnieje albo ID jest puste, przepływ idzie przez Nie znaleziono.

Po Znaleziono pola rekordu są w zmiennych zaczynających się od found i typu: {foundCustomer.firstName}, {foundInvoice.displayId}, {foundReservation.checkIn}, {foundTerrain.name}, {foundInboxMessage.direction}. Pozostałe typy nazywają się foundOccupation, foundPayment, foundTask, foundAccessMethod, foundNfcTag, foundMeter i foundInboxThread. Dołączone są też rekordy, do których się odwołuje, na głębokość jednego poziomu, jak {foundReservation.customer.firstName}. Wszystko jest na liście pod przyciskiem Zmienna.

Drugie wyszukiwanie tego samego typu zastępuje pierwsze. Uważaj przy Zadanie: używa ono tej samej nazwy foundTask co Znajdź zadanie, a wygrywa ostatnie z nich. To samo dotyczy Dokument i foundDocument z Znajdź dokument.

Mapuj zmienneKopiuj link do tej sekcji

Kopiuje wartości do nowych nazw zmiennych, żeby późniejsze kroki mogły używać jednej postaci. To przydatne, gdy jeden przepływ startuje przez Webhook przychodzący ({body.…}) i przez Faktura przeterminowana ({invoice.…}).

Krok ma jedno wyjście: Dalej. Jeśli źródło to dokładnie jedna zmienna w nawiasach klamrowych, na przykład {foundInvoice}, Tillor kopiuje cały rekord (obiekt). W przeciwnym razie Tillor wstawia źródło jako tekst, jak Faktura {foundInvoice.displayId} w meta.label.

Typowy test webhooka: Webhook przychodzący → Wyszukaj rekord (Faktura, ID {body.invoiceId}) → Mapuj zmienne (invoice ← {foundInvoice}) → te same warunki i zatwierdzenie co przy wyzwalaczu harmonogramu.

Uruchom kodKopiuj link do tej sekcji

Wykonuje fragment TypeScriptu na zmiennych przepływu i zapisuje to, co zwróci, jako nową zmienną. Służy do logiki, której nie da się zmieścić w polach i warunkach: jakie podzadania mają powstać, obliczenie kwoty albo daty, przekształcenie treści webhooka.

Krok ma jedno wyjście: Dalej. Działa to tak:

• Kod widzi tylko zmienne, które wymienia. Zmienna, której przepływ nie ma, jest null, a data przychodzi jako tekst (2026-07-01T10:00:00.000Z)
• Formatowanie i przesunięcia dat ({bedrag|currency}, {datum + 1 day}) tu nie działają: oblicz je w kodzie
• Zwróć listę, tekst, liczbę albo obiekt. Obiekt czytasz potem pole po polu: {result.total}
• Kod nie może niczego pobierać ani wysyłać: nie ma internetu ani bazy danych. Tylko liczy. Zbyt długie liczenie (ponad 50 ms) zostaje przerwane
• Jeśli kod zgłosi błąd, wykonanie kończy się tym błędem i numerem wiersza. Zobaczysz je na karcie Uruchomienia
• Po prawej stronie kodu od razu widać, co zwraca on na przykładzie. Przy testowaniu uruchamia się razem z całością

Przykład: po wyjeździe chcesz podzadania zależne od działki. Dodaj krok Uruchom kod z:

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

Potem przy Utwórz zadanie wpisz w polu Podzadania wyłącznie {result}: każdy tekst z listy staje się podzadaniem.

Dla każdegoKopiuj link do tej sekcji

Wykonuje kroki po Dla każdego raz dla każdego elementu listy, na przykład dla każdej otwartej faktury klienta. Sam przepływ idzie dalej przez Gotowe.

Krok ma dwa wyjścia o własnym znaczeniu:

• Dla każdego prowadzi do kroków, które chcesz wykonać dla każdego elementu
• Gotowe to droga, którą idzie sam przepływ

Działa to tak:

• Każdy element dostaje własne wykonanie, które przechodzi kroki po Dla każdego do końca tej gałęzi. Widzisz je na karcie Uruchomienia, która pokazuje tylko ostatnie 20
• Element jest w zmiennej item, na przykład {item.id}. Zmienne zdarzenia i wcześniejszych kroków pozostają dostępne
• Przepływ nie czeka, aż elementy się skończą. Zaraz po ich uruchomieniu idzie dalej przez Gotowe. Wyniku elementu nie możesz więc użyć w krokach po Gotowe
• Przetwarzanych jest najwyżej 100 elementów, od najstarszych. Jeśli na liście jest ich więcej, pozostałe nie są przetwarzane
• Jeśli lista jest pusta albo pole Dla jest puste, nic nie startuje i przepływ od razu idzie dalej przez Gotowe
• Otwarte faktury klienta to zaksięgowane faktury, z których coś jeszcze pozostaje do zapłaty. Potwierdzone rezerwacje klienta to rezerwacje ze statusem Zarezerwowane

Przykład: faktura przeterminowuje się i chcesz utworzyć link do płatności dla każdej otwartej faktury tego klienta. Wybierz Otwarte faktury klienta, wpisz {invoice.customerId} przy Dla i dodaj po Dla każdego krok Utwórz link do płatności z {item.id} jako fakturą.

Czekaj, ażKopiuj link do tej sekcji

Sprawdza warunki raz za razem, aż zostaną spełnione, albo przestaje po jakimś czasie. Użyj tego, gdy nie wiesz, kiedy coś się wydarzy, ale wiesz, na co czekasz, na przykład aż faktura zostanie opłacona.

Krok ma dwa wyjścia: Spełniono (warunki są spełnione) i Przekroczono czas (czas oczekiwania minął, a warunki nie zostały spełnione).

Zwróć uwagę na to:

• Pierwsze sprawdzenie odbywa się od razu. Jeśli warunki są już spełnione, przepływ od razu idzie dalej przez Spełniono. Jeśli nie wpiszesz żadnego warunku, jest on zawsze spełniony
• Przy każdym sprawdzeniu Tillor czyta rekordy zdarzenia ponownie, tak jak przy opóźnieniu. Warunek taki jak invoice.paymentStatus jest PAID zobaczy więc płatność, gdy tylko się pojawi
• Interwał krótszy niż 5 minut zostaje zamieniony na 5 minut
• Podczas czekania wykonanie dostaje status Oczekuje. Wstrzymywanie i zmiana przepływu działają tak samo jak przy Opóźnieniu

Czekaj na zdarzenieKopiuj link do tej sekcji

Zatrzymuje przepływ, aż w Tillor coś się wydarzy, na przykład aż faktura zostanie opłacona.

Krok ma dwa wyjścia: Odebrano (zdarzenie nadeszło) i Przekroczono czas (czas oczekiwania minął bez zdarzenia). Jeśli Tylko dla tego samego rekordu jest włączone, dochodzi trzecie wyjście, Usunięto. Używasz go, gdy rekord przepływu został usunięty w trakcie czekania.

Zwróć uwagę na to:

• Przy włączonym Tylko dla tego samego rekordu liczy się na przykład tylko płatność faktury, od której przepływ wystartował. Jeśli to wyłączysz, każde zdarzenie tego typu pozwala przepływowi iść dalej
• Jeśli nie połączysz Usunięto z niczym, Tillor zatrzyma oczekujące przepływy tego rekordu i usunie zadania, które przepływ utworzył i które tylko on mógł zakończyć. Jeśli połączysz to wyjście, przepływ pójdzie tam dalej
• Jeśli przepływ startuje bez rekordu, na przykład przy Codziennie o danej godzinie, liczy się każde zdarzenie tego typu
• Liczy się też zdarzenie, które wywołał sam krok automatyzacji. Oczekujące przepływy idą więc dalej także wskutek pracy Przepływu pracy
• Po Odebrano dane zdarzenia, na które czekałeś, są w zmiennych, bez kolegi, który je wywołał. Jeśli czekasz na invoice:paid, to {invoice.paymentStatus} zwraca potem nowy stan
• Podczas czekania wykonanie dostaje status Oczekuje. Wstrzymywanie i zmiana przepływu działają tak samo jak przy Opóźnieniu

Poproś o decyzjęKopiuj link do tej sekcji

Tworzy zadanie z przyciskami, które sam określasz, i czeka, aż ktoś wybierze któryś z nich. Dzięki temu wbudowujesz moment, w którym człowiek patrzy na sprawę, na przykład zanim przepływ zablokuje klienta albo zaksięguje fakturę. Każda opcja to przycisk w zadaniu i wyjście kroku.

Ustawianie opcjiKopiuj link do tej sekcji

1. Przy Opcje kliknij Dodaj opcję i wpisz nazwę, na przykład Zatwierdź. Ta nazwa jest na przycisku i na wyjściu
2. Kliknij kolorowe pole po lewej stronie nazwy (Ikona i kolor), aby wybrać kolor i ikonę. Ikona nie jest wymagana
3. Włącz Poproś o notatkę, jeśli kolega ma przy tym wyborze wpisać powód
4. Włącz Poproś o potwierdzenie, jeśli kolega ma najpierw potwierdzić. Wpisujesz wtedy Tytuł potwierdzenia i Treść potwierdzenia oraz wybierasz przy Poziom jedną z opcji Info, Ostrzeżenie albo Destrukcyjny. W tych tekstach możesz używać zmiennych
5. Powtórz to dla każdej opcji. Możesz utworzyć maksymalnie 8 opcji

Jeśli lista jest jeszcze pusta, przycisk Zatwierdź / Odrzuć od razu przygotowuje dwie opcje: zielone Zatwierdź i czerwone Odrzuć. Każda opcja potrzebuje nazwy, inaczej Tillor pokazuje Każda opcja musi mieć nazwę. Bez opcji Tillor pokazuje Dodaj co najmniej jedną opcję.

WyjściaKopiuj link do tej sekcji

Krok ma jedno wyjście na opcję, z nazwą i kolorem tej opcji, oraz zawsze Przekroczono czas.

Zwróć uwagę na to:

• Przyciski są na karcie zadania, na liście zadań i w samym zadaniu. Takie zadanie nie ma haczyka: nie możesz go po prostu ukończyć, możesz tylko wybrać przycisk. Po wyborze zadanie ma status Ukończone i widać, którą opcję wybrano. Zobacz Zadania z przyciskami wyboru
• Wybrać może osoba przypisana do zadania, także przez grupę, oraz administratorzy. Jeśli nikogo nie przypiszesz, wybrać może każdy, kto widzi zadanie
• Zadanie dostaje priorytet Wysoki. Jest na nazwisko Przepływ pracy
• Jeśli zadanie zostanie usunięte, zanim ktoś wybierze, przepływ idzie dalej przez Przekroczono czas. Po Przekroczono czas wskutek upływu czasu oczekiwania zadanie pozostaje
• Późniejsze kroki mogą używać {approvalTask.id}, {approval.decision}, {approval.label}, {approval.note} i {approval.decidedBy.name}. {approval.label} to nazwa wybranej opcji, a {approval.note} to notatka, którą wpisał kolega
• Podczas czekania wykonanie dostaje status Oczekuje. Wstrzymywanie i zmiana przepływu działają tak samo jak przy Opóźnieniu

Co dzieje się potem?Kopiuj link do tej sekcji

• Wyjście, którego nie połączysz, kończy w tym miejscu wykonanie.
• Przy kroku czekania wykonanie dostaje status Oczekuje i rusza dalej później. Wstrzymana automatyzacja zatrzymuje oczekujące wykonania po upływie czasu oczekiwania.
• Po czasie oczekiwania Tillor czyta dane ponownie, żeby kroki widziały aktualny stan.

Problemy?Kopiuj link do tej sekcji