Die OneStream-zu-Workiva-Integration von ermöglicht es Unternehmen, die Extraktion, Transformation und Bereitstellung von Daten aus der OneStream Cloud in die Workiva-Plattform zu automatisieren. Diese Integration kann entweder über eine direkte, API-basierte Verbindung über Workiva Chains und den HTTP-Connector oder über einen dateibasierten SFTP-Workflow unter Verwendung des OneStream Smart Integration Connector (SIC) realisiert werden.
Beide Integrationsmethoden unterstützen die Datenübernahme in Workiva für nachgelagerte, damit verbundene Berichtsprozesse.
API-Integration
Anforderungen an die API-Verbindung
- OneStream-Cloud-Umgebung: Der Ansatz der API-Integration wird nur unterstützt, wenn OneStream in einer öffentlich zugänglichen Cloud-Umgebung gehostet wird.
- Spezielles Dienstkonto: Legen Sie aus Gründen der Sicherheit, der Prüfbarkeit und der Betriebsstabilität in OneStream ein spezielles, nicht interaktives Dienstkonto an, das ausschließlich für die Integration bestimmt ist.
- Erforderliche Mindestberechtigungen: Weisen Sie dem Dienstkonto nur die Berechtigungen zu, die für den Zugriff auf die entsprechenden Cube-Ansichten und die zugehörigen Daten erforderlich sind.
- Persönliches Zugriffstoken (PAT): Erstellen Sie ein PAT unter Verwendung der Anmeldedaten des Dienstkontos und bewahren Sie das Token unmittelbar nach der Erstellung sicher auf, da es danach möglicherweise nicht mehr abgerufen werden kann.
- Netzwerk- und Firewall-Zugriff: Stellen Sie sicher, dass die statischen IP-Adressen von Workiva auf die Zulassungsliste gesetzt sind, um ausgehende HTTPS-Kommunikation (Port 443) zum OneStream-API-Endpunkt zu ermöglichen.
API-Integration konfigurieren
Die API-Integration nutzt die Endpunkte „ “, „GetCubeView“ ( ) oder „ “ sowie „GetAdoDataSetForCubeViewCommand“ ( ), um Cube-View-Daten aus OneStream abzurufen.
Workiva Chains können sich bei OneStream authentifizieren, die API-Anfrage ausführen, die zurückgegebene JSON-Datenlast umwandeln und den resultierenden Datensatz zur Berichterstellung und Weiterverarbeitung in Wdata-Tabellen laden.
Schritte zur Konfiguration von Workiva
- Speichern Sie den PAT sicher: Erstellen Sie im Chain Builder eine „ “-Arbeitsbereichsvariable (z. B.
onestream_api_pat) und kennzeichnen Sie die Variable als „ -Secret“, um den Wert zu verschlüsseln und unbefugten Zugriff zu verhindern. - Erforderliche Konnektoren aktivieren: Stellen Sie sicher, dass der HTTP-Konnektor, der JSON-Transformationskonnektor und der tabellarische Transformationskonnektor in der Workiva-Umgebung aktiviert und ordnungsgemäß konfiguriert sind.
- Erstellen Sie die Ziel-Wdata-Tabelle: Exportieren Sie eine Beispiel-Cube-Ansicht aus OneStream als CSV-Datei und verwenden Sie diese als Vorlage für das Schema der Wdata-Tabelle „ “. Notieren Sie sich die Tabellen-ID für die Verwendung in der Kettenkonfiguration.
- Daten transformieren und zuordnen: Wandeln Sie die JSON-Antwort bei Bedarf in ein tabellarisches Format um und ordnen Sie anschließend die OneStream-Feldnamen den entsprechenden Spalten und Datentypen der Workiva-Tabelle zu.
- Chain-Automatisierung konfigurieren: Konfigurieren Sie den Auslösemechanismus der Chain, um festzulegen, wann sie ausgeführt wird. Zu den Optionen gehören die Ausführung nach einem definierten Zeitplan , auf Abruf (manuelle Ausführung), als Schritt innerhalb eines größeren Orchestrierungs-Workflows oder ausgelöst durch ein Steuerblatt .
Erforderliche API-Parameter
| Parameter | Vorschrift | Beschreibung |
| BaseWebServerUrl | Ja | Die Basis-URL des OneStream-Anwendungsservers. |
| Anwendungsname | Ja | Der Name der OneStream-Anwendung, die die Cube-Ansicht enthält. |
| Name des Würfels | Ja | Die Cube-Ansicht, die zum Abrufen des Datensatzes verwendet wurde. |
| Würfelname | Ja | Der zugehörige Cube-Name, der von der Cube-Ansicht verwendet wird. |
SFTP-Integration
Bei einer SFTP-basierten Integration exportiert OneStream Datendateien (in der Regel im CSV-Format) mithilfe des Smart Integration Connectors an einen SFTP-Zwischenspeicherort. Workiva Chains ruft die Dateien anschließend über den SFTP-Konnektor „ “ ab, verarbeitet die Daten und lädt sie in Wdata-Tabellen.
Dieser Ansatz wird häufig in Unternehmen verwendet, in denen kein direkter API-Zugriff möglich ist oder man darauf verzichtet, CubeViews zu erstellen oder zu verwenden.
| Aufgaben des IT-/Finanzteams des Kunden | Aufgaben des Implementierungspartners |
|
|