Centrum wsparcia Workiva

Polecenia to zadania wykonywane w łańcuchu na podstawie połączenia ze źródłem danych. W przypadku bardziej złożonych łańcuchów może to obejmować polecenia uruchamiane przez różnorodne warunki.

Uwaga: Przed dodaniem łańcucha upewnij się, że Twoja organizacja skonfigurowała połączenia wymagane do włączenia poleceń ze swoimi źródłami danych.

Aby uruchomić określone polecenia szeregowo —jedno po drugim, przy czym każde czeka na zakończenie poprzedniego polecenia — lub jednocześnie równolegle albo aby spowodować awarię łańcucha, jeśli jedno z kilku poleceń się nie powiedzie, zgrupuj je razem .

Dodaj polecenie do łańcucha

1. W łańcuchu wybierz polecenie, które chcesz wykonać:

   • Aby dodać nowe polecenie do łańcucha, w obszarze Dostępne łączniki kliknij jego połączenie, a następnie przenieś polecenie w miejsce, w którym powinno wystąpić w łańcuchu.
   • Aby zduplikować istniejące polecenie, zaznacz jego węzeł, kliknij Kopiuj kopia_pliku i przenieś nowy węzeł w miejsce, w którym powinien się znaleźć w łańcuchu.

   Wskazówka: Aby dodać polecenie jako pierwszy węzeł łańcucha, przenieś je do Start .

2. Aby połączyć polecenie z poprzednimi i następnymi węzłami w łańcuchu, kliknij i przeciągnij linie między portami odpowiednich węzłów.

   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ę znaleźć. Aby przenieść wiele węzłów jednocześnie, przytrzymaj klawisz SHIFT podczas ich zaznaczania.

3. Wybierz nowy węzeł i kliknij Edytuj utwórz .
4. Wprowadź parametry polecenia:
   • W polu Informacje podstawowe wprowadź unikalną nazwę i opis, aby ułatwić identyfikację polecenia i jego przeznaczenia.
   • Przełącz ikonę oka , jeśli chcesz zamaskować dane wrażliwe w wynikach.
   • Aby uruchomić polecenie wielokrotnie dla każdego elementu na liście, włącz opcję Iterator powtórz, i wprowadź wartości iteracji .
   • W obszarze Właściwości polecenia wprowadź dane wejściowe polecenia w oparciu o łącznik .
5. Kliknij Zapisz.

Uruchom tylko jedno polecenie lub grupę

Aby ułatwić testowanie i szybkie iteracje podczas tworzenia łańcuchów, możesz wykonać pojedyncze polecenie lub grupę poleceń w obrębie łańcucha.

1. W Chain Builder , na karcie Chains wybierz Execute flight_takeoff z menu łańcucha.
2. Aby uruchomić polecenie lub grupę, kliknij Wykonaj to polecenie play_circle_outline .
3. Kliknij Uruchom łańcuch .

Pomiń polecenie

Aby opracować logikę rozgałęzień lub w ramach rozwijania łańcucha, może zaistnieć potrzeba pominięcia polecenia w celu wymuszenia określonego wyniku. Można również skonfigurować logikę warunkową, która automatycznie zwróci konkretny wynik na podstawie ustalonych reguł.

1. W łańcuchu wybierz węzeł polecenia, kliknij Edytuj utwórz i wybierz Pomiń skip_next .
2. Wybierz, czy chcesz automatycznie zwrócić wynik info check_circle , warning warning lub error error dla polecenia, gdy zostanie pominięte.

3. Aby pominąć polecenie tylko wtedy, gdy spełnione są określone kryteria, określ kiedy. Zbuduj logikę warunkową jako grupę, do której dodajesz reguły i inne grupy reguł, każdą połączoną operatorem logicznym AND lub OR.

   • Jeśli aby pominąć, wszystkie warunki muszą być spełnione, wybierz AND.
   • Jeżeli do pominięcia wymagany jest tylko jeden warunek, wybierz LUB.

   Możesz dodawać reguły na podstawie różnych typów danych:

   Typ danych	Opis
   Ciąg	Dwa lub więcej znaków
   Liczba całkowita	Dowolna wartość liczbowa całkowita, niebędąca liczbą dziesiętną
   Data	Dowolny ciąg daty lub zmienna daty
   Platforma	Dowolna wartość liczbowa
   JSON	Notacja obiektów JavaScript; użyj Transformacji zmiennych do analizy obiektów

   Aby sprawdzić, czy dane spełniają kryteria pozwalające pominąć polecenie, należy je sparować z operatorem i wartością:

   • Jest puste lub Nie jest puste
   • Zawiera
   • Pasuje do RegExp dla wyrażenia regularnego
   • Zaczyna się na lub Kończy się na
   • = lub !=
   • < lub >
   • <= lub >=
