Voraussetzungen
Stellen Sie sicher, dass Sie Administrator Ihres Workday-Kontos sind, bevor Sie beginnen.
Nachdem Sie sich bei Workday angemeldet haben, suchen Sie nach „View API Clients“
Wenn Sie dieses Menüelement nicht sehen, sind Sie kein Administrator des Workday-Kontos.
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
Klicken Sie auf das „Such“-Feld oben und geben Sie „View API Clients“ ein
Klicken Sie auf die Aufgabe „View API Clients“, die gerade erschienen ist
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}.
Fügen Sie einen Integrationssystembenutzer (ISU) hinzu
Klicken Sie auf das „Such“-Feld oben und geben Sie „Create Integration System User“ ein
Klicken Sie auf die Aufgabe „Create Integration System User“, die gerade erschienen ist
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.Klicken Sie am unteren Rand des Dialogs auf „OK“
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.
Suchen Sie nach der Aufgabe „Maintain Password Rules“ in der oberen Leiste:
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
Klicken Sie auf das „Such“-Feld oben und geben Sie „Create Security Group“ ein
Klicken Sie auf die Aufgabe „Create Security Group“, die gerade erschienen ist
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
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)
Klicken Sie am unteren Rand der Seite auf „OK“
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“)
Klicken Sie anschließend auf „OK“
Fügen Sie die erforderlichen Berechtigungen zur Sicherheitsgruppe hinzu
Klicken Sie auf das „Such“-Feld oben und geben Sie „Maintain Permission for Security Group“ ein
Klicken Sie auf die Aufgabe „Maintain Permission for Security Group“, die gerade erschienen ist
Stellen Sie im gerade erschienenen Fenster sicher, dass die Option „Maintain“ ausgewählt ist
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.
Klicken Sie auf „OK“
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.
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:
Stellen Sie sicher, dass der Tab „Domain Security Policy Permissions“ ausgewählt ist
Klicken Sie auf das Symbol mit dem „+“
Klicken Sie auf die Zelle in der Spalte „View/Modify Access“
Wenn bei der Berechtigung „Get:“ steht, wählen Sie „Get Only“. Andernfalls wählen Sie „Get and Put“Klicken Sie auf die Zelle in der Spalte „Domain Security Policy“,
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
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.
Klicken Sie auf das „Such“-Feld oben und geben Sie „Activate Pending Security Policy Changes“ ein
Klicken Sie auf die Aufgabe „Activate Pending Security Policy Changes“, die gerade erschienen ist
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“
Klicken Sie auf „OK“
Aktivieren Sie im neuen Fenster das Kontrollkästchen „Confirm“
Klicken Sie auf „OK“
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.
Klicken Sie auf das „Such“-Feld oben und geben Sie „Register API Client for Integrations“ ein
Klicken Sie auf die Aufgabe „Register API Client for Integrations“, die gerade erschienen ist
Geben Sie im gerade erschienenen Fenster einen „Client Name“ ein, z. B. „test_isu API client“
Stellen Sie sicher, dass die Option „Non-Expiring Refresh Tokens“ aktiviert ist
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.
Klicken Sie auf „OK“
Bitte beachten Sie: Die oben genannten Bereiche sind ein Beispiel. Bitte verwenden Sie die Berechtigungen, die im Verbindungsfluss angefordert werden.
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“
Klicken Sie, noch auf derselben Seite, oben auf die drei Punkte und dann auf „API Client“ > „Manage Refresh Tokens for Integrations“
Geben Sie im neuen Fenster den Namen des zuvor von Ihnen erstellten ISU ein
Klicken Sie auf „OK“
Aktivieren Sie im neuen Fenster das Kontrollkästchen für „Generate New Refresh Token“
Klicken Sie auf „OK“
Kopieren Sie im neuen Fenster das Refresh-Token und speichern Sie es für die spätere Verwendung
Fehlerbehebung bei Problemen mit „Invalid username or password!“
Wenn beim Einloggen der Fehler „Invalid username or password!“ auftritt, versuchen Sie Folgendes:
Suchen Sie in der oberen Leiste nach „Manage Authentication Policies“.
Klicken Sie neben der Richtlinie auf „Edit“
Erstellen Sie eine neue „Authentication Rule“, indem Sie oben links auf das + klicken
Weisen Sie dieser neuen Regel die zuvor erstellte Security Group zu und geben Sie der Regel einen passenden Namen.
Klicken Sie auf das + neben „Authentication Condition Name“ und geben Sie einen passenden Namen ein.
Stellen Sie sicher, dass „Allowed Authentication Types“ entweder auf „Specific: User Name Password“ oder auf „Any“ gesetzt ist.
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.) |
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. |
Get Only | Worker Data: Workers | Abrufen von Mitarbeiterdaten aus den Webdiensten von Workday |
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.
