Chcesz połączyć się z aplikacją innej firmy poza gotowymi konektorami Premium Workiva? Możesz to osiągnąć wykorzystując HTTP Request Connector Commands do interakcji z interfejsami API REST.
Uwaga: Chociaż jest to oznaczone jako żądanie HTTP, HTTPS (bezpieczny HTTP) jest obsługiwany (i zalecany).
W tej połączonej ścieżce edukacyjnej zaktualizujemy nasz łańcuch, aby korzystał z Runtime Inputs, gdzie możemy określić, który arkusz kalkulacyjny chcemy pobrać.
| Główny biznesowy przypadek użycia | Łączenie się z systemami innych firm |
| Podstawowy cel edukacyjny | Korzystaj z poleceń konektora żądań HTTP Workiva do interakcji z interfejsami API REST dla aplikacji innych firm poza wstępnie zbudowanymi konektorami. Zaktualizuj łańcuchy, aby użyć danych wejściowych środowiska uruchomieniowego w celu określenia, który arkusz kalkulacyjny ma zostać użyty. |
| Drugorzędny cel edukacyjny | Korzystanie z danych wejściowych Runtime |
| Wymagania wstępne |
Skonfiguruj konektor żądań HTTP Wypełnij arkusze kalkulacyjne CLP | HTTP Request List |
| Szablon pomocniczy | CLP | Żądanie HTTP Pobierz pojedynczy arkusz kalkulacyjny |
Krok 1: Skopiuj i zmodyfikuj łańcuch
- Przejdź do Chain Builder i znajdź Chain CLP | HTTP Request List Spreadsheets.
- Kliknij pionową elipsę, aby Kopiuj łańcuch.
- Kliknij ikonę ołówka, aby edytować łańcuch.
- Kliknij Ustawienia łańcucha w prawym górnym rogu i zmień nazwę łańcucha: CLP | HTTP Request Get a Single Spreadsheet.
- (Opcjonalnie) Wprowadź Opis: "Ten łańcuch generuje nowy token dostępu do interfejsu API Workiva. Musisz podać prawidłowy Client ID i Client Secret z wcześniej wygenerowanego API Grant w zmiennych wartościach poniżej. Gdy Łańcuch zostanie uruchomiony, poprosi użytkownika o wprowadzenie identyfikatora arkusza kalkulacyjnego. Łańcuch pobierze arkusz kalkulacyjny".
- Zapisz Łańcuch.
Krok 2: Dane wejściowe środowiska uruchomieniowego
Użyj zdarzenia Runtime Inputs Chain Event, aby uruchomić łańcuch.
Pozwala nam to określić identyfikator arkusza kalkulacyjnego, który chcemy uzyskać. Przeczytaj więcej o danych wejściowych środowiska uruchomieniowego.
- Przenieś polecenie POST - Retrieve a Token poza węzeł startowy.
- Dodaj Runtime Inputs Chain Event z Chain Trigger Events do węzła startowego.
- Kliknij dwukrotnie łącze, które łączy Runtime Inputs z poleceniem Get - List Spreadsheets i usuń łącze.
- Connect Runtime Inputs to the POST - Retrieve a Token Command.
-
Połącz polecenie POST - Retrieve a Token z poleceniem GET - List Spreadsheets.
- Kliknij dwukrotnie pozycję Runtime Inputs Chain Event, aby ją skonfigurować.
- Kliknij Add Input i skonfiguruj następujące pola:
- Typ: Pole tekstowe
- Wyświetlana nazwa: Identyfikator arkusza kalkulacyjnego - sprawdź ten dokument, aby uzyskać pomoc w znalezieniu identyfikatora
- Wymagane: Zaznacz to pole wyboru
- (Opcjonalnie) Wprowadź Opis: "To polecenie pozwala użytkownikowi określić wartości wymaganych danych wejściowych w czasie działania".
- Zapisz polecenie.
Krok 3: Zaktualizuj polecenie Get
Zaktualizujemy polecenie HTTP Request Get, aby uzyskać szczegółowe informacje o pojedynczym arkuszu kalkulacyjnym, zamiast wyświetlać listę wszystkich arkuszy kalkulacyjnych w obszarze roboczym.
- Kliknij dwukrotnie polecenie Get - List of Spreadsheets, aby je skonfigurować.
- Nazwij polecenie: Get - Retrieve a Single Spreadsheet.
-
Użyj zmiennej Spreadsheet ID z Runtime Inputs w polu URL, aby określić, który arkusz kalkulacyjny ma zostać pobrany.
Aby to zrobić, kliknij pole URL i po /spreadsheets dodaj "/<Spreadsheet ID>",
zastępując <Spreadsheet ID> zmienną z Runtime Inputs w następujący sposób:- W lewym panelu rozwiń listę rozwijaną Trigger.
- Rozwiń listę rozwijaną Runtime Inputs.
- Wybierz zmienną Spreadsheet ID.
- (Opcjonalnie) Wprowadź Opis: "To polecenie zwraca pojedynczy arkusz kalkulacyjny. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją dla deweloperów na stronie https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/".
- Zapisz polecenie.
Krok 4: Przetestuj ćwiczenie
Teraz, gdy łańcuch jest gotowy, możemy przetestować wynik.
- Opublikuj the Chain.
- Kliknij Execute, a następnie Run with Inputs.
- Znajdź identyfikator arkusza kalkulacyjnego , przechodząc do arkusza kalkulacyjnego na platformie Workiva. Upewnij się, że użytkownik grantu ma uprawnienia do tego arkusza kalkulacyjnego.
- Kliknij Start.
- Po zakończeniu działania łańcucha możesz zobaczyć, że szczegóły arkusza kalkulacyjnego zostały wygenerowane w zakładce Outputs - Response Body polecenia Get.
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->