Integracja OneStream z Workiva umożliwia organizacjom automatyzację ekstrakcji, transformacji i dostarczania danych z OneStream Cloud na platformę Workiva. Integrację tę można wdrożyć przy użyciu bezpośredniego połączenia opartego na interfejsie API za pośrednictwem łańcuchów Workiva i łącznika HTTP lub opartego na plikach przepływu pracy SFTP za pomocą łącznika OneStream Smart Integration Connector ( SIC ).
Obie metody integracji obsługują pobieranie danych do systemu Workiva w celu dalszego przetwarzania połączonych procesów raportowania.
Integracja API
Wymagania dotyczące połączenia API
- Środowisko chmurowe OneStream: Podejście do integracji API jest obsługiwane tylko wtedy, gdy OneStream jest hostowany w publicznie dostępnym środowisku chmurowym.
- Dedykowane konto usługi: Ze względów bezpieczeństwa, audytu i stabilności operacyjnej utwórz w OneStream dedykowane, nieinteraktywne konto usługi specjalnie na potrzeby integracji.
- Minimalne wymagane uprawnienia: Przypisz kontu usługi tylko uprawnienia wymagane do dostępu do odpowiednich widoków kostki i powiązanych danych.
- Token dostępu osobistego (PAT): Wygeneruj PAT przy użyciu danych uwierzytelniających konta usługi i bezpiecznie przechowuj token natychmiast po utworzeniu, ponieważ później może nie być możliwe jego odzyskanie.
- Dostęp do sieci i zapory sieciowej: Upewnij się, że statyczne adresy IP Workiva znajdują się na liście dozwolonych, aby zezwolić na wychodzącą komunikację HTTPS (port 443) z punktem końcowym interfejsu API OneStream.
Skonfiguruj integrację API
Integracja API wykorzystuje punkty końcowe GetCubeView lub GetAdoDataSetForCubeViewCommand w celu pobrania danych Cube View z OneStream.
Workiva Chains może uwierzytelniać się względem OneStream, wykonywać żądanie API, przekształcać zwrócony ładunek JSON i ładować wynikowy zestaw danych do tabel Wdata w celu raportowania i dalszego przetwarzania.
Kroki konfiguracji Workiva
- Bezpieczne przechowywanie PAT: Utwórz zmienną obszaru roboczego (na przykład
onestream_api_pat) w programie Chain Builder i oznacz zmienną jako Secret, aby zaszyfrować wartość i zapobiec nieautoryzowanemu dostępowi. - Włącz wymagane łączniki: Sprawdź, czy łącznik HTTP, łącznik transformacji JSON i łącznik transformacji tabelarycznej są włączone i poprawnie skonfigurowane w środowisku Workiva.
- Utwórz tabelę docelową Wdata: Wyeksportuj przykładowy widok kostki z OneStream jako plik CSV i użyj go jako szablonu dla schematu tabeli Wdata. Zapisz identyfikator tabeli do wykorzystania w konfiguracji łańcucha.
- Przekształć i zmapuj dane: W razie potrzeby przekonwertuj odpowiedź JSON do formatu tabelarycznego, a następnie zmapuj nazwy pól OneStream na odpowiadające im kolumny tabeli Workiva i typy danych.
- Skonfiguruj automatyzację łańcucha: Skonfiguruj mechanizm wyzwalania łańcucha, aby kontrolować, kiedy wykonuje on opcje, w tym uruchamianie według zdefiniowanego harmonogramu, na żądanie (wykonywanie ręczne), jako krok w ramach większego przepływu pracy orkiestracjilub wyzwalane przez arkusz sterowania.
Wymagane parametry API
| Parametr | Wymagane | Opis |
| Adres URL serwera bazowego | Tak | Podstawowy adres URL serwera aplikacji OneStream. |
| NazwaAplikacji | Tak | Nazwa aplikacji OneStream zawierającej widok kostki. |
| NazwaWidokuKostki | Tak | Widok kostki używany do pobierania zestawu danych. |
| Nazwa kostki | Tak | Powiązana nazwa kostki używana przez widok kostki. |
Integracja SFTP
W przypadku integracji opartej na protokole SFTP OneStream eksportuje pliki danych (zwykle w formacie CSV) do pośredniej lokalizacji SFTP przy użyciu Smart Integration Connector. Następnie Workiva Chains pobiera pliki za pomocą łącznika SFTP, przetwarza dane i ładuje je do tabel Wdata.
Podejście to jest powszechnie stosowane w organizacjach, w których bezpośredni dostęp do interfejsu API jest niedostępny lub nie chce się tworzyć ani używać widoków CubeView.
| Obowiązki zespołu IT/finansów klienta | Obowiązki partnera wdrażającego |
|
|