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.
Fase 1: Ottenere le informazioni relative al 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.
Tra gli esempi figurano: la gestione del personale per Get Workers, la gestione finanziaria per Import Budget, le integrazioni per i comandi relativi alla BEI,…. - Fare clic sul pulsante "Azioni correlate" di quel servizio, quindi selezionare " " e "Visualizza WSDL" dal menu "Servizio Web".
- Nel file XML, individua l'elemento
soapbind:address(di solito si trova in fondo al file). - Utilizzando l'URL presente nell'attributo della pagina
, estrai dall'URL le informazioni relative al tenant, all'host e al dominio.
L'URL utilizza il seguente formato:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
Esempio
Utilizzando il formato sopra indicato, possiamo ricavare 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 di esempio |
|---|---|
| Tenant | mycompany |
| Host | wd2-impl-services1 |
| Dominio | workday.com |
Questi valori ti serviranno per configurare il connettore nel passaggio successivo.
Fase 2: Configurazione dell'autenticazione Workday
Questo connettore offre due modalità di autenticazione: OAuth2 tramite API e nome utente + password.
Autenticazione tramite API OAuth2
Se si utilizza l'autenticazione tramite API OAuth2 di , è necessario aver configurato un client API in Workday. Per istruzioni su come creare un client API, consultare la pagina di supporto di Workday e la pagina "Registrazione dei client API".
Nell'ambito della configurazione del client API, assicurati di disporre di:
- Selezionato " " come tipo di token di accesso "Bearer" e " " come tipo di token di accesso.
- Sono state selezionate (contrassegnate) le seguenti caselle di controllo:
- Token di aggiornamento senza scadenza
- Includere l'ambito di competenza di Workday
URL di reindirizzamento
Workiva dispone di URL di override della connessione specifici per regione per le configurazioni dei connettori. Utilizza la tabella seguente per selezionare l'URL corretto in base alla tua posizione.
| Ambiente | URI di reindirizzamento |
|---|---|
| Prodotti APAC (regione Asia-Pacifico) | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prodotto CA (Canada) | https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback |
| Prodotti UE (EMEA) | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Produzione statunitense (Stati Uniti, America Centrale, America del Sud) | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
Endpoint OAuth2
Se utilizzi OAuth2 per verificare la tua connessione, dovrai disporre dei seguenti valori di endpoint. Queste voci verranno visualizzate quando configuri il client API di Workday nella pagina "Modifica client API" ( ) all'indirizzo in Workday.
| Endpoint | Valore di esempio |
|---|---|
| Endpoint REST di Workday | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Endpoint 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 stai utilizzando un'istanza client API esistente che impiega un token e un segreto OAuth2, puoi trovare queste informazioni nella parte superiore della pagina "Workday View API" all'indirizzo.
Autenticazione di base
Se si utilizza l'autenticazione di base di , consultare la pagina del supporto WorkdayCreare un account utente di sistema di integrazione (ISU) in Workday per le istruzioni su come creare un utente di sistema di integrazione (ISU).
Fase 3: Configurazione del connettore Workday
Nota: Per rendere il connettore disponibile per l'uso nelle catene della propria organizzazione, un amministratore della sicurezza dell'organizzazione deve prima abilitarlo da Configurazione.
- Da Chain Builder, clicca su Connections, quindi su Create in alto a destra.
- In " " (Connettori) > "Connection" (Connessione), seleziona " " (Connettore Workday) e l'impostazione predefinita "CloudRunner".
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.
-
In Properties, inserisci i dettagli della connessione.
Se utilizzi OAuth2, dovrai inserire i valori relativi a (Endpoint REST di Workday), (Endpoint token OAuth2 di Workday) e (Endpoint di autorizzazione OAuth2 di Workday).
Se utilizzi l'autenticazione di base di (nome utente + password), lascia questi campi vuoti.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 che precedono la proprietà Domain rappresentano l'host. Dominio Il dominio dell'ambiente Workday a cui connettersi,
, ad esempioworkday.com,omyworkday.com,.Endpoint REST di Workday L'URL dell'endpoint REST fornito da Workday.
(Solo se si utilizza l'autenticazione OAuth2.)Endpoint del token OAuth2 di Workday L'URL dell'endpoint del token 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 disponga delle autorizzazioni necessarie per accedere ai gruppi funzionali e ai domini correlati ai comandi della connessione.
- Verificare che per il connettore siano stati inseriti il tenant, l'host e il dominio corretti di Workday.
- 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.