Workiva Support Center

Der Workiva Chains-Konnektor bietet gemeinsame Befehle für Arbeitsbereiche, Umgebungen und Ketten. Dazu gehören die Befehle "list" und "get", die zum Abrufen von Eigenschaften, Details von Kettenläufen, Ereignissen von Anmeldeaktivitäten und mehr verwendet werden. 

Eine vollständige Liste der kompatiblen Befehle finden Sie in dem Artikel Workiva Chains commands.

Anforderungen

Bevor Sie den Stecker benutzen:

• Ein Org-Sicherheitsadministrator muss den Workiva Chains 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.
• Sie müssen einen speziellen Integrationsbenutzer mit und einer OAuth2-Erlaubnis in Ihrer Software erstellen.
• Um Ihre Ketten-IDs zu finden, schauen Sie sich diesen Artikel an: find IDs in Workiva.

Zusätzliche Anforderungen an den Integrationsnutzer

Während alle Arbeitsbereichseigentümer auf Ketten zugreifen können, die den Konnektor verwenden, benötigt der Konnektor selbst einen speziellen 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.

Bei der Einrichtung des Integrationsbenutzers sind folgende Angaben erforderlich:

• Sie müssen die OAuth2-Grant-ID und das Geheimnis des Integrationsbenutzers kennen.
• Sie müssen dem Integrationsbenutzer für jeden Befehl, den der Konnektor ausführt, die entsprechenden Berechtigungen erteilen, z. B. kann er der Eigentümer des Arbeitsblatts oder des Arbeitsbereichs sein, mit dem der Konnektor interagiert.
• Der Integrationsbenutzer muss sich bei Chain Builder anmelden, bevor er Befehle ausführen kann. Dies ist notwendig, um das Benutzerkonto einzurichten.

Verbindungsaufbau

Um den Workiva Chains-Anschluss einzurichten:

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Unter Connector Connection, wählen Sie Workiva Chains und den Standard CloudRunner.
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
4. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   

   Eigenschaft	Details
   Basis-URL	Die Basis-URL; der Standardwert ist https://h.app.wdesk.com/s/wdata/oc/api/
   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 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.

5. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.

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 EU oder APAC enthält, ist eine Überschreibung erforderlich.

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