Workiva Support Center

Mit dem Workiva-Konnektor können Sie Befehle in Ketten verwenden, um mit der Workiva-Plattform zu interagieren, einschließlich anderer Wdata-Funktionen, Arbeitsblättern und GraphDB. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Tabellen, Abfragen und Ansichten erstellen und verwalten
• Datensätze oder Importfehler einer Tabelle auflisten
• Arbeitsblätter oder deren Blätter erstellen und verwalten
• Aufzeichnungen und Berichte verwalten

Anforderungen

Zur Interaktion mit der Workiva-Plattform nutzt der Konnektor die Workiva-REST-APIs. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein dedizierter Workiva-Integrations-Benutzer mit und einer OAuth2-Berechtigung.

  Hinweis: Dieser Integrationsbenutzer benötigt entsprechende Berechtigungen für die Befehle, die der Connector ausführt, z. B. die Berechtigung als Eigentümer der Tabellenkalkulationen oder des Arbeitsbereichs, mit denen er interagiert.

• Die OAuth2-Grant-ID und der Secret des Integrationsbenutzers.
• Um die Kette in einer Testumgebung auszuführen, müssen die URLs verwendet werden, um die Hosts und Basispfade der API zu überschreiben.

Hinweis: Während die Besitzer des Arbeitsbereichs auf Ketten zugreifen können, die den Konnektor verwenden, benötigt der Konnektor selbst einen dedizierten Integrationsbenutzer, um seine Befehle auszuführen. Durch die Verwendung eines dedizierten Integrationsbenutzers (anstelle des Benutzerkontos eines Mitarbeiters) können Sie die Aktivitäten des Konnektors nachverfolgen und seinen Zugriff auf die Funktionen beschränken, die er zur Ausführung seiner Befehle benötigt.

Workiva-Konnektor einrichten

1. Rufen Sie unter den Chain Builder auf, klicken Sie auf compare_arrows „Connections“ in der linken Seitenleiste und anschließend auf compare_arrows „Create“ oben rechts.
2. Unter Verbindung erstellen, wählen Sie Workiva und den Standard CloudRunner.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.

4. Wählen Sie unter „ -Ressourcen“ () die Ressourcen aus, die Sie dieser Verbindung zuordnen möchten.
   Dieser Abschnitt bietet einen sicheren Speicherort für alle Dateien (Skripte, Sicherheitstoken, Zertifikate usw.), die der Konnektor für seinen Betrieb benötigt, beispielsweise für die Authentifizierung oder zur Erfüllung von Umgebungsanforderungen. Wenn Sie die Verbindung speichern, werden diese Dateien automatisch mit AES-256 verschlüsselt. Weitere Informationen finden Sie auf der Support-Seite „ “ zur Sicherheitsarchitektur des Workiva Chain Builders unter.

   Vorteile:

   • Sichere Speicherung: Da diese Dateien beim Speichern verschlüsselt und auf Verbindungsebene gespeichert werden, eignen sie sich ideal für sensible oder statische Konfigurationsdaten, die nicht fest in die Chain selbst einprogrammiert werden sollten.
   • Portabilität: Wenn Sie Ihre Kette von einem „Test“-Arbeitsbereich in einen „Produktions“-Arbeitsbereich verschieben, bleiben die Ressourcen mit den Verbindungseinstellungen verknüpft, sodass Sie die Dateipfade in Ihren Kettenknoten nicht neu schreiben müssen.
   • Erreichbarkeit: Durch das Speichern der Dateien an dieser Stelle stehen sie dem „ -Runner“ (dem Agenten, der die Aufgabe ausführt) zur Verfügung, ohne dass die Datei manuell auf dem physischen Host-Rechner des Runners abgelegt werden muss.

   Nachteile:

   • Da sie verschlüsselt sind, können sie nicht direkt bearbeitet werden; Sie müssen die Datei löschen und die geänderte Version hochladen.

5. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   

   Eigenschaft	Details
   ID	Geben Sie die ID für die OAuth-Erlaubnis der Integrationsbenutzer ein.
   Secret	Geben Sie das Secret für die Eigenschaft ID ein.
   Überschreibung des zentralen Hosts	Um den URL-Host und den Basispfad für die Wdata-Endpunkte zu überschreiben (z. B. für eine Testumgebung), geben Sie stattdessen die zu verwendende URL ein.
   Überschreibung des Arbeitsblätter-Hosts	Um den URL-Host und den Basispfad für die Arbeitsblätter-Endpunkte zu überschreiben (z. B. für eine Testumgebung), geben Sie stattdessen die zu verwendende URL ein.
   Überschreibung des IAM-Hosts	Um den URL-Host und den Basispfad für die Identity Access Management (IAM)-Endpunkte zu überschreiben (z. B. für eine Testumgebung), geben Sie stattdessen die zu verwendende URL ein.
   Überschreibung des Administrator-Hosts	Um den URL-Host und den Basispfad für die Administrator-Endpunkte zu überschreiben (z. B. für eine Testumgebung), geben Sie stattdessen die zu verwendende URL ein.
   Überschreibung des GraphDB-Hosts	Um den URL-Host und den Basispfad für die GraphDB-Endpunkte zu überschreiben (z. B. für eine Testumgebung), geben Sie stattdessen die zu verwendende URL ein.
   Überschreibung des Plattform-API-Hosts	Um den URL-Host und den Basispfad für die Endpunkte der Workiva-Plattform zu überschreiben (z. B. für eine Testumgebung), geben Sie stattdessen die zu verwendende URL ein.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und unter Verwendung der AES-256-Verschlüsselung gespeichert.

6. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
7. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Dateien auflisten des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

URL-Überschreibungen

Abhängig von der Region Ihrer Produktionsumgebung kann eine Überschreibungs-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 .apac, .ca oder .eu enthält, ist eine Überschreibung erforderlich.

Hinweis: Informationen zur US-Region sind als Referenz aufgeführt.

Fehlersuche

Wenn die Verbindung zur Workiva-Plattform fehlschlägt:

• Stellen Sie sicher, dass die OAuth-Anmeldeinformationen der Anwendung des Konnektors vorhanden, korrekt und gültig sind. OAuth-Anmeldeinformationen haben ein bestimmtes Ablaufdatum, und das Zertifikat kann abgelaufen sein. Wenn dies der Fall ist, müssen Sie ein neues Zertifikat erstellen und das neue Client-Geheimnis in den Connector eingeben. 
• Vergewissern Sie sich, dass der Integrationsbenutzer über die entsprechenden Berechtigungen für den auszuführenden Befehl verfügt.
• Wenn Sie eine Host-Überschreibung verwenden, überprüfen Sie, ob die für den Konnektor eingegebene URL korrekt ist.

• Stellen Sie sicher, dass die ID der Workiva-Datei – beispielsweise der Tabelle, der Abfrage oder der Tabelle –, mit der interagiert wird, korrekt ist.

  Hinweis: Die ID einer Datei erscheint in der URL der Datei, wenn sie in Workiva geöffnet wird. Beispielsweise erscheint die ID eines Arbeitsblatts nach spreadsheet/ in der URL und die ID einer Tabelle nach tables/.