Zum Hauptinhalt springen

Workday HRIS Integration (Standard)

Wie integriere ich mein Workday?

Verfasst von David William

Voraussetzungen

  • Stellen Sie sicher, dass Sie Administrator Ihres Workday-Kontos sind, bevor Sie beginnen.

    1. Nachdem Sie sich bei Workday angemeldet haben, suchen Sie nach „View API Clients“

    2. Wenn Sie dieses Menüelement nicht sehen, sind Sie kein Administrator des Workday-Kontos.
      ​

      Workday_find_Service_URL.png
    3. Wenn Sie dieses Menüelement nicht sehen, finden Sie heraus, wer Ihr Workday-Administrator ist, und bitten Sie ihn, Ihrem Konto ausreichende Berechtigungen zu erteilen oder den Integrationsprozess zu übernehmen.

Übersicht

Geschätzte Gesamteinrichtungszeit: 30 Minuten.
​

Grundsätzlich gibt es 3 Hauptschritte, die Sie abschließen müssen, um die Integration einzurichten:

1. Sie müssen einen neuen Integrationssystembenutzer und eine Sicherheitsgruppe für diesen Benutzer erstellen,

2. Sie müssen die erforderlichen Berechtigungen der Sicherheitsgruppe zuweisen und die Änderungen aktivieren,

3. (Optional, selten erforderlich: Sie müssen einen neuen API-Client erstellen.)
​

Das war's! Der Rest dieses Dokuments ist eine Schritt-für-Schritt-Anleitung zu allem, was Sie wissen und tun müssen, um die Integration einzurichten.

Finden Sie Ihre Workday Service-URL

  1. Klicken Sie auf das „Such“-Feld oben und geben Sie „View API Clients“ ein

  2. Klicken Sie auf die Aufgabe „View API Clients“, die gerade erschienen ist

    Workday_find_Service_URL.png

  3. Suchen und kopieren Sie am oberen Rand der gerade erschienenen Seite den „Workday REST API Endpoint“.
    Die URL sollte folgendem Schema entsprechen: https://{domain}/ccx/api/v1/{tenant}.

    Workday_see_Service_URL.png

Fügen Sie einen Integrationssystembenutzer (ISU) hinzu

  1. Klicken Sie auf das „Such“-Feld oben und geben Sie „Create Integration System User“ ein

  2. Klicken Sie auf die Aufgabe „Create Integration System User“, die gerade erschienen ist

    Workday_create_ISU.png

  3. Geben Sie im Dialog, der sich gerade geöffnet hat, einen Benutzernamen ein und generieren Sie ein sicheres Passwort.
    Die anderen Felder können Sie unverändert lassen.

  4. Klicken Sie am unteren Rand des Dialogs auf „OK“

    Workday_configure_ISU.png

Fügen Sie den ISU Ihrer Liste der Systembenutzer hinzu

Auch wenn der neu erstellte ISU für die Verknüpfung Ihres Workday-Kontos funktioniert, läuft sein Passwort nach einiger Zeit ab, sofern Sie ihn nicht Ihrer Liste der Systembenutzer hinzufügen.

  1. Suchen Sie nach der Aufgabe „Maintain Password Rules“ in der oberen Leiste:
    ​

  2. Fügen Sie anschließend Ihren erstellten ISU zur Liste „System Users exempt from password expiration“ hinzu

