Centrum wsparcia Workiva

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

Uwaga: Przed dodaniem łańcucha upewnij się, że Twoja organizacja skonfigurowała połączenia wymagane do włączenia poleceń ze ź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 w równolegle, lub aby łańcuch nie powiódł się, jeśli jedno polecenie z kilku zawiedzie, zgrupuj je razem.

Dodaj polecenie do łańcucha

1. W łańcuchu wybierz polecenie do wykonania:
   • Aby dodać nowe polecenie do łańcucha, na stronie Available Connectorskliknij jego połączenie, a następnie przenieś polecenie w miejsce, w którym powinno się ono znaleźć w łańcuchu.
   • Aby zduplikować istniejące polecenie, zaznacz jego węzeł, kliknij Copy  file_copy , a następnie 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 poprzednim i następnym węzłem w łańcuchu, kliknij i przeciągnij linie między portami 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ę znajdować. Aby przenieść wiele węzłów jednocześnie, przytrzymaj SHIFT podczas ich zaznaczania.

3. Wybierz nowy węzeł i kliknij Edytuj  Utwórz.
4. Wprowadź parametry polecenia:
   • W sekcji Podstawowe informacjewprowadź unikalną nazwę i opis, które pomogą zidentyfikować polecenie i jego przeznaczenie.
   • Przełącz ikonę oka , jeśli chcesz zamaskować wrażliwe dane wyjściowe.
   • Aby uruchomić polecenie wielokrotnie, dla każdego elementu na liście włącz Iterator repeat, i wprowadź wartości iteracji.
   • W sekcji Command Propertieswprowadź dane wejściowe polecenia, w oparciu o złącze.
5. Kliknij Zapisz.

Uruchom tylko pojedyncze polecenie lub grupę

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

1. W narzędziu Chain Builder, w zakładce Chains wybierz z menu łańcucha opcję Execute  flight_takeoff .
2. Aby wybrać polecenie lub grupę do uruchomienia, kliknij Wykonaj to polecenie  play_circle_outline.
3. Kliknij Run Chain.

Pomiń polecenie

Aby opracować logikę rozgałęzień lub w ramach tworzenia łańcucha, może być konieczne pominięcie polecenia w celu wymuszenia określonego wyniku. Możesz także skonfigurować logikę warunkową, aby automatycznie zwracać określony 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 automatycznie zwracać wynik info  check_circle, warning  warning, czy error  error dla polecenia, które zostało pominięte.
3. Aby pominąć polecenie tylko wtedy, gdy spełnione są określone kryteria, określ when. Zbuduj logikę warunkową jako grupę, do której dodajesz reguły i inne grupy reguł, z których każda jest połączona z wartością logiczną AND lub OR.
   • Jeśli wszystkie warunki muszą być spełnione, aby pominąć, wybierz AND.
   • Jeśli tylko jeden warunek musi być spełniony, aby pominąć, wybierz OR.

   Możesz dodawać reguły oparte na różnych typach danych:

   Typ danych	Opis
   Ciąg	Dwa lub więcej znaków
   Liczba całkowita	Dowolna całkowita, niedziesiętna wartość liczbowa
   Data	Dowolny ciąg daty lub zmienna Date
   Pływak	Dowolna wartość liczbowa
   JSON	JavaScript Object Notation; użyj Variable Transformation do analizowania obiektów

   Aby sprawdzić, czy dane spełniają kryteria pominięcia polecenia, sparuj je z operatorem i wartością:

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

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

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

1. W łańcuchu kliknij węzeł polecenia, kliknij Edytuj  utwórzi wybierz Obsługa błędów  ostrzeżenie.
2. W sekcji Czynności związane z błędem  powtórz, wybierz, co należy zrobić, jeśli polecenie nie powiedzie się.
   
   • Aby postępować zgodnie z logiką rozgałęziania łańcucha, wybierz Continue with chain.
   • Aby tymczasowo zatrzymać łańcuch, np. w celu naprawienia problemu, wybierz Wstrzymaj łańcuch. Aby ponownie uruchomić łańcuch po rozwiązaniu problemu, wybierz polecenie w łańcuchu i kliknij Resume.
   • Aby całkowicie zatrzymać łańcuch, wybierz Zakończ łańcuch.
3. Aby zatrzymać polecenie, jeśli trwa ono dłużej niż powinno, w obszarze Timeout conditions  alarmwprowadź maksymalny czas trwania w sekundach.
   
4. Aby ponowić próbę wykonania polecenia, jeśli jego źródło danych jest przerywane lub niedostępne, wprowadź liczbę ponawianych prób i liczbę sekund oczekiwania między próbami.
5. W sekcji Error conditions  priority_highwybierz błędy, które mają być ignorowane, np. podczas tworzenia folderu, który już istnieje.
6. Aby ustawić stan polecenia na podstawie jego danych wyjściowych, kliknij Dodaj w obszarze Interpretacja danych wyjściowychi zdefiniuj regułę lub grupę reguł, aby zinterpretować jego stan.Na przykład za pomocą zmiennej Status w danych wyjściowych Command Details możesz ustawić regułę, która spowoduje wyświetlenie ostrzeżenia, gdy polecenie się powiedzie.
   
7. W sekcji Interpretacja dziennikawybierz, czy polecenie ma być odrzucane na podstawie tego, czy powoduje określone dane wyjściowe.
   • Aby nie nie wykonać polecenia na podstawie określonych danych wyjściowych, wybierz opcję Nie interpretuj.
   • Aby polecenie nie powiodło się w przypadku znalezienia określonych wyjść, wybierz opcję Nie powiodło się, jeśli znaleziono wyjścia i wprowadź wyjścia do wyszukania.
   • Aby polecenie nie powiodło się, gdy określone wyjścia nie zostaną znalezione, wybierz opcję Fail if output(s) not found i wprowadź dane wyjściowe do wyszukania.
   • Wiele wierszy tekstu będzie musiało zostać rozdzielonych za pomocą \n
8. Kliknij Zapisz.

Wyświetl dane wyjściowe polecenia

Na stronie Monitor flight_takeoffmożesz wyświetlić podgląd danych wyjściowych polecenia uruchomionego przez CloudRunner. 

1. W programie Chain Builder, na stronie Monitorotwórz przebieg z danymi wyjściowymi do podglądu i wybierz polecenie.
2. Na karcie Dane wyjściowe kliknij przycisk Podgląd danych wyjściowych widoczność , aby wyświetlić dane wyjściowe.
   

Uwaga: Możesz wyświetlać tylko podgląd wyników poleceń uruchamianych przez CloudRunner, nie GroundRunner.

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żesz usunąć polecenia, jeśli jego rodzic ma wiele rodzeństwa lub gałęzi na tym samym poziomie.