Zum Inhalt springen

Workday-Connector für Jitterbit Studio

Zusammenfassung

Der Workday-Connector ermöglicht den Zugriff auf Workday.

Der Workday-Connector bietet eine Schnittstelle zur Erstellung einer Workday-Verbindung, die als Grundlage für die Generierung von Instanzen von Workday-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Workday.

Der Workday-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Hinweis

Integrationsrezepte und Prozessvorlagen sind über den Jitterbit Marketplace für diesen Connector verfügbar.

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Workday-Verbindung zu konfigurieren, die den Zugriff auf ein Konto auf dem Workday-Server ermöglicht, und dann, um eine oder mehrere Workday-Aktivitäten zu konfigurieren, die mit dieser Verbindung als Quelle oder Ziel innerhalb eines Vorgangs verbunden sind.

Die Vorgänge in der Workday Web Services (WWS) API der Versionen 32.0 bis 43.0 sind in diese Aktivitäten kategorisiert:

  • Hinzufügen
  • Anpassen
  • Zuweisen
  • Abbrechen
  • Ändern
  • Schließen
  • Vertrag
  • Erstellen
  • Bearbeiten
  • Eingeben
  • Abrufen
  • Importieren
  • Verwalten
  • Einfügen
  • Entfernen
  • Anfordern
  • Festlegen
  • Einreichen
  • Andere

Die Vorgänge jedes Webdienstes sind auf der Grundlage des startenden Tokens des Vorgangs in diese Aktivitäten kategorisiert. Beispiele:

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

Aktivitäten

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

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

Zusammen werden eine spezifische Workday-Verbindung und ihre Aktivitäten als Workday-Endpunkt bezeichnet. Sobald eine Verbindung konfiguriert ist, sind die mit dem Endpunkt verbundenen Aktivitäten über den Endpoints Filter verfügbar:

Connections tab

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in endpoint usage reporting enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Um eine Verbindung mit dem Workday-Server herzustellen, wenden Sie sich an den Workday-Administrator, um die erforderlichen Anmeldeinformationen zu erhalten:

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

Dieser Connector unterstützt die 2-beinige OAuth 2.0-Authentifizierung. Siehe Workday OAuth-Voraussetzungen für Anweisungen zur Konfiguration der Workday-Instanz.

Der Workday-Connector verwendet die Workday-Webdienste (wws) API WSDL-Versionen 32.0 bis 43.0, abhängig von der in einer Workday-Verbindung ausgewählten Version. Weitere Informationen zu den Schemafeldern finden Sie in der API-Dokumentation.

Der Workday-Connector erfordert die Verwendung einer Agent-Version 10.1 oder höher. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Einschränkungen

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

Workday WSDL-Version Nicht verfügbarer Dienst
v42.0 Human_Resources (v42.0)
Resource_Management (v42.0)
v42.1 Human_Resources (v42.1)

Die Unfähigkeit, Daten für diese Dienste abzurufen, ist auf ein Problem in der von Workday bereitgestellten WSDL-Definition zurückzuführen. Wenn Sie diese Dienste nutzen müssen, empfiehlt Jitterbit, eine Workday WSDL-Version zu verwenden, die älter als v42.0 oder neuer als v42.1 ist, da das Problem dort nicht besteht. Die Versionen 32.0 bis 43.0 werden unterstützt.

Fehlerbehebung

Wenn Sie Probleme mit dem Workday-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Test-Schaltfläche in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Auto Connector Update deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

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

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

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

    Weitere Informationen zum ausführlichen Protokollieren des Connectors finden Sie unter Ausführliches Protokollieren für Connectoren, die Jitterbit private Agenten verwenden.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

  6. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Operationen.

Zusätzliche Ressourcen

Ein Jitterbit-Mikrolern-Tutorial für Workday zu FTP ist über unsere Jitterbit-Basics-Video-Serie verfügbar, die von Jitterbit University erstellt wurde.