Workiva kundestøttesenter

Med Oracle® Hyperion® Financial Management-koblingen kan du bruke kommandoer i en kjede for å samhandle med Oracle Hyperion Financial Management (HFM) versjon 11.1.2.4.x eller 11.2.x. Du kan for eksempel opprette en kjede for å trekke ut data fra Oracle HFM som en fil for opplasting til en Wdata-tabell.

Viktig: Selv om denne koblingen ble bygget av Workiva for å koble til et HFM-system, kan supportteamet vårt bare hjelpe med å konfigurere denne koblingen i arbeidsområdet ditt. Vi kan ikke feilsøke eller på annen måte hjelpe med problemer som oppstår utenfor Workiva-plattformen.

Merk: For å koble til Oracle HFM versjon 9.3.1 til 11.1.2.3, bruk Oracle HFM Legacy-koblingen.

Forutsetninger

For å sette opp tilkoblingen trenger du:

• En server med tilgang til Oracle HFM.
  Den bør ha hele HFM-pakken installert (inkludert JDK-er, støtteelementer osv.)
• Installasjoner av:
  • Java-kjøretiden som følger med HFM.Fra og med 2026 er dette vanligvis Oracle Java Runtime Environment (JRE) 8. Denne kjøretidsfilen bør installeres som JRE på systemnivå.

  • Denne kjøretidsfilen må være tilgjengelig fra kommandolinjen.
    Du kan teste dette ved å åpne en terminal (Linux) eller ledetekst/PowerShell (Windows) og skrive inn java -version. Svaret skal se omtrent slik ut: (versjon 1.8.x er JRE 8)

    Java-versjon "1.8.0_481" Java(TM) SE Runtime Environment (bygg 1.8.0_481-b10) Java HotSpot(TM) 64-biters server-VM (bygg 25.481-b10, blandet modus)

    Hvis den ikke er tilgjengelig, må du justere PATH-miljøvariabelen din.

    Merk: Hvis du prøver å bruke andre JVM-er, kan det hende at koblingen ikke fungerer som den skal. Dette skyldes noen eldre krav i Oracle HFM Java-bibliotekene.

• En GroundRunner-henrettelsesagent

  Merk: Installer GroundRunner på en Enterprise Performance (EPM)-servermaskin som er vert for HFM Application Service.Workiva kan ikke tilby feilsøkingsstøtte når GroundRunner kjører på en annen server eller et annet nettverk enn Oracle HFM-instansen.

• Stier til Oracle Enterprise Performance (EPM)-systemforekomsten og dens HFM-hjemmekatalog.
• Klyngenavnet til HFM-serveren slik det vises i EPM-registeret for delte tjenester.

• En Oracle HFM-integrasjonsbruker som brukes til å autentisere med Oracle HFM-instansen.

  Merk: Integrasjonsbrukeren må være en Native Directory-bruker – ikke en Microsoft® Active Directory® (MSAD)-bruker – med tilgang til data som kreves for rapportering og utvidet analyse. MSAD-brukeren er fortsatt nødvendig, men formålet er å kommunisere med GroundRunner.

• En GroundRunner for å utføre oppgavene i Oracle HFM og relasjonsdatabasen.

  Merk: For å aktivere tilkoblingen trenger GroundRunners integrasjonsbruker Utførelsesrettigheter til HFM-hjemmekatalogen.

For hjelp når du oppretter og bygger kjeder, anbefaler vi også at du identifiserer:

• Dine Workiva-administratorer
• Oracle HFM-administratorene
• Dine nettverks- og infrastrukturingeniørteam

Konfigurer tilkoblingen til Oracle HFM

For å sette opp tilkoblingen konfigurerer en IT-administrator serveren, og en arbeidsområdeeier oppretter tilkoblingen til Oracle HFM.

Trinn 1. Konfigurer serveren

