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 Authentifizierungsdaten eines in Workday angelegten Benutzers des Integrationssystems.

Schritt 1: Abrufen der Workday-Mieterinformationen

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: Personaleinsatz für Get Workers, Finanzmanagement für das Importbudget, Integrationen für EIB-bezogene Befehle, ....
3. Klicken Sie auf die Schaltfläche "Verwandte Aktionen" des betreffenden Dienstes und dann im Menü "Webdienst" auf WSDL anzeigen.
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 location die Informationen zu Mieter, Host und Domäne aus der URL.
   Die URL hat das folgende Format:
   https://{host}.{domain}/ccx/service/{mieter}/public_web_service_name/version_number

Beispiel

Mithilfe des obigen Formats können wir den Mieter, den Host und die Domäne anhand einer WSDL-Beispiel-URL ermitteln:
https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1

Sie benötigen diese Werte, wenn Sie im nächsten Schritt Ihren Anschluss einrichten.

Schritt 2: Konfigurieren Sie die Workday-Authentifizierung

Dieser Konnektor bietet zwei Möglichkeiten der Authentifizierung: OAuth2 über API und Benutzer+Passwort. 

OAuth2-API-Authentifizierung

Wenn Sie OAuth2 API-Authentifizierung verwenden, müssen Sie einen API-Client in Workday einrichten. Anweisungen zum Erstellen eines API-Clients finden Sie auf der Workday-Supportseite Register API Clients. 

Vergewissern Sie sich im Rahmen dieser API-Client-Konfiguration, dass Sie über die erforderlichen Informationen verfügen:

• Wählen Sie Bearer als Access Token Type.
• Aktivieren (markieren) Sie die folgenden Kontrollkästchen:
  • Nicht ablaufende Auffrischungsmünzen
  • Workday Owned Scope einbeziehen

Umleitungs-URLs

Workiva verfügt über regionsspezifische Connection Override URLs für Connector-Konfigurationen. Verwenden Sie die folgende Tabelle, um die richtige URL für Ihren Standort auszuwählen.
Wenn Sie sich in Nord-, Mittel- oder Südamerika befinden, verwenden Sie die Standard-URL. Wenn Sie sich in der Region Asien-Pazifik befinden, verwenden Sie die APAC-URL. Wenn Sie sich in der EMEA-Region befinden, verwenden Sie die EU-URL. 

OAuth2-Endpunkte

Wenn Sie OAuth2 zur Verifizierung Ihrer Verbindung verwenden, benötigen Sie die folgenden Endpunktwerte. Diese werden aufgelistet, wenn Sie den Workday-API-Client auf der Seite API-Client bearbeiten in Workday einrichten.

TIPP: Wenn Sie eine vorhandene API-Client-Instanz verwenden, die ein OAuth2-Token und ein Geheimnis verwendet, können Sie diese Informationen oben auf der Seite Workday View API sehen.

Grundlegende Authentifizierung

Wenn Sie Basic Authentication verwenden, finden Sie auf der Workday-Supportseite Create an Integration System User (ISU) account in Workday Anweisungen zum Erstellen eines Integration System User (ISU).

Schritt 3: Einrichten des Workday-Connectors

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

1. Klicken Sie unter Chain Builder auf Connectionscompare_arrows und dann Create oben rechts.
2. Wählen Sie unter Connector Connection, Workday Connector und den Standard-CloudRunner.
   
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 Endpoint, Workday OAuth2 Token Endpoint, und Workday OAuth2 Authorization Endpoint eingeben.
   Wenn Sie Basic Authentication (Benutzername+Kennwort) 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 zur Verfügung gestellte URL des REST-Endpunkts. (Nur bei Verwendung der OAuth2-Authentifizierung.)
   Workday OAuth2-Token-Endpunkt	Die von Workday zur Verfügung gestellte URL des OAuth2-Token-Endpunkts. (Nur bei Verwendung der OAuth2-Authentifizierung.)
   Workday OAuth2-Autorisierungsendpunkt	Die von Workday zur Verfügung gestellte OAuth2-Endpunkt-URL. (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.
• Vergewissern Sie sich, dass der Benutzer des Integrationssystems über die richtigen Berechtigungen für den Zugriff auf die Funktionsgruppen und Domänen verfügt, die mit den Befehlen der Verbindung verbunden sind.
• Vergewissern Sie sich, dass der richtige Workday-Mandant, Host und die richtige Domäne für den Connector eingegeben wurden.
• Wenn Sie den Befehl Benutzerdefinierten Bericht herunterladen ausführen, stellen Sie sicher, dass der Berichtstyp auf Erweitert eingestellt ist. Zusammengesetzte Berichte sind zur Zeit nicht über die Workday-API verfügbar.