Erstellen Sie eine Sicherheitsgruppe und weisen Sie dem ISU diese zu

  1. Klicken Sie auf das „Such“-Feld oben und geben Sie „Create Security Group“ ein

  2. Klicken Sie auf die Aufgabe „Create Security Group“, die gerade erschienen ist

    Workday_create_security_group.png

  3. Suchen Sie auf der gerade erschienenen Seite das Dropdown-Menü „Type of Tenanted Security Group“ und wählen Sie „Integration System Security Group (Unconstrained)“ aus

  4. Geben Sie für den „Name“ den Wert des „User Name“ ein, den Sie zuvor beim Erstellen des ISU verwendet haben (in diesem Fall wäre es test_isu, Ihrer wird jedoch anders lauten)

  5. Klicken Sie am unteren Rand der Seite auf „OK“

    Workday_configure_security_group.png

  6. Auf der nächsten Seite müssen Sie nur noch zum Feld „Integration System Users“ gehen und den zuvor von Ihnen erstellten Benutzer hinzufügen. Dazu klicken Sie auf das Feld und geben den Namen des ISU ein (in diesem Fall „test_isu“)

  7. Klicken Sie anschließend auf „OK“

    Workday_edit_security_group.png

Fügen Sie die erforderlichen Berechtigungen zur Sicherheitsgruppe hinzu

  1. Klicken Sie auf das „Such“-Feld oben und geben Sie „Maintain Permission for Security Group“ ein

  2. Klicken Sie auf die Aufgabe „Maintain Permission for Security Group“, die gerade erschienen ist

    Workday_maintain_permissions_of_security_gruop.png

  3. Stellen Sie im gerade erschienenen Fenster sicher, dass die Option „Maintain“ ausgewählt ist

  4. Klicken Sie auf das Feld „Source Security Group“, geben Sie den Namen der Gruppe ein (in diesem Fall test_isu) und drücken Sie die Eingabetaste. Klicken Sie anschließend auf die Sicherheitsgruppe, um sie auszuwählen.

  5. Klicken Sie auf „OK“

    Workday_select_security_group_to_maintain.png

  6. Im gerade erschienenen Fenster können Sie die gewünschten Berechtigungen für den ISU hinzufügen. Die Liste der benötigten Berechtigungen finden Sie im Verbindungsfluss.

    Workday


    ​Hinweis: Die Liste der Berechtigungen hier ist nur ein Beispiel. Bitte prüfen Sie Ihre eigenen Berechtigungen im Verbindungsfluss.
    ​
    ​Wiederholen Sie für jede Berechtigung den folgenden Vorgang:
    ​

    1. Stellen Sie sicher, dass der Tab „Domain Security Policy Permissions“ ausgewählt ist

    2. Klicken Sie auf das Symbol mit dem „+“

      Workday_add_new_domain_security_permission.png

    3. Klicken Sie auf die Zelle in der Spalte „View/Modify Access“

      Workday


      Wenn bei der Berechtigung „Get:“ steht, wählen Sie „Get Only“. Andernfalls wählen Sie „Get and Put“

      Workday

    4. Klicken Sie auf die Zelle in der Spalte „Domain Security Policy“,

      Workday


      geben Sie den Namen der Richtlinie ein (z. B. „Integration: Build“), drücken Sie die Eingabetaste und klicken Sie auf den Eintrag, der gerade in einer Liste erschienen ist

      Workday

Aktivieren Sie Ihre Änderungen

