Koppling till Oracle Hyperion Financial Management (HFM)

Med Oracle® Hyperion® Financial Management-anslutningen kan du använda kommandon i en kedja för att interagera med Oracle Hyperion Financial Management (HFM) version 11.1.2.4.x eller 11.2.x. Du kan till exempel skapa en kedja för att extrahera data från Oracle HFM som en fil att ladda upp till en Wdata-tabell.

Viktigt: Även om den här anslutningen byggdes av Workiva för att ansluta till ett HFM-system, kan vårt supportteam bara hjälpa till att konfigurera den i din arbetsyta. Vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.

Obs: För att ansluta till Oracle HFM version 9.3.1 till 11.1.2.3, använd Oracle HFM Legacy-anslutningen.

Förkunskapskrav

För att konfigurera anslutningen behöver du:

En server med åtkomst till Oracle HFM.
Den bör ha hela HFM-sviten installerad (inklusive JDK:er, stödjande resurser etc.)
Installationer av:
- Java-körningsmiljön som medföljer HFM.Från och med 2026 är detta vanligtvis Oracle Java Runtime Environment (JRE) 8. Denna runtime bör installeras som JRE på systemnivå.
- Denna runtime måste vara tillgänglig från kommandoraden.
  Du kan testa detta genom att öppna en terminal (Linux) eller kommandotolken/PowerShell (Windows) och ange java -version. Svaret bör se ut ungefär så här: (version 1.8.x är JRE 8)
```
Java-version "1.8.0_481" Java(TM) SE Runtime Environment (version 1.8.0_481-b10) Java HotSpot(TM) 64-bitars server-VM (version 25.481-b10, blandat läge)
```
  Om den inte är tillgänglig måste du justera din PATH-miljövariabel.
  
  Obs: Om du försöker använda andra JVM-maskiner kanske kopplingen inte fungerar korrekt. Detta beror på vissa äldre krav i Oracle HFM Java-biblioteken.

En GroundRunner exekveringsagent

Obs: Installera GroundRunner på en Enterprise Performance (EPM)-servermaskin som är värd för HFM Application Service. Workiva kan inte tillhandahålla support för felsökning när GroundRunner körs på en annan server eller i ett annat nätverk än Oracle HFM-instansen.

Sökvägar till systeminstansen Oracle Enterprise Performance (EPM) och dess HFM-hemkatalog.
HFM-serverns klusternamn som det visas i EPM Shared Services Registry.
En Oracle HFM-integrationsanvändare som används för att autentisera sig med Oracle HFM-instansen.

Obs: Integrationsanvändaren måste vara en Native Directory-användare – inte en Microsoft® Active Directory® (MSAD)-användare – med åtkomst till data som krävs för rapportering och utökad analys. MSAD-användaren behövs fortfarande, men dess syfte är att kommunicera med GroundRunner.
En GroundRunner för att utföra uppgifterna i Oracle HFM och relationsdatabasen.

Obs: För att aktivera anslutningen behöver GroundRunners integrationsanvändare körbehörighet till HFM:s hemkatalog.

För att få hjälp med att skapa och bygga kedjor rekommenderar vi också att du identifierar:

Dina Workiva-administratörer
Administratörer för Oracle HFM
Dina team för nätverks- och infrastrukturteknik

Konfigurera anslutningen till Oracle HFM

För att konfigurera anslutningen konfigurerar en IT-administratör servern och en ägare av arbetsytan skapar anslutningen till Oracle HFM.

Steg 1: Konfigurera servern. Konfigurera servern

I Oracle HFM skapar du integrationsanvändaren och beviljar åtkomst till Reporting and Extended Analytics.
På den server som har åtkomst till Oracle HFM:
- Installera Java-körningsprogrammet som medföljer HFM. Detta kommer att vara Java Runtime Environment 8 eller senare.
  
  Obs: När du installerar Java kan du få frågan om du vill installera Java Development Kit (JDK) eller Java Runtime Environment (JRE). Endast JRE krävs.
- Lägg till sökvägen till den JVM som paketeras med Oracle HFM (detta är vanligtvis JAVA_HOME för JRE och sedan bin -mappen) till systemmappen PATH.
- Ladda ner, installera och aktivera GroundRunner-körningsagenten.
- Tillåt värddomänerna för Workiva.

Steg 2. Konfigurera Oracle HFM-anslutningen

Obs: För att göra kopplingen tillgänglig för användning i din organisations kedjor måste en organisations säkerhetsadministratör först aktivera den från Konfiguration.

Från Kedjebyggareklickar du på Anslutningar compare_arrowsoch sedan på Skapa längst upp till höger.
Under Connector Connection väljer du Oracle Hyperion Financial Management och den GroundRunner som är installerad på servern.
Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.

Under Egenskaperanger du anslutningens detaljer:

Obs: Kontakta din Oracle HFM-administratör för korrekta värden.

Egenskap	Information
Användarnamn	Ange användarnamnet för användaren av Oracle HFM-integrationen.
Lösenord	Ange lösenordet för användaren av Oracle HFM-integrationen.
EPM:s hem	Ange sökvägen till HFM:s hemkatalog för Oracle EPM-systemet. Standardvärdet är: `C:/Oracle/Middleware/EPMSystem11R1`.
EPM-instans	Ange sökvägen till EPM-systemet. Standardvärdet är: `C:/Oracle/Middleware/user_projects/epmsystem1`.
HFM-kluster	Ange klusternamnet för Oracle HFM-servern, så som det visas i EPM Shared Services-registret.

Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.

Välj de miljöer på arbetsyta som ska användas med kontakten och klicka på Spara.
Testa anslutningen genom att skapa och köra en kedja med kommandot Extract Members List från Oracle HFM Connector och kontrollera att den returnerar en giltig utdata.

Felsökning

Kan jag använda HFM-anslutningen på en lastbalanserad server?

Lastbalansering är inbyggd i HFM och styrs inte av Chains, men du kan ange din konfiguration i fältet ClusterName när du konfigurerar connectorn.

Anslutningen till Oracle HFM går inte

Verifiera namnet på det Oracle HFM-kluster som du ska ansluta till och Oracle HFM-integrationsanvändarens autentiseringsuppgifter.

Kontakten returnerar en tom utgång eller inget svar

För att säkerställa att GroundRunner kan kommunicera med Oracle HFM JAR-filerna ska du verifiera sökvägarna till HFM:s hemkatalog och EPM-instansen.

Anslutningen returnerar felet "otillräcklig behörighet"

Kontrollera att Oracle HFM-integrationsanvändaren har åtkomst till både läsning och skrivning - inte endast läsning.

Obs: MSAD-användaren - som GroundRunner är beroende av - måste också ha tillräcklig åtkomst till alla kataloger som innehåller filer som Chains kommer att interagera med.

Ett kommando returnerar utgångskoden Success men har ingen utdata

Om kommandot Clear slice, Copy data, Extract data to database, eller Extract data to file lyckas men inte ger någon utdata, ska du kontrollera att egenskapen "Expand only" inte är markerad. Välj "Expand only" för att visa medlemmar utan extraktion, t.ex. för testning.

Ett autentiseringsfel uppstår när du installerar på flera servrar

Leta efter följande rad i loggarna:

 INFO (INFORMATION): Filen reg.properties kunde inte hittas.

Om detta hittas kopierar du filen reg.properties från Oracle\Middleware\user_projects\config\foundation\11.1.2.0

till

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

Support

Community

Workiva supportcenter