Workiva Support Center

Workiva Scripting bietet eine flexible und sichere Umgebung für die Ausführung von Python-Code auf der Workiva-Plattform. Dieser Artikel behandelt einige der häufigsten Szenarien, auf die Sie bei der Erstellung Ihres Skripts stoßen können.

Workiva Scripting ist in „Customize Workiva“ enthalten. Um die Skriptfunktion nutzen zu können, muss in Ihrem Arbeitsbereich die Option „Workiva anpassen/Skriptfunktion“ aktiviert sein, und die Benutzer benötigen die entsprechenden Skriptrollen sowie die entsprechenden Dateiberechtigungen.

Bei Fragen, die hier nicht behandelt werden, schauen Sie sich unsere „ “ sowie weitere Artikel zum Thema Workiva-Skripting unter an oder besuchen Sie die Communities „ “ (Workiva-APIs) unter und „Workiva Scripting“ (Workiva-Skripting) unter .

Verwaltungs- und Berechtigungsprobleme

Aktion "Skript ausführen" erscheint nicht in Automatisierungen

Die Aktion „Skript ausführen“ steht nur Benutzern mit einer entsprechenden „ -Skripting“-Rolle zur Verfügung . Wenden Sie sich an Ihren Workspace-Administrator, um die erforderliche Rolle zuzuweisen. Falls die Rolle bereits zugewiesen ist und die Aktion dennoch nicht verfügbar ist, wenden Sie sich bitte an den Workiva-Support.

Workiva Scripting Konnektor nicht in Chains verfügbar

Dies zeigt an, dass der Workiva Scripting Connector für Ihren Arbeitsbereich nicht aktiviert wurde. Wenn Sie der Meinung sind, dass diese Funktion aktiviert sein sollte, dies aber nicht der Fall ist, wenden Sie sich bitte an Ihr Workiva-Kundenteam.

Für den Arbeitsbereichsadministrator sind keine Skripting-Rollen sichtbar.

Dies bedeutet, dass die Skriptfunktion für Ihren Arbeitsbereich nicht aktiviert wurde. Wenn Sie der Meinung sind, dass diese Funktion aktiviert sein sollte, dies aber nicht der Fall ist, wenden Sie sich bitte an Ihr Workiva-Kundenteam.

Workiva Scripting Connector und Befehlsprobleme (Ketten)

Die Befehlsausführung beginnt, die Skriptausführung jedoch nicht

Überprüfen Sie, ob die Skriptfunktion für Ihren Arbeitsbereich aktiviert wurde. Wenn Sie der Meinung sind, dass diese Funktion aktiviert sein sollte, dies aber nicht der Fall ist, wenden Sie sich bitte an Ihr Workiva-Kundenteam.

Wenn Sie bestätigt haben, dass Skripting aktiviert ist, dann hat der Integrationsbenutzer für den Workiva Scripting Connector möglicherweise nicht die erforderliche Rolle zugewiesen. Wenden Sie sich an Ihren Workspace-Administrator, um eine geeignete Scripting-Rolle zuzuweisen. Sie sollten auch überprüfen, ob der Integrationsbenutzer die Berechtigung hat, auf das vom Befehl ausgelöste Skript zuzugreifen.

Die Befehlsausführung ist noch im Gange, aber die Skriptausführung wird unerwartet angehalten

Falls der Befehlskettenvorgang nach Beendigung des Skripts noch läuft, überprüfen Sie Folgendes:

• Überprüfen Sie, ob der Lauf abgesagt wurde:  

  Der Ausführungsverlauf ist im Eigenschaftenfenster des Skript-Editors sowie über GET /scripts/{scriptId}/runs oder GET /scripts/{scriptId}/runs/{runId} verfügbar. Für API-Anfragen ist der Bereich „ script:read“ erforderlich, und sie müssen X-Version: 2026-01-01 enthalten. 

  Anleitungen zum Erstellen oder Aktualisieren einer API-Berechtigung finden Sie unter Workiva API Setup .

  

• Überprüfen Sie, ob das Skript ein Ressourcenlimit überschritten hat:

  Die Auslastung von Arbeitsspeicher, CPU und Festplatte sowie die Laufzeit werden automatisch in den Ausführungsprotokollen der Skripte und in den von der API zurückgegebenen Ausführungsdaten der Skripte erfasst.

  Weitere Informationen finden Sie unter , „Umgang mit Ressourcenbeschränkungen in Workiva Scripting“ sowie , „Workiva Scripting-Beschränkungen“ .

• Überprüfen Sie, ob das Skript seine maximale Laufzeit erreicht hat:

  Sollte dies der Fall sein, reduzieren Sie den Arbeitsaufwand pro Durchlauf oder teilen Sie die Arbeit in kleinere Arbeitsschritte auf. Siehe „ “ – Einschränkungen bei der Skriptsprache von Workiva: .

• Überprüfen Sie, ob Funktionen vorhanden sind, die den Python-Prozess explizit beenden:

  Stellen Sie sicher, dass das Skript Folgendes nicht aufruft:

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

  quit() , exit() , und sys.exit() raise SystemExit . os._exit() beendet den Prozess sofort, ohne die normalen Aufräumroutinen auszuführen.

Weitere Informationen zu den Funktionen der Scripting-API finden Sie im Handbuch zur Scripting-API von „ “ unter .

Befehls- und Skriptausführung nicht synchronisiert

Dies ist der Fall, wenn der Befehl beendet wird und der Skriptlauf weiterläuft oder umgekehrt.

Falls der Befehl vor der Skriptausführung abgeschlossen wird, stellen Sie bitte sicher, dass das Zeitlimit für den Befehl „ “ größer ist als die Skriptausführungszeit (Informationen zur maximalen Skriptausführungszeit finden Sie unter Workiva Scripting Limits ).

Wenn die Skriptausführung nur wenige Sekunden vor dem Befehl abgeschlossen ist, kann dies eine erwartete Verzögerung sein, die dadurch entsteht, dass das Skripting-System Informationen verarbeitet, nachdem die Skriptausführung abgeschlossen ist. Der Befehl meldet den Abschluss erst, wenn der gesamte Prozess abgeschlossen ist.

Skripting-Editor

Der Import einer Bibliothek funktioniert nicht

Workiva Scripting unterstützt Python's Standardbibliothek, sowie Komponenten aus dem Python Package Index (siehe Unterstützte Workiva Scripting Bibliotheken und Abhängigkeiten für weitere Informationen). PyPI-Komponenten, die zusätzliche Installationen erfordern, werden möglicherweise nicht unterstützt.

Vergewissern Sie sich, dass die Bibliothek, die Sie zu importieren versuchen, Teil der Python-Standardbibliothek oder des Python Package Index ist. Wenn es sich um eine Komponente des letzteren handelt, stellen Sie sicher, dass keine zusätzlichen Installationen erforderlich sind.