Configurare un'istanza di Workday per la replica dei dati

Questo documento descrive come configurare Datastream per trasferire flussi di dati da un'istanza Workday a una destinazione supportata, come BigQuery o Cloud Storage.

Prima di iniziare

Prima di iniziare a configurare Workday per l'utilizzo con Datastream, devi:

  • Avere accesso a un'istanza Workday attiva.
  • Avere familiarità con la navigazione e la modifica delle impostazioni in Workday.
  • Avere familiarità con la creazione di utenti del sistema di integrazione e gruppi di sicurezza in Workday.

Configurare un'istanza Workday per l'utilizzo con Datastream

Per stabilire una connessione tra l'istanza Workday e Datastream, devi fornire il nome host e il nome del tenant dell'istanza, nonché le credenziali client OAuth 2.0, come un ID client, un client secret e un token di aggiornamento quando crei un profilo di connessione Workday.

Identificare il nome host e il nome del tenant

Puoi trovare il nome host e il nome del tenant dell'istanza Workday in uno dei seguenti modi:

  • Utilizzando l'indirizzo URL di accesso. Il nome host e il nome del tenant fanno parte dell'indirizzo URL dell'istanza che utilizzi per accedere a Workday. Ad esempio, se l'URL di accesso è https://wd5-impl.workday.com/google/d/home.html, allora la parte wd5-impl.workday.com è il nome host e il nome breve o l'alias dell'istanza che appare immediatamente dopo il nome host nell' URL è il nome del tenant (in questo caso, google).
  • Utilizzando i dettagli del client API registrato. Se hai già registrato un client API, puoi recuperare queste informazioni direttamente dall'indirizzo URL dell'endpoint REST:

    1. In Workday, cerca e seleziona l'attività Visualizza client API.
    2. In Dettagli client, trova il campo Endpoint API REST Workday, ad esempio: https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant.
    3. Trova le tue credenziali:

      • Il nome host è la parte del dominio dell'URL, ad esempio wd2-impl-services1.workday.com.
      • Il nome del tenant è l'ultimo segmento del percorso dell'URL dopo /v1/ (ad esempio, mytenant).

Per saperne di più su come trovare gli endpoint API, consulta la documentazione delle API Workday.

Configurare un utente e un gruppo di sicurezza

Per trasferire flussi di dati da Workday, devi configurare un utente del sistema di integrazione (ISU) dedicato, assegnarlo a un gruppo di sicurezza senza vincoli e concedere al gruppo le autorizzazioni di dominio necessarie.

Creare l'utente del sistema di integrazione (ISU)

  1. Nella barra di ricerca di Workday, cerca e seleziona l'attività Crea utente del sistema di integrazione.
  2. Configura l'account ISU:

    1. Inserisci un nome utente, ad esempio datastream_isu.
    2. Crea una password sicura.
    3. Inserisci 0 (nessun timeout) nel campo Session Timeout Minutes (Minuti di timeout della sessione).
    4. Deseleziona la casella di controllo Do Not Allow UI Sessions (Non consentire sessioni UI).
  3. Fai clic su OK, quindi su Fine.

Creare un gruppo di sicurezza del sistema di integrazione

  1. Cerca e seleziona l'attività Crea gruppo di sicurezza.
  2. Configura le opzioni del gruppo di sicurezza:

    1. Dal menu a discesa Tipo di gruppo di sicurezza multi-tenant, seleziona Gruppo di sicurezza del sistema di integrazione (senza vincoli).
    2. Nel campo Nome , inserisci un nome per il gruppo di sicurezza, ad esempio datastream_sg.
  3. Fai clic su OK.

  4. Nella pagina successiva, nel campo Utenti del sistema di integrazione, cerca e seleziona l'ISU che hai creato nel passaggio precedente.

  5. Fai clic su OK.

Concedere le autorizzazioni per le norme di sicurezza del dominio

