Der Workiva Scripting Connector bietet eine einfache Möglichkeit, Python-Skripte innerhalb der Workiva-Plattform auszuführen. Sie funktioniert unabhängig von der vollständigen Skripterfahrung und ermöglicht es technisch nicht versierten Benutzern, Skripte auszuführen, ohne sich mit dem zugrunde liegenden Quellcode auseinandersetzen zu müssen.
Eine vollständige Liste der kompatiblen Befehle finden Sie in dem Artikel Workiva Scripting commands.
Die Skripting-Funktion ist derzeit nur im Rahmen eines Early Adopter Programs verfügbar. Wenn Sie daran interessiert sind, Skripting zu Ihrem Arbeitsbereich hinzuzufügen, wenden Sie sich an Ihren Customer Success Manager, um die Teilnahme am Programm zu besprechen.
Erfahren Sie mehr über die Anforderungen an Skripte unter.
Anforderungen
Bevor Sie den Workiva-Anschluss verwenden:
- Ein Org-Sicherheitsadministrator muss den Workiva Scripting Connector über den Bildschirm Konfigurationen aktivieren.
- Um die Kette in einer Testumgebung auszuführen, benötigen Sie die URLs, um die Hosts und Basispfade der API außer Kraft zu setzen.
Warum sollte ich den Workiva Scripting Connector über HTTP Request verwenden?
Der HTTP Request Connector benötigt eine zusätzliche Logik, um Inhaber-Tokens zu aktualisieren und den Status des Skripts abzufragen. Diese Anforderungen werden durch den Einsatz des Workiva Scripting Connectors eliminiert.
Darüber hinaus bietet der Workiva Scripting Connector zusätzliche Funktionen wie die Möglichkeit, Befehlsausgaben (wie stdout und logs) an anderer Stelle in einer Kette zu verwenden.
Einrichtung der Verbindung
Um den Workiva Scripting Connector einzurichten:
- Öffnen Sie den „ -Chain-Builder“ unter.
- Klicken Sie im linken Navigationsbereich auf „ “ („Verbindungen“) und anschließend oben rechts auf der Seite auf „ “ („erstellen“) .
- Wählen Sie unter „ -Connector-Verbindung“ () die Option „ -Workiva-Skripting“ ( ) und den Standard-CloudRunner aus.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
-
Geben Sie unter „ -Eigenschaften“ () die Details der Verbindung ein:
Eigenschaft Details Kunden-ID Geben Sie die ID für die OAuth-Erlaubnis des Integrationsbenutzers ein.
Dieser wird nach dem Zufallsprinzip generiert.Client secret Geben Sie das Secret für die Eigenschaft ID ein.
Dieser wird nach dem Zufallsprinzip generiert.Skripting-Server-API (Optional) Geben Sie die URL ein, die den Standard-URL-Host und den Basispfad für die Scripting-Server-API ersetzen soll. Überschreibung des IAM-Hosts (Optional) Geben Sie die URL ein, die den Standard-URL-Host und den Basispfad für die Identify and Access Management (IAM)-Endpunkte ersetzen soll. Skripting-API-Versionen Wählen Sie die zu verwendende Version der API.
V1 ist die Standardeinstellung und wird für die meisten Benutzer empfohlen.
V0 wird in naher Zukunft entfernt werden. - Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
URL-Überschreibungen
Je nach Region Ihrer Produktionsumgebung kann eine Override-URL gelten. Sie können dies überprüfen, indem Sie die URL vergleichen, die Sie für die Anmeldung bei Wdesk verwenden. Wenn die URL EU oder APAC enthält, ist eine Überschreibung erforderlich.
Hinweis: Die Informationen zur US-Region unter dienen lediglich als Referenz. Wenn Sie sich in dieser Region befinden, müssen Sie keine Ausnahmeregelungen anwenden.
| Feld | Wert |
|---|---|
| Überschreibung des zentralen Hosts | https://h.app.wdesk.com/s/cerebral |
| Überschreibung des Arbeitsblätter-Hosts | https://api.app.wdesk.com/spreadsheets/v1/ |
| Überschreibung des IAM-Hosts | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Überschreibung des Administrator-Hosts | https://api.app.wdesk.com/admin/v1 |
| Überschreibung des GraphDB-Hosts | https://api.app.wdesk.com/graphdb/v1/ |
| Überschreibung des Plattform-API-Hosts | https://api.app.wdesk.com/platform/v1 |
| Überschreiben der Scripting-Server-API | https://h.app.wdesk.com/s/scripting |
| Feld | Wert |
|---|---|
| Überschreibung des zentralen Hosts | https://h.apac.wdesk.com/s/cerebral |
| Überschreibung des Arbeitsblätter-Hosts | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Überschreibung des IAM-Hosts | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Überschreibung des Administrator-Hosts | https://api.apac.wdesk.com/admin/v1 |
| Überschreibung des GraphDB-Hosts | https://api.apac.wdesk.com/graphdb/v1 |
| Überschreibung des Plattform-API-Hosts | https://api.apac.wdesk.com/platform/v1 |
| Überschreiben der Scripting-Server-API | https://h.apac.wdesk.com/s/scripting |
| Feld | Wert |
|---|---|
| Überschreibung des zentralen Hosts | https://h.ca.wdesk.com/s/cerebral |
| Überschreibung des Arbeitsblätter-Hosts | https://api.ca.wdesk.com/spreadsheets/v1/ |
| Überschreibung des IAM-Hosts | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| Überschreibung des Administrator-Hosts | https://api.ca.wdesk.com/admin/v1 |
| Überschreibung des GraphDB-Hosts | https://api.ca.wdesk.com/graphdb/v1/ |
| Überschreibung des Plattform-API-Hosts | https://api.ca.wdesk.com/platform/v1 |
| Überschreiben der Scripting-Server-API | https://h.ca.wdesk.com/s/scripting |
| Feld | Wert |
|---|---|
| Überschreibung des zentralen Hosts | https://h.eu.wdesk.com/s/cerebral |
| Überschreibung des Arbeitsblätter-Hosts | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Überschreibung des IAM-Hosts | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Überschreibung des Administrator-Hosts | https://api.eu.wdesk.com/admin/v1 |
| Überschreibung des GraphDB-Hosts | https://api.eu.wdesk.com/graphdb/v1/ |
| Überschreibung des Plattform-API-Hosts | https://api.eu.wdesk.com/platform/v1 |
| Überschreiben der Scripting-Server-API | https://h.eu.wdesk.com/s/scripting |