Nota: Questo connettore sviluppato da Workiva ti permette di collegare le piattaforme Workiva e Workday. L'assistenza di Workiva sarà lieta di guidarti nella configurazione del connettore all'interno del tuo spazio di lavoro. Tuttavia, qualsiasi errore della piattaforma Workday o la risoluzione di problemi all'interno della piattaforma Workday devono essere gestiti dall'amministratore Workday o dal suo team di supporto.
Con il connettore Workday, puoi utilizzare i comandi in una catena per interagire con Workday® HR e Financials per:
- Scaricare report personalizzati da Workday
- Importare i dati di bilancio in Workday
- Avviare un'integrazione Workday Enterprise Interface Builder (EIB)
Requisiti
Per configurare la connessione, avrai bisogno di:
- Il tenant di Workday a cui connettersi.
- L'host e il dominio dell'ambiente Workday a cui connettersi.
- Le credenziali di autenticazione di un utente del sistema di integrazione creato in Workday.
Passo 1: ottenere le informazioni sul tenant di Workday
Puoi determinare le informazioni sul tenant, sull'host e sul dominio dal file XML del servizio web pubblico di Workday .
- Inserisci "Public Web Services" nella barra di ricerca di Workday e seleziona il report.
- Trova il servizio web per la particolare integrazione che stai utilizzando.
Gli esempi includono: Personale per i lavoratori Get, Gestione finanziaria per il bilancio delle importazioni, Integrazioni per i comandi legati alla BEI, ..... - Fare clic sul pulsante "Azioni correlate" del servizio in questione, quindi fare clic su View WSDL nel menu "Web Service".
- Nel file XML, individua l'elemento
soapbind:address(di solito si trova in fondo al file). - Utilizzando l'URL dell'attributo
location, estrarre le informazioni su tenant, host e dominio dall'URL.
L'URL utilizza il seguente formato:https://{host}.{dominio}/ccx/service/{tenant}/nome_servizio_web_pubblico/numero_di_versione
Esempio
Utilizzando il formato precedente, possiamo trovare il tenant, l'host e il dominio da un URL WSDL di esempio:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| Proprietà | Valore campione |
|---|---|
| Tenant | mycompany |
| Host | wd2-impl-services1 |
| Dominio | workday.com |
Questi valori sono necessari per l'impostazione del connettore nella fase successiva.
Passo 2: Configurare l'autenticazione Workday
Questo connettore offre due modalità di autenticazione: OAuth2 via API e Utente+Password.
Autenticazione API OAuth2
Se si utilizza l'autenticazione API OAuth2, è necessario disporre di un client API impostato in Workday. Per istruzioni sulla creazione di un client API, consultare la pagina del supporto Workday Register API Clients.
Come parte della configurazione del client API, assicurarsi di avere:
- Selezionato Bearer come Access Token Type.
- Attivate (contrassegnate) le seguenti caselle di controllo:
- Gettoni di aggiornamento non scadenti
- Includere l'ambito di proprietà di Workday
URL di reindirizzamento
Workiva dispone di URL di esclusione della connessione specifici per regione per le configurazioni dei connettori. Utilizzate la seguente tabella per selezionare l'URL corretto per la vostra località.
Se ci si trova in Nord, Centro o Sud America, utilizzare l'URL predefinito. Se vi trovate nella regione Asia-Pacifico, utilizzate l'URL APAC. Se vi trovate nell'area EMEA, utilizzate l'URL UE.
| Ambiente | URL di reindirizzamento |
|---|---|
| Prod APAC | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prodotto UE | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prodotto statunitense | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Endpoint OAuth2
Se si utilizza OAuth2 per verificare la connessione, è necessario disporre dei seguenti valori dell'endpoint. Questi vengono elencati quando si configura il client API di Workday nella pagina Edit API Client di Workday.
| Punto finale | Valore campione |
|---|---|
| Endpoint REST di Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Punto finale del token OAuth2 di Workday | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Endpoint di autorizzazione OAuth2 di Workday | https://xxxx.workday.com/xxxx/authorize |
SUGGERIMENTO: Se si utilizza un'istanza client API esistente che utilizza un token e un segreto OAuth2, è possibile vedere queste informazioni nella parte superiore della pagina Workday View API.
Autenticazione di base
Se si utilizza l'Autenticazione di base, consultare la pagina del supporto Workday Create an Integration System User (ISU) account in Workday per istruzioni sulla creazione di un Integration System User (ISU).
Fase 3: Impostazione del connettore Workday
Nota: Per rendere il connettore disponibile per l'uso nelle catene dell'organizzazione, un amministratore della sicurezza dell'organizzazione deve prima abilitarlo da Configurazione.
- Da Chain Builder, fare clic su Connections, quindi Create in alto a destra.
- In Connector Connection, selezionare Workday Connector e il CloudRunner predefinito.
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.
-
In Properties, inserisci i dettagli della connessione.
Se si utilizza OAuth2, è necessario inserire i valori per Workday REST Endpoint, Workday OAuth2 Token Endpoint e Workday OAuth2 Authorization Endpoint.
Se si utilizza l'Autenticazione di base (nome utente+password), lasciare vuoto questo campo.Campo Contenuto Tenant Il tenant di Workday a cui connettersi. Host L'host dell'ambiente Workday a cui connettersi. Nell'URL dell'ambiente, i caratteri prima della proprietà Domain rappresentano l'host. Dominio Il dominio dell'ambiente Workday a cui connettersi,
comeworkday.comomyworkday.com.Endpoint REST di Workday L'URL dell'endpoint REST fornito da Workday.
(Solo se si utilizza l'autenticazione OAuth2)Punto finale del token OAuth2 di Workday L'URL del token endpoint OAuth2 fornito da Workday.
(Solo se si utilizza l'autenticazione OAuth2)Endpoint di autorizzazione OAuth2 di Workday L'URL dell'endpoint OAuth2 fornito da Workday.
(Solo se si utilizza l'autenticazione OAuth2)
Risoluzione dei problemi
Se la connessione a Workday fallisce:
- Verifica che le credenziali di autenticazione dell'utente del sistema di integrazione siano corrette.
- Verificare che l'utente del sistema di integrazione abbia le autorizzazioni corrette per accedere ai gruppi funzionali e ai domini relativi ai comandi della connessione.
- Verificare che il tenant, l'host e il dominio di Workday corretti siano inseriti per il connettore.
- Quando esegui il comando Scarica un report personalizzato, assicurati che il tipo di report sia impostato su Advanced. Al momento i report compositi non sono disponibili tramite l'API di Workday.