1. Opprett integrasjonsbrukeren i Oracle HFM og gi dem tilgang til rapportering og utvidet analyse.
2. På serveren som har tilgang til Oracle HFM:

   • Installer Java-kjøretiden som følger med HFM. Dette vil være Java Runtime Environment 8 eller nyere.

     Merk: Når du installerer Java, kan du bli spurt om du vil installere Java Development Kit (JDK) eller Java Runtime Environment (JRE). Bare JRE er nødvendig.

   • Legg til banen til JVM-en som er pakket med Oracle HFM (dette er vanligvis JAVA_HOME til JRE og deretter bin -mappen) i systemmappen PATH.
   • Last ned, installer og aktiver GroundRunner-utførelsesagenten.
   • Tillat vertsdomenene for Workiva.

Trinn 2. Konfigurer Oracle HFM-koblingen

Merk: For å gjøre koblingen tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Konfigurasjon.

1. Fra Kjedebyggerklikker du på Tilkoblinger compare_arrowsog deretter på Opprett øverst til høyre.
2. Under Connector Connectionvelger du Oracle Hyperion Financial Management og GroundRunner som er installert på serveren.
3. Under Grunnleggende informasjonskriver du inn et unikt navn og en beskrivelse for å identifisere forbindelsen.

4. Under Egenskaperskriver du inn tilkoblingsdetaljene:

   Merk: Kontakt Oracle HFM-administratoren din for å få de riktige verdiene.

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet til Oracle HFM-integrasjonsbrukeren.
   Passord	Skriv inn passordet til Oracle HFM-integrasjonsbrukeren.
   EPM-hjem	Skriv inn -banen til HFM-hjemmekatalogen for Oracle EPM-systemet. Standardverdien er: C:/Oracle/Middleware/EPMSystem11R1.
   EPM-forekomst	Skriv inn banen til EPM-systemet. Standardinnstillingen er: C:/Oracle/Middleware/user_projects/epmsystem1.
   HFM-klynge	Skriv inn klyngenavnet for Oracle HFM-serveren, slik det vises i registeret for EPM Shared Services.

   Merk: All sensitiv påloggingsinformasjon krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.

5. Velg arbeidsområdemiljøene som skal brukes med koblingen, og klikk på Lagre.
6. For å teste tilkoblingen, opprett og kjør en kjede med Oracle HFM-koblingensExtract Members List-kommando, og bekreft at den returnerer en gyldig utdata.

Feilsøking

Kan jeg bruke HFM-koblingen på en belastningsbalansert server?

Lastbalansering er innebygd i HFM og kontrolleres ikke av Chains, men du kan angi konfigurasjonen din i ClusterName-feltet når du konfigurerer koblingen.

Tilkoblingen til Oracle HFM mislykkes

Bekreft navnet på Oracle HFM-klyngen du skal koble til, og autentiseringslegitimasjonen til Oracle HFM-integrasjonsbrukeren.

Koblingen returnerer en tom utgang eller intet svar

For å sikre at GroundRunner kan kommunisere med Oracle HFM JAR-filene, må du bekrefte stiene til HFM-hjemmekatalogen og EPM-forekomsten.

Koblingen returnerer feilen «utilstrekkelige tillatelser»

Bekreft at Oracle HFM-integrasjonsbrukeren har både lese- og skrivetilgang – ikke bare lesetilgang.

Merk: MSAD-brukeren – som GroundRunner er avhengig av – må også ha tilstrekkelig lese-/skrivetilgang til alle kataloger som inneholder filer som Chains vil samhandle med.

En kommando returnerer en avslutningskode for suksess, men har ingen utdata

Hvis kommandoen Fjern sektor, Kopier data, Pakk ut data til databaseeller Pakk ut data til fil lykkes, men ikke gir noen utdata, må du bekrefte at egenskapen «Bare utvid» ikke er valgt. Velg «Bare utvid» for å vise medlemmer uten uttrekking, for eksempel for testing.

Det oppstår en autentiseringsfeil når du installerer på flere servere

Se etter følgende linje i loggene:

 INFO: Filen reg.properties ble ikke funnet.

Hvis dette blir funnet, kopier filen reg.properties fra Oracle\Middleware\user_projects\config\foundation\11.1.2.0

til

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