Aby wielokrotnie uruchamiać polecenie lub grupę poleceń w łańcuchu, należy skonfigurować iterator.
Uwaga: Aby przekonwertować dane wyjściowe z relacyjnej bazy danych lub zewnętrznej usługi sieciowej na tablicę JSON do użycia z iteratorem, należy użyć polecenia CSV na JSON łącznika JSON lub transformacji zmiennej JSON .
Skonfiguruj iterator
Za pomocą iteratora można powtarzać polecenie lub grupę na podstawie:
- Statyczna lub dynamiczna lista wartości
- Dokładna liczba wartości
- Na podstawie tego, czy istnieje warunek
Iterator może powtarzać polecenie lub grupę:
- Statyczna lista wartości, takich jak regiony lub jednostki
- Dynamiczna lub zmienna lista wartości, np. z pliku przesłanego jako zasób obszaru roboczego lub wynik polecenia wykonanego wcześniej w łańcuchu
Uwaga: Polecenie lub grupa jest ograniczona do 1000 iteracji.
Aby uruchomić iterator na liście wartości:
- W łańcuchu wybierz polecenie lub grupę, które chcesz wielokrotnie uruchomić, i kliknij Edytuj
- Na karcie Iteracje
- W Wybierz typ modyfikatora wybierz opcję Lista.
-
Wprowadź wartości iteracji:
- W przypadku listy statycznej wprowadź wartość dla każdej iteracji, naciskając Enter po każdej.
- W przypadku listy dynamicznej wybierz dane wyjściowe z poprzedniego polecenia z wartościami, które mają zostać użyte.
- W przypadku listy statycznej wprowadź wartość dla każdej iteracji, naciskając Enter po każdej.
Iterator może powtarzać polecenie lub grupę dla określonej liczby wartości, np. sumy stron wyjściowych polecenia wykonanego wcześniej w łańcuchu.
Krok 1. Skonfiguruj zmienną dla wartości liczbowej
Aby wskazać liczbę iteracji, utwórz dynamiczną zmienną łańcuchową:
- W łańcuchu dodaj zmienną dynamiczną określającą liczbę iteracji, taką jak Licznik , bez wartości początkowej.
- Aby ustawić początkową wartość zmiennej podczas działania łańcucha, po poleceniu, które wyprowadza liczbę iteracji, dodaj zdarzenie Ustaw zmienną dynamicznego łańcucha :
- Wybierz zmienną dynamiczną utworzoną dla liczby iteracji.
- W polu Wartość wprowadź jej wartość początkową, np. 1.
Krok 2. Dodaj grupę poleceń
Aby wskazać polecenia do iteracji i regułę iteracji, dodaj grupę poleceń:
- Po zdarzeniu Ustaw zmienną łańcucha dynamicznego dodaj Grupę poleceń i przeciągnij łącze między nimi.
- Wybierz grupę i kliknij Edytuj .
- Na karcie grupy Iteracje
- W Wybierz typ modyfikatora wybierz Powtarzaj do.
- Kliknij + Reguła , wybierz typ danych Float i określ, kiedy zakończyć iteracje. Na przykład, aby wykonać iterację na podstawie wyniku Total records poprzedniego polecenia, należy ustawić regułę, która zatrzyma iteracje, gdy wartość zmiennej będzie większa niż (>) wynik Total records .
- Dodaj polecenia iteracyjne do grupy.
Krok 3. Dodaj zdarzenie, aby zwiększyć wartość zmiennej
Aby zwiększyć wartość zmiennej przy każdej iteracji:
- Jako ostatni krok grupy dodaj kolejne zdarzenie Ustaw zmienną łańcucha dynamicznego :
- Wybierz zmienną dynamiczną utworzoną dla liczby iteracji.
- W polu Wartość wybierz tę samą zmienną.
- Aby przekształcić wartość , kliknij zmienną w Wartość i dodaj przekształcenie Analiza liczby .
- Dodaj transformację Dodaj z wartością 1 i kliknij Akceptuj .
Jeśli wartości lub dokładna liczba wartości nie są znane, można powtórzyć obliczenia, sprawdzając, czy spełnione są określone warunki. Można na przykład powtarzać polecenie tak długo, aż spełnione zostaną określone kryteria.
Krok 1. Skonfiguruj zmienne dla wartości warunkowych
Aby przedstawić warunki wskazujące wartości, które należy iterować, utwórz dynamiczne zmienne łańcuchowe. Na przykład, jeśli polecenie dostarcza wynik w postaci klucza logicznego wskazującego, czy odpowiedź zawiera dodatkowe strony, oraz parametr przesunięcia całkowitego identyfikujący każdą stronę, utwórz zmienne dla tych wartości:
- W łańcuchu dodaj zmienną dynamiczną dla każdego warunku, bez wartości początkowej.
- Aby ustawić początkowe wartości zmiennych podczas działania łańcucha, po poleceniu wyprowadzającym wartości warunków dodaj zdarzenie Ustaw dynamiczną zmienną łańcucha , wybierz zmienne dynamiczne i wprowadź ich wartości początkowe.
Na przykład wprowadź wartość klucza logicznego jako True, a wartość przesunięcia jako 0.
Krok 2. Dodaj grupę poleceń
Aby wskazać polecenia do iteracji i regułę iteracji, dodaj grupę poleceń:
- Po zdarzeniu Ustaw zmienną łańcucha dynamicznego dodaj Grupę poleceń i przeciągnij łącze między nimi.
- Wybierz grupę i kliknij Edytuj .
- Na karcie grupy Iteracje
- W Wybierz typ modyfikatora wybierz „Powtarzaj do:”.
- Kliknij + Reguła i określ, kiedy zatrzymać iteracje, np. gdy klucz logiczny ma wartość Fałsz.
- Dodaj polecenia iteracyjne do grupy.
Krok 3. Ustaw wartości zmiennych przy każdej iteracji
Jako ostatni krok grupy dodaj kolejne zdarzenie Ustaw zmienną łańcucha dynamicznego , aby ustawić lub zwiększyć wartości zmiennych przy każdej iteracji.
- Aby ustawić wartości zmiennych, należy przypisać każdą zmienną do odpowiednich wyników poprzedniego polecenia. Na przykład dla zmiennej Boolean wybierz wyjście klucza logicznego; dla zmiennej Offset wybierz parametr przesunięcia będący liczbą całkowitą.
-
Aby zwiększyć zmienną , taką jak Offset , kliknij jej wartość, a następnie zastosuj transformację Parse Number i transformację Add z wartością, która ma być zwiększana przy każdej iteracji.
Wyjścia iteratora
Dane wyjściowe iteratora można wykorzystać jako właściwość innych poleceń lub zdarzeń w dalszej części łańcucha. Wyniki zależą od modyfikatora iteratora — Lista lub Powtarzaj, aż .
| Dane wyjściowe | Opis |
|---|---|
| Iteracja poleceń lub iteracja grupowa | Wartość zmiennej iteracji przetwarzanej w pętli. |
| Indeks | Liczba zerowa określająca liczbę iteracji przetworzonych w pętli. |
| Pierwsza iteracja | Wartość logiczna określająca, czy przetwarzana iteracja jest pierwszą w pętli. |
| Ostatnia iteracja | Tylko w przypadku iteratora List wartość logiczna określająca, czy przetwarzana iteracja jest ostatnią w pętli. |
| Całkowita liczba iteracji | Tylko w przypadku iteratora List , zliczana od zera liczba wszystkich iteracji przetworzonych przez pętlę. |
Aby użyć wyjścia jako właściwości innego polecenia lub zdarzenia, wybierz je odpowiednio w obszarze Iterator poleceń lub Iterator grup .