↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak sprawdzić regułę i usunąć skutki błędu

    6 min czytaniaZaktualizowano

    Elbuz zapisuje każde wykonane polecenie reguły w „Dzienniku operacji” i sam oznacza na schemacie reguły bez warunku, bez akcji lub z możliwą pętlą. Dzięki temu błąd widać, zanim reguła wyśle setki wiadomości.

    Kiedy to się przyda:

    • Reguła jest włączona, a wiadomości nie ma — dziennik pokaże, czy polecenie doszło do wykonania i dlaczego się nie udało.
    • Chcesz włączyć nową regułę dla wszystkich rekordów — najpierw test na jednym dokumencie z wąskim warunkiem.
    • Poczta nie przyjmuje wiadomości z reguły — po trzech nieudanych próbach wysyłka zostaje wstrzymana.
    • Reguła już narobiła szkód — zatwierdzenie się cofa, zbędne karty kontrahentów trafiają do kosza.

    Od czego zacząć: „Reguły automatyczne” → przycisk „Schemat reguł” w nagłówku.

    Co pomoże sprawdzić regułę

    • „Schemat reguł” — graf wszystkich reguł z ostrzeżeniami o pustym warunku, wyłączonych akcjach i możliwej pętli.
    • „Dziennik operacji” — wiersz dla każdego wykonanego polecenia, „Nie wykonano!” i przyczyna obok.
    • Wstrzymanie wiadomości — po trzech nieudanych próbach z rzędu wiadomość dla rekordu nie jest wysyłana, dopóki nie poprawisz szablonu lub skrzynki.
    • Niebezpieczne miejsca — pętla, masowe uruchomienie przy imporcie, kilka reguł na jednym zdarzeniu.
    • Przerwanie wykonania — co pozostało wykonane i co stanie się przy ponownym zapisie.
    • Usuwanie skutków — cofnięcie zatwierdzenia, zbędni kontrahenci i organizacje.

    Schemat reguł: trzy ostrzeżenia

    W nagłówku okna jest przycisk „Schemat reguł”. Rysuje graf wszystkiego, co skonfigurowano: zdarzenie → reguła z warunkiem → polecenia w kolejności. Schemat służy tylko do podglądu; regułę otwiera się do edycji kliknięciem ołówka w rogu bloku.

    U góry jest filtr „Sekcja” z wartościami „Wszystkie reguły”, „Dokumenty”, „Kontrahenci” i „Firmy” (ostatnia zawsze jest pusta: reguł tej sekcji nie da się utworzyć z interfejsu), pole wyboru „Tylko włączone” i licznik „Reguł: … · włączonych: … · akcji: …”.

    Okno schematu reguł: zdarzenie, reguła z warunkiem i bloki akcji
    1Blok zdarzenia
    2Blok reguły z warunkiem
    3Blok akcji
    1. Blok zdarzenia — od niego zaczyna się każda reguła tego zdarzenia.
    2. Blok reguły — pod nazwą warunek opisany zwykłymi słowami.
    3. Blok akcji — akcje połączone w kolejności wykonania.

    Najważniejsze są w nim trzy ostrzeżenia, które program dodaje sam. To gotowa autokontrola: szybciej niż otwieranie każdej reguły osobno.

    Co oznacza schemat
    Napis na blokuCo oznacza
    „Brak warunku — zadziała przy każdym zdarzeniu”reguła jest włączona, a warunek pusty: polecenia wykonają się dla każdego dokumentu lub kontrahenta bez wyjątku
    „Wszystkie akcje są wyłączone — reguła nic nie robi”reguła jest włączona, ale nie ma w niej ani jednego włączonego polecenia
    „Zmienia ten sam rekord, którego nasłuchuje — możliwa pętla”reguła reaguje na zdarzenie dokumentu i sama zmienia dokument (albo to samo z kontrahentem)

    Widać tam też drobniejsze rzeczy: w bloku reguły warunek jest opisany zwykłymi słowami albo napisem „Bez warunku — przy każdym zdarzeniu”, a w bloku polecenia — nazwa szablonu wiadomości lub „Nie wybrano szablonu wiadomości”, nazwa procesu lub „Nie wybrano procesu”.

    Jeśli na jednym zdarzeniu jest kilka reguł, pod nim widnieje podpis „Reguł dla tego zdarzenia: N” — przypomnienie, że zadziałają wszystkie, jedna po drugiej.

    Gdzie widać, że reguła zadziałała

    Każde wykonane polecenie zostawia wiersz w „Dzienniku operacji” — to okno otwiera się z menu „Panel klienta” → „Dziennik operacji”. Wiersz wygląda tak:

    „Wyzwalacz #7 zamówienie - status - w realizacji Wykonanie polecenia: #8 Wyślij e-mail”

    Czyli: numer reguły, jej nazwa, numer polecenia, nazwa polecenia. Jeśli polecenie się nie udało, na początku dopisywane jest „Nie wykonano!”, a sam wiersz jest oznaczony kolorem jak błąd:

    „Nie wykonano! Wyzwalacz #7 zamówienie - status - w realizacji Wykonanie polecenia: #8 Wyślij e-mail”

    Dziennik operacji przefiltrowany po podtypie Wyzwalacz, z wykonaniami poleceń reguł
    1Podtyp operacji
    2Wiersz uruchomienia wyzwalacza
    1. Podtyp operacji — filtr ustawiony na wyzwalacz, więc na liście są tylko uruchomienia reguł.
    2. Informacja — każdy wiersz podaje regułę i wykonane polecenie.

    Przyczyny niepowodzenia szukaj w sąsiednich wierszach dziennika z tej samej chwili. Dla wiadomości będzie to osobny wpis „Wiadomość nie została wysłana!” z adresem, tematem i treścią błędu serwera pocztowego albo „Nie podano e-maila!”, jeśli odbiorca w szablonie nie jest wypełniony.

    Pusty dziennik oznacza co innego: polecenie w ogóle nie doszło do wykonania. Albo warunek nie został spełniony, albo to polecenie już wcześniej wykonało się dla tego rekordu.

    Wiadomość nie wychodzi trzy razy — wstrzymanie

    Jeśli wiadomości z wyzwalacza nie udało się wysłać dla tego samego rekordu trzy razy, program przestaje próbować: do wiersza „Nie wykonano!” dopisywane jest „Wiadomość nie została wysłana 3 razy z rzędu — wysyłanie dla tego rekordu wstrzymano do czasu zmiany szablonu wiadomości lub skrzynki pocztowej.”. Dzięki temu niedziałająca skrzynka nie zasypuje dziennika setkami identycznych błędów.

    Wstrzymanie znika samo, gdy tylko zapiszesz szablon wiadomości tego polecenia lub dowolną skrzynkę pocztową: następnym razem wiadomość spróbuje wyjść ponownie.

    O takim problemie przypomina też „Mój dzień” na pulpicie — sygnał „Wiadomości z wyzwalaczy nie są wysyłane” z nazwą reguły i ostatnim błędem (widzą go osoby z dostępem do okna wyzwalaczy). Kliknięcie prowadzi tam, gdzie trzeba poprawić: do „Szablony wiadomości”, jeśli błąd jest w szablonie, albo do „Podłączenie poczty”, jeśli coś jest nie tak z serwerem, loginem, hasłem lub adresem nadawcy.

    Niebezpieczne miejsca

    Pętla

    Reguła nasłuchuje „Dokument: aktualizacja” i poleceniem „Zmień dane dokumentu” poprawia ten sam dokument. Nowego zdarzenia z tego nie będzie: każde polecenie, które coś zmienia lub tworzy, oznacza własną zmianę znacznikiem technicznym, a program ją pomija. Dotyczy to też zatwierdzenia — polecenie, które zatwierdza dokument, nie wywołuje zdarzenia „Dokument: zatwierdzenie (podpis)”.

    Jedna droga w kółko jednak zostaje — polecenie „Uruchom proces (Flow)”. Proces działa w tle i zapisuje rekordy jak zwykły użytkownik, więc jego zmiany wywołują zdarzenia w pełni. Właśnie przeciw temu wprowadzono limit „nie częściej niż 3 razy na 10 minut”.

    Dziennik uruchomień tu nie pomaga: blokuje tylko powtórzenie tej samej reguły dla tego samego rekordu, a dwie różne reguły nie są dla niego ze sobą powiązane.

    Masowe uruchomienie przy imporcie

    Zdarzenie powstaje przy każdym zapisanym rekordzie, a nie przy każdym kliknięciu przycisku. Import pliku z zamówieniami, synchronizacja ze stroną, integracja przez API — wszystko to tworzy dokumenty pojedynczo, a reguła wykona się dla każdego. Tysiąc wierszy importu z włączoną regułą „Wyślij e-mail” bez warunku to tysiąc wiadomości wysłanych synchronicznie, bezpośrednio w trakcie importu.

    Zanim pierwszy raz włączysz regułę z poleceniem, które wysyła coś na zewnątrz — wiadomość, SMS, żądanie HTTP — sprawdź ją na jednym rekordzie. Kolejność: zostaw przełącznik „Aktywność” wyłączony, zbuduj możliwie wąski warunek (na przykład numer konkretnego dokumentu), włącz, zapisz ten dokument ręcznie, zajrzyj do „Dziennika operacji”. I dopiero wtedy rozszerzaj warunek. Wysłanej wiadomości nie da się cofnąć.

    Kilka reguł na jednym zdarzeniu

    Zadziałają wszystkie, które spełniają swój warunek — po kolei, według pola „Kolejność wykonania”, a przy równej kolejności — według nazwy. Pierwsza reguła nie może zatrzymać kolejnych: mechanizmu „nie idź dalej” nie ma. Dlatego dwa polecenia „Zmień dane dokumentu” z różnych reguł na to samo zdarzenie po prostu nadpiszą się nawzajem, a wygra to, które wykonało się jako ostatnie.

    Gdy wykonanie przerwało się w połowie

    Polecenia reguły wykonują się po kolei, a każde udane polecenie zapisuje się w dzienniku uruchomień osobno, zaraz po swoim wykonaniu. Wspólnej zasady „wszystko albo nic” dla poleceń nie ma. Dlatego jeśli żądanie przerwało się w środku reguły, stan jest taki:

    • polecenia, które zdążyły się wykonać, pozostają wykonane i mają wpis w dzienniku uruchomień. Wysłanej wiadomości, SMS-a ani żądania HTTP nie da się odwołać;
    • polecenia, do których nie doszła kolejka, nie wykonały się i nie mają wpisu;
    • reguły, które były dalej na liście tego zdarzenia, też się nie wykonały.

    Rekord można zapisać ponownie. Jeśli warunek znów jest spełniony, program przejdzie wszystkie polecenia od nowa: te z wpisem w dzienniku pominie (przy „Okresie sprawdzania” 0 lub dopóki okres nie minął), a te, które nie doszły, wykona. Ponowny zapis nie dubluje tego, co już wysłano.

    Trzy wyjątki, o których warto wiedzieć:

    • jeśli przerwanie nastąpiło między wykonaniem polecenia a wpisem do dziennika, przy powtórzeniu to polecenie wykona się jeszcze raz — na przykład wiadomość wyjdzie po raz drugi;
    • polecenia oznaczone „Nie wykonano!” nie dostają wpisu w dzienniku, więc ponowny zapis spróbuje je wykonać znowu;
    • jeśli warunek opiera się na opcji „Wartość początkowa”, ponowny zapis bez zmiany pola nie spełni warunku — pozostałe polecenia nie zadziałają, dopóki pole znów się nie zmieni.

    Jak usunąć skutki błędnej reguły

    Najpierw wyłącz regułę przełącznikiem „Aktywność” — inaczej będzie dalej działać, gdy sprzątasz. Dalej wszystko zależy od tego, co reguła zdążyła zrobić.

    Zatwierdzone dokumenty i stany

    Dokument zatwierdzony przez regułę cofa się ręcznie lub regułą — wartością 0 w polu zatwierdzenia polecenia „Zmień dane dokumentu”: przyjęcie znika ze stanu magazynu, a to, co rozchodowano i przesunięto, wraca. Co porusza każdy typ dokumentu i kiedy ruchu zwrotnego nie będzie — w sekcji o zatwierdzaniu z reguły.

    Zbędni kontrahenci i organizacje

    Polecenie „Utwórz kontrahenta” nie tworzy duplikatu, jeśli taki kontrahent już istnieje: przed utworzeniem szuka karty z tym samym e-mailem, a jeśli w polach polecenia nie ma e-maila — z tą samą nazwą. Gdy znajdzie, nowej karty nie będzie, a polecenie uznaje się za wykonane. Jeśli e-mail podano, ale jest niepoprawny, karta nie powstaje wcale.

    Zbędne karty usuwa się z listy kontrahentów zwykłym przyciskiem usuwania, a dokumenty na tym nie cierpią:

    • usunięcie przenosi kartę do „Kosz”. Powiązania z dokumentami, cennikami i historia zostają bez zmian, a przycisk „Przywróć” zwraca kartę razem z tym wszystkim;
    • „Usuń na zawsze” w koszu kasuje kartę razem z jej cennikami i ich ustawieniami, historią i rejestracją klienta w sklepie, a produkty zostają odłączone od tego dostawcy. Dokumenty zostają, ale odwołanie do kontrahenta jest w nich zerowane. To samo robi automatyczne czyszczenie: karty leżące w koszu dłużej niż 60 dni są kasowane bez Twojego udziału;
    • organizacja utworzona przez regułę to taki sam rekord listy kontrahentów, widać ją w sekcji „Organizacje” i usuwa się ją tak samo. Zanim usuniesz, sprawdź, czy reguła nie wzięła istniejącej karty: jeśli organizacja o takiej nazwie lub zewnętrznym już była, polecenie „Utwórz organizację” nie zakłada nowej, tylko wstawia do dokumentu istniejącą i zapisuje w niej pola z reguły. Karty kontrahenta ze zdarzenia polecenie nie zmienia;
    • własnej organizacji nie da się usunąć ani do kosza, ani na zawsze — program odmówi.

    Scenariusze

    • Nowa reguła z wiadomością do klientów — przed włączeniem otwórz „Schemat reguł”: napis „Brak warunku — zadziała przy każdym zdarzeniu” oznacza, że wiadomość pójdzie do wszystkich. Dalej — test na jednym dokumencie.
    • Przed Tobą import tysiąca zamówień — reguła bez warunku wykona się dla każdego wiersza bezpośrednio w trakcie importu. Wyłącz reguły, które wysyłają wiadomości, SMS-y lub żądania HTTP, albo zawęź ich warunek.
    • Reguła zmieniła nie te dokumenty — wyłącz ją przełącznikiem „Aktywność”, znajdź dotknięte rekordy w „Dzienniku operacji” po nazwie reguły i popraw pola lub cofnij zatwierdzenie. Jak szukać: gdy formuła zapisała coś nie tak.
    • Dwie reguły zapisują to samo pole — wygrywa ta, która wykonała się ostatnia według „Kolejności wykonania”. Rozdziel je warunkami lub kolejnością (kilka reguł na jednym zdarzeniu).

    Co zrobić, gdy reguła działa nie tak

    Objaw, przyczyna i co zrobić
    Co widziszDlaczego tak jestCo zrobić
    „Nie wykonano! Wyzwalacz #7 zamówienie - status - w realizacji Wykonanie polecenia: #8 Wyślij e-mail” Polecenie wykonało się z błędem. Przyczyna jest w osobnym wierszu dziennika z tej samej chwili Znaleźć sąsiedni wiersz w „Dzienniku operacji” (o dzienniku)
    „Wiadomość nie została wysłana!” Serwer pocztowy odmówił: dalej w wierszu są adres, temat i treść błędu Sprawdzić ustawienia serwera pocztowego i adres odbiorcy w szablonie wiadomości
    „Nie podano e-maila!” W szablonie wiadomości odbiorca jest pusty: makro się nie podstawiło, bo w karcie kontrahenta nie ma e-maila Uzupełnić e-mail w karcie kontrahenta albo wpisać odbiorcę w szablonie wprost
    Reguła utworzona z „Szablony wiadomości” działa przy każdym zdarzeniu Warunku nie ma tam z czego zbudować: stamtąd powstaje bez powiązania z dokumentami ani kontrahentami, a lista pól warunku pochodzi właśnie z niego Wyłączyć regułę i utworzyć ją od nowa z listy dokumentów lub kontrahentów (punkty wejścia)
    Reguła działa dla każdego kolejnego dokumentu Warunek jest pusty. Reguła powstaje włączona, więc działa, zanim ustawisz warunek Otworzyć „Schemat reguł”: taka reguła jest tam oznaczona napisem „Brak warunku — zadziała przy każdym zdarzeniu” (o schemacie)
    Reguła włączona, warunek poprawny, a i tak nic Wszystkie polecenia reguły są wyłączone osobnymi polami wyboru w trzeciej sekcji W „Schemacie reguł” widać to jako napis „Wszystkie akcje są wyłączone — reguła nic nie robi” (o schemacie)
    Zamiast okna — obrazek „brak dostępu” Grupa użytkownika nie ma uprawnienia do okna „Reguły automatyczne” Nadać uprawnienie w ustawieniach grup (o dostępie)
    „Błąd aktualizacji” Zmiana wiersza bezpośrednio w tabeli reguł nie zapisała się Odświeżyć okno pozycją „Odśwież” w menu nagłówka i powtórzyć

    Najczęstsze pytania

    Ile razy zadziałała reguła?

    W interfejsie nie ma licznika. Policz wiersze „Dziennika operacji” przefiltrowane po numerze i nazwie reguły.

    Dlaczego w „Schemacie reguł” sekcja „Firmy” jest pusta?

    Reguł tej sekcji nie da się utworzyć z interfejsu, więc filtr „Firmy” zawsze pokazuje pusty schemat. Reguły dokumentów i kontrahentów widać w ich sekcjach.

    Dlaczego po awarii klient dostał wiadomość dwa razy?

    Awaria nastąpiła między wysłaniem wiadomości a wpisem do dziennika uruchomień. Przy ponownym zapisie program nie wiedział, że wiadomość już wyszła (o przerwaniu).

    Czy można zmienić regułę bezpośrednio na schemacie?

    Nie, schemat służy tylko do podglądu. Ołówek w rogu bloku reguły otwiera jej kartę do edycji.

    Czy na schemacie widać, którego szablonu wiadomości używa polecenie?

    Tak. W bloku polecenia jest nazwa szablonu wiadomości lub „Nie wybrano szablonu wiadomości”, dla procesu — jego nazwa lub „Nie wybrano procesu”.

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Dziennik operacji
    Schemat reguł
    przycisk „Schemat reguł” w nagłówku okna „Reguły automatyczne”
    Uprawnienia
    okno „Reguły automatyczne”; schemat nie ma osobnego uprawnienia

    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