Condiții, ramificări și întârzieri

Cu pașii din grupul Logică stabilești încotro merge un flux și când: „dacă” și „așteaptă puțin”. Un exemplu: dacă factura este încă deschisă după o săptămână, creează o sarcină. Ei conduc acțiunile de după ei. Doar Cere o decizie creează ceva, o sarcină.

Dacă / altfelCopiază linkul către această secțiune

Împarte fluxul în două căi pe baza datelor. Este același principiu ca filtrul de la Doar când al declanșatorului, dar acum în mijlocul fluxului.

Pasul are două ieșiri: Da (condițiile sunt îndeplinite) și Nu (nu sunt îndeplinite).

1. Adaugă un pas Dacă / altfel
2. La Condiții, dă clic pe Adaugă condiție
3. Alege câmpul cu butonul Variabilă sau scrie tu însuți calea, de exemplu invoice.paymentStatus
4. Alege comparația (este, nu este, conține, este mai mare decât, este mai mic decât, este unul dintre, este gol sau nu este gol) și completează valoarea
5. Conectează ieșirea Da și, dacă vrei, Nu la un pas următor

Un pas Dacă / altfel are nevoie de cel puțin o condiție. Altfel, Tillor afișează Adaugă o condiție. Când ai mai multe condiții, alegi între Toate trebuie să se potrivească și Este suficientă una. Comparațiile funcționează așa cum este descris la Doar când.

Nu trebuie să conectezi ambele ieșiri. Dacă o ieșire nu duce nicăieri, rularea se termină acolo. Un flux care face ceva doar la Da este deci perfect în regulă.

Poți folosi și câmpuri din pașii anteriori. După o Cerere API poți, de exemplu, să te uiți la response.status sau la response.data.paymentStatus.

RamificareCopiază linkul către această secțiune

Alege Ramificare când ai nevoie de mai mult de două căi. Pasul se uită la valoarea unui singur câmp și alege ramura potrivită.

1. La Câmp, alege câmpul la care vrei să te uiți, de exemplu occupation.occupationType
2. La Ramuri, dă clic pe Adaugă ramură. Completează Ramură (numele care apare pe ieșire) și Egal cu (valoarea pe care trebuie să o aibă câmpul)
3. Repetă pentru fiecare ramură
4. Conectează fiecare ieșire la un pas următor

Fiecare ramură primește o ieșire proprie sub pas. În plus, există mereu o ieșire Implicit. Aceasta se folosește când nicio ramură nu se potrivește.

• Câmpul trebuie să corespundă exact cu valoarea, inclusiv majusculele
• Dacă se potrivește mai mult de o ramură, câștigă prima din listă
• O ramură fără valoare la Egal cu nu contează
• Poți seta cel mult 8 ramuri, plus Implicit
• Dacă câmpul este gol sau nu există, fluxul merge pe Implicit

Valorile câmpurilor de alegere sunt în notația Tillor. O ocupare de tip rulotă de închiriat are, de exemplu, valoarea RENTAL_CARAVAN, iar o factură plătită PAID.

ÎntârziereCopiază linkul către această secțiune

Cu Întârziere faci fluxul să aștepte înainte să continue. Folosești asta pentru lucruri ca mai verifică o dată peste o săptămână.

La Așteaptă alegi una dintre două variante.

Un timp fixCopiază linkul către această secțiune

Alege Pentru un timp fix și completează la Durată un număr și o unitate: secunde, minute, ore, zile sau săptămâni. Secundele nu sunt exacte. Fluxul poate continua cu câteva secunde mai târziu.

O întârziere de 0 nu face nimic, de aceea Tillor afișează O întârziere de 0 nu face nimic.

Până la o datăCopiază linkul către această secțiune

Alege Până la o dată când timpul de așteptare depinde de o dată din date, precum data scadenței unei facturi sau data de sfârșit a unei rezervări.

Exemple:

• Dată invoice.dueDate, După, Decalaj 1 zi: fluxul continuă o zi după data scadenței
• Dată reservation.checkIn, Înainte, Decalaj 2 zile: fluxul continuă cu două zile înainte de sosire

