Automatyzacja odświeżania połączeń jest niezbędna do usprawnienia centralizacji danych i przenoszenia ich na platformę Workiva, zwłaszcza gdy istnieje wiele połączeń. W tej połączonej ścieżce edukacyjnej dowiesz się, jak utworzyć łańcuch, który odświeża listę połączeń między Wdata a platformą Workiva przy użyciu identyfikatora arkusza kalkulacyjnego. Ten łańcuch wygeneruje listę połączeń w jednym arkuszu kalkulacyjnym, a następnie dostarczy nam listę identyfikatorów tych połączeń, dzięki czemu będziemy mogli zautomatyzować odświeżanie każdego połączenia w arkuszu kalkulacyjnym.
| Główny biznesowy przypadek użycia | Łączność danych między Workiva i Wdata |
| Podstawowy cel edukacyjny | Dowiedz się, jak odświeżyć listę połączeń za pomocą łańcuchów |
| Dodatkowe cele edukacyjne | Poznaj podstawy iteratorów grupowych |
| Wymagania wstępne |
Uzupełnij CLP | Odśwież połączenia za pomocą parametru Zapewnij uprawnienia do arkusza kalkulacyjnego dla powiązanego użytkownika dotacji OAuth |
| Szablon pomocniczy | CLP | Odśwież listę połączeń |
Krok 1: Utwórz łańcuch
- Dodaj nowy łańcuch
- Nazwij łańcuch: CLP | Odśwież listę połączeń
- Uratuj łańcuch
Krok 2: Dane wejściowe środowiska uruchomieniowego
Do uruchomienia łańcucha używamy polecenia Runtime Inputs. Pozwala nam to określić, dla którego arkusza kalkulacyjnego chcemy odświeżyć wszystkie połączenia.
- Dodaj Runtime Inputs Chain Event z Chain Trigger Events węzła startowego
- Edytuj zdarzenie łańcucha wejść w czasie wykonywania, klikając dwukrotnie polecenie
- Typ: TextField
- Wyświetlana nazwa: ID arkusza kalkulacyjnego
- Wymagane: Zaznaczone
- Zapisz polecenie
Krok 3: Wyświetl listę połączeń
Użyjemy polecenia List Connections, aby pobrać listę identyfikatorów połączeń powiązanych z identyfikatorem arkusza kalkulacyjnego. Wynikiem polecenia List Connections będzie plik JSON składający się z każdego połączenia w arkuszu kalkulacyjnym wraz ze szczegółami dotyczącymi połączenia, w tym identyfikatorem połączenia.
- Dodaj polecenie List Connections z łącznika Workiva Connector do kanwy Chain
- Połącz polecenie Runtime Inputs z poleceniem List Connections
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Typ miejsca docelowego: Arkusz kalkulacyjny
- Destination ID: Użyj zmiennej Spreadsheet ID z Runtime Inputs - pozwala to na przekazanie wartości określonej w czasie wykonywania łańcucha do polecenia Refresh Connections
- Kliknij pole ID miejsca docelowego
- W lewym panelu rozwiń listę rozwijaną Trigger
- Rozwiń listę rozwijaną Runtime Inputs
- Wybierz zmienną Spreadsheet ID
- Zapisz polecenie
Krok 4: Grupa poleceń
Użyjemy grupy poleceń , aby umożliwić iterację nad każdym połączeniem. Iterator grupowy przepchnie każde połączenie w arkuszu kalkulacyjnym przez następujące kroki, jeden po drugim.
- Dodaj grupę poleceń do kanwy Chain
- Połącz polecenie List Connections z sekcją In grupy poleceń
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Nazwij grupę: Connections Iteration
- 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ąć List Connections
- Wybierz wyjście Connections
- Włącz przełącznik Iterations i kliknij pole Iterations
- Zapisz grupę poleceń
Krok 5: Odśwież połączenie
Użyjemy polecenia Refresh Connection, aby odświeżyć nasze połączenia przy użyciu identyfikatora połączenia z iteracji.
- Dodaj polecenie Refresh Connection z łącznika Workiva Connector do kanwy Chain
- Połącz sekcję Start z Iteratora Grupy z poleceniem Refresh Connection
- Kliknij dwukrotnie polecenie, aby je skonfigurować
- Identyfikator połączenia: użyj identyfikatora połączenia z iteratora grupy - Iteracja połączeń. Dzięki temu możemy przekazać identyfikator bieżącej iteracji do polecenia odświeżania połączeń
- Kliknij pole ID połączenia
- W lewym panelu rozwiń listę rozwijaną Group Iterator
- Rozwiń listę rozwijaną Connections Iteration
- Wybierz zmienną ConnectionId
- Użyj poprzednich parametrów źródła: Zaznaczone
- Pozwala nam to odświeżyć połączenie przy użyciu poprzednich wartości parametrów ze źródła - w naszym przypadku zapytanie z parametrem kraju będzie nadal odświeżane z Brazylią jako wartością filtra
- Identyfikator połączenia: użyj identyfikatora połączenia z iteratora grupy - Iteracja połączeń. Dzięki temu możemy przekazać identyfikator bieżącej iteracji do polecenia odświeżania połączeń
Krok 6: Przetestuj ćwiczenie
Teraz, gdy łańcuch jest gotowy, przetestuj wynik
- Opublikuj Łańcuch
- Kliknij Execute, a następnie wybierz Run With Inputs
- Znajdź identyfikator arkusza kalkulacyjnego
- Przejdź do arkusza kalkulacyjnego przeglądu pracowników CLP
- W adresie URL wybierz identyfikator arkusza kalkulacyjnego, który znajduje się po "spreadsheet/" i przed "/sheet".
- Na przykład identyfikator arkusza kalkulacyjnego jest tutaj pogrubiony: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Przejdź z powrotem do Konstruktora łańcuchów i wklej identyfikator arkusza kalkulacyjnego w polu Identyfikator arkusza kalkulacyjnego
- Kliknij przycisk Start
- Po zakończeniu łańcucha przejdź z powrotem do arkusza kalkulacyjnego i zobacz, że oba połączenia zostały pomyślnie odświeżone!
Udany Chain Run z dwoma iteracjami:
Pomyślne odświeżenie połączenia:
Aby dowiedzieć się więcej na temat korzystania z łańcuchów w celu usprawnienia gromadzenia danych, zapoznaj się z pozostałą częścią Ścieżki centralizacji danych!