Wykorzystanie wartości z arkusza kontrolnego w przepływach pracy Chain wymaga systematycznego odczytywania i stosowania tych wartości w poleceniach. W tej połączonej ścieżce edukacyjnej zbadamy, jak odczytywać i wykorzystywać wartości z arkusza kontrolnego oraz wykorzystywać grupę poleceń do wydajnego iterowania po wielu wierszach.
| Główny biznesowy przypadek użycia |
Orkiestracja przepływów pracy raportowania ze scentralizowanej lokalizacji Uproszczenie zarządzania przepływem pracy dla użytkowników końcowych |
| Podstawowy cel edukacyjny | Dowiedz się, jak używać wartości z arkusza kontrolnego w łańcuchu |
| Dodatkowe cele edukacyjne |
Dowiedz się, jak korzystać z poleceń warunkowych, iteratorów JSON i konektora Handlebars |
| Wymagania wstępne |
Ukończ CLP | Tworzenie i odczytywanie arkusza kontrolnego Skonfiguruj następujące złącza: - JSON |
| Szablon pomocniczy | CLP | Używanie wartości z arkusza kontrolnego |
Krok 1: Edytuj istniejący łańcuch
- Przejdź do aplikacji Chain Builder i znajdź Łańcuch CLP | Odczyt z karty kontrolnej
- Kliknij przycisk ołówka, aby edytować łańcuch
- Kliknij Ustawienia łańcucha w prawym górnym rogu
- Zmień nazwę łańcucha: CLP | Używanie wartości z arkusza kontrolnego
- Uratuj łańcuch
Krok 2: Przekonwertuj arkusz kontrolny na JSON
Aby efektywnie wykorzystać wartości w arkuszu kontrolnym, przekonwertujemy dane wyjściowe polecenia Get Sheet Data z formatu CSV na JSON. Ta konwersja tworzy pary klucz-wartość pomiędzy nagłówkami w arkuszu kontrolnym i odpowiadającymi im wartościami w wierszach poniżej każdego nagłówka, umożliwiając wydajną iterację.
- Dodaj polecenie CSV do JSON z konektora JSON do kanwy łańcucha
- Połącz polecenie Get Sheet Data z poleceniem CSV to JSON
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij polecenie: Convert Control Sheet to JSON
- Kliknij pole Input File
- W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Get Sheet Data
- Wybierz wyjście Data
- Pozostaw pole separatora jako Przecinek (,)
- Zapisz polecenie
Krok 3: Dodaj grupę poleceń
Dodaj grupę poleceń Command Group do łańcucha, aby umożliwić iterację nad każdym wierszem w arkuszu kontrolnym. Dzięki temu możemy przesuwać każdy wiersz arkusza kontrolnego przez serię poleceń dla grupy.
- Dodaj grupę poleceń do kanwy Chain
- Połącz polecenie Convert Control Sheet to JSON z sekcją In w grupie poleceń
- Kliknij dwukrotnie grupę poleceń, aby ją skonfigurować
- Nazwij grupę: Control Sheet Iterator
- Przejdź do zakładki Iteratory
- Włącz przełącznik Iterations i kliknij pole Iterations
- W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Convert Control Sheet to JSON
- Wybierz dane wyjściowe JSON
- Włącz przełącznik Iterations i kliknij pole Iterations
- Zapisz polecenie
Teraz, gdy polecenie zostało skonfigurowane, będzie ono iterować przez każdy wiersz arkusza kontrolnego i dostarczać dane wyjściowe dla każdego wiersza.
Krok 4: Dodaj polecenie warunkowe
W arkuszu kontrolnym użytkownicy mogą określić, czy chcą, aby określony wiersz był wykonywany w ramach przepływu pracy. Jest to wykorzystywane przez kolumnę ActiveFlag. Użyjemy polecenia warunkowego, aby określić, czy przepływ pracy musi być kontynuowany dla każdego wiersza w arkuszu kontrolnym.
- Dodaj zdarzenie łańcuchowe Polecenie warunkowe do kanwy Łańcuch
- Połącz grupę Start w ramach grupy Control Sheet Iterator z poleceniem Conditional
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij polecenie: Aktywna flaga?
- Pozostaw warunek jako AND i kliknij przycisk + RULE
- Upewnij się, że typ danych jest ustawiony na String i zmień testowaną operację z Is Blank na =
- Kliknij w otwarte pole po lewej stronie polecenia (wartość do przetestowania)
- W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Group Iterator
- Wybierz <> Iteracja pliku JSON
- Kliknij zieloną ikonę Iteracja pliku JSON, aby przekształcić zmienną
- Kliknij Wybierz transformację i wybierz Pobierz wartość z JSON
- Naciśnij zielony znak +
- W polu wartości wpisz nagłówek ActiveFlag dokładnie tak, jak znajduje się on w arkuszu kontrolnym i naciśnij Enter
- Wybierz inną transformację i wybierz Małe litery
- Naciśnij zielony znak +
- Kliknij Akceptuj
-
- Wróć do polecenia Conditional, po prawej stronie (wartość do porównania) wpisz słowo true
- Upewnij się, że są to małe litery, ponieważ zastosowana wcześniej transformacja zmiennej powoduje, że wartość Active Flag jest pisana małymi literami.
- Wróć do polecenia Conditional, po prawej stronie (wartość do porównania) wpisz słowo true
- Zapisz polecenie
Krok 5: Prześlij dane wyjściowe do polecenia
W tym momencie iterator arkusza kontrolnego jest skonfigurowany tak, aby dostarczał wartości do każdego polecenia istniejącego w polu Group Start grupy poleceń. Wykorzystamy polecenie Handlebars jako symbol zastępczy do wyświetlania pobranych wartości, który może być również używany iteracyjnie w dalszych poleceniach.
- Dodaj polecenie Render Text Template z łącznika Handlebars do kanwy Chain
- Podłączyć aktywną flagę ? Polecenie do szablonu tekstowego renderowania Polecenie
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij polecenie: Capture Control Sheet Values
- W polu Template wpisz następujące informacje:
- Górny rząd: Informacje o karcie kontrolnej
- Drugi wiersz: Nazwa pliku: <Iteracja pliku JSON>
- Zastąp
<JSON File Iteration>w panelu Select a Variable, kliknij strzałkę w dół, aby rozwinąć Group Iterator - Wybierz <> Iteracja pliku JSON
- Zastąp
-
-
-
- Kliknij zieloną ikonę Iteracja pliku JSON, aby przekształcić zmienną
- Kliknij Wybierz transformację i wybierz Pobierz wartość z JSON
- Naciśnij zielony znak +
- W polu wartości wpisz FileName dokładnie tak, jak w arkuszu kontrolnym i naciśnij enter
- Kliknij Akceptuj
- Kliknij Wybierz transformację i wybierz Pobierz wartość z JSON
- Kliknij zieloną ikonę Iteracja pliku JSON, aby przekształcić zmienną
-
-
-
- Powtórz kroki dla trzeciego, czwartego i piątego rzędu
- Zastąp symbol zastępczy
<JSON File Iteration>zmienną z arkusza kontrolnego.- Identyfikator tabeli: <Iteracja pliku JSON>
- Wykonaj te same kroki, co poprzednio, ale użyj TableID zamiast FileName.
- Identyfikator arkusza kalkulacyjnego: <Iteracja pliku JSON>
- Wykonaj te same kroki, co poprzednio, ale użyj SpreadsheetID zamiast FileName.
- Lokalizacja pliku: <Iteracja pliku JSON>
- Wykonaj te same kroki, co poprzednio, ale użyj FileLocation zamiast FileName.
- Identyfikator tabeli: <Iteracja pliku JSON>
- Zastąp symbol zastępczy
- Powtórz kroki dla trzeciego, czwartego i piątego rzędu
- Zapisz polecenie
Uwaga: Wykonaj opisane kroki, aby wyodrębnić dowolny nagłówek i pobrać odpowiednie wartości wierszy z arkusza kontrolnego.
Krok 6: Przetestuj ćwiczenie
Teraz, gdy łańcuch jest gotowy, przetestuj wynik.
- Opublikuj Łańcuch
- Kliknij Execute, a następnie wybierz Run Chain
- Po zakończeniu tworzenia łańcucha kliknij polecenie Capture Control Sheet Values , aby zweryfikować powodzenie
- Poczekaj, aż łańcuch zostanie w pełni ukończony przed kliknięciem polecenia
- Pojawi się pole o treści Wartość 1
- Jeśli klikniesz to pole, okaże się, że polecenie przetworzyło trzy różne wartości, które są trzema wierszami danych z arkusza kontrolnego
- Kliknij pole Log dla każdej indywidualnej wartości i sprawdź, czy jest ona zgodna z wartościami w arkuszu kontrolnym
Wartość 1:
Wartość 2:
Wartość 3:
Dowiedz się więcej o korzystaniu z arkuszy kontrolnych, wykonując następną ścieżkę: Uruchamianie procesów i rejestrowanie wyników w arkuszu kontrolnym!