Nachdem Sie Änderungen an Ihren Workday-Sicherheitsrichtlinien vorgenommen haben, stellen Sie sicher, dass Sie diese Änderungen übernehmen, indem Sie die Aufgabe „Activate Pending Security Policy Changes“ ausführen. Andernfalls werden Ihre Änderungen nicht wirksam.

  1. Klicken Sie auf das „Such“-Feld oben und geben Sie „Activate Pending Security Policy Changes“ ein

  2. Klicken Sie auf die Aufgabe „Activate Pending Security Policy Changes“, die gerade erschienen ist

    Workday_activate_pending_security_changes_task.png

  3. Fügen Sie im gerade erschienenen Fenster einen Kommentar für die Anwendung der Änderungen hinzu (z. B. „Grant ISU test_isu necessary permissions for integrations“

  4. Klicken Sie auf „OK“

    Workday_activate_pending_security_task_comment.png

  5. Aktivieren Sie im neuen Fenster das Kontrollkästchen „Confirm“

  6. Klicken Sie auf „OK“

    Workday_activate_pending_security_policy_changes_confirm.png

Erstellen Sie einen API-Client

Hinweis: Der folgende Abschnitt ist nicht immer erforderlich! Bitte lesen Sie das Folgende sorgfältig, bevor Sie fortfahren. Dieser Schritt ist nur erforderlich, wenn Sie Folgendes tun möchten:

  • HRIS: Wenn Sie Abwesenheitsdaten (Urlaub) lesen/schreiben oder benutzerdefinierte Mitarbeiterobjekte aus Ihrer Workday-Instanz lesen/schreiben möchten.

  • ATS: Wenn Sie Angebote oder Screening-Fragedaten aus Ihrer Workday-Instanz lesen möchten.

In allen anderen Fällen können Sie die folgenden Schritte überspringen.

  1. Klicken Sie auf das „Such“-Feld oben und geben Sie „Register API Client for Integrations“ ein

  2. Klicken Sie auf die Aufgabe „Register API Client for Integrations“, die gerade erschienen ist

    Workday_create_API_client_task.png

  3. Geben Sie im gerade erschienenen Fenster einen „Client Name“ ein, z. B. „test_isu API client“

  4. Stellen Sie sicher, dass die Option „Non-Expiring Refresh Tokens“ aktiviert ist

  5. Geben Sie für das Feld „Scope (Functional Areas)“ die Werte ein, die Ihnen im Verbindungsfluss angezeigt werden.
    ​
    Für ATS -Integrationen werden unter anderem folgende Bereiche benötigt:
    ​- „Recruiting“, „Tenant Non-Configurable“, „Adaptive Planning for the Workforce“ usw...
    - Bitte verwenden Sie nicht die oben genannten Berechtigungen. Alle relevanten Berechtigungen werden in Ihrem Verbindungsfluss aufgeführt.

    ​
    Für HRIS-Integrationen werden unter anderem folgende Bereiche benötigt:
    ​- „Tenant Non-Configurable“, „Staffing“, „Time Off and Leave“ usw...
    - Bitte verwenden Sie nicht die oben genannten Berechtigungen. Alle relevanten Berechtigungen werden in Ihrem Verbindungsfluss aufgeführt.
    ​

  6. Klicken Sie auf „OK“


    ​Bitte beachten Sie: Die oben genannten Bereiche sind ein Beispiel. Bitte verwenden Sie die Berechtigungen, die im Verbindungsfluss angefordert werden.
    ​

  7. Kopieren Sie im neuen Fenster die Client ID und das Client Secret für die spätere Verwendung und klicken Sie anschließend nicht auf „Done“

    Workday_create_API_client_show_token.png

  8. Klicken Sie, noch auf derselben Seite, oben auf die drei Punkte und dann auf „API Client“ > „Manage Refresh Tokens for Integrations“

    Workday_create_API_client_find_manage_refresh_token.png

  9. Geben Sie im neuen Fenster den Namen des zuvor von Ihnen erstellten ISU ein

  10. Klicken Sie auf „OK“

    Workday_create_API_client_refresh_token_for_ISU.png

  11. Aktivieren Sie im neuen Fenster das Kontrollkästchen für „Generate New Refresh Token“

  12. Klicken Sie auf „OK“

    Workday_create_API_client_confirm_regenerate_refresh_token.png

  13. Kopieren Sie im neuen Fenster das Refresh-Token und speichern Sie es für die spätere Verwendung

    Workday_create_API_client_show_refresh_token.png

Fehlerbehebung bei Problemen mit „Invalid username or password!“

Wenn beim Einloggen der Fehler „Invalid username or password!“ auftritt, versuchen Sie Folgendes:

  1. Suchen Sie in der oberen Leiste nach „Manage Authentication Policies“.

  2. Klicken Sie neben der Richtlinie auf „Edit“

  3. Erstellen Sie eine neue „Authentication Rule“, indem Sie oben links auf das + klicken

  4. Weisen Sie dieser neuen Regel die zuvor erstellte Security Group zu und geben Sie der Regel einen passenden Namen.

  5. Klicken Sie auf das + neben „Authentication Condition Name“ und geben Sie einen passenden Namen ein.

  6. Stellen Sie sicher, dass „Allowed Authentication Types“ entweder auf „Specific: User Name Password“ oder auf „Any“ gesetzt ist.

  7. Suchen Sie abschließend in der oberen Leiste nach „Activate All Pending Authentication Policy Changes“ und bestätigen Sie die vorgenommenen Änderungen.

Dokumentation der möglichen Berechtigungen

View/Modify Access

Security

Explanation

Get Only

Worker Data: Public Worker Reports

Lesen öffentlicher Informationen über einen Mitarbeiter. Öffentlich bedeutet, dass jeder Mitarbeiter innerhalb der Organisation diese Informationen über einen anderen Mitarbeiter einsehen kann (z. B. Vorname, Nachname usw.)
Immer erforderlich, wenn Mitarbeiterdaten gelesen werden

Get Only

Worker Data: All Positions

Lesen positionsbezogener Informationen eines Mitarbeiters. Zum Beispiel Vorgesetzter, Standort, Berufsbezeichnung usw. Ermöglicht uns außerdem das Lesen von Statusdaten über den Mitarbeiter.
Immer erforderlich, wenn Mitarbeiterdaten gelesen werden

Get Only

Worker Data: Workers

Abrufen von Mitarbeiterdaten aus den Webdiensten von Workday
Immer erforderlich, wenn Mitarbeiterdaten gelesen werden

Get Only

Person Data: Mobile Phone

Erforderlich, wenn die Mobiltelefonnummer des Mitarbeiters gelesen wird

Get Only

Person Data: Home Address

Erforderlich, wenn die private Wohnadresse des Mitarbeiters gelesen wird

Get Only

Person Data: Date of Birth

Erforderlich, wenn das Geburtsdatum des Mitarbeiters gelesen wird

Get Only

Person Data: Ethnicity

Erforderlich, wenn die ethnische Zugehörigkeit des Mitarbeiters gelesen wird

Get Only

Person Data: Marital Status

Erforderlich, wenn der Familienstand des Mitarbeiters gelesen wird

Get Only

Person Data: Home Email

Erforderlich, wenn die private E-Mail-Adresse des Mitarbeiters gelesen wird

Get Only

Person Data: Work Email

Erforderlich, wenn die geschäftliche E-Mail-Adresse des Mitarbeiters gelesen wird

Get Only

Person Data: Gender

Erforderlich, wenn das Geschlecht des Mitarbeiters gelesen wird

Get Only

Person Data: ID Information

Erforderlich, wenn Kennungen wie Sozialversicherungsnummer und nationale ID gelesen werden. Wird ausschließlich zum Lesen der Sozialversicherungsnummer verwendet.

Get Only

Worker Data: Current Staffing Information

Erforderlich, wenn Informationen über den Status eines Mitarbeiters gelesen werden. Wird für termination_date, employment_status verwendet.

Get Only

Worker Data: Employment Data

Erforderlich, wenn beschäftigungsbezogene Daten gelesen werden. Wird für termination_date, employment_status verwendet.

Get Only

Worker Data: Compensation by Organization

Erforderlich, wenn Vergütungsdaten für Mitarbeiter gelesen werden. Wird für pay_currency, pay_period und pay_rate in Beschäftigungsverhältnissen verwendet.

Get Only

Worker Data: Current Staffing Information

Erforderlich, wenn Informationen über den Status eines Mitarbeiters gelesen werden. Wird verwendet, um termination_date zu bestimmen.

Get Only

Worker Data: Employment Data

Erforderlich, wenn beschäftigungsbezogene Daten gelesen werden.

Get Only

Manage: Organization Integration

Erforderlich, wenn Gruppendaten (Kostenstellen und Unternehmen) gelesen werden

Get Only

Worker Data: Organization Information

Erforderlich, wenn gelesen wird, welcher Mitarbeiter zu welcher Gruppe (Kostenstellen, Abteilungen und Unternehmen) gehört

Get Only

Manage: Location

Erforderlich, wenn Arbeitsorte gelesen werden

Es gibt drei Optionen zur Konfiguration der Integration

1. Mitarbeiter einladen

Mit dieser Option können Sie festlegen, ob Mitarbeiter automatisch zu WorkFlex eingeladen werden, sobald sie im HRIS hinzugefügt werden. Ist diese Option aktiviert, werden bestehende und neue Mitarbeiter automatisch zu WorkFlex eingeladen. Ist sie deaktiviert, müssen Sie Mitarbeiter nach Abschluss der Integration manuell in WorkFlex importieren.

2. Profildaten der Mitarbeiter synchronisieren

Diese Option stellt sicher, dass die Profilinformationen der Mitarbeiter stets aktuell sind, indem die Profilfelder automatisch ausgefüllt und aktualisiert werden.

3. Mitarbeiter deaktivieren

Mit dieser Option können Sie das Profil eines Mitarbeiters auf WorkFlex automatisch deaktivieren, sobald dieser in Ihrem HRIS deaktiviert wird.

Wie Sie Ihre Mitarbeiter manuell aus Workday importieren und zu WorkFlex einladen

So importieren Sie Mitarbeiter:

  • Sie können die Schaltfläche „Mitarbeiter einladen“ in der Mitarbeiterverwaltung verwenden.

  • Es erscheint ein Dropdown-Menü, in dem Sie die Option „Mitarbeiter von Workday einladen“ auswählen können.

  • Wählen Sie anschließend die Mitarbeiter aus, die Sie hinzufügen möchten, und klicken Sie auf „Einladen“.

Wichtige Informationen zur Datensynchronisierung zwischen Workday und WorkFlex

Der minimale Datensatz, der aus Workday abgerufen wird, umfasst Vorname, Nachname, Status, Beschäftigungsart und E-Mail-Adresse.

Zusätzlich zu den erforderlichen Feldern können Sie auch weitere Daten zwischen Workday und WorkFlex synchronisieren. Dazu gehören unter anderem folgende Felder:

→ Sozialversicherungsnummer des Mitarbeiters

→ Geschlecht

→ Geburtsdatum

→ Wohnadresse

→ Jobtitel

→ Abteilung

→ Einstellungsdatum

→ E-Mail-Adresse des Vorgesetzten

Wenn Sie zusätzliche Informationen oder Datenfelder über die Standardfelder hinaus benötigen, können Sie Custom Fields verwenden. Mit diesen Feldern können Sie neue, nicht standardmäßige Datenfelder zu Ihrer HRIS-Plattform hinzufügen. Damit diese neuen Custom Fields über den API-Schlüssel verfügbar gemacht werden, folgen Sie der Anleitung in diesem Guide. Falls Sie sich für die Verwendung von Custom Fields entscheiden, informieren Sie bitte vorab das Customer-Success-Team von WorkFlex.

Um Daten für diese Felder zu synchronisieren, müssen Sie die Option „Profildaten der Mitarbeiter synchronisieren“ aktivieren und diese Felder in Ihren Workday-API-Zugangsdaten freischalten. Diese Funktion kann Zeit und Aufwand sparen, um die Mitarbeiterinformationen in beiden Systemen konsistent zu halten.


​Die Datensynchronisierung zwischen Workday und WorkFlex erfolgt alle vier bis sechs Stunden. Änderungen, die in Workday vorgenommen werden, können daher bis zu drei Stunden benötigen, bis sie in WorkFlex sichtbar sind, und überschreiben dabei stets die entsprechenden Daten in WorkFlex.
​

Nachdem Sie die oben beschriebenen Schritte in Ihrem HRIS abgeschlossen haben, fahren Sie mit Schritt 2 in diesem Guide auf WorkFlex fort.

Hat dies deine Frage beantwortet?