Centro de suporte da Workiva

Com o conector Oracle® Hyperion® Financial Management, você pode usar comandos em uma cadeia para interagir com o Oracle Hyperion Financial Management (HFM) versão 11.1.2.4.x ou 11.2.x. Por exemplo, você pode criar uma cadeia para extrair dados do Oracle HFM como um arquivo para carregar em uma tabela Wdata.

Importante: Embora esse conector tenha sido criado pela Workiva para se conectar a um sistema HFM, nossa equipe de suporte só pode ajudar a configurar esse conector dentro do seu espaço de trabalho|workspace; não podemos solucionar problemas ou ajudar com problemas originados fora da plataforma Workiva.

Nota: Para você se conectar às versões 9.3.1 a 11.1.2.3 do Oracle HFM, use o conector Oracle HFM Legacy.

Pré-requisitos

Para configurar a conexão, você precisará de:

• Um servidor com acesso ao Oracle HFM.
  Você deve ter toda a suíte HFM instalada (incluindo JDKs, ativos de suporte, etc.)
• Instalações de:
  • O tempo de execução do Java que vem junto com o HFM.  A partir de 2026, geralmente é o Oracle Java Runtime Environment (JRE) 8. Esse tempo de execução deve ser instalado como o JRE em nível de sistema.

  • Você pode testar isso abrindo um terminal (Linux) ou um Prompt de Comando/PowerShell (Windows) e digitando java -version . Esse tempo de execução deve estar acessível na linha de comando. 
    Você pode testar isso abrindo um terminal (Linux) ou o Prompt de Comando/PowerShell (Windows) e inserindo java -version. A resposta deve se parecer com o seguinte: (a versão 1.8.x é JRE 8)

    java versão "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, modo misto)

    Se ele não estiver acessível, você precisará ajustar a variável de ambiente PATH.

    Nota: Se você tentar usar outros JVMs, o conector poderá não funcionar corretamente; isso se deve a alguns requisitos herdados das bibliotecas Java do Oracle HFM.

• Um agente de execução do GroundRunner

  Nota: Instale o GroundRunner em uma máquina do servidor Enterprise Performance (EPM) que hospeda o serviço de aplicativo HFM.  A Workiva não pode fornecer suporte à solução de problemas quando o GroundRunner é executado em um servidor ou rede diferente da instância do Oracle HFM.

• Caminhos para a instância do sistema Oracle Enterprise Performance (EPM) e seu diretório inicial HFM.
• O nome do cluster do servidor HFM, conforme aparece no Registro de Serviços Compartilhados do EPM.

• Um usuário de integração do Oracle HFM, usado para autenticar com a instância do Oracle HFM.

  Nota: O usuário de integração deve ser um usuário do Native Directory - e não um usuário do Microsoft® Active Directory® (MSAD) - com acesso aos dados necessários para o Reporting e o Extended Analytics. O usuário MSAD ainda é necessário, mas sua finalidade é se comunicar com o GroundRunner.

• Um GroundRunner para executar as tarefas no Oracle HFM e no banco de dados relacional.

  Nota: Para ativar a conexão, o usuário de integração do GroundRunner precisa de privilégios de execução no diretório inicial do HFM.

Para obter assistência ao criar e construir cadeias, também recomendamos que você identifique:

• Seus administradores da Workiva
• Os administradores do Oracle HFM
• Suas equipes de engenharia de rede e infraestrutura

Configurar a conexão com o Oracle HFM

Para configurar a conexão, um administrador de TI configura o servidor e o proprietário do espaço de trabalho cria a conexão com o Oracle HFM.

Etapa 1. Configurar o servidor

1. No Oracle HFM, crie o usuário de integração e conceda a ele acesso ao Reporting e ao Extended Analytics.
2. No servidor que pode acessar o Oracle HFM:

   • Se você quiser instalar o tempo de execução do Java que vem com o HFM, instale-o. Isso será Java Runtime Environment 8 ou superior.

     Observação: Ao instalar o Java, você poderá ser questionado se deseja instalar o Java Development Kit (JDK) ou o Java Runtime Environment (JRE). Somente o JRE é necessário.

   • Adicione o caminho para a JVM empacotada com o Oracle HFM (geralmente é o JAVA_HOME do JRE e, em seguida, a pasta bin ) ao sistema PATH.
   • Faça o download, instale e ative o agente de execução do GroundRunner.
   • Permitir os domínios de host para a Workiva.

Etapa 2. Configure o conector Oracle HFM

Nota: Para tornar o conector disponível para uso nas Cadeias da organização, o administrador de segurança da organização deve primeiro habilitá-lo em Configuração.

1. Em Construtor de Cadeias, clique em Conexões compare_arrows e, em seguida, em Criar no canto superior direito.
2. Em Connector Connection, selecione Oracle Hyperion Financial Management e o GroundRunner instalado no servidor.
3. Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.

4. Em Properties, insira os detalhes da conexão:

   Nota: Consulte o administrador do Oracle HFM para obter os valores corretos.

   Propriedade	Detalhes
   Nome de usuário	Digite o nome de usuário do usuário de integração do Oracle HFM.
   Senha	Digite a senha do usuário de integração do Oracle HFM.
   Início do EPM	Digite o caminho para o diretório inicial do HFM para o sistema Oracle EPM.  O padrão é: C:/Oracle/Middleware/EPMSystem11R1.
   Instância do EPM	Digite o caminho para o sistema EPM.  O padrão é: C:/Oracle/Middleware/user_projects/epmsystem1.
   Cluster HFM	Insira o nome do cluster do servidor Oracle HFM, conforme aparece no registro do EPM Shared Services.

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

5. Selecione os ambientes de espaço de trabalho a serem usados com o conector e clique em Salvar.
6. Para testar a conexão, crie e execute uma cadeia com o comando Extract Members List do conector Oracle HFM e verifique se ele retorna uma saída válida.

Solução de problemas

Posso usar o conector HFM em um servidor com balanceamento de carga?

O balanceamento de carga é incorporado ao HFM e não é controlado pelo Chains, mas você pode inserir sua configuração no campo ClusterName ao configurar o conector.

A conexão com o Oracle HFM falha

Verifique o nome do cluster do Oracle HFM ao qual você deve se conectar e as credenciais de autenticação do usuário de integração do Oracle HFM.

O conector retorna uma saída em branco ou nenhuma resposta

Para garantir que o GroundRunner possa se comunicar com os arquivos JAR do Oracle HFM, verifique os caminhos para o diretório inicial do HFM e a instância do EPM.

O conector retorna um erro de "permissões insuficientes"

Verifique se o usuário de integração do Oracle HFM tem acesso de leitura e gravação, e não somente de leitura.

Observação: O usuário do MSAD, do qual o GroundRunner depende, também deve ter acesso suficiente de leitura/gravação a todos os diretórios que contenham arquivos com os quais as cadeias irão interagir.

Um comando retorna um código de saída de Sucesso, mas não tem saída

Se o comando Clear slice, Copy data, Extract data to database ou Extract data to file for bem-sucedido, mas não tiver saída, verifique se a propriedade "Expand only" não está selecionada. Selecione "Expand only" (Expandir somente) para exibir membros sem extração, como, por exemplo, para teste.

Ocorre um erro de autenticação durante a instalação em vários servidores

Procure a seguinte linha nos registros:

 INFO: O arquivo reg.properties não pôde ser encontrado.

Se isso for encontrado, copie o arquivo reg.properties de Oracle\Middleware\user_projects\config\foundation\11.1.2.0

para

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