Centrum wsparcia Workiva

Łącznik Oracle® Hyperion® Financial Management umożliwia używanie poleceń w łańcuchu w celu interakcji z wersją Oracle Hyperion Financial Management (HFM) 11.1.2.4.x lub 11.2.x. Można na przykład utworzyć łańcuch, który będzie wyodrębniał dane z Oracle HFM jako plik do przesłania do tabeli Wdata.

Ważne: Chociaż ten łącznik został stworzony przez firmę Workiva w celu połączenia z systemem HFM, nasz zespół wsparcia może pomóc jedynie w jego skonfigurowaniu w obszarze roboczym; nie jesteśmy w stanie rozwiązywać problemów ani udzielać pomocy w przypadku problemów, które mają swoje źródło poza platformą Workiva.

Uwaga: Aby połączyć się z wersjami Oracle HFM od 9.3.1 do 11.1.2.3, należy użyć łącznika Oracle HFM Legacy.

Wymagania wstępne

Aby nawiązać połączenie, będziesz potrzebować:

• Serwer z dostępem do Oracle HFM.
  Powinien być zainstalowany cały pakiet HFM (wliczając JDK, zasoby pomocnicze itd.)
• Instalacje:
  • Środowisko wykonawcze Java dołączone do HFM.Od 2026 r. jest to zwykle Oracle Java Runtime Environment (JRE) 8. To środowisko wykonawcze należy zainstalować jako środowisko JRE na poziomie systemu.

  • To środowisko wykonawcze musi być dostępne z poziomu wiersza poleceń.
    Możesz to sprawdzić, otwierając terminal (Linux) lub wiersz poleceń/PowerShell (Windows) i wpisując java -version. Odpowiedź powinna wyglądać mniej więcej tak: (wersja 1.8.x to JRE 8)

    wersja Java „1.8.0_481” Java(TM) SE Runtime Environment (kompilacja 1.8.0_481-b10) Java HotSpot(TM) 64-bitowa maszyna wirtualna serwera (kompilacja 25.481-b10, tryb mieszany)

    Jeśli nie jest dostępny, musisz dostosować zmienną środowiskową PATH.

    Uwaga: Jeśli spróbujesz użyć innych maszyn wirtualnych Java, łącznik może nie działać prawidłowo; jest to spowodowane niektórymi starszymi wymaganiami bibliotek Java Oracle HFM.

• Agent egzekucyjny GroundRunner

  Uwaga: Zainstaluj GroundRunner na serwerze Enterprise Performance (EPM) hostującym usługę aplikacji HFM.Firma Workiva nie może zapewnić pomocy technicznej w zakresie rozwiązywania problemów, jeśli GroundRunner działa na innym serwerze lub w innej sieci niż instancja Oracle HFM.

• Ścieżki do instancji systemu Oracle Enterprise Performance (EPM) i jej katalogu domowego HFM.
• Nazwa klastra serwera HFM, taka jaka pojawia się w rejestrze usług współdzielonych EPM.

• Użytkownik integracyjny Oracle HFM, używany do uwierzytelniania w instancji Oracle HFM.

  Uwaga: Użytkownik integracji musi być użytkownikiem katalogu natywnego — a nie użytkownikiem Microsoft® Active Directory® (MSAD) — z dostępem do danych wymaganych do raportowania i rozszerzonej analityki. Użytkownik MSAD jest nadal potrzebny, ale jego celem jest komunikacja z GroundRunnerem.

• GroundRunner wykonujący zadania w Oracle HFM i relacyjnej bazie danych.

  Uwaga: Aby włączyć połączenie, użytkownik integracji GroundRunner musi mieć uprawnienia Execute do katalogu domowego HFM.

Aby uzyskać pomoc przy tworzeniu i budowaniu łańcuchów, zalecamy również zidentyfikowanie:

• Twoi administratorzy Workiva
• Administratorzy Oracle HFM
• Zespoły inżynierów sieci i infrastruktury

Skonfiguruj połączenie z Oracle HFM

Aby nawiązać połączenie, administrator IT konfiguruje serwer, a właściciel obszaru roboczego tworzy połączenie z Oracle HFM.

Krok 1. Skonfiguruj serwer

