↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak wybrać zdarzenie i ustawić warunek reguły

    5 min czytaniaZaktualizowano

    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

    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.

    Pełna lista zdarzeń
    Zdarzenie na liścieKiedy jest wywoływane
    Kontrahent: dodanieutworzenie karty kontrahenta
    Kontrahent: zapiszapisanie karty kontrahenta
    Kontrahent: usunięcieusunięcie kontrahenta — karta trafia przy tym do kosza i pozostaje dostępna dla reguły
    Kontrahent : dodanieutworzenie kontrahenta przez system zewnętrzny przez API
    Kontrahent API: zapiszapisanie kontrahenta przez API
    Kontrahent API: usunięcieusunięcie kontrahenta przez API
    Dokument: dodanieutworzenie dokumentu, w tym zamówienia ze strony
    Dokument: aktualizacjazapisanie 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ęciewiersz 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 wykonanepo 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.

    Sekcja „Warunek” karty wyzwalacza: kreator warunku, opis zwykłymi słowami, rozwinięta podpowiedź o podstawieniach dat i przyciski „Wyczyść warunek” / „Zapisz warunek”
    1Wiersz kreatora warunku
    2Opis zwykłymi słowami
    3Przycisk „Zapisz warunek”
    1. Wiersz kreatora — pole, operator i wartość razem tworzą jeden warunek.
    2. Pasek opisu — pokazuje zwykłymi słowami, jaki warunek wyszedł.
    3. „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

    Objaw, przyczyna i co zrobić
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo