Centrum wsparcia Workiva

Workiva Scripting zapewnia elastyczne i bezpieczne środowisko do uruchamiania kodu Python na platformie Workiva. W tym artykule opisano niektóre z częstszych scenariuszy, jakie mogą wystąpić podczas tworzenia skryptu.

Skrypty Workiva są zawarte w module Customize Workiva. Aby móc korzystać ze skryptów, w obszarze roboczym musi być włączona opcja Dostosowywanie Workiva/Skryptów, a użytkownicy muszą mieć odpowiednie role skryptowe i uprawnienia do plików.

W przypadku problemów, które nie zostały tutaj omówione, zapoznaj się z naszymi innymi artykułami na temat skryptów Workiva lub odwiedź społeczności API Workiva i skryptów Workiva .

Problemy z administratorem i uprawnieniami

Akcja „Wykonaj skrypt” nie pojawia się w automatyzacjach

Akcja Wykonaj skrypt jest dostępna tylko dla użytkowników posiadających odpowiednią rolę Skryptowanie . Skontaktuj się z administratorem obszaru roboczego, aby przypisać wymaganą rolę. Jeśli rola jest już przypisana, a akcja jest nadal niedostępna, skontaktuj się z pomocą techniczną Workiva.

Łącznik skryptowy Workiva nie jest dostępny w łańcuchach

Oznacza to, że łącznik Workiva Scripting nie został włączony dla Twojego obszaru roboczego. Jeśli uważasz, że ta opcja powinna być włączona, a tak nie jest, skontaktuj się z zespołem ds. kont Workiva.

Administrator obszaru roboczego nie widzi żadnych ról skryptowych

Oznacza to, że funkcja skryptów nie została włączona w Twoim obszarze roboczym. Jeśli uważasz, że ta opcja powinna być włączona, a tak nie jest, skontaktuj się z zespołem ds. kont Workiva.

Łącznik skryptowy Workiva i problemy z poleceniami (łańcuchy)

Rozpoczyna się wykonywanie polecenia, ale nie następuje wykonywanie skryptu

Sprawdź, czy funkcja skryptów została włączona w Twoim obszarze roboczym. Jeśli uważasz, że ta opcja powinna być włączona, a tak nie jest, skontaktuj się z zespołem ds. kont Workiva.

Jeśli potwierdzono, że obsługa skryptów jest włączona, użytkownik integracji dla łącznika Workiva Scripting może nie mieć przypisanej niezbędnej roli. Skontaktuj się z administratorem swojego obszaru roboczego, aby przypisać odpowiednią rolę skryptową . Należy również sprawdzić, czy użytkownik integracyjny ma uprawnienia dostępu do skryptu uruchomionego przez polecenie.

Wykonywanie polecenia jest nadal w toku, ale wykonywanie skryptu zostaje nieoczekiwanie przerwane

Jeśli polecenie łańcuchowe nadal jest wykonywane po zatrzymaniu skryptu, sprawdź następujące kwestie:

• Sprawdź, czy bieg został anulowany:

  Historia uruchomień jest dostępna w panelu Właściwości edytora skryptów oraz za pomocą polecenia GET /scripts/{scriptId}/runs lub GET /scripts/{scriptId}/runs/{runId} . Żądania API wymagają zakresu script:read i muszą zawierać X-Version: 2026-01-01 . 

  Instrukcje dotyczące tworzenia lub aktualizowania przyznania API można znaleźć w dokumencie Konfiguracja interfejsu API Workiva .

  

• Sprawdź, czy skrypt przekroczył limit zasobów:

  Użycie pamięci, procesora, dysku i czasu wykonania jest automatycznie raportowane w dziennikach uruchomienia skryptu i w danych uruchomienia skryptu zwracanych przez API.

  Aby uzyskać więcej informacji, zobacz Obsługa limitów zasobów w skryptach Workiva i Limity skryptów Workiva .

• Sprawdź, czy skrypt osiągnął maksymalny czas wykonania:

  Jeśli tak, zmniejsz ilość pracy wykonywanej w jednym cyklu lub podziel pracę na mniejsze operacje. Zobacz Limity skryptów Workiva .

• Sprawdź funkcje, które jawnie zatrzymują proces Pythona:

  Sprawdź, czy skrypt nie wywołuje:

  quit() exit() sys.exit() os._exit()

  quit() , exit() i sys.exit() raise SystemExit . os._exit() natychmiast zatrzymuje proces bez uruchamiania normalnych procedur czyszczenia.

Aby uzyskać więcej informacji na temat operacji interfejsu API skryptowego, zapoznaj się z przewodnikiem po interfejsie API skryptowego .

Wykonywanie poleceń i skryptów nie jest zsynchronizowane

Dzieje się tak, gdy polecenie zostanie zakończone, a skrypt będzie kontynuowany, lub odwrotnie.

Jeśli polecenie zostanie zakończone przed wykonaniem skryptu, upewnij się, że limit czasu polecenia jest większy niż czas wykonania skryptu (zobacz Limity skryptów Workiva , aby dowiedzieć się więcej o maksymalnym czasie wykonania skryptu).

Jeżeli wykonywanie skryptu zakończy się zaledwie kilka sekund przed poleceniem, może to być spowodowane oczekiwanym opóźnieniem spowodowanym przetwarzaniem informacji przez system skryptowy po zakończeniu wykonywania skryptu. Polecenie poinformuje o zakończeniu procesu dopiero po jego zakończeniu.

Edytor skryptów

Importowanie biblioteki nie działa

Workiva Scripting obsługuje standardową bibliotekę języka Python oraz komponenty dostępne w Indeksie pakietów języka Python (więcej informacji można znaleźć w dokumencie Obsługiwane biblioteki i zależności Workiva Scripting ). Komponenty PyPI wymagające dodatkowych instalacji mogą nie być obsługiwane.

Upewnij się, że biblioteka, którą próbujesz zaimportować, jest częścią standardowej biblioteki Pythona lub indeksu pakietów Pythona. Jeżeli jest to składnik tego ostatniego, upewnij się, że nie są wymagane żadne dodatkowe instalacje.