Workiva kundestøttesenter

Workday Adaptive Planning Connector , tidligere kjent som Adaptive Insights, bruker kommandoer i en kjede for å importere eller eksportere data eller metadata.

Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.

Krav

For å aktivere tilkoblingen bruker koblingen Workday Adaptive Planning REST API. For å sette opp kontakten trenger du

• En integrasjonsbruker som er satt opp i Adaptive Planning, og som har fått tildelt en rolle med passende tillatelser til å utføre koblingens kommandoer.
• Integrasjonsbrukerens brukernavn og passord.
• Hvis integrasjonsbrukeren har tilgang til flere instanser av Adaptive Planning, angis instanskoden de vil koble seg til.

  Merk: For å finne integrasjonsbrukerens tilgjengelige forekomstkoder kan du bruke API-endepunktet Adaptive Planning exportInstances.

Konfigurer Workday Adaptive Planning Connector

Merk: For å gjøre kontakten tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Configuration.

1. Fra Chain Builder klikker du på Connections compare_arrows, og deretter Create øverst til høyre.
2. Under Connector Connection velger du Workday Adaptive Planning og standard CloudRunner.
   

Workiva tilbyr to autentiseringsmetoder (Basic og JWT Bearer Grant (Workday Credentials)). Du kan velge den du vil bruke, under Credentials i tilkoblingskonfigurasjonen.

Autentiser med grunnleggende autentisering

1. Under Properties kan du eventuelt angi forekomstkoden for forekomsten Adaptiv planlegging.
2. Velg "Basic Credential" som autentiseringstype.
3. Skriv inn følgende verdier:
   Brukernavn: Brukernavnet til integrasjonsbrukeren som skal brukes med kontakten.
   Passord: Passordet for brukeren som er angitt i feltet Brukernavn.

Autentisering med en JWT Bearer Grant (Workday Credentials)

Denne autentiseringsmetoden bruker Workday-legitimasjon for å autentisere seg med Adaptive Planning, og krever at:

• SSO er aktivert.
• Workday-tenantinnstillingene for Adaptive Planning User Sign-on og Public APIs er aktivert.
• En offentlig API ISU er mappet mellom Workday og Adaptive Planning.

For mer informasjon om dette oppsettet, se følgende Workday-dokumentasjon:

• Konfigurer SAML SSO i Adaptive Planning for synkroniserte brukere
• Feilsøking: Brukersynkronisering med adaptiv planlegging

Som en del av denne konfigurasjonen må en x509-privat nøkkel lastes opp til Connection Resources -delen av denne tilkoblingen, og et offentlig sertifikat som er opprettet av denne nøkkelen, må lastes opp til Workday og knyttes til en API-klient av typen "JWT Bearer Grant". Denne klienten må i sin tur være tilknyttet ISU-enheten du bruker for forespørsler til Adaptive Planning, med tilordnet påloggingsinformasjon mellom de to systemene.

For spesifikke detaljer om dette oppsettet, se følgende Workday-dokumentasjon: Registrere API-klienter.

Viktige detaljer

Det private nøkkelformatet som støttes, er PKCS#8, og kan enten være passordbeskyttet eller ikke-passordbeskyttet. En ny nøkkel kan opprettes ved hjelp av openssl med følgende kommando:

openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650

Bestemme Workday-vert, domene og leietaker

Ved hjelp av Workday REST API-endepunktet som er oppført under API-klienten, identifiserer du verten, domenet og leietakeren, som følger formatet https://{host}.{domain}/ccx/api/v1/{tenant}

Eksempel

https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany

Konfigurer type bærerlegitimasjon i Adaptive Planning Connector

1. Last opp den private nøkkelen din til ressursdelen av tilkoblingen.
   
2. Velg autentiseringstypen "Bearer".
   
3. Skriv inn følgende informasjon:

   Egenskap	Detaljer
   x509 privat nøkkel	Skriv inn navnet på den opplastede privatnøkkelen nøyaktig slik det vises i tilkoblingsressursene.
   Passord	Skriv inn passordet for den private nøkkelen. La dette feltet stå tomt hvis nøkkelen ikke er passordbeskyttet.
   Klient-ID	Skriv inn klient-ID-en til JWT Bearer Grant API-klienten.
   Bruker av integrasjonstjenesten	Skriv inn navnet på integrasjonstjenestebrukeren (ISU) som er knyttet til API-klienten
   Vert	Angi verten for Workday-miljøet du vil koble deg til. I miljøets URL representerer tegnene før Domain-egenskapen verten.
   Leietaker	Skriv inn Workday-leietakeren du vil koble deg til.
   Domene	Skriv inn domenet til Workday-miljøet du vil koble til, for eksempel workday.com eller myworkday.com.

Når du har konfigurert autentiseringen:

1. Velg miljøene som skal bruke tilkoblingen, og klikk på Lagre.
2. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens Export Versions -kommando, og kontrollere at den returnerer en gyldig utdata.

Feilsøking

Hvis tilkoblingen til Workday Adaptive Planning mislykkes:

• Bekreft integrasjonsbrukerens autentiseringsopplysninger.
• Sørg for at integrasjonsbrukerens rolle har de riktige tillatelsene for kommandoene som koblingen utfører.
• Hvis integrasjonsbrukeren har tilgang til flere forekomster av Adaptive Planning, må du kontrollere forekomstkoden som er angitt for koblingen.

For mer informasjon om hvordan du gjør Adaptive Planning API-forespørsler ved hjelp av Workday-legitimasjon, se denne Workday-siden: Foreta API-forespørsler for Adaptive Planning med Workday-legitimasjon.