Obs: Denna Workiva-utvecklade koppling låter dig ansluta Workiva- och Workday-plattformarna. Workiva Support hjälper dig gärna med konfigureringen av kopplingen i din arbetsyta. Eventuella fel eller felsökningar i Workday-plattformen måste dock hanteras av din Workday-administratör eller deras supportteam.
Med Workday-anslutningen kan du använda -kommandon i en kedja för att interagera med Workday® HR och ekonomi för att:
- Ladda ner anpassade rapporter från Workday
- Importera budgetdata till Workday
- Starta en Workday Enterprise Interface Builder (EIB)-integration
Krav
För att konfigurera anslutningen behöver du:
- Workday-klienten att ansluta till.
- Värden och domänen för Workday-miljön att ansluta till.
- Autentiseringsuppgifterna för en integrationssystemanvändare som skapats i Workday.
Steg 1: Hämta informationen om Workday-hyresgästen
Du kan fastställa information om hyresgäst, värd och domän från den offentliga webbtjänstens WSDL XML-fil i Workday.
- Skriv in "Offentliga webbtjänster" i Workdays sökfält och välj rapporten.
- Hitta webbtjänsten för den specifika integrationen du använder.
Exempel inkluderar: Bemanning för Get Workers, ekonomihantering för importbudget, integrationer för EIB-relaterade kommandon,… - Klicka på knappen "Relaterade åtgärder" för den tjänsten och klicka sedan på Visa WSDL under menyn "Webbtjänst".
- Leta reda på elementet
soapbind:addressi XML-filen (detta finns vanligtvis nära filens nedre del). - Använd URL:en från attributet
locationför att extrahera informationen om hyresgäst, värd och domän från URL:en.
URL:en använder följande format:https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
Exempel
Med hjälp av formatet ovan kan vi hitta hyresgästen, värden och domänen från ett exempel på en WSDL-URL:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| Egenskap | Exempelvärde |
|---|---|
| Hyresgäst | mittföretag |
| Värd | wd2-impl-tjänster1 |
| Domän | workday.com |
Du behöver dessa värden när du konfigurerar din koppling i nästa steg.
Steg 2: Konfigurera Workday-autentisering
Den här kopplingen erbjuder två sätt att autentisera: OAuth2 via API och användare + lösenord.
OAuth2 API-autentisering
Om du använder OAuth2 API-autentiseringmåste du ha en API-klient konfigurerad i Workday. Se Workdays supportsida Registrera API-klienter för instruktioner om hur du skapar en API-klient.
Som en del av denna API-klientkonfiguration, se till att du har:
- Vald Bearer som Access Token-typ.
- Följande kryssrutor har aktiverats (markerats):
- Uppdateringstokens som inte löper ut
- Inkludera Workday-ägt omfång
Omdirigerings-URL:er
Workiva har regionspecifika URL:er för anslutningsåsidosättning för anslutningskonfigurationer. Använd följande tabell för att välja rätt URL för din plats.
Om du befinner dig i Nord-, Central- eller Sydamerika, använd standard-URL:en. Om du befinner dig i Asien-Stillahavsområdet, använd APAC-URL:en. Om du befinner dig i EMEA, använd EU-URL:en.
| Miljö | Omdirigerings-URL |
|---|---|
| APAC-produkt | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| EU-produkt | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| Amerikansk produkt | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
OAuth2-slutpunkter
Om du använder OAuth2 för att verifiera din anslutning behöver du ha följande slutpunktsvärden. Dessa kommer att listas när du konfigurerar Workday API-klienten på sidan Redigera API-klient i Workday.
| Slutpunkt | Exempelvärde |
|---|---|
| REST-slutpunkt för arbetsdagen | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Workday OAuth2-tokenslutpunkt | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Workday OAuth2-auktoriseringsslutpunkt | https://xxxx.workday.com/xxxx/authorize |
TIPS: Om du använder en befintlig API-klientinstans som använder en OAuth2-token och hemlighet kan du se den här informationen högst upp på sidan Workday View API.
Grundläggande autentisering
Om du använder Grundläggande autentiseringläser du Workdays supportsidaSkapa ett Integration System User (ISU)-konto i Workday för instruktioner om hur du skapar en Integration System User (ISU).
Steg 3: Konfigurera Workday-anslutningen
Obs: För att göra kopplingen tillgänglig för användning i din organisations kedjor måste en säkerhetsadministratör för organisationen först aktivera den frånKonfiguration.
- Från Kedjebyggareklickar du på Anslutningaroch sedan på Skapa längst upp till höger.
- Under Anslutningsanslutningväljer du Workday-anslutning och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.
-
Under Egenskaperanger du anslutningens uppgifter.
Om du använder OAuth2 måste du ange värdena för Workday REST Endpoint, Workday OAuth2 Token Endpointoch Workday OAuth2 Authorization Endpoint.
Om du använder Grundläggande autentisering (användarnamn + lösenord), lämna dessa tomma.Fält Innehåll Hyresgäst Workday-klienten att ansluta till. Värd Värden för Workday-miljön att ansluta till. I miljöns URL representerar tecknen före egenskapen Domän värden. Domän Domänen för Workday-miljön att ansluta till,
såsomworkday.comellermyworkday.com.REST-slutpunkt för arbetsdagen REST-slutpunkts-URL:en som tillhandahålls av Workday.
(Endast om OAuth2-autentisering används.)Workday OAuth2-tokenslutpunkt Slutpunkts-URL:en för OAuth2-token som tillhandahålls av Workday.
(Endast om OAuth2-autentisering används.)Workday OAuth2-auktoriseringsslutpunkt OAuth2-slutpunkts-URL:en som tillhandahålls av Workday.
(Endast om OAuth2-autentisering används.)
Felsökning
Om anslutningen till Workday går fel:
- Kontrollera att autentiseringsuppgifterna för integrationssystemets användare är korrekta.
- Kontrollera att integrationssystemanvändaren har rätt behörighet för att komma åt de funktionella grupper och domäner som är relaterade till anslutningens kommandon.
- Kontrollera att rätt Workday-klient, värd och domän har angetts för anslutningen.
- När du kör kommandot Download custom report ska du se till att rapporttypen är inställd på Advanced. Sammansatta rapporter är för närvarande inte tillgängliga via Workday API.