Aby wielokrotnie uruchamiać polecenie lub grupę poleceń w łańcuchu, skonfiguruj iterator.
Uwaga: Aby przekonwertować dane wyjściowe z relacyjnej bazy danych lub zewnętrznej usługi internetowej na tablicę JSON w celu użycia z iteratorem, użyj polecenia CSV to JSON konektora JSON lub transformacji zmiennej JSON.
Skonfiguruj iterator
Za pomocą iteratora możesz powtarzać polecenie lub grupę na podstawie:
- Statyczna lub dynamiczna lista wartości
- Dokładna liczba wartości
- Na podstawie tego, czy warunek istnieje
Iterator może powtarzać polecenie lub grupę:
- Statyczna lista wartości, takich jak regiony lub podmioty
- Dynamiczna lub zmienna lista wartości, na przykład z pliku przesłanego jako zasób obszaru roboczego lub dane wyjściowe z polecenia wcześniejszego 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ę do wielokrotnego uruchamiania i kliknij Edytuj .
- Na karcie Iterations włącz opcję Iterator .
- W polu Wybierz modyfikator typu wybierz opcję Lista.
- Wprowadź wartości iteracji:
- W przypadku listy statycznej wprowadź wartość dla każdej iteracji, naciskając Enter po każdej iteracji.
- W przypadku dynamicznej listy wybierz dane wyjściowe z wcześniejszego polecenia z wartościami, których chcesz użyć.
- W przypadku listy statycznej wprowadź wartość dla każdej iteracji, naciskając Enter po każdej iteracji.
Iterator może powtarzać polecenie lub grupę po dokładnej liczbie wartości, takich jak suma stron wyjściowych z polecenia wcześniejszego 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ą dla liczby iteracji, taką jak Licznik, bez wartości początkowej.
-
Aby ustawić wartość początkową zmiennej po uruchomieniu łańcucha, po poleceniu, które wyświetla liczbę iteracji, dodaj zdarzenie Set dynamic chain variable:
- Wybierz zmienną dynamiczną utworzoną dla liczby iteracji.
- W polu Value wprowadź wartość początkową, np. 1.
Krok 2. Dodaj grupę poleceń
Aby wskazać polecenia do iteracji i regułę iteracji, dodaj grupę poleceń:
- Po zdarzeniu Ustaw dynamiczną zmienną łańcuchową, dodaj Grupę poleceń i przeciągnij link między nimi.
- Wybierz grupę i kliknij Edytuj.
- W zakładce grupy Iteracje włącz Iterator .
- W polu Wybierz modyfikator wpisz, wybierz Powtarzaj do.
- Kliknij + Rule, wybierz typ danych Float i określ, kiedy zatrzymać iteracje. Na przykład, aby iterować w oparciu o wynik Total records wcześniejszego polecenia, ustaw regułę zatrzymującą iteracje, gdy wartość zmiennej jest większa niż (>) wynik Total records.
- Dodaj polecenia iteracji do grupy.
Krok 3. Dodaj zdarzenie zwiększające wartość zmiennej
Aby zwiększać wartość zmiennej przy każdej iteracji:
- W ostatnim kroku grupy dodaj kolejne zdarzenie Set dynamic chain variable:
- Wybierz zmienną dynamiczną utworzoną dla liczby iteracji.
- W sekcji Value wybierz tę samą zmienną.
- Aby przekształcić wartość, kliknij zmienną w Value i dodaj Parse Number przekształcenie.
- Dodaj transformację Dodaj z wartością 1 i kliknij Zaakceptuj.
Jeśli wartości lub dokładna liczba wartości są nieznane, możesz iterować w oparciu o to, czy spełnione są określone warunki. Na przykład, możesz powtarzać polecenie w czasie lub do momentu spełnienia określonych kryteriów.
Krok 1. Skonfiguruj zmienne dla wartości warunkowych
Aby reprezentować warunki, które wskazują wartości do iteracji, utwórz dynamiczne zmienne łańcuchowe. Na przykład, jeśli polecenie udostępnia wyjściowy klucz logiczny wskazujący, czy jego odpowiedź zawiera dodatkowe strony oraz parametr przesunięcia liczby całkowitej 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 wysyłającym wartości warunków dodaj Ustaw dynamiczną zmienną łańcuchową zdarzenie, wybierz zmienne dynamiczne i wprowadź ich wartości początkowe.
Na przykład wprowadź wartość klucza boolean 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 dynamiczną zmienną łańcuchową, dodaj Grupę poleceń i przeciągnij link między nimi.
- Wybierz grupę i kliknij Edytuj.
- W zakładce grupy Iteracje włącz Iterator .
- W polu Wybierz modyfikator wpisz, wybierz Powtarzaj do.
- Kliknij + Rule i określ, kiedy zatrzymać iteracje, np. gdy klucz logiczny ma wartość False.
- Dodaj polecenia iteracji do grupy.
Krok 3. Ustaw wartości zmiennych w każdej iteracji
W ostatnim kroku grupy dodaj kolejne zdarzenie Set dynamic chain variable, aby ustawiać lub zwiększać wartości zmiennych przy każdej iteracji.
- Aby ustawić wartości zmiennych, zmapuj każdą zmienną do odpowiednich wyjść z wcześniejszego polecenia. Na przykład dla zmiennej Boolean wybierz wyjście klucza logicznego; dla zmiennej Offset parametr przesunięcia liczby całkowitej.
- Aby inkrementować zmienną, taką jak Offset, kliknij jej wartość, a następnie zastosuj transformację Parse Number i Add z wartością, która ma być inkrementowana przy każdej iteracji.
Wyjścia iteratora
Możesz użyć wyjścia iteratora jako właściwości dla innych poleceń lub zdarzeń w dalszej części łańcucha. Wyjścia zależą od modyfikatora iteratora -Lista lub Powtarzaj do.
| Dane wyjściowe | Opis |
|---|---|
| Iteracja poleceń lub iteracja grupowa | Wartość zmiennej iteracji przetwarzanej w pętli |
| Indeks | Zerowy licznik wskazujący iterację przetworzoną w pętli |
| Pierwsza iteracja |
Wartość logiczna określająca, czy przetwarzana iteracja jest pierwszą w pętli |
| Ostatnia iteracja | Tylko dla iteratora List wartość logiczna określająca, czy przetwarzana iteracja jest ostatnią w pętli |
| Całkowita liczba iteracji | Tylko dla iteratora List, zliczana jest całkowita liczba iteracji przetworzonych przez pętlę |
Aby użyć wyjścia jako właściwości dla innego polecenia lub zdarzenia, wybierz je odpowiednio na stronie Command Iterator lub Group Iterator.