Workday Adaptive Planning Connector , som tidigare kallades Adaptive Insights, använder kommandon i en kedja för att importera eller exportera data eller metadata.
Obs: Denna kontakt är tillverkad av Workiva och ansluts till ett tredjepartssystem. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.
Krav
För att aktivera anslutningen använder anslutningen Workday Adaptive Planning REST API. För att sätta upp kontakten behöver du:
- En integrationsanvändare som har konfigurerats i Adaptive Planning och som har tilldelats en roll med lämpliga behörigheter för att utföra connectorens kommandon.
- Integrationsanvändarens användarnamn och lösenord.
- Om integrationsanvändaren har åtkomst till flera instanser av Adaptive Planning, den Instanskod som de kommer att ansluta till.
Obs: Om du vill fastställa integrationsanvändarens tillgängliga instanskoder kan du använda API-slutpunkten Adaptive Planning
exportInstances.
Konfigurera Workday Adaptive Planning-anslutningen
Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connectionväljer du Workday Adaptive Planning och standard CloudRunner.
Workiva erbjuder två autentiseringsmetoder (Basic och JWT Bearer Grant (Workday Credentials)). Du kan välja vilken du vill använda under Credentials i anslutningskonfigurationen.
Autentisera med grundläggande autentisering
- Under Propertieskan du ange instanskoden för instansen Adaptive Planning.
- Välj "Basic Credential" som autentiseringstyp.
- Ange följande värden:
Username: Användarnamnet för den integrationsanvändare som ska användas med connectorn.
Password: Lösenordet för den användare som anges i fältet Username.
Autentisera med en JWT-bearer Grant (Workday-autentiseringsuppgifter)
Denna autentiseringsmetod använder Workday-autentiseringsuppgifter för att autentisera sig med Adaptive Planning och kräver att:
- SSO är aktiverat.
- Workday-klientinställningarna för Adaptive Planning User Sign-on och Public APIs enabled är aktiverade.
- En Public API ISU är mappad mellan Workday och Adaptive Planning.
För specifika detaljer om denna inställning, se följande Workday-dokumentation:
- Konfigurera SAML SSO till Adaptive Planning för synkroniserade användare
- Felsökning: Användarsynkronisering med adaptiv planering
Som en del av denna konfiguration måste en x509 privat nyckel laddas upp till Connection Resources del av denna anslutning, och ett offentligt certifikat som skapats av denna nyckel måste laddas upp till Workday och associeras med en API-klient av typen "JWT Bearer Grant". Denna klient måste i sin tur vara kopplad till den ISU som du använder för förfrågningar till Adaptive Planning, med mappade autentiseringsuppgifter mellan de två systemen.
För specifika detaljer om denna inställning, se följande Workday-dokumentation: Registrera API-klienter.
Viktiga detaljer
Det privata nyckelformatet som stöds är PKCS#8 och kan vara antingen lösenordsskyddat eller icke-lösenordsskyddat. En ny nyckel kan skapas med hjälp av openssl med följande kommando:
openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650
Fastställande av Workday-värd, domän och klient
Använd Workday REST API Endpoint som anges under API-klienten för att identifiera värd, domän och hyresgäst, vilket följer formatet https://{host}.{domain}/ccx/api/v1/{tenant}
Exempel
https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany
| Fastighet | Värde |
| Hyresgäst | mittföretag |
| Värd | wd2-impl-tjänster1 |
| Domän | workday.com |
Konfigurera typ av Bearer-autentiseringsuppgifter i anslutningen Adaptive Planning
- Ladda upp din privata nyckel till resursdelen av anslutningen.
- Välj autentiseringstypen "Bearer".
- Ange följande information:
Fastighet Detaljer x509 privat nyckel Ange namnet på den uppladdade privata nyckeln exakt som det visas i anslutningsresurserna. Lösenord Ange lösenordet för den privata nyckeln. Lämna detta fält tomt om din nyckel inte är lösenordsskyddad. Klient-ID Ange klient-ID för JWT Bearer Grant API-klienten. Användare av integrationstjänster Ange namnet på den ISU (Integration Service User) som är kopplad till API-klienten Värd Ange värden för den Workday-miljö som du vill ansluta till. I miljöns URL representerar tecknen före Domän egenskapen värden. Hyresgäst Ange den Workday-hyresgäst som du vill ansluta till. Domän Ange domänen för den Workday-miljö som du vill ansluta till, t.ex. workday.com eller myworkday.com.
När du har ställt in autentiseringen:
- Välj de miljöer som ska använda anslutningen och klicka på Save.
- För att testa anslutningen, skapa och kör en kedja med connector's Export Versions kommando, och kontrollera att den returnerar en giltig utdata.
Felsökning
Om anslutningen till Workday Adaptive Planning misslyckas:
- Verifiera autentiseringsuppgifterna för integrationsanvändaren.
- Se till att integrationsanvändarens roll har rätt behörighet för de kommandon som connectorn utför.
- Om integrationsanvändaren har åtkomst till flera instanser av Adaptive Planning, kontrollera den instanskod som angetts för anslutningen.
Mer information om hur du gör API-förfrågningar för Adaptive Planning med Workday-autentiseringsuppgifter finns på denna Workday-sida: Göra API-förfrågningar för Adaptive Planning med Workday-autentiseringsuppgifter.