Per garantire la copertura completa dei domini di dati standard, devi concedere al gruppo di sicurezza le autorizzazioni Solo lettura per i domini Workday richiesti:

  1. Nella pagina dei dettagli del gruppo di sicurezza, fai clic sull'icona con tre puntini Azioni correlate (...) accanto al nome del gruppo di sicurezza.
  2. Vai a Gruppo di sicurezza > Gestisci autorizzazioni di dominio per il gruppo di sicurezza.
  3. Nella tabella Autorizzazioni per le norme di sicurezza del dominio, aggiungi i seguenti domini:

    • Worker Data: Public Worker Reports
    • Workday Usage Metrics
    • Manage: Organization Integration
    • Worker Data: All Positions
    • Job Requisition Data
    • Manage: Evergreen Requisitions
    • Special OX Web Services
    • Prospects
    • Candidate Data: Job Application
    • Worker Data: Skills and Experience
    • Payroll Interface
    • Job Information
    • Staffing Organizations: Header
    • Staffing Organizations: Company
    • Staffing Organizations: Region
    • Staffing Organizations: Business Unit
    • Staffing Organizations: Custom Organization
  4. Per ogni dominio aggiunto, seleziona la casella di controllo nella colonna di accesso Solo lettura.

  5. Fai clic su OK, quindi su Fine.

Escludere l'ISU dalla scadenza della password

Per evitare interruzioni dello stream dovute a password scadute, escludi l'ISU dalle regole standard di scadenza della password del tenant:

  1. Cerca e seleziona l'attività Gestisci regole password.
  2. Nel campo Utenti di sistema esclusi dalla scadenza della password, aggiungi l'ISU che hai creato.
  3. Fai clic su OK, quindi su Fine.

Attivare le modifiche alle norme di sicurezza

Assicurati di attivare esplicitamente le modifiche alle autorizzazioni di dominio, altrimenti non avranno effetto:

  1. Cerca e seleziona l'attività Attiva modifiche alle norme di sicurezza in attesa.
  2. Nel campo Commento , inserisci una descrizione delle modifiche, ad esempio Grant permissions for Datastream Workday integration.
  3. Fai clic su OK.
  4. Nella pagina di conferma, seleziona la casella di controllo Conferma.
  5. Fai clic su OK per attivare le modifiche.

Creare e configurare un client API

Utilizza le seguenti attività in Workday per generare le credenziali necessarie per il profilo di connessione Datastream.

Registrare il client API

  1. Nella barra di ricerca di Workday, cerca e seleziona l'attività Registra client API per le integrazioni.
  2. Configura il client API:

    1. Inserisci un nome per l'integrazione Datastream.
    2. In Tipo di concessione client, seleziona Concessione del codice di autorizzazione.
    3. In Tipo di token di accesso, seleziona Portatore.
    4. Seleziona la casella di controllo Applica scadenza personalizzata del token di accesso, quindi specifica una data di scadenza a tua scelta.
    5. Se vuoi, seleziona la casella di controllo Token di aggiornamento non scaduti per evitare interruzioni della connessione.

    6. In Ambiti, ti consigliiamo di includere le seguenti aree funzionali per garantire la copertura completa dei domini di dati standard:

      • Implementation
      • Jobs & Positions
      • Organizations and Roles
      • Payroll Interface
      • Pre-Hire Process
      • Recruiting
      • Staffing
      • System
      • Talent Pipeline

      Gli ambiti richiesti dipendono dagli endpoint da cui vuoi trasferire flussi di dati.

    7. Seleziona la casella di controllo Include Workday owned scope (Includi ambito di proprietà di Workday).

  3. Fai clic su OK.

  4. Copia e salva l'ID client e il client secret generati. Queste credenziali sono necessarie per creare il profilo di connessione Datastream.

Gestire i token di aggiornamento per le integrazioni

  1. Dopo aver registrato il client, fai clic sull'icona con tre puntini Altro (...) accanto al nome del client e seleziona Gestisci token di aggiornamento per le integrazioni.
  2. Seleziona l'utente del sistema di integrazione (ISU) che hai creato in precedenza.
  3. Fai clic su Genera nuovo token di aggiornamento.

Modificare i gruppi di sicurezza del client API

  1. Per assicurarti che il client API possa essere utilizzato dal tuo ISU, cerca l'attività Modifica client API.
  2. Seleziona il client registrato e vai alle impostazioni di sicurezza.
  3. Aggiungi il gruppo di sicurezza del sistema di integrazione associato al tuo ISU all'elenco dei gruppi di sicurezza consentiti per questo client.

Visualizzare il client API

  1. Per recuperare l'ID client e il client secret, cerca l'attività Visualizza client API o vai alla pagina dei dettagli del client API.
  2. In Dettagli client, individua e copia l'ID client.
  3. Fai clic su Gestisci dettagli del consumatore per visualizzare e copiare il Client secret.

Passaggi successivi

  • Scopri di più sull'origine Workday.