Workiva Scripting tillhandahåller en flexibel och säker miljö för att köra Python-kod på Workiva-plattformen. I den här artikeln beskrivs några av de vanligaste scenarierna som du kan stöta på när du bygger ditt skript.
Workiva-skript ingår i Anpassa Workiva. För att använda skript måste din arbetsyta ha Anpassa Workiva/skript aktiverat, och användarna behöver lämplig(a) skriptroll(er) och filbehörigheter.
För problem som inte tas upp här, kolla in våra andra artiklar om Workiva Scripting eller besök Workiva API:er och Workiva Scripting- communities.
Problem med administratörer och behörigheter
Åtgärden Execute Script visas inte i Automations
Åtgärden Kör skript är endast tillgänglig för användare med lämplig skriptroll . Kontakta din arbetsyteadministratör för att tilldela den roll som krävs. Om rollen redan är tilldelad och åtgärden fortfarande inte är tillgänglig, kontakta Workiva Support.
Workiva Scripting-anslutning inte tillgänglig i kedjor
Detta indikerar att Workiva Scripting Connector inte har aktiverats för din arbetsyta. Om du anser att det borde vara aktiverat och det inte är det, kontakta ditt Workiva-kontoteam.
Inga skriptroller är synliga för administratören av arbetsytan
Detta indikerar att skriptfunktionen inte har aktiverats för din arbetsyta. Om du anser att det borde vara aktiverat och det inte är det, kontakta ditt Workiva-kontoteam.
Workiva Scripting-anslutning och kommandoproblem (kedjor)
Exekveringen av kommandot startar men inte skriptexekveringen
Kontrollera att skriptfunktionen har aktiverats för din arbetsyta. Om du anser att det borde vara aktiverat och det inte är det, kontakta ditt Workiva-kontoteam.
Om du har bekräftat att skript är aktiverat kanske integrationsanvändaren för Workiva Scripting-anslutningen inte har den nödvändiga rollen tilldelad. Kontakta din arbetsyteadministratör för att tilldela en lämplig skriptroll . Du bör också kontrollera att integrationsanvändaren har behörighet för åtkomst till skriptet som startas av kommandot.
Exekveringen av kommandot pågår fortfarande men skriptexekveringen stoppas oväntat
Om kedjekommandot fortsätter att köras efter att skriptet har stoppats, kontrollera följande:
-
Kontrollera om körningen avbröts:
Körningshistoriken finns tillgänglig i egenskapspanelen i skriptredigeraren och via
GET /scripts/{scriptId}/runsellerGET /scripts/{scriptId}/runs/{runId}. API-förfrågningar kräverscript:read- omfånget och måste innehållaX-Version: 2026-01-01.För instruktioner om hur du skapar eller uppdaterar ett API-tillstånd, se Workiva API-konfiguration .
-
Kontrollera om skriptet överskred en resursgräns:
Minnes-, processor-, disk- och körtidsanvändning rapporteras automatiskt i skriptkörningsloggarna och i skriptkörningsdata som returneras av API:et.
För mer information, se Hantera resursgränser i Workiva Scripting och Workiva Scripting-gränser .
-
Kontrollera om skriptet har nått sin maximala körtid:
Om så är fallet, minska mängden arbete som utförs under en körning eller dela upp arbetet i mindre operationer. Se gränser för Workiva-skript .
-
Kontrollera om det finns funktioner som explicit stoppar Python-processen:
Kontrollera att skriptet inte anropar:
quit() exit() sys.exit() os._exit()quit(),exit()ochsys.exit()höjerSystemExit.os._exit()stoppar processen omedelbart utan att köra vanliga rensningshanterare.
Mer information om Scripting API-åtgärder finns i Scripting API-guiden .
Kommando- och skriptexekvering inte synkroniserade
Detta inträffar när kommandot slutförs och skriptkörningen fortsätter, eller vice versa.
Om kommandot slutförs innan skriptet körs, se till att kommandots timeout är större än skriptets körningstid (se Workiva Scripting Limits för att lära dig mer om maximal skriptkörningstid).
Om skriptexekveringen är klar bara några sekunder före kommandot kan detta vara en förväntad fördröjning som orsakas av att skriptsystemet bearbetar information efter att skriptexekveringen är klar. Kommandot kommer att rapportera slutförande först när hela processen är klar.
Skript-editor
Importera ett bibliotek fungerar inte
Workiva Scripting stöder Pythons standardbibliotek direkt, såväl som komponenter som är tillgängliga från Python Package Index (se Workiva Scripting-bibliotek och beroenden som stöds för mer information). PyPI-komponenter som kräver ytterligare installationer kanske inte får support.
Kontrollera att det bibliotek du försöker importera ingår i Pythons standardbibliotek eller Pythons paketindex. Om det är en komponent i den senare, se till att inga ytterligare installationer krävs.