Precedentemente noto come Adaptive Insights, il connettore Workday Adaptive Planning utilizza i comandi in una catena per importare o esportare dati o metadati.
Nota: Questo connettore è stato creato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.
Requisiti
Per attivare la connessione, il connettore utilizza l'API REST di Workday Adaptive Planning. Per configurare il connettore, avrai bisogno di:
- Un utente dell'integrazione impostato in Adaptive Planning a cui è stato assegnato un ruolo con le autorizzazioni appropriate per eseguire i comandi del connettore.
- Nome utente e password dell'utente dell'integrazione.
- Se l'utente dell'integrazione può accedere a più istanze di Adaptive Planning, il codice dell'istanza a cui si connetterà.
Nota: Per determinare i codici di istanza disponibili dell'utente dell'integrazione, puoi utilizzare l'endpoint API di Adaptive Planning
exportInstances.
Configura il connettore di Workday Adaptive Planning
Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.
- Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
- In Connector Connection, seleziona Workday Adaptive Planning e il CloudRunner predefinito.
Workiva offre due metodi di autenticazione (Basic e JWT Bearer Grant (Workday Credentials)). Puoi selezionare quello che desideri utilizzare alla voce Credenziali nella configurazione della connessione.
Autenticazione con autenticazione di base
- In Properties, inserisci facoltativamente il codice dell'istanza di Pianificazione adattiva.
- Seleziona "Credenziale di base" come tipo di autenticazione.
- Inserisci i seguenti valori:
Nome utente: Il nome utente dell'utente dell'integrazione da utilizzare con il connettore.
Password: La password dell'utente fornita nel campo Nome utente.
Autenticare con un JWT Bearer Grant (Credenziali Workday)
Questo metodo di autenticazione utilizza le credenziali di Workday per autenticarsi con Adaptive Planning e richiede che:
- L'SSO sia abilitato.
- Le impostazioni del tenant di Workday per l'accesso utente di Adaptive Planning e le API pubbliche sono abilitate.
- Una ISU API pubblica è mappata tra Workday e Adaptive Planning.
Per maggiori dettagli su questa configurazione, consulta la seguente documentazione di Workday:
- Impostare SAML SSO in Adaptive Planning per gli utenti sincronizzati
- Risoluzione dei problemi: Sincronizzazione degli utenti con Adaptive Planning
Come parte di questa configurazione, una chiave privata x509 deve essere caricata nella parte Connection Resources di questa connessione e un certificato pubblico creato da questa chiave deve essere caricato in Workday e associato a un client API di tipo "JWT Bearer Grant". Questo client deve essere a sua volta associato all'ISU che stai utilizzando per le richieste ad Adaptive Planning, con credenziali mappate tra i due sistemi.
Per maggiori dettagli su questa configurazione, consulta la seguente documentazione di Workday: Registrare i client API.
Dettagli sulla chiave
Il formato della chiave privata supportato è PKCS#8 e può essere protetto da password o non protetto da password. Una nuova chiave può essere creata con openssl con il seguente comando:
openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650
Determinare l'host, il dominio e il tenant di Workday
Utilizzando l'endpoint dell'API REST di Workday elencato nel Client API, identifica l'host, il dominio e l'inquilino che segue il formato di https://{host}.{domain}/ccx/api/v1/{tenant}
Esempio
https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany
| Proprietà | Valore |
| Inquilino | mycompany |
| Host | wd2-impl-services1 |
| Dominio | workday.com |
Imposta il tipo di credenziali Bearer nel connettore Adaptive Planning
- Carica la tua chiave privata nella sezione Risorse della connessione.
- Seleziona il tipo di autenticazione "Bearer".
- Inserisci le seguenti informazioni:
Proprietà Dettagli Chiave privata x509 Inserisci il nome della chiave privata caricata esattamente come mostrato nelle risorse di connessione. Password Inserisci la password della chiave privata. Lascia questo campo vuoto se la chiave non è protetta da password. ID client Inserisci l'ID client del client API JWT Bearer Grant. Utente del servizio di integrazione Inserisci il nome dell'utente del servizio di integrazione (ISU) associato al client API. Host Inserisci l'host dell'ambiente Workday a cui connetterti. Nell'URL dell'ambiente, i caratteri prima della proprietà Domain rappresentano l'host. Tenant Inserisci il tenant di Workday a cui connetterti. Dominio Inserisci il dominio dell'ambiente Workday a cui connetterti, ad esempio workday.com o myworkday.com.
Una volta impostata l'autenticazione:
- Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
- Per testare la connessione, crea ed esegui una catena con il comando Export Versions del connettore e verifica che il risultato sia valido.
Risoluzione dei problemi
Se la connessione a Workday Adaptive Planning fallisce:
- Verifica le credenziali di autenticazione dell'utente dell'integrazione.
- Assicurati che il ruolo dell'utente dell'integrazione abbia le autorizzazioni appropriate per i comandi che il connettore esegue.
- Se l'utente dell'integrazione può accedere a più istanze di Adaptive Planning, controlla il codice di istanza inserito per il connettore.
Per ulteriori informazioni su come effettuare richieste API di Adaptive Planning utilizzando le credenziali di Workday, consulta questa pagina di Workday: Effettuare richieste API di Adaptive Planning con le credenziali di Workday.