|
Klasyczne typy plików nie są już dostępne od stycznia 2021 r. Możesz przenieść swoje klasyczne pliki lub pobrać plik PDF. Dowiedz się więcej

Centrum wsparcia Workiva

CLP - Arkusze kalkulacyjne listy żądań HTTP

CLP - Arkusze kalkulacyjne listy żądań HTTP

  • Ostatnia aktualizacja

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. W tej połączonej ścieżce edukacyjnej zaktualizujemy nasz Łańcuch, aby wykorzystać Token Nośnika w Poleceniu, które używa punktu końcowego listy Arkuszy kalkulacyjnych, aby zapewnić nam listę Arkuszy kalkulacyjnych w Obszarze roboczym.

Uwaga: Mimo że jest to oznaczone jako żądanie HTTP, protokół HTTPS (bezpieczny HTTP) jest obsługiwany (i zalecany).
Podstawowy przypadek użycia biznesowego Łączenie się z systemami innych firm
Główny cel edukacyjny Poznaj podstawowe koncepcje łańcuchów, korzystając z łącznika żądań HTTP
Wymagania wstępne Skonfiguruj API Workiva Grant
Skonfiguruj łącznik żądania HTTP
CLP - żądanie HTTP Wygeneruj token
Szablon pomocniczy CLP - Arkusze kalkulacyjne listy żądań HTTP

 

Krok 1: Utwórz zmienne obszaru roboczego

Aby móc korzystać ze szczegółów interfejsu API Workiva w wielu łańcuchach i poleceniach, utworzymy zmienne obszaru roboczego służące do przechowywania tych informacji. Utworzymy nową zmienną obszaru roboczego dla adresu URL interfejsu API platformy.

  1. W narzędziu Chain Builder przejdź do Ustawień obszaru roboczego .
  2. W obszarze Zmienne obszaru roboczego kliknij znak plus, aby utworzyć nową zmienną obszaru roboczego.

  3. Skonfiguruj zmienne, korzystając z następujących informacji:

    • Nazwa: wsv-BaseURL-Platform
    • Wartość: Użyj odpowiedniej wartości w zależności od regionu. Możesz zweryfikować region, sprawdzając adres URL. Jeśli adres URL zawiera EU lub APAC , użyj odpowiedniego adresu URL. W przeciwnym wypadku użyj wartości amerykańskiej.
    Uwaga: w regionie USA dostępna jest tylko aplikacja.
    Pole Wartość amerykańska
    Podstawowy adres URL IAM https://api.app.wdesk.com
    Pole Wartość UE
    Podstawowy adres URL IAM https://api.eu.wdesk.com
    Pole Wartość APAC
    Podstawowy adres URL IAM https://api.apac.wdesk.com
    Pole Wartość CA
    Podstawowy adres URL IAM https://api.ca.wdesk.com
  4. Zapisz ustawienia obszaru roboczego .
Uwaga: Wszystkie te zmienne powinny być widoczne w Ustawieniach obszaru roboczego. Jeśli nie, zapoznaj się ponownie z wymaganiami wstępnymi wymienionymi powyżej

