Centro assistenza di Workiva

Con il connettore Oracle® Essbase®, puoi utilizzare i comandi in una catena per interagire con Oracle Essbase. Ad esempio, con questo connettore puoi:

• Eseguire script di calcolo, MaxL e report in Oracle Essbase
• Elencare e gestire database, applicazioni e variabili di Essbase
• Caricare, scaricare ed eliminare file in Oracle Essbase

Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa 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.

Prerequisiti

Per attivare la connessione, il connettore utilizza l'API Java® di Oracle Essbase, protetta da un'autenticazione di base con nome utente e password. Per configurare la connessione, avrai bisogno di:

• Un GroundRunner designato impostato per il connettore
• Un utente di integrazione designato impostato in Oracle Essbase per il connettore
• Le credenziali di autenticazione dell'utente dell'integrazione
• L'utente di integrazione deve avere le autorizzazioni applicabili ai comandi che il connettore esegue.
• L'URL di base dell'istanza Essbase a cui connettersi
• Il nome del cluster Essbase a cui connettersi
• Il percorso dei file di archivio Java (JAR) del client Essbase:
  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar
• Se l'istanza di Essbase ha abilitato la modalità Embedded

Avviso di compatibilità: Workiva ha testato e convalidato questo connettore esclusivamente con le versioni 11.1.2.2.x, 11.1.2.3, 11.1.2.4 e 11.2. Workiva non può garantire che questo connettore funzioni come desiderato con versioni non testate.

Individua i file JAR del client Essbase

Per attivare la connessione, il connettore richiede i file JAR del client presenti nell'installazione di Oracle Essbase.

• Percorso predefinito per Microsoft® Windows®: C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI\<version_#>\lib
• Percorso predefinito per Linux: /User/username/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib

Se GroundRunner e Oracle Essbase sono installati su server diversi, copia i file JAR in una cartella sul server di GroundRunner e annota il percorso della cartella per la proprietà Java API Path del connettore.

Configura il connettore Oracle Essbase

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 Chain Builder, clicca su Connections compare_arrows, e poi su Create in alto a destra.
2. In Connector Connection, seleziona Oracle Essbase e il GroundRunner da utilizzare con il connettore.
   
3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.

4. In Proprietà, inserisci i dettagli del connettore:
   

   Proprietà	Dettagli
   Nome utente	Inserisci il nome utente dell'utente di integrazione Essbase del connettore.
   Password	Inserisci la password per la proprietà Nome utente.
   URL dell'istanza	Inserisci l'URL di base dell'istanza Essbase a cui connettersi, compreso il protocollo principale; spesso, un indirizzo IP come http://100.0.0.1.
   Nome del cluster	Inserisci il cluster Essbase a cui connettersi; per impostazione predefinita, EssbaseCluster.
   Percorso API Java	Inserisci il percorso dei file JAR del client per l'istanza di Essbase: Se GroundRunner ed Essbase sono installati sullo stesso server , inserisci il percorso dei file JAR nell'installazione di Essbase. Se GroundRunner ed Essbase sono installati su server diversi, inserisci il percorso della cartella sul server di GroundRunner che contiene le copie dei file JAR.
   Modalità integrata abilitata	Se l'istanza di Essbase ha attivato la modalità integrata, seleziona questa casella. (Gli ambienti Oracle Hyperion® standalone di solito hanno la Modalità Incorporata abilitata).

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

5. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
6. Per verificare la connessione, crea ed esegui una catena con il comando List Applications del connettore e verifica che restituisca un output valido.

Risoluzione dei problemi

Questa sezione tratta i potenziali problemi del connettore Oracle Essbase e dei suoi comandi.

 Eccezione nel thread "main" [] false} stdErr="java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

Errore: com.essbase.api.base.EssException: Impossibile connettersi al server del provider

Errore: com.essbase.api.base.EssException: Impossibile connettersi al servizio olap. Impossibile connettersi al server Essbase. Errore:Essbase Error(1042003): Errore di rete [11001]: Failed to retrieve name information for [Essbase-Cluster1] Error authenticating with Essbase: Impossibile connettersi al servizio olap. Impossibile connettersi al server Essbase. Errore:Essbase Error(1042003): Errore di rete [11001]: Failed to retrieve name information for [Essbase-Cluster1]

Impossibile creare un oggetto file olap. Errore Essbase(1030014): Tipo di oggetto non valido passato alla funzione ESSAPI