Workiva Support Center

Der Workday Adaptive Planning Connector , früher bekannt als Adaptive Insights, verwendet Befehle in einer Kette, um Daten oder Metadaten zu importieren oder zu exportieren.

Hinweis: Dieser Connector wurde von Workiva erstellt und stellt eine Verbindung zu einem System eines Drittanbieters her. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Anforderungen

Um die Verbindung zu aktivieren, verwendet der Connector die Workday Adaptive Planning REST API. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein in Adaptive Planning eingerichteter Integrationsbenutzer, dem eine Rolle mit entsprechenden Berechtigungen zur Ausführung der Befehle des Connectors zugewiesen wurde.
• Der Benutzername und das Passwort des Integrationsbenutzers.
• Wenn der Integrationsbenutzer auf mehrere Instanzen von Adaptive Planning zugreifen kann, geben Sie den Instanzcode an, mit dem er sich verbinden wird.

  Hinweis: Um die verfügbaren Instanzcodes des Integrationsbenutzers zu ermitteln, können Sie den API-Endpunkt Adaptive Planning exportInstances verwenden.

Einrichten des Workday Adaptive Planning Connectors

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Klicken Sie unter Chain-Generator auf Verbindungen   compare_arrows und dann auf Erstellen oben rechts.
2. Unter Connector Verbindung, wählen Sie Workday Adaptive Planning und den Standard-CloudRunner.
   

Workiva bietet zwei Authentifizierungsmethoden an (Basic und JWT Bearer Grant (Workday Credentials)). Sie können die gewünschte Methode unter Credentials in der Verbindungskonfiguration auswählen.

Mit Basis-Authentifizierung authentifizieren

1. Geben Sie unter Eigenschaften optional den Instanzcode für die Instanz Adaptive Planning ein.
2. Wählen Sie 'Basic Credential' als Authentifizierungsart.
3. Geben Sie die folgenden Werte ein:
   Benutzername: Der Benutzername des Integrationsbenutzers, der mit dem Connector verwendet werden soll.
   Passwort: Das Passwort für den Benutzer, der im Feld Benutzername angegeben ist.

Authentifizierung mit einem JWT Bearer Grant (Workday-Zugangsdaten)

Diese Authentifizierungsmethode verwendet Workday-Anmeldeinformationen zur Authentifizierung bei Adaptive Planning und setzt voraus, dass:

• SSO ist aktiviert.
• Die Workday-Mandanteneinstellungen für Adaptive Planning User Sign-on und Public APIs enabled sind aktiviert.
• Eine öffentliche API ISU wird zwischen Workday und Adaptive Planning abgebildet.

Nähere Informationen zu dieser Einrichtung finden Sie in der folgenden Workday-Dokumentation:

• SAML SSO in der adaptiven Planung für synchronisierte Benutzer einrichten
• Fehlersuche: Benutzer-Synchronisierung mit Adaptive Planning

Als Teil dieser Konfiguration muss ein privater x509-Schlüssel in den Teil Verbindungsressourcen dieser Verbindung hochgeladen werden und ein öffentliches Zertifikat, das mit diesem Schlüssel erstellt wurde, muss in Workday hochgeladen und mit einem API-Client vom Typ 'JWT Bearer Grant' verknüpft werden. Dieser Client muss wiederum mit der ISU verknüpft sein, die Sie für Anfragen an Adaptive Planning verwenden, wobei die Anmeldeinformationen zwischen den beiden Systemen gemappt werden müssen.

Spezifische Details zu dieser Einrichtung finden Sie in der folgenden Workday-Dokumentation: API-Clients registrieren.

Details zum Schlüssel

Das unterstützte Format für private Schlüssel ist PKCS#8 und kann entweder passwortgeschützt oder nicht passwortgeschützt sein. Ein neuer Schlüssel kann mit openssl mit dem folgenden Befehl erstellt werden:

openssl req -x509 \ -neuer Schlüssel rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650

Ermitteln des Workday-Hosts, der Domäne und des Mandanten

Verwenden Sie den Workday REST API Endpunkt, der unter dem API Client aufgeführt ist, und identifizieren Sie den Host, die Domäne und den Mandanten im Format https://{host}.{domain}/ccx/api/v1/{tenant}

Beispiel

https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany

Einrichten des Typs Bearer Credentials im Adaptive Planning Connector

1. Laden Sie Ihren privaten Schlüssel in den Ressourcenteil der Verbindung hoch.
   
2. Wählen Sie die Authentifizierungsart 'Bearer'.
   
3. Geben Sie die folgenden Informationen ein:

   Eigenschaft	Details
   x509 Privater Schlüssel	Geben Sie den Namen des hochgeladenen privaten Schlüssels genau so ein, wie er in den Verbindungsressourcen angezeigt wird.
   Kennwort	Geben Sie das Kennwort für den privaten Schlüssel ein. Lassen Sie dieses Feld leer, wenn Ihr Schlüssel nicht passwortgeschützt ist.
   Kunden-ID	Geben Sie die Client-ID des JWT Bearer Grant API-Clients ein.
   Integrationsdienst-Benutzer	Geben Sie den Namen des Integrationsdienst-Benutzers (ISU) ein, der mit dem API-Client verbunden ist.
   Host	Geben Sie den Host der Workday-Umgebung ein, mit der eine Verbindung hergestellt werden soll. In der URL der Umgebung stellen die Zeichen vor der Eigenschaft Domain den Host dar.
   Mieter	Geben Sie den Workday-Mandanten ein, mit dem eine Verbindung hergestellt werden soll.
   Bereich	Geben Sie die Domäne der Workday-Umgebung ein, mit der eine Verbindung hergestellt werden soll, z. B. workday.com oder myworkday.com.

Sobald Sie die Authentifizierung eingerichtet haben:

1. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
2. Um die Verbindung zu testen, erstellen Sie eine Kette mit dem Befehl Exportversionen des Konnektors und führen Sie sie aus und überprüfen Sie, ob sie eine gültige Ausgabe liefert.

Fehlersuche

Wenn die Verbindung zu Workday Adaptive Planning fehlschlägt:

• Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers.
• Stellen Sie sicher, dass die Rolle des Integrationsbenutzers über die entsprechenden Berechtigungen für die Befehle verfügt, die der Connector ausführt.
• Wenn der Integrationsbenutzer auf mehrere Instanzen von Adaptive Planning zugreifen kann, überprüfen Sie den für den Connector eingegebenen Instanzcode.

Weitere Informationen zu Adaptive Planning API-Anfragen mit Workday-Anmeldeinformationen finden Sie auf dieser Workday-Seite: Adaptive Planning API-Anfragen mit Workday-Anmeldeinformationen stellen.