Centro assistenza di Workiva

Con il connettore Oracle® Hyperion® Financial Management, puoi usare i comandi in una catena per interagire con Oracle Hyperion Financial Management (HFM) versione 11.1.2.4.x o 11.2.x. Ad esempio, puoi creare una catena per estrarre i dati da Oracle HFM come file da caricare in una tabella Wdata.

Importante: sebbene questo connettore sia stato creato da Workiva per connettersi a un sistema HFM, il nostro team di assistenza può solo aiutare a configurare questo connettore all'interno del tuo spazio di lavoro; non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Nota: Per connettersi a Oracle HFM dalle versioni 9.3.1 a 11.1.2.3, utilizza il connettore Oracle HFM Legacy.

Prerequisiti

Per configurare la connessione, avrai bisogno di:

• Un server con accesso a Oracle HFM.
  Dovrebbe essere installata l'intera suite HFM (compresi i JDK, le risorse di supporto, ecc.)
• Installazioni di:
  • Il runtime Java fornito con HFM.  A partire dal 2026, di solito si tratta di Oracle Java Runtime Environment (JRE) 8. Questo runtime deve essere installato come JRE a livello di sistema.

  • Questo runtime deve essere accessibile dalla riga di comando. 
    Puoi verificarlo aprendo un terminale (Linux) o un Prompt dei comandi/PowerShell (Windows) e digitando java -version. La risposta dovrebbe essere simile a questa: (la versione 1.8.x è JRE 8)

    java version "1.8.0_481" Java(TM) SE Runtime Environment (build 1.8.0_481-b10) Java HotSpot(TM) 64-Bit Server VM (build 25.481-b10, mixed mode)

    Se non è accessibile, dovrai modificare la tua variabile d'ambiente PATH.

    Nota: Se provi a utilizzare altre JVM, il connettore potrebbe non funzionare correttamente; ciò è dovuto ad alcuni requisiti legacy delle librerie Java di Oracle HFM.

• Un agente di esecuzione GroundRunner

  Nota: Installa GroundRunner su un server Enterprise Performance (EPM) che ospita il servizio applicativo HFM.  Workiva non può fornire assistenza per la risoluzione dei problemi quando GroundRunner viene eseguito su un server o una rete diversi da quelli dell'istanza Oracle HFM.

• Percorsi dell'istanza di sistema Oracle Enterprise Performance (EPM) e della sua home directory HFM.
• Il nome del cluster del server HFM come appare nel registro dei servizi condivisi EPM.

• Un utente di integrazione Oracle HFM, utilizzato per autenticarsi con l'istanza Oracle HFM.

  Nota: L'utente dell'integrazione deve essere un utente di Native Directory - non un utente di Microsoft® Active Directory® (MSAD) - con accesso ai dati necessari per Reporting e Extended Analytics. L'utente MSAD è ancora necessario, ma il suo scopo è comunicare con il GroundRunner.

• Un GroundRunner per eseguire le attività in Oracle HFM e nel database relazionale.

  Nota: Per attivare la connessione, l'utente dell'integrazione di GroundRunner deve avere i privilegi di esecuzione nella home directory di HFM.

Per assistenza durante la creazione e la costruzione di catene, ti consigliamo di identificare: i tuoi amministratori di Workiva:

• Gli amministratori di Workiva
• Gli amministratori di Oracle HFM
• I team di ingegneri della rete e dell'infrastruttura

Configurare la connessione a Oracle HFM

Per configurare la connessione, un amministratore IT configura il server e il proprietario dell'area di lavoro crea la connessione a Oracle HFM.

Passo 1. Configurare il server

1. In Oracle HFM, crea l'utente di integrazione e concedigli l'accesso a Reporting e Extended Analytics.
2. Sul server che può accedere a Oracle HFM:

   • Installa il runtime Java fornito con HFM. Questo sarà Java Runtime Environment 8 o superiore.

     Nota: Durante l'installazione di Java, potrebbe esserti chiesto se installare il Java Development Kit (JDK) o il Java Runtime Environment (JRE). È necessario solo il JRE.

   • Aggiungi il percorso della JVM fornita con Oracle HFM (di solito si tratta della JAVA_HOME della JRE e poi della cartella bin ) al PATH di sistema.
   • Scarica, installa e attiva l'agente di esecuzione GroundRunner.
   • Autorizza i domini host per Workiva.

Passo 2. Configurare il connettore Oracle HFM

Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.

1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
2. In Connector Connection, seleziona Oracle Hyperion Financial Management e il GroundRunner installato sul server.
3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.

4. In Proprietà, inserisci i dettagli della connessione:

   Nota: Consulta l'amministratore di Oracle HFM per i valori corretti.

   Proprietà	Dettagli
   Nome utente	Inserisci il nome utente dell'utente dell'integrazione Oracle HFM.
   Password	Inserisci la password dell'utente dell'integrazione Oracle HFM.
   EPM home	Inserisci il percorso della directory home di HFM per il sistema Oracle EPM.  L'impostazione predefinita è: C:/Oracle/Middleware/EPMSystem11R1.
   Istanza EPM	Inserisci il percorso del sistema EPM.  L'impostazione predefinita è: C:/Oracle/Middleware/user_projects/epmsystem1.
   Cluster HFM	Inserisci il nome del cluster del server Oracle HFM, come appare nel registro di EPM Shared Services.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.

5. Seleziona gli ambienti di lavoro da utilizzare con il connettore e clicca su Salva.
6. Per testare la connessione, crea ed esegui una catena con il comando Extract Members List del connettore Oracle HFM e verifica che restituisca un output valido.

Risoluzione dei problemi

Posso utilizzare il connettore HFM su un server con bilanciamento del carico?

Il bilanciamento del carico è integrato in HFM e non è controllato da Chains, ma puoi inserire la tua configurazione nel campo ClusterName quando imposti il connettore.

La connessione a Oracle HFM fallisce

Verifica il nome del cluster Oracle HFM a cui connettersi e le credenziali di autenticazione dell'utente dell'integrazione Oracle HFM.

Il connettore restituisce un output vuoto o nessuna risposta

Per assicurarti che GroundRunner possa comunicare con i file JAR di Oracle HFM, verifica i percorsi della home directory di HFM e dell'istanza EPM.

Il connettore restituisce un errore di "permessi insufficienti".

Verifica che l'utente dell'integrazione Oracle HFM abbia accesso sia in lettura che in scrittura, non solo in lettura.

Nota: L'utente MSAD, da cui dipende GroundRunner, deve avere accesso in lettura/scrittura a tutte le directory che contengono file con cui Chains interagirà.

Un comando restituisce un codice di uscita di Successo ma non ha alcun output

Se il comando Cancella fetta, Copia dati, Estrai dati nel database, o Estrai dati nel file ha successo ma non produce alcun risultato, verifica che la proprietà "Solo espansione" non sia selezionata. Seleziona "Solo espansione" per visualizzare i membri senza estrazione, ad esempio per i test.

Si verifica un errore di autenticazione durante l'installazione su più server

Cerca la seguente riga nei log:

 INFO: Il file reg.properties non è stato trovato.

Se viene trovato, copia il file reg.properties da Oracle\Middleware\user_projects\config\foundation\11.1.2.0

a

OracleMiddleware_user_projects\epmsystem1\configurazione\foundation\11.1.2.0.