Skripte in Ihrer Website können über die Aktion Skriptausführung im Bedienfeld Automatisierungen ausgeführt werden. Auf diese Weise können Sie Scripts manuell von einem Dokument, einer Kalkulationstabelle oder einer Präsentation aus ausführen.
Die Skriptfunktion 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 Dateiberechtigungen.
Anforderungen
- Workiva Scripting muss für Ihren Arbeitsbereich aktiviert sein. Erfahren Sie mehr über Workiva Scripting.
- Skripte können nur in demselben Arbeitsbereich ausgeführt werden, in dem sie gehostet werden. Erfahren Sie mehr!
- Nur Dateibesitzer können eine Automatisierung erstellen.
- Die Rolle Script Editor ist für die Erstellung von Scripts erforderlich.
Erstellen Sie Ihre Automatisierung
So erstellen Sie eine Automatisierung aus einer Datei, die Sie besitzen:
- Öffnen Sie unter Home ein Dokument, eine Präsentation oder eine Tabellenkalkulation.
- Klicken Sie in der rechten Seitenleiste auf das Blitzsymbol für „ -Automatisierungen“.
- Klicken Sie auf + oder „Neue Automatisierung erstellen“ , um eine neue Automatisierung hinzuzufügen.
- Wählen Sie aus dem Dropdown-Menü Automatisierungsauslöser die Option Manuelle Ausführung.
- (Optional) Ermöglichen Sie anderen Benutzern, diese Automatisierung manuell auszuführen, indem Sie deren Namen eingeben und sie im Feld „Ausführung“ unter „ “ auswählen.
- Wählen Sie unter Aktionsdetails Skript ausführen.
- Geben Sie die ID „ “ aus dem Ende der Skript-URL „ “ in das Feld „ -Skript-ID“ ( ) ein.
- (Optional) Wählen Sie die Tabelle und den Abschnitt aus, die die Eingabedaten für das Skript enthalten.
- Klicken Sie zum Abschluss auf Erstellen.
Ausführen und Verwalten Ihrer Automatisierung
Ihre neue Automatisierung erscheint als "Aktiv" im Fenster "Automatisierungen". Als Eigentümer der Datei können Sie über das Dropdown-Menü verschiedene Aktionen ausführen:
- Ausführen: Führt das Skript der Automatisierung manuell aus.
- Bearbeiten: Aktualisieren Sie Details über die Automatisierung, wie z. B. die Auslösekriterien.
- Deaktivieren/Aktivieren: Wählen Sie aus, ob eine Automatisierung zur Ausführung verfügbar ist.
- Aktivität anzeigen: Öffnen Sie das Aktivitätsprotokoll der Automatisierung.
- Löschen: Entfernen Sie die Automatisierung dauerhaft aus der Datei.
Hinweis: Um Doppelläufe zu vermeiden, ist die Option Run für 20 Sekunden zwischen den Klicks deaktiviert.
Informationen, die Ihr Skript erhält
Wenn eine Automatisierung läuft, sendet sie Informationen, die das Skript als Umgebungsvariablen liest:
- DOCUMENT_ID: Die ID des Dokuments, in dem die Automatisierung ausgeführt wird.
- INPUT_SHEET_ID: Die WURL des Tabellenblatts, das zur Verwaltung der Eingabeparameter der Automatisierung verwendet wird.
- INPUT_RESOURCE_ID: Die WURL des Abschnitts im vorgenannten Arbeitsblatt.
- INPUT_SPREADSHEET_ID: Die ID des vorgenannten Arbeitsblatts.
- INPUT_SPREADSHEET_SHEET_ID: Die ID des Abschnitts im vorgenannten Arbeitsblatt.
Eine WURL ist eine proprietäre, Workiva-spezifische URL, die die ID und andere Informationen des Arbeitsblatts oder Abschnitts enthält.
Um die IDs aus den Parametern abzurufen, verwenden Sie dieses Skript:
# Willkommen bei Workiva Scripting import requests import json import os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("Rohparameter:") print(os.environ) print("") print("Tatsächliche IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Hinweis : Die Automatisierung übermittelt derzeit keine Anmeldedaten für die öffentliche Workiva-API – wie beispielsweise die Client-ID oder den Secret – an das Skript. Möglicherweise müssen Sie diese Anmeldeinformationen direkt in das Skript kodieren.
FAQ
Kann ich ein Skript ausführen, das in einem anderen Arbeitsbereich, einer anderen Organisation oder einer anderen Region (APAC, CA, EU oder US) gehostet wird?
Workiva-Automatisierungen können nur Skripte ausführen, die sich im selben Arbeitsbereich wie die Datei befinden. Um ein Skript in einem anderen Arbeitsbereich, einer anderen Organisation oder einer anderen Region auszuführen, verwenden Sie den Workiva-Skripting-Konnektor „ “ ( ) oder die Workiva-Skripting-API „ “ ( ).
Wenn Sie die Scripting-API verwenden, erstellen Sie die API-Berechtigung in dem Arbeitsbereich, in dem sich das Zielskript befindet. Für die Förderung ist Folgendes erforderlich: script:execute ; wenn die Integration den Ausführungsstatus, Protokolle oder die Ausgabe abruft, ist außerdem Folgendes erforderlich: script:read . Anleitungen zum Erstellen oder Aktualisieren einer API-Berechtigung finden Sie unter Workiva API Setup .
Kann ich zur Laufzeit Eingaben/Parameter bei der Skriptausführung senden?
Zurzeit lässt die Automatisierungsfunktion keine Laufzeiteingaben zu, die bei der Ausführung des Skripts an das Skript gesendet werden.
Welche Metadaten werden von einer Automatisierung an eine Skriptausführung gesendet? Wird die Arbeitsbereichskennung gesendet?
Wenn ein Skript im Rahmen einer Automatisierung ausgeführt wird, werden die folgenden Parameter übermittelt:
- DOCUMENT_ID: Die ID des Dokuments, in dem die Automatisierung ausgeführt wird.
- INPUT_SHEET_ID: Die WURL des Tabellenblatts, das zur Verwaltung der Eingabeparameter der Automatisierung verwendet wird.
- INPUT_RESOURCE_ID : Die WURL des Abschnitts in der „input“-Tabelle.
- INPUT_SPREADSHEET_ID : Die ID der „Eingabe“-Tabelle.
- INPUT_SPREADSHEET_SHEET_ID : Die ID des Abschnitts in der „Eingabe“-Tabelle.
Weitere Informationen finden Sie auf der Workiva-Supportseite unter sowie unter „Skripte mit Automatisierungen ausführen“ unter .
Wie erhalte ich von der Skriptausführung aus Zugriff auf die Zugangsdaten zu Workiva- und Nicht-Workiva-Systemen?
Wenn ein Skript von einer Automatisierung ausgeführt wird, besteht die einzige Möglichkeit darin, die Anmeldedaten im Code selbst zu kodieren.
Kann ein und dasselbe Skript gleichzeitig aus zwei oder mehr Dateien ausgeführt werden?
Ja, ein Skript kann entweder aus derselben Datei oder aus mehreren Dateien gleichzeitig ausgeführt werden.