Centro de suporte da Workiva

Com o conector do Oracle® Essbase®, você pode usar os comandos em uma cadeia para interagir com o Oracle Essbase. Por exemplo, com esse conector, você pode:

• Executar scripts de cálculo, MaxL e relatório no Oracle Essbase
• Listar e gerenciar bancos de dados, aplicativos e variáveis do Essbase
• Fazer upload, download e excluir arquivos no Oracle Essbase

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Pré-requisitos

Para habilitar a conexão, o conector usa a API Java® do Oracle Essbase, protegida por autenticação básica de nome de usuário e senha. Para configurar a conexão, você precisará de:

• Um GroundRunner designado configurado para o conector
• Um usuário de integração designado configurado no Oracle Essbase para o conector
• As credenciais de autenticação do usuário de integração
• O usuário de integração deve ter permissões aplicáveis aos comandos que o conector executa.
• O URL de base da instância do Essbase à qual você deve se conectar
• O nome do cluster do Essbase ao qual você deve se conectar
• O caminho para esses arquivos Java (JAR) do cliente Essbase:
  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar
• Se a instância do Essbase tem o Embedded Mode ativado

Aviso de compatibilidade: A Workiva testou e validou esse conector exclusivamente com as versões 11.1.2.2.x, 11.1.2.3, 11.1.2.4 e 11.2. A Workiva não pode garantir que esse conector funcionará como desejado com versões não testadas.

Localize os arquivos JAR do cliente Essbase

Para habilitar a conexão, o conector requer arquivos JAR do cliente localizados na instalação do Oracle Essbase.

• Caminho padrão para o Microsoft® Windows®: C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI\<version_#>\lib
• Caminho padrão para o Linux: /User/username/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib

Se o GroundRunner e o Oracle Essbase estiverem instalados em servidores diferentes, copie os arquivos JAR para uma pasta no servidor do GroundRunner e anote o caminho para a pasta da propriedade Java API Path do conector.

Configure o conector do Oracle Essbase

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.

1. Em Construtor de Cadeias, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Conexão de conector, selecione Oracle Essbase e o GroundRunner para usar com o conector.
   
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.

4. Em Propriedades, insira os detalhes do conector:
   

   Propriedade	Detalhes
   Nome do usuário	Digite o nome de usuário do usuário de integração do Essbase do conector.
   Senha	Digite a senha da propriedade Nome de usuário.
   URL da instância	Digite o URL de base da instância do Essbase à qual você deve se conectar, incluindo o protocolo principal; geralmente, um endereço IP, como http://100.0.0.1.
   Nome do cluster	Digite o cluster do Essbase ao qual você deve se conectar; por padrão, EssbaseCluster.
   Caminho da API Java	Digite o caminho para os arquivos JAR do cliente para a instância do Essbase: Se o GroundRunner e o Essbase estiverem instalados no mesmo servidor , digite o caminho para os arquivos JAR na instalação do Essbase. Se o GroundRunner e o Essbase estiverem instalados em servidores diferentes, digite o caminho para a pasta no servidor do GroundRunner que contém cópias dos arquivos JAR.
   Modo incorporado ativado	Se a instância do Essbase tiver o Embedded Mode ativado, marque esta caixa. (Os ambientes autônomos do Oracle Hyperion® geralmente têm o Modo Incorporado ativado).

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

5. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
6. Para testar a conexão, crie e execute uma cadeia com o comando Listar ações do conector e verifique se ele retorna uma saída válida.

Solução de problemas

Esta seção aborda possíveis problemas com o próprio conector do Oracle Essbase e seus comandos.

 Exceção na thread "main" [] false} stdErr="java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

Erro: com.essbase.api.base.EssException: Não é possível conectar-se ao servidor do provedor

Erro: com.essbase.api.base.EssException: Não é possível conectar-se ao serviço olap. Não é possível conectar-se ao servidor Essbase. Erro:Essbase Error(1042003): Erro de rede [11001]: Falha ao recuperar informações de nome para [Essbase-Cluster1] Erro ao autenticar com o Essbase: Não é possível conectar-se ao serviço olap. Não é possível conectar-se ao servidor Essbase. Erro:Essbase Error(1042003): Erro de rede [11001]: Falha ao recuperar informações de nome para [Essbase-Cluster1]

Não é possível criar um objeto de arquivo olap. Erro do Essbase (1030014): Tipo de objeto inválido passado para a função ESSAPI