Dacă acel moment este deja în trecut sau data este goală, fluxul continuă imediat.

Ce se întâmplă în timpul așteptăriiCopiază linkul către această secțiune

• Rularea primește starea În așteptare. În fila Rulări scrie când continuă (Continuă …). Timpii lungi de așteptare, precum săptămânile, nu sunt o problemă
• După întârziere, Tillor citește din nou datele, astfel încât pașii de după să vadă situația actuală. Vezi mai jos
• Dacă pui automatizarea pe pauză în timpul așteptării, rularea se oprește imediat ce trece timpul de așteptare. Nu mai continuă și primește starea Anulată. Dacă activezi automatizarea înainte să treacă timpul de așteptare, rularea continuă normal
• Dacă ștergi automatizarea, rulările în așteptare se opresc
• Dacă modifici fluxul în timp ce o rulare așteaptă, acea rulare se termină cu fluxul așa cum era când a pornit

Datele sunt citite din nouCopiază linkul către această secțiune

O rulare își amintește datele din momentul evenimentului, dar citește din nou înregistrările aferente înainte să continue. Acestea sunt înregistrarea evenimentului (de exemplu factura) și înregistrările la care aceasta face referire (de exemplu clientul).

Un exemplu: o automatizare trimite un memento pentru o factură, așteaptă 7 zile și apoi verifică cu Dacă / altfel dacă invoice.paymentStatus nu este PAID. Dacă factura a fost plătită în acea săptămână, condiția vede factura plătită și fluxul merge pe Nu.

Există două excepții:

• Dacă înregistrarea nu mai există, de exemplu pentru că o ocupare a fost ștearsă, rularea păstrează copia din momentul evenimentului
• Datele pe care le-a produs un pas anterior, precum răspunsul unei cereri API, nu sunt preluate din nou. Dacă vrei astfel de date reîmprospătate după o întârziere, fă o nouă cerere API

Deschis acum?Copiază linkul către această secțiune

Verifică dacă organizația ta este deschisă în acest moment și împarte fluxul în Deschis și Închis. Nu ai nimic de setat. Tillor folosește orele de la Setări > Program de funcționare, cu perioade de sezon, sărbători și excepții. Vezi Setările organizației.

Folosește-l, de exemplu, ca să trimiți un alt text în afara programului sau să creezi o sarcină. Dacă preferi să aștepți până când ești din nou deschis, folosește Așteaptă până la deschidere. Dacă vrei să aștepți până închizi, folosește Așteaptă până la închidere.

Așteaptă până la deschidereCopiază linkul către această secțiune

Pune fluxul pe pauză până la următoarea oră de deschidere și apoi continuă. Organizația ta este deja deschisă? Atunci fluxul continuă imediat. Nu ai nimic de setat.

• Ora de deschidere vine din Setări > Program de funcționare, în fusul orar al organizației tale
• Dacă luna următoare nu există nicio oră de deschidere, fluxul continuă imediat în loc să rămână în așteptare
• În timpul așteptării, rularea primește starea În așteptare. Ce se întâmplă atunci găsești la Întârziere

Așteaptă până la închidereCopiază linkul către această secțiune

Pune fluxul pe pauză până la următoarea oră de închidere și apoi continuă. Organizația ta este deja închisă? Atunci fluxul continuă imediat. Nu ai nimic de setat.

• Ora de închidere vine din Setări > Program de funcționare, în fusul orar al organizației tale
• Blocurile care se leagă între ele, precum 9:00–12:00 și 12:00–17:00, contează ca o singură bucată. Fluxul așteaptă până la sfârșitul acelei bucăți
• În timpul așteptării, rularea primește starea În așteptare. Ce se întâmplă atunci găsești la Întârziere

Cel mult o dată pe perioadăCopiază linkul către această secțiune

Lasă fluxul să treacă doar dacă nu a trecut deja prin acest pas pentru aceeași înregistrare în cadrul perioadei. Așa nu trimiți unui client același memento în fiecare zi.