4. Kliknij Zapisz.

Zarządzanie obsługą błędów polecenia

Aby wykryć lub zignorować błędy polecenia:

1. W łańcuchu kliknij węzeł polecenia, kliknij Edytuj utwórz i wybierz Obsługa błędów ostrzeżenie .
2. W obszarze Działania dotyczące błędów powtórz wybierz, co zrobić, jeśli polecenie się nie powiedzie.
   
   • Aby postępować zgodnie z logiką rozgałęzienia łańcucha, wybierz Kontynuuj z łańcuchem .
   • Aby tymczasowo zatrzymać łańcuch, np. w celu rozwiązania problemu, wybierz opcję Wstrzymaj łańcuch . Aby ponownie uruchomić łańcuch po rozwiązaniu problemu, wybierz polecenie w łańcuchu i kliknij Wznów .
   • Aby całkowicie zatrzymać łańcuch, wybierz Wyjdź z łańcucha .
3. Aby zatrzymać polecenie, jeżeli trwa ono dłużej niż powinno, w polu Warunki limitu czasu alarm wprowadź jego maksymalny czas trwania w sekundach.
   
4. Aby ponowić polecenie, jeśli źródło danych jest niestabilne lub niedostępne, wprowadź liczbę ponownych prób i czas oczekiwania między nimi.
5. W obszarze Warunki błędu priorytet_wysoki wybierz błędy, które chcesz zignorować, np. błędy występujące podczas tworzenia folderu, który już istnieje.
6. Aby ustawić status polecenia na podstawie jego danych wyjściowych, kliknij Dodaj w obszarze Interpretacja danych wyjściowych i zdefiniuj regułę lub grupę reguł, aby zinterpretować jej status.Na przykład za pomocą zmiennej Status w wynikach Szczegóły polecenia możesz ustawić regułę, która spowoduje wyświetlenie ostrzeżenia w przypadku pomyślnego wykonania polecenia.
   
7. W obszarze Interpretacja dziennika wybierz, czy polecenie ma zostać odrzucone w zależności od tego, czy spowoduje ono określone wyniki.
   • Aby nie odrzucić polecenia na podstawie określonych wyników, wybierz opcję Nie interpretuj.
   • Aby polecenie nie powiodło się po znalezieniu określonych danych wyjściowych, wybierz opcję Niepowodzenie, jeśli znaleziono dane wyjściowe i wprowadź dane wyjściowe, które mają zostać przeszukane.
   • Aby polecenie nie powiodło się, gdy nie znaleziono określonych wyjść , wybierz opcję Niepowodzenie, jeśli wyjścia nie zostaną znalezione i wprowadź dane wyjściowe, które mają zostać przeszukane.
   • Wiele wierszy tekstu należy oddzielić znakiem \n
8. Kliknij Zapisz.

Wyświetlanie wyników polecenia

Z poziomu Monitor flight_takeoff możesz wyświetlić podgląd wyniku polecenia uruchomionego za pomocą CloudRunner. 

1. W Chain Builder , z Monitor , otwórz przebieg z podglądem wyników i wybierz polecenie.
2. Na karcie Wyjścia kliknij Podgląd wyjścia widoczność , aby wyświetlić dane wyjściowe.
   

Uwaga: Można jedynie wyświetlać podgląd wyników poleceń uruchamianych za pomocą CloudRunnera, a nie GroundRunnera.

Usuń polecenie z łańcucha

Aby usunąć polecenie z łańcucha, kliknij jego węzeł, kliknij Usuń usuń , a następnie kliknij Usuń .

Uwaga: Aby zapewnić logikę łańcucha, nie można usunąć polecenia, jeśli jego element nadrzędny ma wiele elementów pokrewnych lub gałęzi na tym samym poziomie.