De OneStream -Workiva - integratie stelt organisaties in staat om de extractie, transformatie en levering van gegevens vanuit OneStream Cloud naar het Workiva-platform te automatiseren. Deze integratie kan worden geïmplementeerd met behulp van een directe API -gebaseerde verbinding via Workiva Chains en de HTTP Connector, of een op bestanden gebaseerde SFTP -workflow met behulp van de OneStream Smart Integration Connector (SIC).
Beide integratiemethoden ondersteunen de invoer van gegevens in Workiva voor daaropvolgende rapportageprocessen.
API-integratie
API-verbindingsvereisten
- OneStream-cloudomgeving: De API-integratiemethode wordt alleen ondersteund wanneer OneStream wordt gehost in een publiek toegankelijke cloudomgeving.
- Speciaal serviceaccount: Maak voor de beveiliging, controle en operationele stabiliteit een speciaal, niet-interactief serviceaccount aan binnen OneStream, specifiek voor de integratie.
- Minimale vereiste machtigingen: Wijs het serviceaccount alleen de machtigingen toe die nodig zijn om toegang te krijgen tot de relevante kubusweergaven en bijbehorende gegevens.
- Persoonlijk toegangstoken (PAT): Genereer een PAT met behulp van de serviceaccountgegevens en bewaar het token direct na aanmaak veilig, aangezien het daarna mogelijk niet meer kan worden opgevraagd.
- Netwerk- en firewalltoegang: Zorg ervoor dat de statische IP-adressen van Workiva op de lijst met toegestane IP-adressen staan om uitgaande HTTPS-communicatie (poort 443) naar het OneStream API-eindpunt mogelijk te maken.
Configureer de API-integratie
De API-integratie maakt gebruik van de eindpunten GetCubeView of GetAdoDataSetForCubeViewCommand om Cube View-gegevens uit OneStream op te halen.
Workiva Chains kan authenticeren via OneStream, het API-verzoek uitvoeren, de geretourneerde JSON-payload transformeren en de resulterende dataset in Wdata-tabellen laden voor rapportage en verdere verwerking.
Configuratiestappen voor Workiva
- Bewaar de PAT veilig: Maak een Werkruimtevariabele (bijvoorbeeld
onestream_api_pat) aan in Chain Builder en markeer de variabele als Geheim om de waarde te versleutelen en ongeautoriseerde inzage te voorkomen. - Vereiste connectoren inschakelen: Controleer of de HTTP-connector, de JSON-transformatieconnector en de tabulaire transformatieconnector zijn ingeschakeld en correct geconfigureerd in de Workiva-omgeving.
- Maak de bestemmingstabel Wdata aan: Exporteer een voorbeeld-kubusweergave vanuit OneStream als een CSV-bestand en gebruik deze als sjabloon voor het schema van de Wdata-tabel. Noteer de tabel-ID voor gebruik binnen de ketenconfiguratie.
- Gegevens transformeren en toewijzen: Converteer de JSON-respons indien nodig naar een tabelvorm en wijs vervolgens OneStream-veldnamen toe aan de overeenkomstige Workiva-tabelkolommen en gegevenstypen.
- Kettingautomatisering configureren: Configureer het triggermechanisme van de ketting om te bepalen wanneer deze wordt uitgevoerd. Opties zijn onder andere: uitvoeren volgens een gedefinieerd schema, op aanvraag (handmatige uitvoering), als een stap binnen een grotere orchestratieworkflow, of geactiveerd door een controleblad.
Vereiste API-parameters
| Parameter | Vereist | Beschrijving |
| BasisWebServerUrl | Ja | De basis-URL van de OneStream-applicatieserver. |
| Applicatienaam | Ja | De naam van de OneStream-applicatie die de Cube View bevat. |
| Naam van de kubusweergave | Ja | De kubusweergave werd gebruikt om de dataset op te halen. |
| Kubusnaam | Ja | De bijbehorende kubusnaam die door de kubusweergave wordt gebruikt. |
SFTP-integratie
Bij een SFTP-gebaseerde integratie exporteert OneStream gegevensbestanden (meestal in CSV-formaat) naar een tussenliggende SFTP-locatie met behulp van de Smart Integration Connector. Workiva Chains haalt vervolgens de bestanden op met behulp van de SFTP-connector, verwerkt de gegevens en laadt deze in Wdata-tabellen.
Deze aanpak wordt vaak gebruikt in organisaties waar directe API-toegang niet beschikbaar is of waar men er de voorkeur aan geeft geen CubeViews te creëren of te gebruiken.
| Verantwoordelijkheden van het IT-/financiële team van de klant | Verantwoordelijkheden van de implementatiepartner |
|
|