Pasul are două ieșiri: Continuă dacă fluxul nu a trecut pe acolo în perioadă și Deja rulat dacă a trecut. Conectează Deja rulat la un alt pas sau lasă-l gol, astfel încât rularea să se termine acolo.

Ține cont de următoarele:

• Contează doar rulările aceleiași automatizări și doar dacă au trecut prin acest pas pe Continuă
• Dacă nu conectezi Șters la nimic, Tillor oprește fluxurile în așteptare ale acelei înregistrări și șterge sarcinile pe care le-a creat fluxul și pe care doar fluxul le putea finaliza. Dacă conectezi ieșirea, fluxul continuă acolo
• Dacă fluxul pornește fără înregistrare, de exemplu la În fiecare zi la o oră, completează tu o variabilă la Numără per. Fără această valoare fiecare rulare este nouă și pasul nu oprește nimic
• Rularea care este în curs nu se numără pe ea însăși

Un exemplu: Perioadă 7 zile și Numără per {invoice.customerId} lasă să treacă cel mult un memento pe săptămână per client, chiar dacă acel client are mai multe facturi scadente.

Caută o înregistrareCopiază linkul către această secțiune

Încarcă o înregistrare pe baza ID-ului ei, astfel încât pașii de după să îi poată folosi câmpurile. Este util când evenimentul oferă doar un ID, precum mesajul dintr-o conversație din inbox.

Pasul are două ieșiri: Găsită și Negăsită. Dacă înregistrarea nu există sau ID-ul este gol, fluxul merge pe Negăsită.

După Găsită, câmpurile înregistrării se află în variabile care încep cu found urmat de tip: {foundCustomer.firstName}, {foundInvoice.displayId}, {foundReservation.checkIn}, {foundTerrain.name}, {foundInboxMessage.direction}. Celelalte tipuri se numesc foundOccupation, foundPayment, foundTask, foundAccessMethod, foundNfcTag, foundMeter și foundInboxThread. Sunt incluse și înregistrările la care face referire, cu un nivel în adâncime, precum {foundReservation.customer.firstName}. Totul se află în lista din spatele butonului Variabilă.

O a doua căutare de același tip o înlocuiește pe prima. Atenție la Sarcină: folosește același nume foundTask ca Caută o sarcină, iar ultima dintre cele două câștigă. Același lucru este valabil pentru Document și foundDocument de la Caută un document.

Mapează variabileCopiază linkul către această secțiune

Copiază valori în nume noi de variabile, astfel încât pașii următori să poată folosi o singură formă - util când un flux pornește prin Webhook de intrare ({body.…}) și prin Factură restantă ({invoice.…}).

Pasul are o singură ieșire: Următorul. Dacă sursa este exact o variabilă între acolade, de exemplu {foundInvoice}, Tillor copiază întreaga înregistrare (obiect). Altfel, Tillor completează sursa ca text, precum Factură {foundInvoice.displayId} în meta.label.

Test obișnuit cu webhook: Webhook de intrare → Caută o înregistrare (Factură, ID {body.invoiceId}) → Mapează variabile (invoice ← {foundInvoice}) → aceleași condiții și aprobare ca la declanșatorul de tip program.

Rulează codCopiază linkul către această secțiune

Execută o bucată de TypeScript pe variabilele fluxului și păstrează ce returnează ca variabilă nouă. Pentru logică pe care nu o poți exprima în câmpuri și condiții: ce subsarcini trebuie să apară, calculul unei sume sau al unei date, remodelarea corpului unui webhook.

Pasul are o singură ieșire: Următorul. Iată cum funcționează:

• Codul vede doar variabilele pe care le menționează. O variabilă pe care fluxul nu o are este null; o dată vine ca text (2026-07-01T10:00:00.000Z)
• Formatările și decalajele de dată ({bedrag|currency}, {datum + 1 day}) nu funcționează aici: calculează-le în cod
• Returnează o listă, un text, un număr sau un obiect. Un obiect îl citești apoi câmp cu câmp: {result.total}
• Codul nu poate prelua sau trimite nimic: fără internet, fără bază de date. Doar calculează. Un calcul prea lung (mai mult de 50 ms) se întrerupe
• Dacă codul aruncă o eroare, rularea se oprește cu acea eroare și numărul rândului. O vezi în fila Rulări
• În dreapta codului vezi imediat ce returnează pe exemplu; la testare rulează și el

