Skip to main content
Documentatie
Documentatie
Peakon
Laatst bijgewerkt: 2025-05-16
Maak verbinding met Workday via OAuth

Maak verbinding met Workday via OAuth

Maak in Workday de volgende integratie-items:
  • Integratiebeveiligingsdomein
     in het functionele gebied Integratie.
  • Gebruiker van integratiesysteem.
  • Beveiligingsgroep voor integratiesysteem.
Beveiliging: Beheerderstoegang in Peakon.
U kunt Peakon verbinden met Workday en overgedragen gegevens verifiëren met OAuth.
Wij raden u aan Maak verbinding met Workday met behulp van ISU-naam en wachtwoord, die eenvoudiger op te zetten is en minder gevoelig is voor verbroken verbindingen door externe factoren.
  1. Ga in Workday naar de taak
    Tenantinstellingen bewerken – Beveiliging
     .
  2. Selecteer het selectievakje
    OAuth 2.0-clients ingeschakeld
     .
  3. Open, terwijl u nog in Workday bent, de taak
    API-client registreren
     .
  4. Voer de
    klantnaam
     in en selecteer
    Autorisatiecode verlenen
    .
  5. Selecteer
    Bearer
     als het
    toegangstokentype
     en voer de
    omleidings-URL
    in.
    De omleidings-URL heeft de volgende indeling:
    https://bedrijfsnaam.peakon.com/workday/complete
    . Vervang
    companyname.peakon.com
     door uw aangepaste subdomein.
  6. Selecteer het selectievakje
    Vernieuwingstokens die niet verlopen
     .
  7. Selecteer deze functionele gebieden via de prompt
    Scope (Functional Areas)
     :
    • Contactgegevens
    • Uitvoering
    • Persoonsgegevens
    • Openbare gegevens
    • Personeelsbezetting
    • Systeem
  8. Klik op
    OK
    .
  9. Verzamel de waarden
    voor Tenant
    ,
    Webservice Host
    ,
    Client ID
    ,
    Client Secret
    en
    Auth Host
     .
    Het
    Workday REST API-eindpunt
     bevat de
    webservicehost
     en de
    tenant
    . Voorbeeld: wanneer het eindpunt
    https://wd3-services1.myworkday.com/api/v1/tenant_name
    is, dan is de
    webservicehost
    wd3-services1.myworkday.com
     en de
    tenant
    tenant_name
    .
    Het
    autorisatie-eindpunt
     bevat de
    Auth Host
    . Voorbeeld: wanneer het autorisatie-eindpunt
    https://wd3.myworkday.com/tenant_name/authorize
    is, is de
    Auth Host
    wd3.myworkday.com
    .
    Workday labelt
    Client ID
     en
    Client Secret
    dienovereenkomstig.
    Let op de waarde van het
    Client Secret
     , want deze is niet meer te herstellen nadat u deze pagina hebt gesloten. Dit is nodig in geval van een verbroken verbinding.
  10. Open Peakon in een incognitovenster om u aan te melden als gebruiker van het Peakon-integratiesysteem (ISU).
    Wanneer uw bedrijf SSO gebruikt om u aan te melden bij uw Workday-tenants, gebruikt u deze URL-sjabloon om u aan te melden bij Workday als de Peakon ISU: (https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n). <workdayDomain> is het domein van uw Workday-tenant en <tenant> is de naam van uw Workday-tenant.
    Als u zich aanmeldt via een incognitovenster, voorkomt u dat de integratie verbinding maakt met de verkeerde inloggegevens voor de Workday-tenant. Dit zou namelijk tot synchronisatieproblemen leiden.
  11. Ga in Peakon naar
    Beheer
    Integraties
    Workday
    .
  12. Selecteer
    OAuth
     in het venster
    Authenticatiemodus
     .
  13. Voer de waarden uit stap 9 in deze velden in:
    • Tenant
    • Webservicehost
    • Client-ID
    • Clientgeheim
    • Auth-host
  14. Klik op
    Verbinden
    .
    De synchronisatie is nu actief en wordt automatisch uitgevoerd. Als u dit wilt voorkomen en toch de installatie in stap 17 wilt voortzetten, klikt u op
    Uitschakelen
    .
  15. (Optioneel) Meld u op de aanmeldpagina aan als ISU.
  16. Klik op
    Toestaan
    .
  17. Configureer de instellingen die nu worden weergegeven op de Workday-integratiepagina op Peakon.
    Voor sommige opties is aanvullende domeinbeveiligingstoegang vereist. Zien Domeinen instellen in beveiligingsgroep voor Workday-integratie.
    Optie
    Beschrijving
    Integratiesysteem-ID
    (Optioneel) Vul dit veld in als u veldoverschrijvingen wilt maken om aangepaste velden over te dragen of de functionaliteit
    van PEAKON_INCLUDED
     wilt gebruiken.
    Organisatie-ID
    (Optioneel) Vul dit veld in om te filteren op medewerkers per organisatie. Als u medewerkers in meerdere organisaties wilt synchroniseren, scheidt u de organisatie-ID's met één spatie. Wanneer u een organisatie-ID invoert om te filteren, worden onderliggende organisaties automatisch opgenomen.
    Wij adviseren om dit te gebruiken in plaats van de
    PEAKON_INCLUDED
     functionaliteit bij het filteren op organisaties, omdat:
    • Het is lastig om de
      PEAKON_INCLUDED
       -functionaliteit op een manier te configureren die het veld
      Organisatie-ID
       weerspiegelt. De synchronisatie levert daarom mogelijk niet het gewenste resultaat op.
    • Het werkt sneller dan de
      PEAKON_INCLUDED
       functionaliteit.
    Tijdzone
    (Optioneel) Selecteer deze optie om de lokale tijdzones van werknemers te synchroniseren. Peakon stuurt een enquête naar werknemers in hun lokale tijdzone.
    Landinstellingen
    (Optioneel) Selecteer deze optie om de lokale talen van werknemers te synchroniseren. Peakon gebruikt de gesynchroniseerde talen in de communicatie van werknemersenquêtes, als die talen zijn ingeschakeld in de enquête-instellingen van uw organisatie.
    Telefoonnummer
    (Optioneel) Selecteer deze optie om de synchronisatieopties voor telefoonnummers van medewerkers weer te geven.
    • Werk
    • Privé
    • Privénummers synchroniseren
    Het synchroniseren van telefoonnummers is handig als u enquêtemeldingen via sms wilt versturen.
    Wanneer u zowel
    een werk-
     als
    een privénummer
     selecteert, heeft het
    primaire
     werktelefoonnummer voorrang.
    Specifieke werknemers opnemen - Gebaseerd op aangepaste criteria die in Workday zijn ingesteld
    (Optioneel) Selecteer deze optie om alleen bepaalde groepen werknemers te synchroniseren.
    Naast het inschakelen van dit selectievakje, moet u een veldoverride-item
    voor PEAKON_INCLUDED
     maken in de
    Field Override Service
    . De bronoverschrijving moet een berekend Booleaans veld zijn dat
    True
     retourneert voor werknemers die u wilt opnemen.
    Specifieke werknemers opnemen - Tijdelijke werknemers
    (Optioneel) Selecteer deze optie om ook tijdelijke medewerkers op te nemen.
    Kaart op basis van externe ID (alleen als de gegevens geen dubbele segmenten bevatten)
    (Optioneel) Selecteer deze optie om externe ID's te koppelen aan segmenten wanneer u kenmerken van Workday toewijst aan Peakon.
    Met deze functie kunt u geavanceerdere kenmerktoewijzing gebruiken wanneer u geen dubbele segmenten hebt.
    Workday koppelt de externe segment-ID's van deze kenmerken aan Peakon:
    • Afdeling
    • Type dienstverband
    • Geslacht
    • Functiefamilie
    • Managementniveau
    • Reden van scheiding
    Workday wijst de externe ID niet toe als er een veldoverride voor het kenmerk is.
    Workday maakt geen nieuw segment aan in Peakon wanneer een segmentnaam in Workday verandert. Voorbeeld: wanneer u in Workday de naam van het segment
    Benefits EMEA Region
     wijzigt naar
    Benefits Global
    , werkt Peakon automatisch de bestaande naam van het segment
    Benefits EMEA Region
     bij naar
    Benefits Global
    .
    Wanneer segmenten dubbele namen bevatten, synchroniseert Peakon het segment niet voor de getroffen werknemers en geeft in plaats daarvan een foutmelding weer
Voer een volledige synchronisatie uit door op
Alles synchroniseren
 te klikken in
Beheer
Integraties
Workday
.
Na de eerste volledige synchronisatie synchroniseert Peakon alle toekomstige wijzigingen stapsgewijs per uur. U kunt echter ook handmatig een volledige synchronisatie starten.
U kunt de knop
Exporteren naar CSV
 bij integratieaudits gebruiken om de laatste 5.000 records van auditlogboeken van integratiegebeurtenissen te exporteren in CSV-indeling.