Elbuz wykonuje polecenia reguły tylko wtedy, gdy zaszło wybrane zdarzenie, a rekord spełnia warunek. Zdarzenie odpowiada na pytanie „kiedy sprawdzać”, warunek — „czy ten rekord nas interesuje”.
Kiedy to się przyda:
- E-mail ma wychodzić tylko przy zamówieniu klienta — warunek według typu dokumentu odsieje pozostałe dokumenty.
- Potrzebna jest reakcja na zmianę statusu, a nie na każdy zapis — pozycja „Wartość początkowa” wychwytuje właśnie zmianę.
- Przypomnienie o płatności trzy dni po terminie — podstawienie daty w warunku samo liczy termin.
- Przypomnienie ma się powtarzać codziennie — „Okres sprawdzania” pozwala na powtórzenie dla tego samego rekordu.
Od czego zacząć: „Reguły automatyczne” → „Dodaj” → wybierz zdarzenie.
Co potrafią zdarzenie i warunek
- Dwanaście zdarzeń — utworzenie, zapis, zatwierdzenie dokumentu, zmiany kontrahenta, zatwierdzenie wniosku agenta AI.
- Przeterminowana płatność — zdarzenie z harmonogramu systemowego co 32 minuty, bez działania człowieka.
- Kreator warunku — pole, operator i wartość z pól Twojej listy dokumentów lub kontrahentów.
- Podstawienia dat — „dziś minus trzy dni” zamiast konkretnej daty.
- „Wartość początkowa” — uruchomienie właśnie przy zmianie pola.
- „Okres sprawdzania” — raz na rekord albo powtórzenie nie częściej niż w zadanym okresie.
Zdarzenia, do których można podpiąć regułę
Zdarzeń jest dwanaście. Sześć dotyczy kontrahentów, pięć dokumentów i jedno zatwierdzenia wniosku agenta AI.
| Zdarzenie na liście | Kiedy jest wywoływane |
|---|---|
| Kontrahent: dodanie | utworzenie karty kontrahenta |
| Kontrahent: zapis | zapisanie karty kontrahenta |
| Kontrahent: usunięcie | usunięcie kontrahenta — karta trafia przy tym do kosza i pozostaje dostępna dla reguły |
| Kontrahent : dodanie | utworzenie kontrahenta przez system zewnętrzny przez API |
| Kontrahent API: zapis | zapisanie kontrahenta przez API |
| Kontrahent API: usunięcie | usunięcie kontrahenta przez API |
| Dokument: dodanie | utworzenie dokumentu, w tym zamówienia ze strony |
| Dokument: aktualizacja | zapisanie dokumentu; zmiana zamówienia podczas importu (tunel, marketplace’y, API v2); do tego co 32 minuty harmonogram systemowy przechodzi przez niezatwierdzone dokumenty z ostatnich 30 dni |
| Dokument: usunięcie | wiersz na liście jest, ale reguła na nim nie działa: w chwili sprawdzania dokumentu nie ma już w bazie |
| Dokument: zatwierdzenie (podpis) | zatwierdzenie dokumentu i cofnięcie zatwierdzenia |
| Dokument: przeterminowana płatność | tylko z harmonogramu systemowego, co 32 minuty |
| Agent AI: zatwierdzenie wykonane | po tym, jak człowiek zaakceptował wniosek agenta AI o zmianę danych; to zdarzenie jest proponowane tylko w oknie otwartym z „Szablonów wiadomości” — a stamtąd reguła powstaje bez warunku (dlaczego) |
Przeterminowana płatność — przypadek szczególny
To zdarzenie nie pochodzi z działania człowieka: co 32 minuty tworzy je harmonogram systemowy. Bierze on dokumenty, w których „Termin płatności” już minął, ale nie więcej niż 90 dni temu, i w których nie wpisano daty płatności — do 300 dokumentów na przebieg, zaczynając od najnowszych.
W tym samym przebiegu harmonogram przechodzi przez niezatwierdzone dokumenty z ostatnich 30 dni — też do 300 najnowszych — i wywołuje dla nich „Dokument: aktualizacja”.
To wiersz systemowego harmonogramu konta, nie trzeba go zakładać — już istnieje. Ale jeśli harmonogram na koncie jest wyłączony, zdarzenie w ogóle nie przyjdzie: ani o przeterminowanej płatności, ani o niezatwierdzonych dokumentach.
Gdy tworzysz regułę właśnie na przeterminowaną płatność, program od razu wstawia do niej warunek-wzór: „Termin płatności” mniejsze {current_date}. Możesz go zostawić bez zmian albo przerobić pod siebie.
Reguła powstaje już włączona. To odwrotnie niż harmonogram, który tworzy się wyłączony i czeka, aż zaznaczysz pole. Dlatego sekwencja „utworzyć regułę → pójść na kawę → wrócić, by ustawić warunek” jest niebezpieczna: reguła bez warunku działa przy każdym zdarzeniu. Dopóki warunek nie jest gotowy, wyłącz przełącznik „Aktywność” w pierwszej sekcji karty.
Warunek: co dokładnie jest sprawdzane
Warunek składa się w kreatorze: pole, operator, wartość — i tak dowolnie wiele wierszy połączonych przez „i” lub „lub”. Pod kreatorem program opisuje złożony warunek zwykłymi słowami, żeby można go było przeczytać i upewnić się, że wyszło dokładnie to, co zamierzano.
1
Wiersz kreatora warunku2
Opis zwykłymi słowami3
Przycisk „Zapisz warunek”- Wiersz kreatora — pole, operator i wartość razem tworzą jeden warunek.
- Pasek opisu — pokazuje zwykłymi słowami, jaki warunek wyszedł.
- „Zapisz warunek” — warunek zapisuje się tylko tym przyciskiem; pozostałe pola karty zapisują się same.
Lista pól pochodzi z Twojej tabeli dokumentów lub kontrahentów. Daje to dostęp do setek pól, w tym Twoich własnych, ale ma drugą stronę: u pracownika, który ani razu nie otworzył danej listy, kreator będzie pusty. Rozwiązanie jest proste — otworzyć listę, ustawić kolumny i wrócić do reguły.
Operatory zależą od typu pola:
- liczba — równa się, jest różne od, mniejsze, mniejsze lub równe, większe, większe lub równe, pomiędzy;
- data i tekst — wszystko powyższe plus jest puste, nie jest puste, zawiera, nie zawiera;
- status dokumentu, status i rodzaj płatności, status i rodzaj dostawy, grupa kontrahenta, język, waluta — równa się, jest różne od, jeden z podanych, żaden z podanych (na ekranie te dwa podpisane „zawiera” / „nie zawiera”), z listą gotowych wartości;
- magazyn, firma i typ dokumentu — równa się, jest różne od, jest puste;
- tak/nie — tylko równa się, z listą „Tak” i „Nie”.
Stany pozycji dokumentu warunek widzi tylko w zdarzeniu „Dokument: zatwierdzenie (podpis)”: pojawia się tam pole „Stan produktu w magazynie”. W innych zdarzeniach takiego pola nie ma.
Podstawienia dat
W wartości warunku zamiast konkretnej daty możesz wpisać podstawienie, a program zamieni je w chwili sprawdzania. Są trzy: {current_date}, {current_datetime} i {current_time}. Do każdego dopisuje się przesunięcie: znak plus lub minus, liczbę i jednostkę — minute, hour, day, week, month, year.
W samym programie te wzory leżą pod napisem „Podpowiedź: podstawianie dat w warunkach”, kliknięcie wzoru go kopiuje. Przykład z podpowiedzi: warunek „Termin płatności” mniejsze {current_date-3day} oznacza „po terminie ponad trzy dni”.
„Wartość początkowa” — reakcja na zmianę
Na listach wartości statusów dokumentu, płatności i dostawy, rodzajów płatności i dostawy, magazynu, firmy, języka i waluty jest osobna pozycja „Wartość początkowa”. Działa tylko w parze z operatorem „jest różne od” i czyta się ją tak: „pole stało się inne niż przed zapisem”. Czyli reguła zadziała właśnie przy zmianie, a nie przy każdym zapisie karty.
Ta pozycja ma drugi, mniej oczywisty efekt: gdy wartość naprawdę się zmieniła, program czyści dziennik uruchomień dla tego rekordu. Dlatego reguła z „Wartością początkową” może działać dla jednego i tego samego dokumentu raz po raz — za każdym razem, gdy pole się zmienia.
Warunek zapisuje się osobnym przyciskiem „Zapisz warunek” pod kreatorem. Pozostałe pola karty — nazwa, uwagi, przełącznik „Aktywność”, „Okres sprawdzania” — zapisują się same, gdy tylko opuścisz pole, przycisku dla nich nie ma. Przez to łatwo złożyć warunek, zamknąć okno i dostać regułę ze starym warunkiem: nazwa się zapisała, a warunek nie.
Obok jest „Wyczyść warunek” — usuwa wszystkie wiersze z kreatora, ale w bazie warunek pozostaje stary, dopóki nie klikniesz „Zapisz warunek”.
Raz na rekord — i nigdy więcej
To najczęstsze źródło pytania „reguła jest włączona, a e-maila nie ma”. Program prowadzi osobny dziennik uruchomień: dla każdej pary „polecenie + rekord” zapamiętuje, że już ją wykonał. Drugi raz dla tego samego dokumentu polecenie się nie wykona.
Zachowaniem steruje pole „Okres sprawdzania” w pierwszej sekcji karty i sąsiednie pole „Jednostka” z wartościami: sekund, minut, godzin, dni, tygodni, miesięcy, kwartałów, lat.
- 0 — wartość, z którą reguła powstaje. Oznacza „żadnego powtórzenia”: jedno polecenie, jeden rekord, jeden raz przez całe życie reguły.
- Więcej niż zero — wpis w dzienniku starszy niż podany okres jest usuwany i polecenie może wykonać się ponownie. „1 dzień” czyta się jako „nie częściej niż raz na dobę dla jednego rekordu”.
Trzeci sposób na powtórzenie — warunek z pozycją „Wartość początkowa”: gdy pole naprawdę się zmieniło, dziennik dla tego rekordu jest czyszczony w całości.
Scenariusze
- Jeden e-mail na każde nowe zamówienie — zdarzenie „Dokument: dodanie”, warunek „Typ dokumentu” równa się „Zamówienie klienta”, „Okres sprawdzania” 0. W całości: e-mail z potwierdzeniem.
- Przypomnienie codziennie, dopóki faktura nie jest opłacona — zdarzenie „Dokument: przeterminowana płatność”, „Okres sprawdzania” 1 dzień. W całości: przypomnienie o płatności.
- SMS tylko wtedy, gdy zmieniono status — warunek „Status dokumentu” jest różne od „Wartość początkowa” i równa się potrzebnemu statusowi. W całości: SMS według statusu.
- Prośba o opinię trzy dni po wysyłce — zdarzenie „Dokument: aktualizacja”, warunek z podstawieniem daty, „Okres sprawdzania” 0: przypomnienie ma wyjść raz.
Co zrobić, gdy reguła nie reaguje
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Reguła jest włączona, zdarzenie zaszło, w dzienniku nic | Najczęściej — polecenie już wcześniej wykonało się dla tego rekordu, a „Okres sprawdzania” jest równy zeru | Ustawić „Okres sprawdzania” większy od zera albo dodać do warunku pozycję „Wartość początkowa” (o powtórzeniach) |
| W sekcji „Warunek” nie ma żadnego pola do wyboru | Lista pól pochodzi z Twojej tabeli dokumentów lub kontrahentów, a ta lista nie była jeszcze otwierana | Otworzyć odpowiednią listę, ustawić kolumny, wrócić do reguły (o warunku) |
| Złożony warunek, zamknięte okno — warunek jest stary | Warunek zapisuje się osobnym przyciskiem, pozostałe pola karty — same | Kliknąć „Zapisz warunek” pod kreatorem (o warunku) |
| Warunek o przeterminowanej płatności jest, a reguła milczy | To zdarzenie przychodzi tylko z harmonogramu systemowego, co 32 minuty, i tylko dla dokumentów, w których „Termin płatności” minął nie więcej niż 90 dni temu, a data płatności nie jest wypełniona. Na przebieg harmonogram bierze do 300 takich dokumentów, zaczynając od najnowszych | Sprawdzić, czy płatność naprawdę nie jest wpisana, a termin minął nie więcej niż 90 dni temu (o przeterminowanej płatności) |
| „Warunek nie został zapisany: zawiera pole, operator lub wartość, których kreator nie akceptuje. Otwórz warunek ponownie i zapisz jeszcze raz.” — w nawiasie po nim przyczyna | Komunikat pojawia się przy każdym błędzie odczytu warunku: w lewej kolumnie wyrażenie zamiast pola z listy; operator, którego kreator nie zna; dla „pomiędzy” wypełniona jedna wartość z dwóch; grupy połączone nie przez AND/OR; uszkodzony warunek. Prawie zawsze to warunek zapisany starszą wersją programu | Zamknąć kartę, otworzyć ponownie, usunąć dziwne wiersze, złożyć je od nowa z pól listy, wypełnić obie wartości „pomiędzy” i kliknąć „Zapisz warunek”. Datę porównywać podstawieniem w wartości: „Termin płatności” → mniejsze → {current_date-3day} |
Najczęstsze pytania
Czy można zmienić zdarzenie w gotowej regule?
Nie. Zdarzenie wybiera się raz przy tworzeniu, w karcie reguły nie da się go zmienić. Potrzebne jest inne zdarzenie — utwórz nową regułę.
Dlaczego zamówienie dodane ręcznie nie dostało e-maila z reguły na dodanie?
Zdarzenie utworzenia, które wywołuje ręczne dodanie z listy dokumentów, nie niesie numeru dokumentu, więc reguła taki rekord pomija. E-mail z „Dokument: dodanie” wychodzi przy zamówieniach zaimportowanych ze strony.
Dlaczego reguła na „Dokument: usunięcie” nic nie robi?
W chwili sprawdzania dokumentu nie ma już w bazie. Dla kontrahenta to zdarzenie działa: karta trafia do kosza i pozostaje dostępna dla reguły.
Czy można wychwycić zmianę magazynu lub firmy przez „Wartość początkową”?
Tak. Warunek „Magazyn” lub „Firma” → „jest różne od” → „Wartość początkowa” zadziała, gdy magazyn lub firmę w dokumencie zmieniono (o „Wartości początkowej”).
Dlaczego nie ma przypomnienia o fakturze przeterminowanej pół roku temu?
Harmonogram systemowy bierze tylko dokumenty, w których „Termin płatności” minął nie więcej niż 90 dni temu. Starsze wypadają z wyboru.
Gdzie to jest i kto ma dostęp
Reguły nie mają pozycji w menu: okno otwiera się z listy dokumentów lub kontrahentów (wszystkie wejścia).
- Zdarzenie
- „Reguły automatyczne” → „Dodaj” → lista zdarzeń
- Warunek
- karta reguły → sekcja „Warunek”
- Uprawnienia
- okno „Reguły automatyczne” z prawem edycji
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu, — jak działają reguły automatyczne.
- Jeśli warunek jest złożony i trzeba wybrać, co zrobić, — polecenia reguły.
- Jeśli reguła jest włączona, a w dzienniku pusto lub „Nie wykonano!”, — jak sprawdzić regułę.