Un exemplu: după plecare vrei subsarcini care depind de parcelă. Pune un pas Rulează cod cu:

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

Apoi, la Creează sarcină, completează câmpul Subtaskuri doar cu {result}: fiecare text din listă devine o subsarcină.

Pentru fiecareCopiază linkul către această secțiune

Execută pașii de după Pentru fiecare o dată pentru fiecare element dintr-o listă, de exemplu pentru fiecare factură deschisă a unui client. Fluxul în sine continuă pe Gata.

Pasul are două ieșiri cu sens propriu:

• Pentru fiecare duce la pașii pe care vrei să îi faci per element
• Gata este calea prin care continuă fluxul însuși

Iată cum funcționează:

• Fiecare element primește o rulare proprie, care parcurge pașii de după Pentru fiecare până la capătul acelei ramuri. Le vezi în fila Rulări, care le arată doar pe ultimele 20
• Elementul se află în variabila item, de exemplu {item.id}. Variabilele evenimentului și ale pașilor anteriori rămân disponibile
• Fluxul nu așteaptă ca elementele să se termine. Imediat după ce acestea au pornit, continuă pe Gata. Rezultatul unui element nu îl poți deci folosi în pașii de după Gata
• Se procesează cel mult 100 de elemente, cele mai vechi primele. Dacă în listă sunt mai multe, restul nu se procesează
• Dacă lista este goală sau câmpul Al este gol, nu pornește nimic și fluxul continuă imediat pe Gata
• Facturile deschise ale unui client sunt facturi înregistrate din care mai este ceva de plătit. Rezervările confirmate ale unui client sunt rezervări cu starea Rezervată

Un exemplu: o factură devine scadentă și vrei să creezi un link de plată pentru fiecare factură deschisă a acelui client. Alege Facturile deschise ale unui client, completează {invoice.customerId} la Al și pune după Pentru fiecare un pas Creează link de plată cu {item.id} ca factură.

Așteaptă până cândCopiază linkul către această secțiune

Verifică condițiile din nou și din nou până sunt îndeplinite sau se oprește după un timp. Folosește-l când nu știi când se întâmplă ceva, dar știi ce aștepți, de exemplu până când o factură este plătită.

Pasul are două ieșiri: Îndeplinită (condițiile sunt îndeplinite) și Expirat (timpul de așteptare a trecut fără ca ele să fie îndeplinite).

Ține cont de următoarele:

• Prima verificare are loc imediat. Dacă condițiile sunt deja îndeplinite, fluxul continuă direct pe Îndeplinită. Dacă nu ai completat nicio condiție, este îndeplinită întotdeauna
• La fiecare verificare, Tillor citește din nou înregistrările evenimentului, ca la o întârziere. O condiție precum invoice.paymentStatus este PAID vede deci plata imediat ce există
• Un interval sub 5 minute devine 5 minute
• În timpul așteptării, rularea primește starea În așteptare. Pentru pauză și modificarea fluxului este valabil același lucru ca la Întârziere

Așteaptă un evenimentCopiază linkul către această secțiune

Pune fluxul pe pauză până se întâmplă ceva în Tillor, de exemplu până când factura este plătită.

Pasul are două ieșiri: Primit (evenimentul a venit) și Expirat (timpul de așteptare a trecut fără eveniment). Dacă Doar pentru aceeași înregistrare este activat, apare o a treia ieșire, Șters. O folosești când înregistrarea fluxului a fost ștearsă în timp ce fluxul aștepta.

Ține cont de următoarele:

