Passa al contenuto principale
Documentazione
Documentazione
Peakon
Ultimo aggiornamento: 2025-05-16
Connettiti a Workday tramite OAuth

Connettiti a Workday tramite OAuth

In Workday, crea questi elementi di integrazione:
  • Dominio
    di sicurezza dell'integrazione
     nell'area funzionale Integrazione.
  • Utente del sistema di integrazione.
  • Gruppo di sicurezza del sistema di integrazione.
Sicurezza: accesso amministratore in Peakon.
È possibile connettere Peakon a Workday e autenticare i dati trasferiti tramite OAuth.
Ti consigliamo di Connettiti a Workday utilizzando il nome e la password ISU, che è più facile da configurare e meno soggetto a disconnessione dovuta a fattori esterni.
  1. In Workday, accedi all'attività
    Modifica configurazione tenant – Sicurezza
     .
  2. Selezionare la casella di controllo
    Client OAuth 2.0 abilitati
     .
  3. Mentre sei ancora in Workday, accedi all'attività
    Registra client API
     .
  4. Inserisci il
    nome del cliente
     e seleziona
    Concessione del codice di autorizzazione
    .
  5. Selezionare
    Bearer
     come
    tipo di token di accesso
     e immettere l'
    URL di reindirizzamento
    .
    Il formato dell'URL di reindirizzamento è
    https://companyname.peakon.com/workday/complete
    . Devi sostituire
    companyname.peakon.com
     con il tuo sottodominio personalizzato.
  6. Selezionare la casella di controllo
    Token di aggiornamento senza scadenza
     .
  7. Selezionare queste aree funzionali dal prompt
    Ambito (Aree funzionali)
     :
    • Informazioni sui contatti
    • Implementazione
    • Dati personali
    • Dati pubblici
    • Personale
    • Sistema
  8. Fare clic su
    OK
    .
  9. Raccogli i valori
    Tenant
    ,
    Webservice Host
    ,
    Client ID
    ,
    Client Secret
    e
    Auth Host
     .
    L'
    endpoint dell'API REST di Workday
     contiene l'
    host del servizio Web
     e il
    tenant
    . Esempio: quando l'endpoint è
    https://wd3-services1.myworkday.com/api/v1/tenant_name
    , l'
    host del servizio Web
     è
    wd3-services1.myworkday.com
     e il
    tenant
     è
    tenant_name
    .
    L'
    endpoint di autorizzazione
     contiene l'
    host di autorizzazione
    . Esempio: quando l'endpoint di autorizzazione è
    https://wd3.myworkday.com/tenant_name/authorize
    , l'
    host di autorizzazione
     è
    wd3.myworkday.com
    .
    Workday etichetta di conseguenza
    l'ID client
     e
    il segreto client
    .
    Prendi nota del valore
    del Client Secret
     , perché non sarà possibile recuperarlo dopo aver chiuso questa pagina. È necessario in caso di disconnessione.
  10. Apri Peakon in una finestra di navigazione in incognito per accedere come utente del sistema di integrazione Peakon (ISU).
    Quando la tua azienda utilizza SSO per accedere ai tenant di Workday, usa questo modello di URL per accedere a Workday come Peakon ISU: (https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n). <workdayDomain> è il dominio del tenant di Workday e <tenant> è il nome del tenant di Workday.
    L'accesso tramite una finestra di navigazione in incognito garantisce che l'integrazione non si connetta con credenziali errate per il tenant Workday, il che causerebbe problemi di sincronizzazione.
  11. In Peakon, vai su
    Amministrazione
    Integrazioni
    Workday
    .
  12. Selezionare
    OAuth
     dal prompt
    Modalità di autenticazione
     .
  13. Inserisci i valori del passaggio 9 in questi campi:
    • Tenant
    • Host di servizi Web
    • ID cliente
    • Chiave privata
    • Host di autenticazione
  14. Fare clic su
    Connetti
    .
    La sincronizzazione è ora attiva e verrà eseguita automaticamente. Se vuoi evitare che ciò accada e al tempo stesso puoi continuare la configurazione nel passaggio 17, fai clic su
    Disabilita
    .
  15. (Facoltativo) Nella pagina di accesso, accedi come ISU.
  16. Fare clic su
    Consenti
    .
  17. Configura le impostazioni che ora vengono visualizzate nella pagina di integrazione di Workday su Peakon.
    Alcune opzioni richiedono un accesso di sicurezza al dominio aggiuntivo. Vedere Impostare i domini nel gruppo di sicurezza per l'integrazione di Workday.
    Opzione
    Descrizione
    ID sistema di integrazione
    (Facoltativo) Compilare questo campo se è necessario creare sostituzioni di campo per trasferire campi personalizzati o utilizzare la funzionalità
    PEAKON_INCLUDED
     .
    ID organizzazione
    (Facoltativo) Compila questo campo per filtrare i dipendenti in base all'organizzazione. Per sincronizzare i dipendenti di più organizzazioni, separare gli ID delle organizzazioni con uno spazio. Quando inserisci un ID organizzazione per filtrare, includiamo automaticamente le organizzazioni subordinate.
    Si consiglia di utilizzare questa funzionalità anziché
    PEAKON_INCLUDED
     quando si filtra per organizzazione, perché:
    • È difficile configurare correttamente la funzionalità
      PEAKON_INCLUDED
       in modo che rispecchi il campo
      ID organizzazione
       e la sincronizzazione potrebbe quindi non fornire il risultato previsto.
    • Funziona più velocemente della funzionalità
      PEAKON_INCLUDED
       .
    Fuso orario
    (Facoltativo) Selezionare questa opzione per sincronizzare i fusi orari locali dei dipendenti. Peakon invierà un sondaggio ai dipendenti nel loro fuso orario locale.
    Lingua
    (Facoltativo) Selezionare questa opzione per sincronizzare le lingue locali dei dipendenti. Peakon utilizzerà le lingue sincronizzate nelle comunicazioni del sondaggio per i dipendenti, se tali lingue sono abilitate nelle impostazioni del sondaggio della tua organizzazione.
    Numero di telefono
    (Facoltativo) Seleziona questa opzione per visualizzare le opzioni di sincronizzazione dei numeri di telefono dei dipendenti.
    • Ufficio
    • Casa
    • Sincronizza numeri privati
    La sincronizzazione dei numeri di telefono è utile se si desidera inviare notifiche di sondaggi tramite SMS.
    Se selezioni sia il numero
    di lavoro
     che
    quello di casa
     , avrà la precedenza il numero di telefono
    principale del lavoro
     .
    Includi dipendenti specifici - In base ai criteri personalizzati impostati in Workday
    (Facoltativo) Selezionare questa opzione per sincronizzare solo determinati gruppi di dipendenti.
    Oltre ad abilitare questa casella di controllo, creare una voce di override del campo
    PEAKON_INCLUDED
     nel
    servizio di override del campo
    . L'override della sorgente deve essere un campo calcolato booleano che restituisce
    True
     per i dipendenti che si desidera includere.
    Includi dipendenti specifici - Lavoratori a tempo determinato
    (Facoltativo) Selezionare questa opzione per includere anche i lavoratori temporanei.
    Mappa per ID esterno (solo se i dati non contengono segmenti duplicati)
    (Facoltativo) Selezionare questa opzione per abbinare gli ID esterni ai segmenti quando si mappano gli attributi da Workday a Peakon.
    Questa funzionalità consente di utilizzare una mappatura degli attributi più avanzata quando non si hanno segmenti duplicati.
    Workday mappa gli ID esterni del segmento di questi attributi su Peakon:
    • Dipartimento
    • Tipo di impiego
    • Genere
    • Famiglia lavorativa
    • Livello di gestione
    • Motivo della separazione
    Workday non mappa l'ID esterno quando è presente un override di campo per l'attributo.
    Workday non crea un nuovo segmento in Peakon quando il nome di un segmento cambia in Workday. Esempio: quando in Workday modifichi il nome del segmento
    Benefits EMEA Region
     in
    Benefits Global
    , Peakon aggiorna automaticamente il nome del segmento
    Benefits EMEA Region
     esistente in
    Benefits Global
    .
    Quando i segmenti contengono nomi duplicati, Peakon non sincronizza il segmento per i dipendenti interessati e, invece, visualizza un messaggio di errore
Eseguire una sincronizzazione completa facendo clic su
Sincronizza tutto
 in
Amministrazione
Integrazioni
Workday
.
Dopo la sincronizzazione completa iniziale, Peakon sincronizzerà ogni ora tutte le modifiche future in modo incrementale; tuttavia, è possibile avviare manualmente una sincronizzazione completa.
È possibile utilizzare il pulsante
Esporta in CSV
 negli audit di integrazione per esportare gli ultimi 5.000 record dei log di audit degli eventi di integrazione in formato CSV.