Krok 2: Kopiowanie i modyfikowanie łańcucha

  1. Przejdź do Chain Builder i znajdź łańcuch o nazwie CLP | Generuj token .
  2. Kliknij pionową elipsę po prawej stronie i wybierz Kopiuj .
  3. Po utworzeniu kopii łańcucha kliknij ikonę ołówka, aby edytować łańcuch.
  4. Kliknij Ustawienia łańcucha w prawym górnym rogu.
  5. Zmień nazwę łańcucha: CLP | Arkusze kalkulacyjne listy żądań HTTP .
  6. ( 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. Następnie pobiera listę wszystkich arkuszy kalkulacyjnych w obszarze roboczym. Twoja przestrzeń robocza musi zawierać co najmniej jeden arkusz kalkulacyjny.
  7. Ratujmy Łańcuch.

Krok 3: Lista arkuszy kalkulacyjnych

Aby pobrać listę naszych arkuszy kalkulacyjnych, ten łańcuch używa Polecenie GET z łącznika żądań HTTP.

  1. Dodaj polecenie Get z łącznika żądań HTTP do płótna łańcucha.
  2. Połącz polecenie Post - Pobierz token z poleceniem Get .
  3. Kliknij dwukrotnie polecenie, aby je skonfigurować.
    1. Zmień nazwę polecenia: Pobierz - Lista arkuszy kalkulacyjnych
    2. Kliknij polecenie, a następnie ikonę ołówka, aby edytować polecenie.
    3. Zaznacz pole wyboru Pokaż odpowiedź .
    4. Kliknij w adres URL , a następnie kliknij w Obszar roboczy w panelu „Wybierz zmienną” i wybierz zmienną utworzoną w kroku 1 ( wsv-BaseURL-Platform ).
    5. Dodaj /spreadsheets po zmiennej. Następnie


      poinformujemy punkt końcowy, jak ma zostać wykonany, określając Nagłówki w formularzu Pobierz . 
    6. Kliknij dwukrotnie szary przycisk ze znakiem plus (+) znajdujący się obok sekcji Nagłówek i wypełnij każde pole podanymi poniżej wartościami, zwracając szczególną uwagę na wielkość liter i spację po słowie „Bearer”.
      •  
      • Pole nagłówka 1:
      • Użyj znaku plus , aby dodać pole Nagłówek .
        • Klucz: Akceptuj
        • Wartość : application/json
      • Akceptuj image.png
      • Pole nagłówka 2 :
      • Użyj znaku plus , aby dodać kolejne pole nagłówka .
        • Klucz: Wersja X
        • Wartość : 2026-01-01
      • Nagłówek wersji X pic.png

        Poinformujemy punkt końcowy, jak wykonać polecenie, korzystając z parametrów wprowadzonych w formularzu Post . Aby to zrobić, kliknij zielony przycisk plus obok sekcji Formularz cztery razy i wypełnij każde pole podanymi poniżej wartościami, zwracając szczególną uwagę na wielkość liter.

      •  
        • Pole 1:
          • Nazwa: identyfikator_klienta
          • Wartość: <wsv-Workiva API Client ID>
            W panelu Wybierz zmienną kliknij strzałkę w dół, aby rozwinąć Obszar roboczy i wybierz wsv-Workiva API Client ID .
        • Pole 2:
          • Nazwa: client_secret
          • Wartość: <wsv-Workiva API Client Secret>
            W panelu Wybierz zmienną kliknij strzałkę w dół, aby rozwinąć Obszar roboczy i wybierz opcję wsv-Workiva API Client Secret .
        • Pole 3:
          • Nazwa: grant_type
          • Wartość: client_credentials
        • Pole 4:
          • Nazwa: zakres
          • Wartość: Opcjonalnie dodaj tutaj wartość określającą zakresy, do których ten token powinien mieć dostęp.
  4. Wypełnij odpowiedź przykładowym ładunkiem poniżej. W ten sposób nadajemy wynikom polecenia określony format, dzięki czemu każda zwrócona zmienna staje się łatwiejsza w użyciu.
  5. { "access_token": "ciąg", "expires_in": "liczba całkowita", "scope": "ciąg", "token_type": "ciąg" }

  6. ( Opcjonalnie ) Wprowadź opis : „To polecenie zwraca jedną stronę listy arkuszy kalkulacyjnych. Więcej informacji znajdziesz w dokumentacji dla programistów pod adresem https://developers.workiva.com/2026-01-01/getspreadsheets.html

    Wskazówka! Aby dowiedzieć się, jak wypełniać pola Nagłówek i Odpowiedź, zapoznaj się z dokumentacją programistyczną dotyczącą punktu końcowego API, z którym chcesz się połączyć. W tym przypadku używamy punktu końcowego „ Pobierz arkusze kalkulacyjne ”.
  7. Zapisz polecenie.

Krok 4: Przetestuj ćwiczenie

Teraz, gdy łańcuch jest gotowy, można przetestować wynik.

  1. Opublikuj Łańcuch.
  2. Kliknij Wykonaj , a następnie Uruchom łańcuch .
  3. Po zakończeniu działania Łańcucha na karcie Wyjścia – Treść odpowiedzi polecenia Get powinna zostać wyświetlona lista arkuszy kalkulacyjnych.

 

Aby dalej stawiać sobie wyzwania i dowiedzieć się więcej na temat korzystania z łącznika żądań HTTP w celu łączenia się z interfejsem API innej firmy, sprawdź następne ćwiczenie: CLP — żądanie HTTP — uzyskanie pojedynczego arkusza kalkulacyjnego .

Chcesz połączyć się z aplikacją innej firmy poza wbudowanymi złączami Premium firmy Workiva? Można to osiągnąć, wykor...