• Cu Doar pentru aceeași înregistrare activat, contează, de exemplu, doar plata facturii cu care a pornit fluxul. Dacă îl dezactivezi, orice eveniment de acel tip lasă fluxul să continue
• Dacă nu conectezi Șters la nimic, Tillor oprește fluxurile în așteptare ale acelei înregistrări și șterge sarcinile pe care le-a creat fluxul și pe care doar fluxul le putea finaliza. Dacă conectezi ieșirea, fluxul continuă acolo
• Dacă fluxul pornește fără înregistrare, de exemplu la În fiecare zi la o oră, contează orice eveniment de acel tip
• Un eveniment pe care îl provoacă chiar un pas al unei automatizări contează și el. Fluxurile în așteptare continuă deci și pe baza muncii făcute de Flux de lucru
• După Primit, datele evenimentului pe care l-ai așteptat se află în variabile, fără colegul care l-a provocat. Dacă aștepți invoice:paid, {invoice.paymentStatus} dă apoi noua stare
• În timpul așteptării, rularea primește starea În așteptare. Pentru pauză și modificarea fluxului este valabil același lucru ca la Întârziere

Cere o decizieCopiază linkul către această secțiune

Creează o sarcină cu butoane pe care le stabilești tu și așteaptă până când cineva alege un buton. Așa introduci un moment în care un om se uită peste, de exemplu înainte ca fluxul să blocheze un client sau să înregistreze o factură. Fiecare opțiune este un buton pe sarcină și o ieșire a pasului.

Setarea opțiunilorCopiază linkul către această secțiune

1. La Opțiuni, dă clic pe Adaugă opțiune și completează numele, de exemplu Aprobă. Acest nume apare pe buton și pe ieșire
2. Dă clic pe căsuța colorată din stânga numelui (Pictogramă și culoare) ca să alegi o culoare și o pictogramă. O pictogramă nu este obligatorie
3. Activează Cere o notă dacă la această alegere colegul trebuie să completeze un motiv
4. Activează Cere confirmare dacă colegul trebuie mai întâi să confirme. Completezi atunci un Titlu confirmare și un Mesaj de confirmare și alegi la Severitate dintre Info, Avertisment sau Destructiv. În aceste texte poți folosi variabile
5. Repetă pentru fiecare opțiune. Poți crea cel mult 8 opțiuni

Dacă lista este încă goală, butonul Aprobă / Respinge pregătește imediat două opțiuni: un Aprobă verde și un Respinge roșu. Fiecare opțiune are nevoie de un nume, altfel Tillor afișează Fiecare opțiune are nevoie de un nume. Fără opțiuni, Tillor afișează Adaugă cel puțin o opțiune.

IeșiriCopiază linkul către această secțiune

Pasul are câte o ieșire per opțiune, cu numele și culoarea acelei opțiuni, plus mereu Expirat.

Ține cont de următoarele:

• Butoanele apar pe cardul sarcinii, în lista de sarcini și în sarcina însăși. O astfel de sarcină nu are bifă: nu o poți finaliza pur și simplu, ci doar alege un buton. După alegere, sarcina are starea Finalizată și se arată ce opțiune a fost aleasă. Vezi Sarcini cu butoane de alegere
• Poate alege cel căruia i-a fost atribuită sarcina, inclusiv printr-un grup, precum și administratorii. Dacă nu atribui pe nimeni, poate alege oricine vede sarcina
• Sarcina primește prioritatea Ridicată. Apare pe numele Flux de lucru
• Dacă sarcina este ștearsă înainte să aleagă cineva, fluxul continuă pe Expirat. După Expirat din cauza timpului de așteptare, sarcina rămâne
• Pașii următori pot folosi {approvalTask.id}, {approval.decision}, {approval.label}, {approval.note} și {approval.decidedBy.name}. {approval.label} este numele opțiunii alese, iar {approval.note} nota pe care a completat-o colegul
• În timpul așteptării, rularea primește starea În așteptare. Pentru pauză și modificarea fluxului este valabil același lucru ca la Întârziere

Ce se întâmplă după aceea?Copiază linkul către această secțiune

• O ieșire pe care nu o conectezi face ca rularea să se termine acolo.
• La un pas de așteptare, rularea primește starea În așteptare și continuă mai târziu. O automatizare pusă pe pauză oprește rulările în așteptare imediat ce trece timpul de așteptare.
• După un timp de așteptare, Tillor citește din nou datele, astfel încât pașii să vadă situația actuală.

Probleme?Copiază linkul către această secțiune