Centrum wsparcia Workiva

Chcesz połączyć się z aplikacją innej firmy poza wbudowanymi złączami Premium firmy Workiva? Można to osiągnąć, wykorzystując polecenia łącznika żądań HTTP do interakcji z interfejsami API REST. 

Uwaga: Mimo że jest to oznaczone jako żądanie HTTP, protokół HTTPS (bezpieczny HTTP) jest obsługiwany (i zalecany).

W tej połączonej ścieżce edukacyjnej zaktualizujemy nasz Łańcuch, aby wykorzystać Dane wejściowe środowiska wykonawczego, gdzie możemy określić, który arkusz kalkulacyjny chcemy pobrać.

Krok 1: Kopiowanie i modyfikowanie łańcucha

1. Przejdź do Chain Builder i znajdź Chain CLP | Arkusze listy żądań HTTP .
2. Kliknij pionową elipsę, aby skopiować łańcuch.
3. Kliknij ikonę ołówka, aby edytować łańcuch.
4. Kliknij Ustawienia łańcucha w prawym górnym rogu i zmień nazwę łańcucha na: CLP | Żądanie HTTP Pobierz pojedynczy arkusz kalkulacyjny .
5. ( Opcjonalnie ) Wprowadź opis : „Ten łańcuch generuje nowy token dostępu API Workiva. W poniższych wartościach zmiennych należy podać prawidłowy identyfikator klienta i tajny klucz klienta z wcześniej wygenerowanego zezwolenia API. Po wykonaniu Łańcucha użytkownik zostanie poproszony o podanie identyfikatora Arkusza kalkulacyjnego. Łańcuch pobierze arkusz kalkulacyjny.
6. Ratujmy Łańcuch.

Krok 2: Dane wejściowe środowiska wykonawczego

Użyj zdarzenia łańcucha danych wejściowych środowiska wykonawczego , aby uruchomić łańcuch.
Pozwala nam to określić identyfikator arkusza kalkulacyjnego, który chcemy uzyskać. Dowiedz się więcej o danych wejściowych środowiska wykonawczego.

1. Przenieś polecenie POST - Pobierz token z węzła startowego.
2. Dodaj zdarzenie łańcucha danych wejściowych środowiska wykonawczego z zdarzeń wyzwalacza łańcucha do węzła początkowego.
3. Kliknij dwukrotnie łącze łączące dane wejściowe środowiska wykonawczego z poleceniem Pobierz - Wyświetl arkusze kalkulacyjne i usuń łącze.
4. Podłącz dane wejściowe środowiska wykonawczego do polecenia POST - pobierz token .

5. Połącz polecenie POST - Pobierz token z poleceniem GET - Wyświetl listę arkuszy kalkulacyjnych .

   

6. Kliknij dwukrotnie Runtime Inputs Chain Event, aby je skonfigurować.
7. Kliknij Dodaj dane wejściowe i skonfiguruj następujące pola:
   • Typ: Pole tekstowe
   • Nazwa wyświetlana: Identyfikator arkusza kalkulacyjnego — zapoznaj się z tym dokumentem , aby uzyskać pomoc w znalezieniu identyfikatora
   • Wymagane: Zaznacz to pole wyboru
8. ( Opcjonalnie ) Wprowadź opis : „To polecenie umożliwia użytkownikowi określenie wartości wymaganych danych wejściowych środowiska wykonawczego”.
9. 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.

1. Kliknij dwukrotnie polecenie Pobierz - Lista arkuszy kalkulacyjnych , aby je skonfigurować.
   1. Nazwij polecenie: Get - Pobierz pojedynczy arkusz kalkulacyjny .

   2. Użyj zmiennej Identyfikator arkusza kalkulacyjnego z Danych wejściowych środowiska wykonawczego w polu Adres URL, aby określić, który arkusz kalkulacyjny ma zostać pobrany.
      Aby to zrobić, kliknij pole adresu URL i po /spreadsheets dodaj "/ < ID arkusza kalkulacyjnego > ", zastępując
      <Spreadsheet ID> ze zmienną z danych wejściowych środowiska wykonawczego w następujący sposób:

      

      1. W lewym panelu rozwiń menu rozwijane Wyzwalacz.
      2. Rozwiń listę rozwijaną Dane wejściowe środowiska wykonawczego .
      3. Wybierz zmienną Identyfikator arkusza kalkulacyjnego .

2. ( Opcjonalnie ) Wprowadź opis : „To polecenie zwraca pojedynczy arkusz kalkulacyjny. Więcej informacji znajdziesz w dokumentacji dla deweloperów pod adresem https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html"
3. Zapisz polecenie.

Krok 4: Przetestuj ćwiczenie

Teraz, gdy Łańcuch jest gotowy, możemy przetestować wynik.

1. Opublikuj Łańcuch.
2. Kliknij Wykonaj , a następnie Uruchom z danymi wejściowymi .
3. Znajdź Identyfikator arkusza kalkulacyjnegoprzechodząc do Arkusza kalkulacyjnego na platformie Workiva. Upewnij się, że użytkownik, któremu udzielono grantu, ma uprawnienia do tego arkusza kalkulacyjnego.
4. Kliknij Start .
5. Po zakończeniu działania Łańcucha możesz zobaczyć, że szczegóły arkusza kalkulacyjnego zostały wygenerowane na karcie Wyjścia – Treść odpowiedzi polecenia Get .