Zanim automatyzacja zacznie pracować dla Twoich członków, chcesz zobaczyć, jak pracuje dla Ciebie. Przebieg testowy uruchamia ją raz na żądanie. Historia przebiegów pokazuje potem każdy przebieg, prawdziwy lub testowy, krok po kroku, więc widzisz, co się stało i dlaczego przebieg się nie powiódł.
Co naprawdę robi przebieg testowy
Przebieg testowy nie jest symulacją. Uruchamia automatyzację raz, od razu:
- Akcje są naprawdę wykonywane. E-maile zostają wysłane, tagi, grupy i dostęp do kursów się zmieniają, a webhooki i żądania zewnętrzne zostają wysłane. Testuj na własnym koncie lub na członku testowym, a nie na prawdziwym kliencie.
- Używa najnowszej zapisanej wersji, nawet jeśli nie jest jeszcze opublikowana. Prawdziwe zdarzenia nadal używają wersji opublikowanej, dopóki nie opublikujesz nowej.
- Działa także wtedy, gdy automatyzacja jest wyłączona.
- Gdy przepływ dojdzie do kroku Opóźnienie lub Czekaj do daty, przebieg testowy czeka jak prawdziwy przebieg. Pozostałe kroki wykonują się naprawdę po zakończeniu czekania.
- Krok Uruchom przepływ naprawdę uruchamia drugą automatyzację. Ten przebieg pojawia się w historii przebiegów drugiej automatyzacji ze źródłem Automatyczne.
- Każda integracja używana przez przepływ musi być połączona. W przeciwnym razie test zatrzymuje się z komunikatem „Najpierw połącz te integracje:” i nazwami brakujących.
Przebiegi testowe nie liczą się na liście: Ost. przebieg, Przebiegi (7 dni), Sukces (7 dni) i widok Nieudany je pomijają. Nieudany test nie oznacza Twojej automatyzacji jako nieudanej.
Uruchamianie przebiegu testowego z listy
Otwórz menu automatyzacji na liście i wybierz Uruchom test. Okno wyjaśnia: „Uruchamia bieżący szkic raz z pustymi danymi testowymi. Akcje są naprawdę wykonywane.” Ten test startuje bez danych wyzwalacza i bez członka. Nadaje się do szybkiego sprawdzenia. Aby testować z członkiem lub własnymi danymi, uruchom test w edytorze.
Jeśli automatyzacja ma kilka wyzwalaczy, wybierz jeden w Zacznij od wyzwalacza. Potem kliknij Uruchom test. Wynik pojawia się w tym samym oknie:
- Test zakończony, z czasem trwania.
- Test czeka na kroku opóźnienia lub oczekiwania, gdy przepływ wstrzymał się na kroku Opóźnienie lub Czekaj do daty. Reszta nastąpi później.
- Test nieudany, z komunikatem błędu przebiegu.
Uruchom znów uruchamia kolejny test. Jeśli automatyzacja nie ma wyzwalacza, okno pokazuje „Ta automatyzacja nie ma wyzwalacza, od którego można zacząć.”
Uruchamianie przebiegu testowego w edytorze
Kliknij Uruchom test w nagłówku edytora. Okno daje więcej kontroli:
- Jeśli masz niezapisane zmiany, informacja mówi „Niezapisane zmiany zostaną zapisane przed testem.” Test najpierw zapisuje, a potem startuje. Jeśli zapis się nie powiedzie, test nie startuje.
- Przy jednym wyzwalaczu okno go wymienia. Przy kilku wybierz jeden w Blok wyzwalacza.
- Dane (JSON) to dane, które dostarczyłby wyzwalacz. Na początku jest to
{}. Wpisz pola, które odczytują Twoje kroki, na przykład pole sprawdzane przez warunek albo używane przez symbol zastępczy taki jak{{order_id}}:{"order_id": 1042, "amount": 4900}. Dopóki tekst nie jest poprawnym JSON, okno pokazuje „Dane muszą być w poprawnym formacie JSON.” i nie uruchamia testu. - UUID członka (opcjonalnie) to członek, którego dotyczy przebieg. Akcje działające na członku, na przykład dodanie tagu albo przyznanie kursu, potrzebują go. Zostaw puste dla przepływów bez członka, takich jak harmonogram lub webhook. UUID znajdziesz na końcu adresu strony, gdy otworzysz członka w panelu administracyjnym. Nieznany UUID zatrzymuje test komunikatem „Nie znaleziono tego członka w tej firmie.”
Kliknij Uruchom. Okno się zamyka, otwiera się historia przebiegów, a płótno pokazuje nowy przebieg.
Te komunikaty zatrzymują test, zanim wystartuje:
- „Zapisz automatyzację przynajmniej raz, zanim uruchomisz test.”
- „Dodaj wyzwalacz i zapisz, zanim uruchomisz test.”
- „Tego wyzwalacza nie ma jeszcze w zapisanej wersji. Zapisz i spróbuj ponownie.”
- „Najpierw upuść blok wyzwalacza na płótno. Przebiegi testowe zawsze zaczynają się od wyzwalacza.”
Historia przebiegów
Kliknij Historia przebiegów w nagłówku edytora. Przycisk działa, gdy automatyzacja jest zapisana. Panel wymienia 50 najnowszych przebiegów pasujących do Twoich filtrów, od najnowszego, i odświeża się co kilka sekund. Każdy wpis pokazuje status, źródło, wyzwalacz, czas rozpoczęcia przebiegu oraz, po jego zakończeniu, czas trwania. Dla czekającego przebiegu pokazuje też, kiedy zostanie wznowiony.
Status
- W toku: przebieg trwa.
- Czeka: przebieg czeka na kroku Opóźnienie lub Czekaj do daty. Wpis pokazuje Wznowienie z datą i godziną w Twoim czasie lokalnym, kiedy przebieg będzie kontynuowany. Jeśli czeka kilka ścieżek, jest to najwcześniejsza godzina.
- Ukończony: przebieg dotarł do końca.
- Nieudany: krok się nie powiódł albo przebieg osiągnął limit. Otwórz przebieg, aby zobaczyć dlaczego.
- Anulowany: przebieg czekał i został zatrzymany, ponieważ automatyzację wyłączono, zarchiwizowano lub usunięto. Więcej na ten temat niżej.
Źródło
- Automatyczne: coś na Twojej platformie uruchomiło przebieg, na przykład nowy członek lub zamówienie. Przebiegi uruchomione przez krok Uruchom przepływ innej automatyzacji również mają to źródło.
- Harmonogram: przebieg uruchomił zegar platformy. Dotyczy to wyzwalaczy Według harmonogramu (cron), Członek nieaktywny, Wydarzenie wkrótce się zacznie i Zbliża się odnowienie.
- Ręczne: przebieg testowy lub odtworzenie.
- Webhook: przychodzący webhook lub wywołanie z usługi zewnętrznej.
- Inne: każde inne uruchomienie.
Filtry
Nad listą możesz filtrować według statusu (Dowolny status), według źródła (Dowolne źródło) oraz według daty i godziny rozpoczęcia w Od. Nie ma osobnego filtra statusu dla czekających przebiegów: pojawiają się w W toku. Wyczyść resetuje wszystkie filtry i pokazuje, ile z nich jest aktywnych. Gdy nic nie pasuje, panel pokazuje „Żaden przebieg nie pasuje do filtrów.” z linkiem Pokaż wszystkie przebiegi. Przed pierwszym przebiegiem pokazuje „Brak przebiegów. Kliknij „Uruchom test”, aby wywołać pierwszy.”
Oglądanie przebiegu
Kliknij przebieg na liście. Płótno przełącza się na ten przebieg i pokazuje przepływ w postaci z wersji, której przebieg używał. Baner na górze pokazuje, kiedy przebieg wystartował, jego status oraz „Płótno jest tylko do odczytu.” Podczas oglądania przebiegu nie możesz edytować. Zakończ odtwarzanie przywraca Twój bieżący szkic.
Każdy krok, do którego dotarł przebieg, dostaje kolorową obwódkę i małą plakietkę:
- Zielony: Ukończony.
- Czerwony: Nieudany.
- Niebieski: W toku.
- Fioletowy z klepsydrą: Czeka. Krok to Opóźnienie lub Czekaj do daty, a przebieg będzie kontynuowany później.
- Szary: Pominięty. Krok został pominięty, na przykład dlatego, że filtr zatrzymał tę ścieżkę albo przebieg anulowano podczas czekania.
Kroki bez obwódki nie zostały osiągnięte.
Kliknij krok, aby otworzyć go w panelu po prawej. Ustawienia pokazuje jego konfigurację tylko do odczytu. Przebieg pokazuje, co się stało:
- Status, Rozpoczęto i Zakończono. Czekający krok pokazuje Wznowienie z godziną, o której przebieg będzie kontynuowany.
- Dane wejściowe i Dane wyjściowe: dane, które krok otrzymał i przekazał dalej.
- Czerwone pole z błędem, jeśli krok się nie powiódł. Pokaż ślad stosu otwiera szczegóły techniczne, które możesz wysłać do wsparcia.
- Żółta Uwaga na ukończonym kroku oznacza, że krok się wykonał, ale nic nie zmienił, na przykład „The member already has this badge.”
Krok, do którego przebieg nigdy nie dotarł, pokazuje „Przebieg nie dotarł do tego bloku.” Jeśli cały przebieg się nie powiódł, baner pokazuje też na czerwono błąd przebiegu.
Odtwarzanie przebiegu
Odtwórz na banerze uruchamia przebieg ponownie. Po pytaniu Odtworzyć ten przebieg? okno ostrzega: „Uruchamia bieżący szkic ponownie z tymi samymi danymi. Akcje są naprawdę wykonywane.” Odtworzenie używa tych samych danych wyzwalacza i tego samego członka co pierwotny przebieg, ale najnowszej zapisanej wersji Twojego przepływu. To najszybszy sposób na sprawdzenie poprawki: znajdź nieudany przebieg, popraw krok, zapisz, odtwórz.
Odtworzenie to nowy przebieg ze źródłem Ręczne, a płótno od razu się na niego przełącza. Jeśli od pierwotnego przebiegu wyzwalacz został wymieniony, odtworzenie zatrzymuje się z komunikatem „Wyzwalacz tego przebiegu nie istnieje już w bieżącej wersji. Zamiast tego uruchom nowy przebieg testowy.”
Wykrywanie niepowodzeń na liście
Nie musisz otwierać każdej automatyzacji, żeby znaleźć problemy. Lista je pokazuje, wyłącznie na podstawie prawdziwych przebiegów:
- Widok Nieudany obok Twoich folderów wymienia każdą automatyzację, której ostatni przebieg się nie powiódł. Gdy nie ma żadnej, pokazuje Brak nieudanych automatyzacji.
- Kolumna Ost. przebieg pokazuje Nigdy albo czas ostatniego przebiegu z kolorową kropką: zieloną dla ukończonego, niebieską dla trwającego, szarą dla anulowanego. Nieudany ostatni przebieg pojawia się jako czerwona plakietka z podpowiedzią Nieudany przebieg.
- Sukces (7 dni) to udział ukończonych przebiegów wśród zakończonych przebiegów z ostatnich siedmiu dni. Przebiegi w toku się nie liczą. Nieudane i anulowane przebiegi go obniżają. Przebiegi (7 dni) liczy wszystkie przebiegi z ostatnich siedmiu dni i jest domyślnie ukryte.
- Filtr Status przebiegu znajduje automatyzacje według Ukończono, Nieudany, W toku, Anulowano lub Nigdy.
Stąd otwórz automatyzację, otwórz Historia przebiegów, filtruj według Nieudany i kliknij przebieg, aby zobaczyć, który krok się nie powiódł i dlaczego.
Aktywność: kto co zmienił
Aktywność w menu automatyzacji wymienia jej ostatnie 50 zmian, każdą z osobą i czasem: Utworzono, Zapisano, Opublikowane, Wycofano, Włączone, Wyłączone, Zarchiwizowane, Odarchiwizowano, Usunięty, Zduplikowano, Import dla automatyzacji utworzonej z szablonu oraz Zmieniono sekret webhooka. Zmiany wykonane dla kilku automatyzacji naraz pojawiają się w każdej z nich. Przebiegi testowe i odtworzenia nie są częścią aktywności; znajdziesz je w historii przebiegów. Nowa automatyzacja bez zmian pokazuje „Brak aktywności.”
Co dzieje się z czekającymi przebiegami
Przebieg czekający na kroku Opóźnienie lub Czekaj do daty po zakończeniu czekania ponownie sprawdza automatyzację:
- Wyłączona: prawdziwy przebieg, którego czas nadchodzi, gdy automatyzacja jest wyłączona, zostaje anulowany. Jego pozostałe kroki się nie wykonują. Jeśli włączysz automatyzację z powrotem przed końcem czekania, przebieg kontynuuje normalnie. Przebiegi testowe i odtworzenia kontynuują nawet wtedy, gdy automatyzacja jest wyłączona.
- Zarchiwizowana: przebieg zostaje anulowany, łącznie z przebiegami testowymi. Archiwizacja także wyłącza automatyzację.
- Usunięta: przebieg zostaje anulowany.
- Opublikowano nową wersję: przebieg, który już wystartował, kończy się z wersją, z którą wystartował. Tylko przebiegi uruchomione po publikacji używają nowej wersji. To samo dotyczy przywrócenia wersji.
Anulowany przebieg pokazuje w historii przebiegów Anulowany, a jego czekający krok zmienia się na Pominięty. Błąd przebiegu mówi dlaczego: „Automatyzacja została wstrzymana, gdy przebieg czekał.”, albo to samo z archiwizacją lub usunięciem.
Warunki, rozgałęzienia i opóźnienia
Jak długo przechowywane są przebiegi
Historia przebiegów przechowuje przebiegi przez 90 dni. Raz dziennie starsze przebiegi są usuwane razem z danymi wejściowymi i wyjściowymi ich kroków. Przebiegi, które jeszcze czekają, są przechowywane do ich zakończenia.
Typowe błędy i ich znaczenie
Problemy zgłaszane przez edytor
Edytor oznacza kroki z problemami, zanim cokolwiek uruchomisz. Zapisywanie nadal działa, ale automatyzacja może nie zachowywać się zgodnie z oczekiwaniami:
- „Wyzwalacz nie ma wybranego typu zdarzenia.”: wybierz, na co wyzwalacz ma reagować.
- „Wyzwalacz nie powinien mieć połączenia przychodzącego.”: wyzwalacz zawsze rozpoczyna przepływ. Usuń połączenie, które do niego prowadzi.
- „Akcja nie ma wybranego typu.”: wybierz, co ma robić akcja.
- „Akcja wymaga integracji, ale żadna nie jest wybrana.” i „Wymagana integracja nie jest połączona.”: połącz usługę w Integracje i wybierz połączenie w kroku.
- „„Dni nieaktywności” musi wynosić co najmniej 1.”, „„Dni przed odnowieniem” musi wynosić co najmniej 1.” i „„Godziny przed rozpoczęciem” musi wynosić co najmniej 1.”: wyzwalacze Członek nieaktywny, Zbliża się odnowienie i Wydarzenie wkrótce się zacznie nigdy nie startują bez tej liczby. Wpisz liczbę całkowitą równą co najmniej 1.
- „Opóźnienie nie ma czasu trwania.”: wpisz czas trwania większy od zera.
- „W kroku „Uruchom przepływ” nie wybrano przepływu.”: wybierz automatyzację, którą krok ma uruchomić.
- „Brak połączenia przychodzącego. Ten blok jest nieosiągalny.”: połącz krok z przepływem albo go usuń.
- „Schemat nie ma bloku wyzwalacza.”: dodaj wyzwalacz.
- „Odpowiedź na webhook następuje po kroku opóźnienia lub oczekiwania. Wywołujący webhook otrzyma zamiast tego domyślną odpowiedź.”: przenieś odpowiedź przed czekanie.
Błędy w nieudanym przebiegu
Błąd nieudanego przebiegu wymienia krok po jego wewnętrznym ID i typie, na przykład „Krok „n4” (action) nie powiódł się.” lub „Krok „n4” (action) zatrzymał się z błędem.”, a po nim przyczynę. Kliknij czerwony krok na płótnie, aby przeczytać pełny komunikat. Te błędy pojawiają się w domyślnym języku Twojej platformy, także dla przebiegów testowych i odtworzeń. Częste przyczyny:
- „… zatrzymał się z błędem.”: krok napotkał błąd, często usługę zewnętrzną, która odrzuciła żądanie, albo połączenie, które trzeba odnowić.
- „Żądanie zwróciło HTTP …”, „Nie udało się wysłać żądania: …” lub „Adres URL „…” jest nieprawidłowy lub niedozwolony.”: krok Wyślij żądanie zewnętrzne dostał błąd z Twojego serwera, brak odpowiedzi na czas, przekierowanie albo adres, którego nie może wywołać.
- „Nie znaleziono przepływu do uruchomienia.”, „Przepływ do uruchomienia nie ma opublikowanej wersji.” lub „Przepływ do uruchomienia nie ma wyzwalacza.”: automatyzacja uruchamiana przez krok Uruchom przepływ została usunięta, nigdy nie została opublikowana albo nie ma wyzwalacza.
- „Przepływ nie może uruchomić samego siebie.” i „Przepływy są zagnieżdżone zbyt głęboko (maksymalnie 5 poziomów).”: kroki Uruchom przepływ wywołują się nawzajem w kółko albo zbyt głęboko.
- „Przepływ „…” nie powiódł się.”: druga automatyzacja się nie powiodła. Sprawdź jej własną historię przebiegów.
- „Osiągnięto limit 500 kroków.”: przebieg wykonuje maksymalnie 500 kroków za jednym razem. Zwykle wynika to z pętli po długiej liście z kilkoma krokami w środku.
- „Przebieg trwał zbyt długo i został zatrzymany.”: przebieg trwał dłużej, niż pozwala platforma, na przykład dlatego, że usługa zewnętrzna odpowiadała zbyt wolno.
Informacje na ukończonych krokach
Żółta informacja oznacza krok, który się zakończył, ale nie wykonał swojego zadania:
- „No member of this business could be resolved for this run.”: przebieg nie ma członka. Przetestuj ponownie z UUID członka (opcjonalnie) albo sprawdź, czy członek nie został usunięty podczas czekania.
- „The configured course no longer exists.”, albo to samo dla grupy lub odznaki: wybierz nowy element w kroku.
- „The course is not published, so no access was granted.”: najpierw opublikuj kurs.
- „Nie znaleziono daty w „…”. Przepływ działał dalej bez czekania.” lub „Nie udało się odczytać daty „…”. Przepływ działał dalej bez czekania.”: krok Czekaj do daty nie znalazł użytecznej daty i poszedł dalej bez czekania.
- „Przepływ „…” jest wstrzymany. Automatyzacja działała dalej bez niego.”: włącz automatyzację, którą uruchamia krok Uruchom przepływ.
Nie każda akcja zostawia informację. Jeśli krok dotyczący członka pokazuje Ukończony, ale nic się nie zmieniło, sprawdź, czy przebieg miał członka w Dane wejściowe.