Workiva Support Center

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.

Hinweis: Scripting ist derzeit nur über Customize Workiva verfügbar.  Erfahren Sie mehr.

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:

1. Öffnen Sie unter Home ein Dokument, eine Präsentation oder eine Tabellenkalkulation.
2. Wählen Sie auf der rechten Seite des Bildschirms Automations aus.
   
3. Klicken Sie auf + oder Erstellen, um eine neue Automatisierung hinzuzufügen.
   
4. Wählen Sie aus dem Dropdown-Menü Automatisierungsauslöser die Option Manuelle Ausführung.
   
5. Unter Wenn Ausführen ausgewählt wird von können Sie optional anderen Benutzern die Möglichkeit geben, diese Automatisierung manuell auszuführen.
   
6. Wählen Sie unter Aktionsdetails Skript ausführen.
   
7. Geben Sie unter Skript-ID die ID am Ende der URL des Skripts ein.
   
8. Wählen Sie das Arbeitsblatt und den Abschnitt aus, die die Eingaben für das Script enthalten. Dies ist fakultativ.
9. 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:

# Welcome to Workiva Skripting importiert Anfragen importiert json importiert os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("RAW parameters:") print(os.environ) print("") print("Actual IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) 

Hinweis: Die Automatisierung sendet derzeit keine öffentlichen Workiva-API-Zugangsdaten – wie die Client-ID oder das 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 Umgebung (APAC, EU, US) gehostet wird?

Die Automatisierungsfunktion in Workiva kann Skripte nur in demselben Arbeitsbereich ausführen, in dem sich die Datei befindet. Der Workiva Scripting Connector oder die Workiva Scripting API können jedoch verwendet werden, um ein an einem anderen Ort gehostetes Skript auszuführen.

Wenn Sie die Skripting-API verwenden, müssen Sie im Hauptarbeitsbereich ein Skript erstellen und bereitstellen, dessen einziger Zweck es ist, die Skripting-API aufzurufen und das Skript im sekundären Arbeitsbereich auszuführen.

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 von einer Automatisierung ausgeführt wird, ist der einzige Parameter, der gesendet wird, die ID des Dokuments, in dem die Automatisierung konfiguriert ist.

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.