Workiva-ondersteuningscentrum

Met de Oracle® Hyperion® Financial Management-connector kunt u opdrachten in een keten gebruiken om te communiceren met Oracle Hyperion Financial Management (HFM) versie 11.1.2.4.x of 11.2.x. U kunt bijvoorbeeld een keten maken om gegevens uit Oracle HFM als bestand te extraheren en te uploaden naar een Wdata-tabel.

Belangrijk: Hoewel deze connector door Workiva is ontwikkeld om verbinding te maken met een HFM-systeem, kan ons supportteam u alleen helpen bij het configureren van deze connector binnen uw werkruimte; we kunnen geen problemen oplossen of anderszins ondersteuning bieden bij problemen die buiten het Workiva-platform ontstaan.

Opmerking: Om verbinding te maken met Oracle HFM-versies 9.3.1 tot en met 11.1.2.3, gebruikt u de Oracle HFM Legacy-connector.

Voorwaarden

Om de verbinding tot stand te brengen, heb je het volgende nodig:

• Een server met toegang tot Oracle HFM.
  Het systeem moet de volledige HFM-suite geïnstalleerd hebben (inclusief JDK's, ondersteunende bestanden, enz.).
• Installaties van:
  • De Java-runtime die standaard met HFM wordt meegeleverd.Vanaf 2026 is dit meestal de Oracle Java Runtime Environment (JRE) 8. Deze runtime moet als systeem-JRE worden geïnstalleerd.

  • Deze runtime moet toegankelijk zijn vanaf de commandoregel.Je kunt dit testen door een terminal (Linux) of opdrachtprompt/PowerShell (Windows) te openen en het volgende in te voeren
    : `java -version`. Het antwoord zou er ongeveer zo uit moeten zien: (versie 1.8.x is JRE 8)

    Java-versie "1.8.0_481" Java(TM) SE Runtime Environment (build 1.8.0_481-b10) Java HotSpot(TM) 64-bits server-VM (build 25.481-b10, gemengde modus)

    Als het niet toegankelijk is, moet u uw PATH -omgevingsvariabele aanpassen.

    Opmerking: Als u andere JVM's probeert te gebruiken, werkt de connector mogelijk niet correct; dit komt door enkele verouderde vereisten van de Oracle HFM Java-bibliotheken.

• Een GroundRunner-executieagent

  Opmerking: Installeer GroundRunner op een Enterprise Performance (EPM)-servermachine waarop de HFM-applicatieservice draait.Workiva kan geen probleemoplossing bieden wanneer GroundRunner op een andere server of in een ander netwerk draait dan de Oracle HFM-instantie.

• Paden naar de Oracle Enterprise Performance (EPM) systeeminstantie en de bijbehorende HFM -thuisdirectory.
• De clusternaam van de HFM-server zoals deze in het EPM Shared Services Registry staat.

• Een Oracle HFM-integratiegebruiker, die wordt gebruikt voor authenticatie met de Oracle HFM-instantie.

  Opmerking: De integratiegebruiker moet een Native Directory-gebruiker zijn — geen Microsoft® Active Directory® (MSAD)-gebruiker — met toegang tot de gegevens die nodig zijn voor rapportage en uitgebreide analyses. De MSAD-gebruiker is nog steeds nodig, maar dient nu alleen nog voor de communicatie met de GroundRunner.

• Een GroundRunner om de taken in Oracle HFM en de relationele database uit te voeren.

  Opmerking: Om de verbinding mogelijk te maken, heeft de integratiegebruiker van GroundRunner uitvoeringsrechten nodig voor de HFM-thuisdirectory.

Voor hulp bij het creëren en opbouwen van ketens raden we u ook aan het volgende te identificeren:

• Uw Workiva-beheerders
• De Oracle HFM-beheerders
• Uw netwerk- en infrastructuurteams

Stel de verbinding met Oracle HFM in.

Om de verbinding tot stand te brengen, configureert een IT-beheerder de server en maakt een werkruimte-eigenaar de verbinding met Oracle HFM.

Stap 1. Configureer de server.

1. Maak in Oracle HFM de integratiegebruiker aan en verleen deze toegang tot rapportage en uitgebreide analyses.
2. Op de server die toegang heeft tot Oracle HFM:

   • Installeer de Java-runtime die bij HFM wordt meegeleverd. Dit zal Java Runtime Environment 8 of hoger zijn.

     Opmerking: Bij het installeren van Java kan u gevraagd worden of u de Java Development Kit (JDK) of de Java Runtime Environment (JRE) wilt installeren. Alleen de JRE is vereist.

   • Voeg het pad naar de JVM die bij Oracle HFM is meegeleverd (dit is meestal de JAVA_HOME van de JRE en vervolgens de bin map) toe aan het systeem PATH.
   • Download, installeer en activeer de GroundRunner-uitvoeringsagent.
   • Sta de hostdomeinen voor Workiva toe.

Stap 2. De Oracle HFM-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de organisatie deze eerst inschakelen via Configuratie.

1. Klik in Chain Builderop Connections compare_arrowsen vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connectionde optie Oracle Hyperion Financial Management en GroundRunner, die op de server is geïnstalleerd.
3. Voer onder Basisinfoeen unieke naam en beschrijving in om de verbinding te identificeren.

4. Onder Eigenschappenkunt u de verbindingsgegevens invoeren:

   Opmerking: Raadpleeg uw Oracle HFM-beheerder voor de juiste waarden.

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de Oracle HFM-integratiegebruiker in.
   Wachtwoord	Voer het wachtwoord van de Oracle HFM-integratiegebruiker in.
   EPM-homepage	Voer het pad naar de HFM-thuisdirectory in voor het Oracle EPM-systeem. De standaardwaarde is: C:/Oracle/Middleware/EPMSystem11R1.
   EPM-instantie	Ga naar het EPM-systeem. De standaardwaarde is: C:/Oracle/Middleware/user_projects/epmsystem1.
   HFM-cluster	Voer de clusternaam in voor de Oracle HFM-server, zoals deze wordt weergegeven in het EPM Shared Services-register.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met behulp van de Advanced Encryption Standard (AES)-256-codering.

5. Selecteer de werkruimteomgevingen die u met de connector wilt gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maak en voer een keten uit met deopdrachtExtract Members List van de Oracle HFM-connectoren controleer of deze een geldige uitvoer retourneert.

Probleemoplossing

Kan ik de HFM-connector gebruiken op een load-balanced server?

Load balancing is ingebouwd in HFM en wordt niet beheerd door Chains, maar u kunt uw configuratie invoeren in het veld ClusterName bij het instellen van de connector.

De verbinding met Oracle HFM mislukt.

Controleer de naam van het Oracle HFM-cluster waarmee u verbinding wilt maken, en de authenticatiegegevens van de Oracle HFM-integratiegebruiker.

De connector geeft een blanco uitvoer of geen reactie terug.

Om ervoor te zorgen dat GroundRunner kan communiceren met de Oracle HFM JAR-bestanden, controleer je de paden naar de HFM-thuisdirectory en de EPM-instantie.

De connector geeft een foutmelding "onvoldoende machtigingen" terug.

Controleer of de Oracle HFM-integratiegebruiker zowel lees- als schrijftoegang heeft, en niet alleen leestoegang.

Opmerking: De MSAD-gebruiker – waarvan GroundRunner afhankelijk is – moet ook voldoende lees-/schrijftoegang hebben tot alle mappen die bestanden bevatten waarmee Chains interactie zal hebben.

Een commando retourneert de exitcode 'Success', maar heeft geen uitvoer.

Als de opdracht Clear slice, Copy data, Extract data to databaseof Extract data to file slaagt maar geen uitvoer heeft, controleer dan of de eigenschap "Expand only" niet is geselecteerd. Selecteer "Alleen uitbreiden" om leden zonder extractie weer te geven, bijvoorbeeld voor testdoeleinden.

Er treedt een authenticatiefout op bij installatie op meerdere servers.

Zoek in de logbestanden naar de volgende regel:

 INFO: Het bestand reg.properties kon niet worden gevonden.

Als dit wordt gevonden, kopieer dan het bestand reg.properties van Oracle\Middleware\user_projects\config\foundation\11.1.2.0

naar

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