Workday-Connector in Jitterbit Studio

Zusammenfassung

Der Workday-Connector stellt Zugriff auf Workday her.

Der Workday-Connector bietet eine Schnittstelle zum Erstellen einer Workday-Verbindung, die Grundlage für die Generierung von Workday-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Workday.

Der Workday-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst verwendet, um eine Workday-Verbindung zu konfigurieren, die Zugriff auf ein Konto auf dem Workday-Server herstellt, und dann zur Konfiguration einer oder mehrerer Workday-Aktivitäten, die dieser Verbindung zugeordnet sind, als Quelle oder Ziel innerhalb einer Operation.

Operationen in den Workday Web Services (WWS) API-Versionen 32.0 bis 45.1 werden in diese Aktivitäten kategorisiert:

• Add
• Adjust
• Assign
• Cancel
• Change
• Close
• Contract
• Create
• Edit
• Enter
• Get
• Import
• Manage
• Put
• Remove
• Request
• Set
• Submit
• Other

Die Operationen jedes Webservices werden auf Basis des Starttokens der Operation unter diese Aktivitäten kategorisiert. Beispiele:

• Die Operation Add_Additional_Job des Webservices Staffing befindet sich in der Aktivität Add.

• Die Operation Put_Carryover_Override des Webservices Absence_Management befindet sich in der Aktivität Put.

Operationen, die nicht durch die obige Kategorisierung abgedeckt werden (Operationen, deren Starttoken nicht oben aufgeführt ist), wie z. B. die Operationen Start_International_Assignment oder Switch_Primary_Job aus dem Webservice Staffing, sind in der Aktivität Other verfügbar.

Aktivitäten

In dieser Dokumentation wird nur eine generische Workday-Aktivität dokumentiert, da jede Aktivität ein ähnliches Design hat.

• Workday-Aktivität: Eine Workday-Aktivität ruft Daten aus einem ausgewählten Workday-Webservice ab und/oder sendet Daten an diesen und wird als Quelle oder Ziel in einer Operation verwendet.

Zusammen werden ein spezifischer Workday-Connector und seine Aktivitäten als Workday-Endpunkt bezeichnet. Nach der Konfiguration einer Verbindung sind die dem Endpunkt zugeordneten Aktivitäten über den Filter Endpoints verfügbar:

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update organization policy aussetzen.

Um sich mit dem Workday-Server zu verbinden, wenden Sie sich an den Workday-Administrator, um die erforderlichen Anmeldedaten zu erhalten:

• Workday-Host (dies ist eine URL wie https://example.workday.com/)
• Workday-Mandant
• Workday-Benutzername
• Workday-Passwort

Dieser Connector unterstützt die 2-legged OAuth 2.0-Authentifizierung. Weitere Informationen zur Konfiguration der Workday-Instanz finden Sie unter Workday OAuth-Voraussetzungen.

Der Workday-Connector verwendet die Workday Web Services (wws) API WSDL-Versionen 32.0 bis 45.1, je nach der in einer Workday-Verbindung ausgewählten Version. Weitere Informationen zu den Schemafeldern finden Sie in der API-Dokumentation.

Einschränkungen

Einige Versionen des Workday WSDL geben zwar Fehler zurück, wenn versucht wird, Daten für bestimmte Services abzurufen, obwohl sie von einer Workday-Verbindung unterstützt werden. Diese sind unten aufgeführt:

Die Unfähigkeit, Daten für diese Services abzurufen, ist auf ein Problem in der von Workday bereitgestellten WSDL-Definition zurückzuführen. Falls Sie diese Services verwenden müssen, empfiehlt Jitterbit, eine Workday WSDL-Version früher als v42.0 oder später als v42.1 zu verwenden, wo das Problem nicht vorhanden ist. Die Versionen 32.0 bis 45.1 werden unterstützt.

Fehlerbehebung

Falls Sie Probleme mit dem Workday-Connector haben, werden diese Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update organization policy verwendet wird).

2. Überprüfen Sie die Operationsprotokolle auf alle während der Ausführung der Operation geschriebenen Informationen.

3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

4. Falls Sie private Agenten verwenden, können Sie das ausführliche Logging für Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten einfügen:

   <logger name="org.jitterbit.connector.workday" level="DEBUG"/>
   

   Weitere Informationen zum ausführlichen Logging für Connectors finden Sie unter Ausführliches Logging für Connectors mit Jitterbit-Privatagenten.

5. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle für weitere Informationen überprüfen.

6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation-Fehlerbehebung.

7. Informationen zu Problemen und Lösungen, die speziell für den Workday-Connector gelten, finden Sie im Leitfaden Connector-Fehlerbehebung:

   • Workday: WSDL v42.0 und v42.1 geben Fehler für bestimmte Services zurück
   • Workday: Verbindungstest schlägt mit „The task submitted is not authorized" fehl

Zusätzliche Ressourcen

Ein Jitterbit-Microlearning-Tutorial für Workday zu FTP ist über unsere Jitterbit-Grundlagen-Videoserie verfügbar, erstellt von Jitterbit University.