Herstellen einer Verbindung mit Workday über OAuth

Erstellen Sie in Workday diese Integrationselemente:

Domäne „Integrationssicherheit“
im Funktionsbereich „Integration“.

Benutzer des Integrationssystems.

Sicherheitsgruppe des Integrationssystems.

Sicherheit: Administratorzugriff in Peakon.

Sie können Peakon mit Workday verbinden und übertragene Daten mit OAuth authentifizieren.

Wir empfehlen Ihnen, Stellen Sie mit ISU-Name und -Passwort eine Verbindung zu Workday her, das einfacher einzurichten ist und weniger anfällig für Verbindungsabbrüche aufgrund externer Faktoren ist.

Greifen Sie in Workday auf die Aufgabe

„Mandanten-Setup bearbeiten – Sicherheit

“ zu.

Aktivieren Sie das Kontrollkästchen

„OAuth 2.0-Clients aktiviert“

Greifen Sie noch in Workday auf die Aufgabe

„API-Client registrieren“

zu.

Geben Sie den

Clientnamen

ein und wählen Sie

„Autorisierungscode gewähren“

aus.

Wählen Sie

„Bearer“

als

Zugriffstokentyp

aus und geben Sie die

Umleitungs-URL

ein.

Das Umleitungs-URL-Format lautet https://companyname.peakon.com/workday/complete
. Sie müssen companyname.peakon.com
durch Ihre benutzerdefinierte Subdomäne ersetzen.

Aktivieren Sie das Kontrollkästchen

„Aktualisierungstoken ohne Ablaufdatum“

Wählen Sie diese Funktionsbereiche aus der Eingabeaufforderung

„Umfang (Funktionsbereiche)“

aus:

Kontaktinformationen

Durchführung

Personenbezogene Daten

Öffentliche Daten

Personal

System

Klicken Sie auf

Erfassen Sie die Werte für „

Tenant“

„Webservice Host“

„Client ID“

„Client Secret“

und

„Auth Host“

Der

Workday REST API-Endpunkt

enthält den

Webservice-Host

und den

Tenant

. Beispiel: Wenn der Endpunkt https://wd3-services1.myworkday.com/api/v1/tenant_name
ist, dann ist der

Webservice-Host

wd3-services1.myworkday.com
und der

Mandant

tenant_name
.

Der

Autorisierungsendpunkt

enthält den

Auth-Host

. Beispiel: Wenn der Autorisierungsendpunkt https://wd3.myworkday.com/tenant_name/authorize
ist, ist der

Authentifizierungshost

wd3.myworkday.com
.

Workday beschriftet

Client-ID

und

Client-Geheimnis

entsprechend.

Notieren Sie sich den Wert des

Client-Geheimnisses

, da es nach dem Schließen dieser Seite nicht möglich ist, ihn wiederherzustellen. Dies ist im Falle einer Verbindungsunterbrechung erforderlich.

Öffnen Sie Peakon in einem Inkognito-Fenster, um sich als Peakon-Integrationssystembenutzer (ISU) anzumelden.

Wenn Ihr Unternehmen SSO zur Anmeldung bei Ihren Workday-Mandanten verwendet, verwenden Sie diese URL-Vorlage, um sich als Peakon ISU bei Workday anzumelden: (https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n). <workdayDomain> ist Ihre Workday-Mandantendomäne und <tenant> ist Ihr Workday-Mandantenname.

Durch die Anmeldung über ein Inkognito-Fenster wird sichergestellt, dass die Integration keine Verbindung mit den falschen Anmeldeinformationen für den Workday-Mandanten herstellt, was zu Synchronisierungsproblemen führen würde.

Gehen Sie in Peakon zu

Administration

Integrationen

Workday

Wählen Sie in der Eingabeaufforderung für den

Authentifizierungsmodus

OAuth

aus.

Geben Sie die Werte aus Schritt 9 in diese Felder ein:

Mandant

Webservice-Host

Client-ID

Geheimer Client-Schlüssel

Auth-Host

Klicken Sie auf

Verbinden

Die Synchronisierung ist jetzt aktiv und wird automatisch ausgeführt. Wenn Sie dies verhindern möchten, aber dennoch mit der Einrichtung in Schritt 17 fortfahren möchten, klicken Sie auf

Deaktivieren

(Optional) Melden Sie sich auf der Anmeldeseite als ISU an.

Klicken Sie auf

Zulassen

Konfigurieren Sie die Einstellungen, die jetzt auf der Workday-Integrationsseite auf Peakon angezeigt werden.

Für einige der Optionen ist zusätzlicher Domänensicherheitszugriff erforderlich. Sehen Domänen in Sicherheitsgruppen für die Workday-Integration einrichten.

