Polecenia arkusza kalkulacyjnego Workiva Connector korzystają z interfejsu API platformy Workiva. Aktualna wersja to 2022-01-01, ale zostanie ona wycofana. Aby łańcuchy działały bez zarzutu, przenosimy wszystkie polecenia Workiva Connector do wersji 2026-01-01.
Większość poleceń łącznika Workiva zostanie automatycznie przeniesiona na datę 2026-01-01 30 listopada 2026 r. i nie będzie konieczna edycja łańcuchów. Dane wejściowe i wyjściowe nie ulegają zmianie.
Polecenia arkusza kalkulacyjnego
Wraz z wprowadzeniem wersji API 2026-01-01 polecenia arkusza kalkulacyjnego w łączniku Workiva mają teraz pole Wersja API , wymagające wybrania wersji 2022 lub 2026. Wartością domyślną jest 2022, a polecenie bez wartości używa 2022. Oznacza to, że polecenia łańcuchowe zapisane przed powstaniem pola będą nadal działać w roku 2022.
W dniu 31 października 2027 r. przeniesiemy te polecenia na 2026-01-01. Dokonaj zmiany przed upływem tego terminu, aby móc przetestować łańcuchy w 2026 roku.
Co się zmieni w 2026 roku
W tej tabeli wymieniono zmiany w poleceniach:
| Polecenie | Zmień |
|---|---|
| Zapisz dane arkusza, Nadpisz dane arkusza, Wyczyść dane arkusza, Aktualizuj metadane arkusza, Publikuj arkusz kalkulacyjny, Usuń arkusz kalkulacyjny |
|
| Usuń arkusz kalkulacyjny |
Przenosi arkusz kalkulacyjny do kosza, skąd można go przywrócić. Polecenie Pobierz metadane arkusza kalkulacyjnego wykonane później w tym łańcuchu zakończy się niepowodzeniem i wyświetleniem komunikatu „Wybrany arkusz kalkulacyjny został usunięty”. |
| Pobierz dane arkusza | Wersja jest ignorowana. Polecenie zwraca najnowsze dane i rekordy Ostrzeżenie: opcja --revision nie jest obsługiwana przez platformę API 2026. Zwrócono najnowsze dane arkusza. w dzienniku. Jeśli twój łańcuch wymaga wcześniejszej rewizji, ustaw polecenie na 2022. |
| Utwórz arkusz kalkulacyjny | W przypadku wystąpienia błędu nie jest już wyświetlana szczegółowa lista „Błędy:”. |
| Usuń arkusz | Arkusz zawierający kod XBRL zostaje odrzucony za pomocą komunikatu API. |
| Pobierz metadane arkusza, zaktualizuj metadane arkusza i inne polecenia przyjmujące nazwę arkusza | Nazwa arkusza po pierwszej stronie arkuszy jest teraz rozpoznawana. |
Inne zmiany
- Niektóre teksty błędów „nie znaleziono” różnią się między wersjami, więc jeśli późniejsze polecenie sprawdzi tekst błędu, może on zachowywać się inaczej w różnych wersjach.
- Jeśli w udzieleniu zezwolenia API brakuje
wartościfile:readlub file:write , polecenia 2026 zakończą się niepowodzeniem, co może spowodować awarię całego łańcucha. - Chociaż okna dialogowe konfiguracji dla opcji Pobierz dane arkusza , Zapisz dane arkusza i Nadpisz dane arkusza mają pole wyboru Użyj interfejsu API platformy , to jeśli wersja interfejsu API to 2026, te polecenia będą używać interfejsu API 2026, nawet jeśli to pole wyboru jest puste.
Co pozostaje takie samo
- Nazwy wejść i wyjść dla każdego polecenia, aby późniejsze polecenia nadal działały.
- Komunikaty o powodzeniu: „Usunięcie pomyślne”, „Aktualizacja pomyślna”, „Publikacja pomyślna”.
- Host nadpisuje połączenie. Nie dodajesz ani nie zmieniasz niczego.
Wymagania wstępne: plik:odczyt i plik:zapis
W API 2026 polecenia te sprawdzają inne zakresy niż w API 2022. Jeżeli te uprawnienia nie zostaną zaktualizowane, polecenie działające przy użyciu interfejsu API 2022 nie zostanie wykonane w przypadku użycia interfejsu API 2026.
- Polecenia, które odczytują arkusz kalkulacyjny, wymagają
pliku:odczyt . - Polecenia, które zmieniają arkusz kalkulacyjny, wymagają
file:write .
Dodawanie wartości zakresu
Dodanie tych zakresów wymaga, aby administrator zabezpieczeń Workiva Org dodał zakresy do przyznania API, którego identyfikator klienta jest zapisany w połączeniu Workiva:
- W prawym górnym rogu kliknij ikonę użytkownika, wybierz Administrator , a następnie Administrator organizacji .
- W menu po lewej stronie wybierz Bezpieczeństwo , a następnie kartę Zaopatrzenie .
- Znajdź ten grant i otwórz go z menu Akcje .
- W Zakresy wybierz
plik:odczytiplik:zapisi zapisz grant. Tajemnica klienta pozostaje taka sama.
Aby uzyskać więcej informacji, zobacz Tworzenie i zarządzanie uprawnieniami API w Administracji organizacją .
Kroki przełączenia łańcucha na 2026 rok
- Upewnij się, że grant zawiera
file:readifile:write .Zobacz Wymagania wstępne . - Otwórz łańcuch. W każdym kroku polecenia arkusza kalkulacyjnego ustaw Wersja API na 2026 .
- Zapisz i uruchom łańcuch.
- (Opcjonalne, ale zalecane) Porównaj następujące dane wyjściowe z wynikami z wcześniejszego uruchomienia w roku 2022:
Zapisane wiersze, Zapisane komórki, Dane w pliku CSV i Liczba arkuszy.
Jeśli coś jest nie tak, cofnij kroki do 2022 i skontaktuj się z pomocą techniczną Workiva .
Używaj tylko jednej wersji API w łańcuchu Workiva zaleca używanie jednej wersji API dla wszystkich kroków poleceń arkusza kalkulacyjnego w łańcuchu; nie gwarantujemy, że łączenie i dopasowywanie wielu wersji API będzie działać zgodnie z oczekiwaniami lub oczekiwaniami.
Rozwiązywanie problemów
| Wiadomość | Co robić |
|---|---|
Dane uwierzytelniające nie mają wymaganego zakresu: plik:odczyt lub plik:zapis , z kodem błędu HTML 401 |
W udzieleniu zezwolenia API brakuje zakresu wskazanego w komunikacie. Dodaj go zgodnie z opisem w Wymagania wstępne , a następnie ponownie uruchom łańcuch. Do tego czasu ustaw polecenie na 2022. |
Przekroczono limit 300 prób lub Przekroczono limit czasu 10m0s |
Polecenie nie zostało wykonane na czas. Zmniejsz rozmiar danych lub ustaw polecenie na 2022 i skontaktuj się z Wsparcie Workiva . |
Operacja nie powiodła się lub Operacja została anulowana |
Sprawdź arkusz kalkulacyjny i identyfikatory arkuszy. Jeśli są poprawne, skontaktuj się z pomocą techniczną, podając identyfikator operacji widoczny w dzienniku. |
Wybrany arkusz kalkulacyjny zostanie usunięty. |
Wcześniejszy krok Usuń arkusz kalkulacyjny przy użyciu 2026 przeniósł go do kosza. Przywróć go lub użyj innego arkusza kalkulacyjnego. |
Wersja API musi być z roku 2022 lub 2026. |
To pole przechowuje inną wartość. Ustaw na rok 2022 lub 2026. |
A co jeśli nic nie zrobię?
Polecenia ustawione na rok 2022 są dostępne do 31 października 2027 . W tym dniu przenosimy je na 2026-01-01. Zmień polecenia odpowiednio wcześniej, aby mieć czas na przetestowanie łańcuchów.
Potrzebujesz pomocy?
Skontaktuj się z Wsparciem Workiva .