Nadszedł czas, aby połączyć wszystko w jeden scentralizowany przepływ pracy raportowania, w którym będziemy przetwarzać nowe dane i odświeżać połączenia, które opierają się na tych danych za pomocą jednego łańcucha. W tej połączonej ścieżce szkoleniowej użyjemy zmiennych z naszego arkusza kontrolnego do uruchomienia przepływów pracy, które przygotowują nasze dane, jednocześnie aktualizując arkusz kontrolny o status, zapewniając użytkownikom biznesowym lepszy wgląd w to, kiedy przepływy pracy zostały ostatnio zakończone.
| 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 Zapewnienie użytkownikom końcowym wglądu w ukończenie przepływu pracy |
| Podstawowy cel edukacyjny |
Dowiedz się, jak uruchamiać podobne procesy przy użyciu wartości z arkusza kontrolnego Dodaj rejestrowanie do arkusza kontrolnego za pomocą poleceń łańcuchowych |
| Wymagania wstępne |
Uzupełnij CLP | Używając wartości ze ścieżki arkusza kontrolnego Skonfiguruj następujące złącza: |
| Szablon pomocniczy | CLP | Uruchamianie procesów i rejestrowanie wyników w arkuszu kontrolnym |
Krok 1: Zaktualizuj arkusz kontrolny, aby uwzględnić rejestrowanie
Aby powiadamiać użytkowników końcowych o statusie i ostatniej aktualizacji procesów uruchomionych przez Control Sheet, potrzebujemy miejsca do przechowywania szczegółów dotyczących czasu uruchomienia przepływu pracy i statusu tego przepływu. Zapiszemy te informacje w arkuszu kontrolnym.
- Na platformie Workiva przejdź do arkusza kalkulacyjnego CLP Control Sheet
- Dodaj dwie nowe kolumny po kolumnie FileLocation z następującymi nagłówkami:
- Status
- TimeStamp
- Nie dodawaj żadnych wartości poniżej tych nagłówków kolumn
Krok 2: Edytuj istniejący łańcuch
- Przejdź do Konstruktora łańcuchów i znajdź Łańcuch CLP | Używanie wartości z arkusza kontrolnego
- Kliknij przycisk ołówka, aby edytować łańcuch
- Kliknij Ustawienia łańcucha w prawym górnym rogu
- Zmień nazwę łańcucha: CLP | Uruchamianie procesów i rejestrowanie wyników w arkuszu kontrolnym
- W sekcji Zmienne łańcuchowe kliknij dwukrotnie znak Plus, aby utworzyć dwie zmienne łańcuchowe i skonfigurować je jak poniżej:
- Typ: Zmienny łańcuchowy (cv)
- Nazwa: cv-Status Column Letter
- Wartość: litera kolumny, w której utworzono nagłówek Status
- W podanym przykładzie wartość ta wynosi F
- Typ: Zmienny łańcuchowy (cv)
- Nazwa: cv-Time Stamp Column Letter
- Wartość: litera kolumny, w której utworzono nagłówek Time Stamp
- W podanym przykładzie wartość ta wynosi G
- Typ: Zmienny łańcuchowy (cv)
- Łańcuch powinien mieć teraz cztery zmienne łańcuchowe
- Uratuj łańcuch
Krok 3: Dodaj polecenie z numerami wierszy
Użyjemy polecenia Add Row Numbers, aby automatycznie dodać numery wierszy do arkusza kontrolnego. Pozwoli nam to określić, gdzie logowanie powinno mieć miejsce w arkuszu kontrolnym.
- Kliknij dwukrotnie łącze między poleceniem Get Sheet Data a poleceniem Convert Control Sheet to JSON
- Przerwij połączenie, klikając przycisk Usuń
- Przerwij połączenie, klikając przycisk Usuń
- Dodaj polecenie Add Row Numbers z konektora Tabular Transformation do kanwy Chain
- Połącz polecenie Get Sheet Data z poleceniem Add Row Numbers
- Połącz polecenie Add Row Numbers z poleceniem Convert Control Sheet to JSON
- Kliknij dwukrotnie polecenie Add Row Numbers, aby je skonfigurować
- Kliknij pole Plik wejściowy
- W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Get Sheet Data
- Wybierz wyjście Data z polecenia Get Sheet Data
- Kliknij pole Plik wejściowy
- Zapisz polecenie
- Teraz, gdy dodaliśmy numery wierszy do zbioru danych, musimy zaktualizować kolejne polecenia, aby korzystać z przekształconych danych. W takim przypadku należy zaktualizować polecenie CSV do JSON.
- Kliknij dwukrotnie polecenie Convert Control Sheet to JSON, aby je zaktualizować
- Kliknij pole Input File i usuń Get Sheet Data Output
- W panelu Wybierz zmienną kliknij strzałkę w dół, aby rozwinąć Dodaj numery wierszy
- Wybierz dane wyjściowe Add Row Numbers z polecenia Add Row Numbers
- Kliknij pole Input File i usuń Get Sheet Data Output
- Zapisz polecenie
- Kliknij dwukrotnie polecenie Convert Control Sheet to JSON, aby je zaktualizować
Krok 4: Uruchom proces przesyłania danych do Wdata
Teraz użyjemy zmiennych z naszego arkusza kontrolnego do uruchomienia procesu, który prześle dane do tabeli Wdata. Zrobimy to za pomocą zdarzenia Run Chain, które uruchamia łańcuch Upload Data to Wdata z Uploading Data to a Table Path.
- Teraz, gdy jesteśmy w stanie wizualizować zmienne z arkusza kontrolnego za pomocą Handlebars, nie potrzebujemy już polecenia Handlebars
- Najedź kursorem na polecenie Kierownica i kliknij kosz na śmieci, aby usunąć
- Potwierdź usunięcie polecenia, klikając Delete
- Najedź kursorem na polecenie Kierownica i kliknij kosz na śmieci, aby usunąć
- Dodaj wydarzenie Run Chain do kanwy Chain
- Połącz Active Flag Conditional Command z Run Chain Event
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij polecenie: Run Chain - Upload Data to Wdata
- Kliknij menu rozwijane Chain i wybierz łańcuch CLP | Upload Data to a Table
- Skonfiguruj Runtime Inputs przy użyciu zmiennych z arkusza kontrolnego:
- Kliknij pole Table ID
- 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 TableID dokładnie tak, jak w arkuszu kontrolnym i naciśnij enter
- Kliknij Akceptuj
- Kliknij pole Table ID
-
-
- Kliknij pole File Name
- Wykonaj te same kroki powyżej, aby użyć zmiennej z arkusza kontrolnego, używając pola FileName zamiast TableID
- Kliknij pole File Location
- Wykonaj te same kroki powyżej, aby użyć zmiennej z arkusza kontrolnego, używając pola FileLocation zamiast TableID
- Kliknij pole File Name
-
- Zapisz polecenie
Krok 5: Uruchom proces, aby odświeżyć połączenia
Następnie użyjemy zmiennych z naszego arkusza kontrolnego, aby uruchomić proces, który odświeży dane w naszych arkuszach raportowania, udostępniając nowo przesłane dane użytkownikom końcowym. Zrobimy to za pomocą zdarzenia Run Chain, które uruchamia łańcuch Refresh List of Connections ze ścieżki Refresh List of Connections Path.
- Dodaj wydarzenie Run Chain do kanwy Chain
- Połącz łańcuch uruchamiania - Prześlij dane do łańcucha Wdata ze zdarzeniem łańcucha uruchamiania
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij polecenie: Run Chain - Refresh Connections
- Kliknij menu rozwijane Chain i wybierz łańcuch CLP | Refresh List of Connections
- Skonfiguruj Runtime Inputs przy użyciu zmiennych z arkusza kontrolnego:
- Kliknij pole Spreadsheet ID
- 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 SpreadsheetID dokładnie tak, jak w arkuszu kontrolnym i naciśnij enter
- Kliknij Akceptuj
- Kliknij pole Spreadsheet ID
- Zapisz polecenie
Krok 6: Wypełnij polecenie statusu i znacznika czasu
Dodamy teraz polecenia, które będą używane do generowania i wypełniania wartości, które będą przekazywane z powrotem do arkusza kontrolnego w celu wskazania, że przepływy pracy zakończyły się powodzeniem. Pierwszym krokiem do tego jest utworzenie pliku ze statusem i czasem.
- Dodaj polecenie Create File z konektora File Utilities do kanwy łańcucha
- Połącz łańcuch Run Chain - Refresh Connections Chain Event z poleceniem Create File
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij polecenie: Wypełnij status i znacznik czasu
- W polu Text wpisz następujące informacje:
Przesyłanie i odświeżanie danych zakończone,(*<System.DateTime>*)
-
-
- Zastąp symbol zastępczy (*System.DateTime*) odpowiednią zmienną Runtime Variable, która programowo pobierze datę i godzinę z Chains
- W panelu Select a Variable po lewej stronie rozwiń Runtime
- Wybierz wartość System.DateTime
- Zastąp symbol zastępczy (*System.DateTime*) odpowiednią zmienną Runtime Variable, która programowo pobierze datę i godzinę z Chains
-
- Zapisz polecenie
Krok 7: Napisz z powrotem do arkusza kontrolnego
Teraz użyjemy polecenia Write Sheet Data, aby zapisać informacje wprowadzone w poprzednim poleceniu z powrotem do arkusza kontrolnego. Zapewni to naszym użytkownikom końcowym wgląd w proces, pokazując status ładowania i odświeżania danych oraz datę ich aktualizacji.
- Dodaj polecenie Write Sheet Data ze złącza Workiva Connector do kanwy łańcucha
- Połącz polecenie Populate Status & Time Stamp z poleceniem Write Sheet Data
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Kliknij pole ID arkusza kalkulacyjnego
- W panelu Wybierz zmienną kliknij strzałkę w dół, aby rozwinąć Chain
- Wybierz identyfikator arkusza kalkulacyjnego cv-Control Zmienna łańcuchowa
- Kliknij pole ID/Nazwa arkusza
- W panelu Wybierz zmienną kliknij strzałkę w dół, aby rozwinąć Chain
- Wybierz cv-Control Sheet Name Chain Variable
- Kliknij pole Data File (Plik danych)
- W panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Populate Status & Time Stamp
- Wybierz plik wyjściowy Created File
- Pole Region zostanie wypełnione kombinacją zmiennych łańcuchowych i danych wyjściowych JSON, aby wskazać łańcuchowi konkretną komórkę w arkuszu kontrolnym do zapisu w bieżącej iteracji:
- Kliknij pole Region i wypełnij je poniższymi danymi:
- cv-Status Column Letter - zmienna znajdująca się w panelu Variables w sekcji Chain Variables
- Iteracja pliku JSON - używamy numeru wiersza iteracji plus 1, aby określić region do zapisu danych, dodajemy jeden, aby uwzględnić wiersz nagłówka
- 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 Row Number i naciśnij Enter
- Wybierz inną transformację i wybierz Parse Number
- Kliknij zielony znak +
- Wybierz inną transformację i wybierz Dodaj
- Kliknij zielony znak +
- W polu wartości wpisz 1
- Kliknij Akceptuj
- Wprowadź dwukropek po pierwszej iteracji pliku JSON:
- cv-Time Stamp Column Letter - zmienna znajdująca się w panelu Variables w sekcji Chain Variables
- Iteracja pliku JSON - używamy numeru wiersza iteracji plus 1, aby określić region do zapisu danych, dodajemy jeden, aby uwzględnić wiersz nagłówka
- Wykonaj te same czynności co powyżej dla drugiej iteracji pliku JSON
- Kliknij pole Region i wypełnij je poniższymi danymi:
- Kliknij pole ID arkusza kalkulacyjnego
- Zapisz polecenie
Krok 8: Przetestuj ćwiczenie
Teraz, gdy łańcuch jest gotowy, przetestuj wynik.
- Opublikuj Łańcuch
- Kliknij Execute, a następnie wybierz Run Chain
- Po zakończeniu łańcucha sprawdź, czy przepływ pracy został zakończony, zaznaczając poniższe pole:
Łańcuch został pomyślnie uruchomiony:
Dane zostały pomyślnie przesłane do tabeli szczegółów pracowników CLP:
Połączenia zostały pomyślnie odświeżone w arkuszu kalkulacyjnym przeglądu pracowników CLP:
Rejestrowanie zostało pomyślnie dodane do głównego arkusza kontrolnego:
Gratulacje! Pomyślnie zautomatyzowałeś przepływ pracy, który pobiera dane ze źródła, przesyła je do tabeli i odświeża połączenia korzystające z tych danych. Ten przepływ pracy wykorzystywał wartości z arkusza kontrolnego do określenia źródła danych, miejsca docelowego przesyłania w Workiva i połączeń do odświeżenia. Zastosuj te zasady do własnych procesów, aby zminimalizować wysiłek manualny i zapewnić użytkownikom końcowym wgląd w ukończone procesy.
Podejmij kolejne wyzwanie, dodając rejestrowanie awarii do arkusza kontrolnego, wykonując następną ścieżkę: Rejestrowanie awarii w arkuszu kontrolnym!