1. W Oracle HFM utwórz użytkownika integracyjnego i przyznaj mu dostęp do funkcji Reporting i Extended Analytics.
2. Na serwerze, który może uzyskać dostęp do Oracle HFM:

   • Zainstaluj środowisko uruchomieniowe Java dołączone do HFM. Będzie to Java Runtime Environment 8 lub nowszy.

     Uwaga: Podczas instalowania Javy może pojawić się pytanie, czy zainstalować Java Development Kit (JDK) czy Java Runtime Environment (JRE). Wymagane jest jedynie środowisko JRE.

   • Dodaj ścieżkę do maszyny wirtualnej Java (JVM) spakowanej z Oracle HFM (zwykle jest to JAVA_HOME środowiska JRE, a następnie folder bin ) do zmiennej systemowej PATH.
   • Pobierz, zainstaluj i aktywuj agenta wykonawczego GroundRunner.
   • Zezwól na domeny hosta dla Workiva.

Krok 2. Skonfiguruj łącznik Oracle HFM

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator zabezpieczeń organizacji musi go najpierw włączyć w Konfiguracji.

1. W Chain Builderkliknij Connections compare_arrows, a następnie Create w prawym górnym rogu.
2. W obszarze Połączenie łącznikawybierz Oracle Hyperion Financial Management i GroundRunner zainstalowany na serwerze.
3. W polu Informacje podstawowewprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.

4. W obszarze Właściwościwprowadź szczegóły połączenia:

   Uwaga: Aby uzyskać prawidłowe wartości, skontaktuj się z administratorem Oracle HFM.

   Właściwość	Szczegóły
   Nazwa użytkownika	Wprowadź nazwę użytkownika integracji Oracle HFM.
   Hasło	Wprowadź hasło użytkownika integracji Oracle HFM.
   Strona główna EPM	Wprowadź ścieżkę do katalogu domowego HFM systemu Oracle EPM. Wartość domyślna: C:/Oracle/Middleware/EPMSystem11R1.
   Instancja EPM	Wprowadź ścieżkę do systemu EPM. Wartość domyślna to: C:/Oracle/Middleware/user_projects/epmsystem1.
   Klaster HFM	Wprowadź nazwę klastra dla serwera Oracle HFM, tak jak pojawia się ona w rejestrze usług współdzielonych EPM.

   Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu algorytmu Advanced Encryption Standard (AES)-256.

5. Wybierz środowiska robocze, których chcesz używać ze złączem, i kliknij Zapisz.
6. Aby przetestować połączenie, utwórz i uruchom łańcuch za pomocą polecenia] Extract Members List[łącznika Oracle HFM i sprawdź, czy zwraca on prawidłowy wynik.

Rozwiązywanie problemów

Czy mogę używać łącznika HFM na serwerze z równoważeniem obciążenia?

Równoważenie obciążenia jest wbudowane w HFM i nie jest kontrolowane przez łańcuchy, ale możesz wprowadzić swoją konfigurację w polu ClusterName podczas konfigurowania łącznika.

Połączenie z Oracle HFM nie powiodło się

Sprawdź nazwę klastra Oracle HFM, z którym chcesz się połączyć, oraz dane uwierzytelniające użytkownika integracji Oracle HFM.

Złącze zwraca pusty wynik lub brak odpowiedzi

Aby mieć pewność, że GroundRunner może komunikować się z plikami JAR Oracle HFM, sprawdź ścieżki do katalogu domowego HFM i instancji EPM.

Łącznik zwraca błąd „niewystarczające uprawnienia”

Sprawdź, czy użytkownik integracji Oracle HFM ma dostęp zarówno do odczytu, jak i zapisu, a nie tylko do odczytu.

Uwaga: Użytkownik MSAD, od którego zależy GroundRunner, musi mieć również wystarczające uprawnienia do odczytu/zapisu w katalogach zawierających pliki, z którymi Chains będzie wchodzić w interakcję.

Polecenie zwraca kod wyjścia „Sukces”, ale nie ma żadnego wyniku

Jeśli polecenie Wyczyść wycinek, Kopiuj dane, Wyodrębnij dane do bazy danychlub Wyodrębnij dane do pliku zostanie wykonane pomyślnie, ale nie zwróci żadnego wyniku, sprawdź, czy jego właściwość „Tylko rozwiń” nie jest zaznaczona. Wybierz opcję „Rozwiń tylko”, aby wyświetlić członków bez wyodrębniania, np. w celach testowych.

Podczas instalacji na wielu serwerach występuje błąd uwierzytelniania

Poszukaj następującego wiersza w logach:

 INFORMACJA: Nie znaleziono pliku reg.properties.

Jeżeli tak jest, skopiuj plik reg.properties z Oracle\Middleware\user_projects\config\foundation\11.1.2.0

do

Oracle\Middleware\user_projects\epmsystem1\config\foundation\11.1.2.0.