|
Klassieke bestandstypen zijn vanaf januari 2021 niet meer beschikbaar voor gebruik. U kunt uw klassieke bestanden omzetten of een PDF downloaden. Meer informatie

Workiva-ondersteuningscentrum

Integratie van OneStream met Workiva

Integratie van OneStream met Workiva

  • Laatst bijgewerkt op
Gerelateerd aan API API versions OneStream SFTP

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.
  • OAuth2-clientreferenties (niet-interactieve gebruiker): Voor optimale beveiliging en controle kunt u een speciale OneStream-gebruiker aanmaken voor deze integratie, waarbij u symmetrische referenties (client-ID en clientgeheim) gebruikt voor authenticatie.
  • Minimale vereiste machtigingen: Wijs het serviceaccount alleen de machtigingen toe die nodig zijn om toegang te krijgen tot de relevante kubusweergaven en bijbehorende gegevens.
  • 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.
Opmerking: Je kunt optioneel een Personal Access Token (PAT) gebruiken in plaats van OAuth2. Deze aanpak vereist dat een standaard interactieve OneStream-gebruiker inlogt op de Identity & Access Management Portal om het token te genereren. Omdat het token mogelijk niet meer kan worden opgevraagd nadat het is gegenereerd, moet u het onmiddellijk vastleggen. Om het veilig op te slaan, maak je een Workspace Variable (zoals onestream_api_pat ) aan in Chain Builder en markeer je deze als Secret om de waarde te versleutelen.

 

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.

onestream_workiva_api_integration_v2.png

Configuratiestappen voor Workiva

  1. Bewaar de OAuth2-referenties veilig : Maak werkruimtevariabelen aan in Chain Builder voor zowel uw client-ID als uw clientgeheim. Bij het aanmaken van de variabele voor het clientgeheim (bijvoorbeeld onestream_api_secret ), moet u de variabele markeren als Secret. Dit versleutelt de waarde en voorkomt dat onbevoegden deze kunnen inzien.
  2. Vereiste connectoren inschakelen: Controleer of de HTTP-connector, de JSON-transformatieconnector en de tabulaire transformatieconnector zijn ingeschakeld en correct geconfigureerd in de Workiva-omgeving.
  3. 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.
  4. 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.
  5. 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.
CubeViewName 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.

onestream_workiva_sftp_integration.png
Verantwoordelijkheden van het IT-/financiële team van de klant Verantwoordelijkheden van de implementatiepartner
  • Het SFTP-omgeving opzetten en onderhouden.
  • Configureer de Smart Integration Connector (SIC) om bestanden over te dragen naar de SFTP-locatie.
  • Definieer het gewenste authenticatiemechanisme (gebruikersnaam/wachtwoord of authenticatie op basis van SSH-sleutel).
  • Geef de verbindingsgegevens van de SFTP-server en de vereiste inloggegevens op.
  • Handhaaf het operationele integratieproces na de ingebruikname.
  • Configureer gegevensbeheersequenties binnen OneStream om het genereren en exporteren van rapporten te automatiseren.
  • Bouw en onderhoud de Workiva-keten die wordt gebruikt om gegevens op te halen, te valideren, te transformeren en te importeren in Wdata.
  • Configureer downstream rapportage-integraties en vernieuw processen.

 

Aanvullende bronnen

De OneStream -Workiva - integratie stelt organisaties in staat om de extractie, transformatie en levering van gegev...