Workday-Verbindung

Einführung

Eine Workday-Verbindung wird über den Workday-Connector konfiguriert, um Zugriff auf ein Konto auf dem Workday-Server zu erhalten. Sobald eine Verbindung hergestellt ist, können Sie eine oder mehrere Workday-Aktivitäten konfigurieren, die mit dieser Verbindung verbunden sind, um sie als Quelle oder Ziel innerhalb eines Vorgangs zu verwenden.

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

Erstellen oder Bearbeiten einer Workday-Verbindung

Eine neue Workday-Verbindung wird über den Workday-Connector an einem dieser Standorte erstellt:

• Die Registerkarte Projektendpunkte und -connectoren der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene Workday-Verbindung kann an diesen Standorten bearbeitet werden:

• Die Registerkarte Projektendpunkte und -connectoren der Designkomponentenpalette (siehe Designkomponentenpalette).
• Die Registerkarte Komponenten des Projektbereichs (siehe Aktionsmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
• Die Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer Workday-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Workday-Verbindung wird im Folgenden beschrieben.

Die in der Konfiguration der Workday-Verbindung verwendete Schnittstelle hängt vom ausgewählten Authentifizierungstyp ab:

• Basic Auth: Bei dieser Option wird die Verbindung mit einem Benutzernamen und einem Passwort authentifiziert.

• JWT Bearer OAuth: Bei dieser Option wird die Verbindung mit einem 2-beinigen OAuth 2.0 authentifiziert. Informationen zum Erhalt der erforderlichen Anmeldeinformationen finden Sie unter Voraussetzungen.

Basic Auth

Wenn Basic Auth als Authentifizierungstyp ausgewählt ist, wird die nachfolgend beschriebene Schnittstelle angezeigt.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Workday-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Workday-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

• Workday-Host: Geben Sie den Workday-Host ein.

• Mandant: Geben Sie den Mandanten für die Workday-Instanz ein.

• Authentifizierungstyp: Wählen Sie Basic Auth, um sich mit einem Benutzernamen und einem Passwort zu authentifizieren.

• Benutzername: Geben Sie den Benutzernamen für die Workday-Instanz ein.

• Passwort: Geben Sie das Passwort für die Workday-Instanz ein.

• Version: Wählen Sie die Version der Workday Web Services. Die Versionen 32.0 bis 43.0 werden unterstützt.

  Vorsicht

  Die Versionen v42.0 und v42.1 geben Fehler zurück, wenn versucht wird, Daten für bestimmte Dienste abzurufen. Weitere Informationen finden Sie unter Einschränkungen.

• Optionale Einstellungen: Klicken Sie auf das Dreieck, um diese optionale Einstellung anzuzeigen:

  • WSDL-Download-Timeout (in Millisekunden): Geben Sie den Timeout-Wert für den Download des Workday WSDL ein. Der Standard-Timeout-Wert beträgt 15 Sekunden (15000 Millisekunden).

• Proxy-Einstellungen verwenden (nur privater Agent): Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agents zu verwenden.

• Test: Klicken Sie auf diese Schaltfläche, um die Verbindung zu überprüfen. Der Server überprüft nur, ob der angegebene Benutzer eine Verbindung herstellen kann. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.

• Änderungen speichern: Klicken Sie auf diese Schaltfläche, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie auf Änderungen verwerfen, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie auf Löschen, um die Verbindung dauerhaft aus dem Projekt zu entfernen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung).

JWT Bearer OAuth

Wenn JWT Bearer OAuth als Authentifizierungstyp ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Workday-Verbindung einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Workday-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• Workday-Host: Geben Sie den Workday-Host ein.

• Mandant: Geben Sie den Mandanten für die Workday-Instanz ein.

• Authentifizierungstyp: Wählen Sie JWT Bearer OAuth, um sich mit einem 2-beinigen OAuth 2.0 JWT-Bearer-Token zu authentifizieren.

• Client-ID: Geben Sie die Client-ID für den Workday OAuth 2.0-Client ein, wie in Voraussetzungen beschrieben.

• ISU-Benutzername: Geben Sie den Benutzername des Integration System User User Name ein, wie in Voraussetzungen beschrieben.

• Privater Schlüssel: Geben Sie den privaten Schlüssel ein, der in der Datei private.key bereitgestellt wird (wie in Voraussetzungen beschrieben) in folgendem Format:

  -----BEGIN PRIVATE KEY-----
  
  <private key>
  
  -----END PRIVATE KEY-----
  

  Ersetzen Sie <private key> (einschließlich der spitzen Klammern < >) durch den entsprechenden Wert.

• Version: Wählen Sie die Version der Workday Web Services. Die Versionen 32.0 bis 42.0 werden unterstützt.

  Vorsicht

  Es gibt eine Einschränkung bei der Verwendung der Human_resources oder resource_management Dienste mit v42.0. Siehe Einschränkungen für weitere Informationen.

• Optionale Einstellungen: Klicken Sie auf das Dreieck, um diese optionale Einstellung anzuzeigen:

  • WSDL-Download-Timeout (in Millisekunden): Geben Sie den Timeout-Wert für den Download des Workday WSDL ein. Der Standard-Timeout-Wert beträgt 15 Sekunden (15000 Millisekunden).

• Proxy-Einstellungen verwenden (nur privater Agent): Bei der Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agents zu verwenden.

• Test: Klicken Sie auf diese Schaltfläche, um die Verbindung zu überprüfen. Der Server prüft nur, ob der angegebene Benutzer eine Verbindung herstellen kann. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie auf diese Schaltfläche, um die Verbindungs-Konfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie auf Änderungen verwerfen, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie auf Löschen, um die Verbindung dauerhaft aus dem Projekt zu entfernen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung).

Nächste Schritte

Nachdem eine Workday-Verbindung erstellt wurde, sind die Menüaktionen für diese Verbindung im Komponenten-Tab des Projektbereichs zugänglich. Siehe Menü für Verbindungsaktionen für Details.

Nachdem Sie eine Workday-Verbindung konfiguriert haben, können Sie eine oder mehrere Workday-Aktivitäten konfigurieren, die mit dieser Verbindung verbunden sind, um sie als Quelle oder Ziel innerhalb eines Vorgangs zu verwenden. Weitere Informationen finden Sie unter:

• 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 einem Vorgang verwendet.