Per replicare i dati da un'istanza Workday a una destinazione supportata come BigQuery o Cloud Storage, puoi connettere Workday come origine Datastream. Autentichi la connessione creando un utente del sistema di integrazione (ISU), concedendo le autorizzazioni del gruppo di sicurezza e registrando un client API per OAuth 2.0.
Prima di iniziare
Prima di iniziare a configurare Workday per l'utilizzo con Datastream, devi:
- Avere accesso a un'istanza Workday attiva.
- Saper navigare e modificare le impostazioni in Workday.
- Conoscere la procedura per creare utenti del sistema di integrazione e gruppi di sicurezza in Workday.
Configura un'istanza Workday da utilizzare 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.
Identifica il nome host e il nome del tenant
Puoi trovare il nome host e il nome del tenant della tua 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 il tuo URL di accesso è
https://wd5-impl.workday.com/google/d/home.html, la partewd5-impl.workday.comè il nome host e il nome breve o l'alias della tua istanza che appare immediatamente dopo il nome host nell'URL è il nome 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:
- In Workday, cerca e seleziona l'attività View API Client (Visualizza client API).
- In Client Details (Dettagli client), individua il campo Workday REST API Endpoint (Endpoint API REST Workday), ad esempio:
https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant. 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 che segue
/v1/(ad esempio,mytenant).
- Il nome host è la parte del dominio dell'URL, ad esempio
Per saperne di più su come trovare gli endpoint API, consulta la documentazione delle API Workday.
Configura un utente e un gruppo di sicurezza
Per trasmettere i dati da Workday, devi configurare un utente del sistema di integrazione (ISU) dedicato, assegnarlo a un gruppo di sicurezza non vincolato e concedere al gruppo le autorizzazioni di dominio necessarie.
Crea l'utente del sistema di integrazione (ISU)
- Nella barra di ricerca di Workday, cerca e seleziona l'attività Create Integration System User (Crea utente del sistema di integrazione).
Configura l'account ISU:
- Inserisci un nome utente, ad esempio
datastream_isu. - Crea una password sicura.
- Inserisci
0(nessun timeout) nel campo Session Timeout Minutes (Timeout della sessione in minuti). - Deseleziona la casella di controllo Do Not Allow UI Sessions (Non consentire sessioni UI).
- Inserisci un nome utente, ad esempio
Fai clic su Ok, quindi su Fine.
Crea un gruppo di sicurezza del sistema di integrazione
- Cerca e seleziona l'attività Create Security Group (Crea gruppo di sicurezza).
Configura le opzioni del gruppo di sicurezza:
- Dal menu a discesa Type of Tenanted Security Group (Tipo di gruppo di sicurezza multi-tenant), seleziona Integration System Security Group (Unconstrained) (Gruppo di sicurezza del sistema di integrazione) (senza vincoli).
- Nel campo Nome, inserisci un nome per il gruppo di sicurezza, ad esempio
datastream_sg.
Fai clic su OK.
Nella pagina successiva, nel campo Integration System Users (Utenti del sistema di integrazione), cerca e seleziona l'ISU che hai creato nel passaggio precedente.
Fai clic su OK.
Concedi le autorizzazioni per le policy di sicurezza del dominio
Per garantire la copertura completa dei domini di dati standard, devi concedere al gruppo di sicurezza le autorizzazioni Get Only per i domini Workday richiesti:
- Nella pagina dei dettagli del gruppo di sicurezza, fai clic sull'icona con tre puntini
(...)Related Actions (Azioni correlate) accanto al nome del gruppo di sicurezza. - Vai a Gruppo di sicurezza > Gestisci autorizzazioni di dominio per il gruppo di sicurezza.
Nella tabella Autorizzazioni delle policy di sicurezza del dominio, aggiungi i seguenti domini:
Worker Data: Public Worker ReportsWorkday Usage MetricsManage: Organization IntegrationWorker Data: All PositionsJob Requisition DataManage: Evergreen RequisitionsSpecial OX Web ServicesProspectsCandidate Data: Job ApplicationWorker Data: Skills and ExperiencePayroll InterfaceJob InformationStaffing Organizations: HeaderStaffing Organizations: CompanyStaffing Organizations: RegionStaffing Organizations: Business UnitStaffing Organizations: Custom Organization
Per ogni dominio aggiunto, seleziona la casella di controllo nella colonna di accesso Solo Get.
Fai clic su Ok, quindi su Fine.
Esenta l'ISU dalla scadenza della password
Per evitare interruzioni dello stream dovute a password scadute, esenta l'ISU dalle regole di scadenza delle password standard del tuo tenant:
- Cerca e seleziona l'attività Maintain Password Rules (Gestisci regole per le password).
- Nel campo Utenti di sistema esenti dalla scadenza della password, aggiungi l'ISU che hai creato.
- Fai clic su Ok, quindi su Fine.
Attiva le modifiche alle policy di sicurezza
Assicurati di attivare esplicitamente le modifiche alle autorizzazioni del dominio, altrimenti non avranno effetto:
- Cerca e seleziona l'attività Activate Pending Security Policy Changes (Attiva modifiche ai criteri di sicurezza in attesa).
- Nel campo Commento, inserisci una descrizione delle modifiche, ad esempio
Grant permissions for Datastream Workday integration. - Fai clic su OK.
- Nella pagina di conferma, seleziona la casella di controllo Conferma.
- Fai clic su OK per attivare le modifiche.
Crea e configura un client API
Utilizza le seguenti attività in Workday per generare le credenziali necessarie per il tuo profilo di connessione Datastream.
Registra il client API
- Nella barra di ricerca di Workday, cerca e seleziona l'attività Registra client API per le integrazioni.
Configura il client API:
- Inserisci un nome per l'integrazione di Datastream.
- In Client Grant Type (Tipo di concessione client), seleziona Authorization Code Grant (Concessione del codice di autorizzazione).
- In Access Token Type (Tipo di token di accesso), seleziona Bearer (Portatore).
- Seleziona la casella di controllo Applica la scadenza del token di accesso personalizzato, quindi specifica una data di scadenza a tua scelta.
Facoltativamente, seleziona la casella di controllo Token di aggiornamento senza scadenza per evitare interruzioni della connessione.
In Ambiti, ti consigliamo di includere le seguenti aree funzionali per garantire una copertura completa dei domini di dati standard:
ImplementationJobs & PositionsOrganizations and RolesPayroll InterfacePre-Hire ProcessRecruitingStaffingSystemTalent Pipeline
Gli ambiti richiesti dipendono dagli endpoint da cui vuoi trasmettere i dati in streaming.
Seleziona la casella di controllo Includi ambito di proprietà di Workday.
Fai clic su OK.
Copia e salva l'ID client e il client secret generati. Queste credenziali sono necessarie per creare il profilo di connessione Datastream.
Gestisci i token di aggiornamento per le integrazioni
- Dopo aver registrato il client, fai clic sull'icona con i puntini di sospensione
(...)accanto al nome del client e seleziona Manage Refresh Tokens for Integrations (Gestisci i token di aggiornamento per le integrazioni). - Seleziona l'utente del sistema di integrazione (ISU) che hai creato in precedenza.
Fai clic su Genera nuovo token di aggiornamento.
Modifica i gruppi di sicurezza dei client API
- Per assicurarti che il client API possa essere utilizzato dalla tua ISU, cerca l'attività Modifica client API.
- Seleziona il client registrato e vai alle impostazioni di sicurezza.
- Aggiungi il gruppo di sicurezza del sistema di integrazione associato all'ISU all'elenco dei gruppi di sicurezza consentiti per questo client.
Visualizza client API
- Per recuperare l'ID client e il client secret, cerca l'attività Visualizza client API o vai alla pagina dei dettagli del client API.
- In Client Details (Dettagli client), individua e copia il Client ID (ID client).
- Fai clic su Manage Consumer Details (Gestisci i dettagli del consumer) per visualizzare e copiare il Client Secret (Client secret).
Passaggi successivi
- Scopri di più sull'origine Workday.