Option	Beschreibung
Integrationssystem-ID	(Optional) Füllen Sie dieses Feld aus, wenn Sie Feldüberschreibungen erstellen müssen, um benutzerdefinierte Felder zu übertragen oder die PEAKON_INCLUDED -Funktionalität zu verwenden.
Organisations-ID	(Optional) Füllen Sie dieses Feld aus, um nach Mitarbeitern nach Organisation zu filtern. Um Mitarbeiter in mehreren Organisationen zu synchronisieren, trennen Sie die Organisations-IDs durch ein einzelnes Leerzeichen. Wenn Sie eine Organisations-ID zum Filtern eingeben, werden untergeordnete Organisationen automatisch mit einbezogen. Wir empfehlen, dies anstelle der PEAKON_INCLUDED- Funktionalität beim Filtern nach Organisationen zu verwenden, weil: Es ist schwierig, die PEAKON_INCLUDED -Funktionalität so zu konfigurieren, dass sie das Feld „Organisations-ID“ widerspiegelt, und daher liefert die Synchronisierung möglicherweise nicht das gewünschte Ergebnis. Es funktioniert schneller als die PEAKON_INCLUDED -Funktionalität.
Zeitzone	(Optional) Wählen Sie diese Option, um die lokalen Zeitzonen der Mitarbeiter zu synchronisieren. Peakon sendet eine Umfrage an die Mitarbeiter in ihrer lokalen Zeitzone.
Standort	(Optional) Wählen Sie diese Option, um die lokalen Mitarbeitersprachen zu synchronisieren. Peakon verwendet die synchronisierten Sprachen in der Mitarbeiterbefragungskommunikation, wenn diese Sprachen in den Umfrageeinstellungen Ihres Unternehmens aktiviert sind.
Telefonnummer	(Optional) Wählen Sie diese Option, um die Synchronisierungsoptionen für die Telefonnummern der Mitarbeiter anzuzeigen. Beruflich Privat Private Nummern synchronisieren Das Synchronisieren von Telefonnummern ist nützlich, wenn Sie Umfragebenachrichtigungen per SMS senden möchten. Wenn Sie sowohl eine Arbeits- als auch eine Privatnummer auswählen, hat die primäre Arbeitstelefonnummer Vorrang.
Bestimmte Mitarbeiter einbeziehen – basierend auf benutzerdefinierten Kriterien, die in Workday festgelegt wurden	(Optional) Wählen Sie diese Option, um nur bestimmte Mitarbeitergruppen zu synchronisieren. Erstellen Sie zusätzlich zur Aktivierung dieses Kontrollkästchens einen PEAKON_INCLUDED- Feldüberschreibungseintrag im Feldüberschreibungsdienst . Die Quellüberschreibung muss ein boolesches berechnetes Feld sein, das für die Mitarbeiter, die Sie einschließen möchten, „True“ zurückgibt.
Bestimmte Mitarbeiter einbeziehen – Zeitarbeiter	(Optional) Wählen Sie diese Option, um auch Zeitarbeiter einzubeziehen.
Zuordnung nach externer ID (nur wenn die Daten keine doppelten Segmente enthalten)	(Optional) Wählen Sie diese Option aus, um externe IDs mit Segmenten abzugleichen, wenn Sie Attribute von Workday zu Peakon zuordnen. Mit dieser Funktion können Sie eine erweiterte Attributzuordnung verwenden, wenn Sie keine doppelten Segmente haben. Workday ordnet die externen Segment-IDs dieser Attribute Peakon zu: Abteilung Beschäftigungsart Geschlecht Berufsfamilie Führungsebene Trennungsgrund Workday ordnet die externe ID nicht zu, wenn für das Attribut eine Feldüberschreibung vorliegt. Workday erstellt in Peakon kein neues Segment, wenn sich ein Segmentname in Workday ändert. Beispiel: Wenn Sie in Workday den Namen des Segments „Vorteile EMEA-Region“ in „Vorteile Global“ ändern, aktualisiert Peakon den vorhandenen Segmentnamen „Vorteile EMEA-Region“ automatisch in „Vorteile Global“ . Wenn Segmente doppelte Namen enthalten, synchronisiert Peakon das Segment für die betroffenen Mitarbeiter nicht und zeigt stattdessen eine Fehlermeldung an

Führen Sie eine vollständige Synchronisierung durch mit Klick auf

Alles synchronisieren

Administration

Integrationen

Workday

Nach der ersten vollständigen Synchronisierung synchronisiert Peakon alle zukünftigen Änderungen schrittweise jede Stunde. Es ist jedoch möglich, eine vollständige Synchronisierung manuell zu starten.

Sie können die Schaltfläche

„In CSV exportieren“

bei Integrationsprüfungen verwenden, um die letzten 5.000 Datensätze der Prüfprotokolle für Integrationsereignisse im CSV-Format zu exportieren.

Schritte: Workday-Integration einrichten