Zdarzenie Assert jest narzędziem do debugowania, podobnym do zdarzenia Conditional, które testuje logikę twojego łańcucha i sprawdza, czy działa zgodnie z przeznaczeniem. Na najbardziej podstawowym poziomie rozgałęzienie łańcucha będzie kontynuowane nieprzerwanie, gdy asercja przejdzie pomyślnie i zatrzyma się, gdy asercja nie powiedzie się - ale istnieje wiele warunków, które wpływają na tę regułę. Możesz znaleźć listę typowych przypadków użycia na dole tego artykułu.
Krok 1: Dodaj zdarzenie do łańcucha
- W narzędziu Chain Builder, na karcie Chains kliknij przycisk Edit for the chain.
- Kliknij Łańcuch zdarzeń i przesuń Assert do miejsca, w którym zdarzenie powinno wystąpić w łańcuchu.
- Przeciągnij łącze do zdarzenia z poprzedniego węzła w łańcuchu.
Uwaga: Aby zmienić pozycję węzła w łańcuchu, odłącz go od innych węzłów, a następnie przenieś w miejsce, w którym powinien się znajdować. Aby przenieść wiele węzłów jednocześnie, przytrzymaj SHIFT podczas ich zaznaczania.
- Wybierz węzeł zdarzenia i kliknij Edytuj.
- W sekcji Podstawowe informacje wprowadź unikalną nazwę i opis, które pomogą zidentyfikować zdarzenie.
Uwaga: Włącz Stop Chain on Fail, jeśli cały łańcuch powinien zostać zatrzymany, gdy to potwierdzenie nie powiedzie się. Jeśli nie zostanie zaznaczone, inne gałęzie łańcucha będą działać do końca, nawet jeśli ta konkretna się nie powiedzie.
Krok 2: Skonfiguruj logikę warunkową
Na stronie Conditions zbuduj logikę warunkową jako reguły lub grupy reguł, aby przetestować wyjścia i zmienne różnych typów danych:
- String, dla jednego lub więcej znaków
- Integer, dla dowolnej całkowitej, nieprzecinkowej wartości liczbowej
- Date, dla ciągu lub zmiennej daty
- Float, dla dowolnej wartości liczbowej
- JSON, dla Javascript Object Notation
Uwaga: Dla JSON, użyj zmiennej transformacji do analizowania wartości.
- Wybierz, czy chcesz dodać regułę czy grupę reguł.
- Jeśli dołączasz wiele reguł lub grup, połącz je za pomocą wartości logicznej AND lub LUB:
- Jeśli wszystkie reguły lub grupy muszą być prawdziwe, aby warunek został spełniony, wybierz AND.
- Jeśli dowolna reguła lub grupa musi być prawdziwa, aby warunek został spełniony, wybierz LUB.
- Dla każdej reguły wybierz typ danych i wyjście lub zmienną do przetestowania, a następnie ustaw kryteria, aby spełnić warunek:
- Aby sprawdzić, czy wartość jest pusta, wybierz Is blank lub Is not blank.
- Aby sprawdzić, czy wartość zawiera określone znaki lub inną wartość wyjściową lub zmienną, wybierz opcję Contains, a następnie wprowadź lub wybierz wartość do dopasowania.
- Aby sprawdzić, czy wartość jest zgodna z wyrażeniem regularnym, wybierz opcję Matches RegExp i wprowadź wyrażenie do dopasowania.
- Aby sprawdzić, czy wartość zaczyna się lub kończy określonymi znakami lub inną wartością wyjściową lub zmienną, wybierz opcję Start with lub Ends with, a następnie wprowadź lub wybierz wartość do dopasowania.
- Aby sprawdzić, czy wartość liczbowa jest równa kwocie, wybierz = lub !=, a następnie wprowadź lub wybierz kwotę.
- Aby sprawdzić, czy wartość liczbowa jest większa lub mniejsza od kwoty, wybierz < lub >, a następnie wprowadź lub wybierz kwotę.
- Aby sprawdzić, czy wartość liczbowa jest większa, mniejsza lub równa kwocie, wybierz <= lub >=, a następnie wprowadź lub wybierz kwotę.
- Po skonfigurowaniu logiki warunkowej kliknij Zapisz.
Uwaga: Aby usunąć regułę z logiki warunkowej, kliknij Usuń .
Warunki i typowe przypadki użycia
Zdarzenie Assert może zostać dodane do wielu ścieżek lub "gałęzi" łańcucha. Każda asercja działa niezależnie, co oznacza, że nieudana asercja zatrzyma tylko konkretną gałąź, w której została umieszczona - wszystkie inne gałęzie będą nadal działać do końca. Jeśli jednak jakakolwiek pojedyncza asercja nie powiedzie się, cały łańcuch zostanie oznaczony jako "Nieudany".
Warto wiedzieć:
- Włącz opcję Stop chain on fail, aby natychmiast zatrzymać cały łańcuch w przypadku niepowodzenia asercji.
- Możesz zastąpić awarię łańcucha, dodając zdarzenie Set Chain Result. Gdy węzeł Set Chain Result jest ustawiony na "Succeed", łańcuch zawsze przejdzie pomyślnie, niezależnie od nieudanych asercji.
Warunek |
Wynik |
Wyjaśnienie |
|---|---|---|
| Twierdzenie przechodzi | Bieg jest kontynuowany; Łańcuch się powiódł | Łańcuch działa bez przerwy. |
|
Twierdzenie nie powiodło się (pojedyncze stwierdzenie) |
Uruchamianie nie powiodło się; Łańcuch nie działa |
Gdy pojedyncza asercja jest umieszczona na ścieżce łańcucha, przebieg łańcucha zatrzymuje się, gdy asercja nie powiedzie się. Przykład: (Kliknij, aby powiększyć) Uwaga: Zdarzenie assert może być używane jako "strażnik", który zatrzymuje łańcuch przed punktami krytycznymi, jeśli warunek nie jest spełniony. Gdy zdarzenie Assert jest zależne od kolejnych węzłów, cały łańcuch zostanie zatrzymany. |
|
Twierdzenie nie powiodło się (z włączoną funkcją "Stop Chain on Fail") |
Uruchamianie nie powiodło się; Łańcuch nie działa; Łańcuch zatrzymuje się natychmiast |
Gdy opcja "Stop Chain on Fail" jest włączona, a asercja nie powiedzie się, wszystkie inne gałęzie są natychmiast zatrzymywane. Przykład: (Kliknij, aby powiększyć) |
|
Twierdzenie nie powiodło się (wiele rozgałęzień/ asercji) |
Łańcuch zatrzymuje się na nieudanej gałęzi, ale kontynuuje dla wszystkich innych gałęzi, dopóki nie zostanie spełniony warunek Guard/Stop; Łańcuch kończy się niepowodzeniem |
Zdarzenie Assert może być umieszczone na wielu ścieżkach lub "gałęziach" w tym samym łańcuchu. Nieudana asercja zatrzyma tę konkretną gałąź, ale wszystkie inne gałęzie będą nadal działać. Pozwala to na testowanie wielu warunków w tym samym łańcuchu. Przykład: (Kliknij, aby powiększyć) |
Zdarzenie assert vs. Zdarzenie warunkowe
Zdarzenie Conditional, w połączeniu ze zdarzeniem Set Chain Result, może być użyte do osiągnięcia podobnych rezultatów - ale wymaganych jest wiele węzłów i ścieżek rozgałęzień w porównaniu do zdarzenia Assert. Zdarzenie Assert ma na celu uproszczenie i zastąpienie tego bardziej złożonego procesu.
Aby to zademonstrować, oto przykład typowej logiki wymaganej do odtworzenia gałęzi "Pass" i "Fail" za pomocą zdarzenia warunkowego:
A oto ta sama logika przy użyciu pojedynczego zdarzenia Assert:
Uwaga: W przypadku użycia w tym samym łańcuchu, zdarzenie Set Chain Result zawsze zastąpi wyniki zdarzenia Assert. Na przykład łańcuch z węzłem Set Chain Result, który jest ustawiony na "Succeed", zawsze przejdzie pomyślnie, niezależnie od zdarzenia Assert.