Workiva Support Center

Hinweis: Dieser von Workiva entwickelte Konnektor ermöglicht es Ihnen, die Plattformen Workiva und Workday zu verbinden. Der Workiva-Support hilft Ihnen gerne bei der Konfiguration des Konnektors in Ihrem Arbeitsbereich. Fehler in der Workday-Plattform oder deren Behebung müssen jedoch von Ihrem Workday-Administrator oder dessen Support-Team behandelt werden.

Mit dem Workday-Konnektor können Sie die Befehle in einer Kette verwenden, um mit Workday® HR und Financials zu interagieren:

• Benutzerdefinierte Berichte von Workday herunterladen
• Budgetdaten in Workday importieren
• Starten Sie eine Workday Enterprise Interface Builder (EIB) Integration

Anforderungen

Um die Verbindung herzustellen, benötigen Sie:

• Der Workday-Mandant, mit dem eine Verbindung hergestellt werden soll.
• Der Host und die Domäne der Workday-Umgebung, mit der eine Verbindung hergestellt werden soll.
• Die Anmeldedaten eines in Workday angelegten Benutzers des Integrationssystems.

Schritt 1: Rufen Sie die Workday-Tenant-Informationen ab

Sie können die Mieter-, Host- und Domäneninformationen aus der WSDL XML-Datei des öffentlichen Webdienstes von Workday abrufen.

1. Geben Sie "Öffentliche Webdienste" in die Workday-Suchleiste ein und wählen Sie diesen Bericht aus.
2. Suchen Sie den Web Service für die jeweilige Integration, die Sie verwenden.
   Beispiele hierfür sind: Personalbesetzung für „Get Workers“, Finanzmanagement für „Import Budget“, Integrationen für EIB-bezogene Befehle, …
3. Klicken Sie auf die Schaltfläche „Related Actions“ (Zugehörige Aktionen) dieses Dienstes und wählen Sie anschließend im Menü „Web Service“ die Option „ “ (WSDL anzeigen) unter „ “ (WSDL-Anzeige) aus.
4. Suchen Sie in der XML-Datei das Element soapbind:address (dieses befindet sich in der Regel am Ende der Datei).
5. Extrahieren Sie anhand der URL aus dem Attribut „ “ unter die Informationen zu Mandant, Host und Domäne aus der URL.
   Die URL hat das folgende Format:
   https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number

Beispiel

Anhand des oben genannten Formats können wir den Mandanten, den Host und die Domäne aus einer Beispiel-WSDL-URL ermitteln:
https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1

Diese Werte benötigen Sie, wenn Sie Ihren Konnektor im nächsten Schritt einrichten.

Schritt 2: Workday-Authentifizierung konfigurieren

Dieser Konnektor bietet zwei Möglichkeiten zur Authentifizierung: OAuth2 über die API und Benutzername + Passwort. 

OAuth2-API-Authentifizierung

Wenn Sie die OAuth2-API-Authentifizierung von nutzen, müssen Sie in Workday einen API-Client eingerichtet haben. Anleitungen zum Erstellen eines API-Clients finden Sie auf der Workday-Support-Seite unter sowie unter „API-Clients registrieren“ ( ). 

Stellen Sie im Rahmen dieser API-Client-Konfiguration sicher, dass Sie über Folgendes verfügen:

• Als „ “ wurde „Bearer“ und als „ Access Token Type“ ausgewählt.
• Die folgenden Kontrollkästchen wurden aktiviert (markiert):
  • Unbefristete Aktualisierungstoken
  • Umfang von Workday einbeziehen

Weiterleitungs-URLs

Workiva verfügt über regionsspezifische URLs zur Überschreibung der Verbindungseinstellungen für die Konfiguration von Konnektoren.  Wählen Sie anhand der folgenden Tabelle die richtige URL für Ihren Standort aus.

OAuth2-Endpunkte

Wenn Sie OAuth2 zur Überprüfung Ihrer Verbindung verwenden, benötigen Sie die folgenden Endpunktwerte. Diese werden angezeigt, wenn Sie den Workday-API-Client auf der Seite „ : API-Client bearbeiten“ ( ) in Workday einrichten.

TIPP: Wenn Sie eine bestehende API-Client-Instanz verwenden, die ein OAuth2-Token und einen geheimen Schlüssel nutzt, finden Sie diese Informationen oben auf der Seite „Workday View API“ unter.

Basisauthentifizierung 

Wenn Sie die Basisauthentifizierung von „ “ verwenden, finden Sie auf der Workday-SupportseiteAnweisungen zum Erstellen eines Integration System User (ISU)-Kontos in Workday unter.

Schritt 3: Richten Sie den Workday-Konnektor ein

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. Gehen Sie auf Chain Builder, klicken Sie auf „ “ (Verbindungen) compare_arrows und anschließend oben rechts auf „ “ (Erstellen).
2. Wählen Sie unter „ -Connector-Verbindung“ () den „ -Workday-Connector“ ( ) und den Standard-CloudRunner aus.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
   

4. Geben Sie unter Eigenschaften die Details der Verbindung ein.
   Wenn Sie OAuth2 verwenden, müssen Sie die Werte für „ “ (Workday-REST-Endpunkt), „ “ (Workday-OAuth2-Token-Endpunkt) und „ “ (Workday-OAuth2-Autorisierungsendpunkt) eingeben.
    Wenn Sie die „ “-Basisauthentifizierung (Benutzername+Passwort) verwenden, lassen Sie diese Felder leer.

   

   Feld	Inhalt
   Mieter	Der Workday-Mandant, mit dem eine Verbindung hergestellt werden soll.
   Host	Der Host der Workday-Umgebung, zu der eine Verbindung hergestellt werden soll. In der URL der Umgebung stellen die Zeichen vor der Eigenschaft „ Domain “ den Host dar.
   Bereich	Die Domäne der Workday-Umgebung, mit der eine Verbindung hergestellt werden soll: , z. B. workday.com, oder myworkday.com,.
   Workday-REST-Endpunkt	Die von Workday bereitgestellte URL des REST-Endpunkts. (Nur bei Verwendung der OAuth2-Authentifizierung.)
   Workday-OAuth2-Token-Endpunkt	Die von Workday bereitgestellte URL des OAuth2-Token-Endpunkts. (Nur bei Verwendung der OAuth2-Authentifizierung.)
   Workday-OAuth2-Autorisierungsendpunkt	Die von Workday bereitgestellte URL des OAuth2-Endpunkts.  (Nur bei Verwendung der OAuth2-Authentifizierung.)

Fehlersuche

Wenn die Verbindung zu Workday fehlschlägt:

• Überprüfen Sie, ob die Authentifizierungsdaten des Benutzers des Integrationssystems korrekt sind.
• Stellen Sie sicher, dass der Benutzer des Integrationssystems über die erforderlichen Berechtigungen verfügt, um auf die Funktionsgruppen und Domänen zuzugreifen, die mit den Befehlen der Verbindung in Zusammenhang stehen.
• Stellen Sie sicher, dass für den Konnektor der richtige Workday-Tenant, der richtige Host und die richtige Domäne eingegeben wurden.
• Wenn Sie den Befehl Benutzerdefinierten Bericht herunterladen ausführen, stellen Sie sicher, dass der Berichtstyp auf Erweitert eingestellt ist. Zusammengestellte Berichte sind derzeit nicht über die Workday-API verfügbar.