Integrasjonen mellom OneStream og Workiva gjør det mulig for organisasjoner å automatisere utvinning, transformasjon og levering av data fra OneStream Cloud til Workiva-plattformen. Denne integrasjonen kan implementeres enten ved hjelp av en direkte API-basert tilkobling gjennom Workiva Chains og HTTP Connector, eller en filbasert SFTP-arbeidsflyt ved hjelp av OneStream Smart Integration Connector (SIC).
Begge integrasjonsmetodene støtter inntak av data i Workiva for nedstrøms tilkoblede rapporteringsprosesser.
API-integrasjon
Krav til API-tilkobling
- OneStream Cloud Environment: API-integrasjonsmetoden støttes bare når OneStream driftes i et offentlig tilgjengelig skymiljø.
- Dedikert tjenestekonto: Av sikkerhetshensyn, revisjon og driftsstabilitet, opprett en dedikert ikke-interaktiv tjenestekonto i OneStream spesielt for integrasjonen.
- Minimum nødvendige tillatelser: Tildel tjenestekontoen kun tillatelsene som kreves for å få tilgang til relevante kubevisninger og tilhørende data.
- Personlig tilgangstoken (PAT): Generer en PAT ved hjelp av tjenestekontoens påloggingsinformasjon og lagre tokenet sikkert umiddelbart etter opprettelse, da det kanskje ikke kan hentes frem etterpå.
- Nettverks- og brannmurtilgang: Sørg for at Workivas statiske IP-adresser er oppført som tillatt for å tillate utgående HTTPS-kommunikasjon (port 443) til OneStream API-endepunktet.
Konfigurer API-integrasjonen
API-integrasjonen bruker endepunktene GetCubeView eller GetAdoDataSetForCubeViewCommand for å hente Cube View-data fra OneStream.
Workiva Chains kan autentisere mot OneStream, utføre API-forespørselen, transformere den returnerte JSON-nyttelasten og laste det resulterende datasettet inn i Wdata-tabeller for rapportering og nedstrømsbehandling.
Workiva-konfigurasjonstrinn
- Lagre PAT-en sikkert: Opprett en Arbeidsområdevariabel (for eksempel
onestream_api_pat) i Chain Builder og merk variabelen som Hemmelig for å kryptere verdien og forhindre uautorisert innsyn. - Aktiver nødvendige koblinger: Bekreft at HTTP-koblingen, JSON-transformasjonskoblingen og tabelltransformasjonskoblingen er aktivert og riktig konfigurert i Workiva-miljøet.
- Opprett mål-Wdata-tabellen: Eksporter en eksempelkubevisning fra OneStream som en CSV-fil og bruk den som mal for Wdata-tabellskjemaet. Registrer tabell-ID-en for bruk i kjedekonfigurasjonen.
- Transformer og tilordne data: Konverter JSON-svaret til et tabellformat om nødvendig, og tilordne deretter OneStream-feltnavn til de tilsvarende Workiva-tabellkolonnene og datatypene.
- Konfigurer kjedeautomatisering: Konfigurer kjedens utløsermekanisme for å kontrollere når den kjører. Alternativer inkluderer kjøring på en definert tidsplan, på forespørsel (manuell utførelse), som et trinn i en større orkestreringsarbeidsflyteller utløst av et kontrollark.
Nødvendige API-parametere
| Parameter | Påkrevd | Beskrivelse |
| BaseWebServerUrl | Ja | Basis-URL-en til OneStream-applikasjonsserveren. |
| Programnavn | Ja | Navnet på OneStream-applikasjonen som inneholder kubevisningen. |
| Kubevisningsnavn | Ja | Kubevisningen som brukes til å hente datasettet. |
| Kubenavn | Ja | Det tilknyttede kubenavnet som brukes av kubevisningen. |
SFTP-integrasjon
I en SFTP-basert integrasjon eksporterer OneStream datafiler (vanligvis CSV-format) til en mellomliggende SFTP-plassering ved hjelp av Smart Integration Connector. Workiva Chains henter deretter filene ved hjelp av SFTP-koblingen, behandler dataene og laster dem inn i Wdata-tabeller.
Denne tilnærmingen brukes ofte i organisasjoner der direkte API-tilgang ikke er tilgjengelig, eller det er en preferanse for å ikke opprette eller bruke CubeViews.
| Ansvar for kundens IT-/økonomiteam | Ansvar for implementeringspartnere |
|
|