Diretrizes de Sintaxe de Função

Consulte Descrições de Função para obter informações sobre a sintaxe de funções individuais.

  • Para trabalhar com uma conexão compartilhada, você deve adicionar à função o identificador WSFN, que especifica uma função de espaço de trabalho, e uma string de conexão. O formato é:

    "WSFN|ProviderType|Server|Application|Database","POV"

    Por exemplo, na função HsGetValue de uma conexão compartilhada com uma origem de dados do Oracle Essbase, o identificador WSFN e a string de conexão são adicionados à função, da seguinte forma:

    =HsGetValue("WSFN|Essbase|myserver|Sample|Basic","Market#South")

    Para ProviderType, use uma das seguintes strings que fazem distinção entre maiúsculas e minúsculas:

    • Essbase (apenas para Essbase on-premises; o Oracle Essbase na nuvem requer uma sintaxe de conexão privada)

    • HFM (para o Oracle Hyperion Financial Management)

    • HP (para Oracle Hyperion Planning, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting)

    Para o Financial Management, o parâmetro Banco de Dados pode ser omitido ou pode ser igual ao parâmetro Aplicativo. Para consistência, a Oracle recomenda inserir o nome do aplicativo para o parâmetro Banco de Dados.

  • Para trabalhar com uma conexão de URL, adicione o identificador WSFN, que especifica uma função de URL, e uma string de conexão à função. O formato é:

    URLFN|URL|Servidor|Aplicativo|Banco de Dados

    Por exemplo, a sintaxe da função HsGetValue usando o URL de uma conexão a um processo de negócios do Planning:

    HsGetValue("URLFN|URL|Servidor|Aplicativo|Banco de Dados","PDV")

    Todas as informações necessárias para estabelecer uma conexão é parte do token, como mostrado acima. Se o token contiver informações inválidas, geralmente será mostrado um erro #NoConnection, com as seguintes exceções para o token do Servidor:

    • Para processos de negócios do Oracle Enterprise Performance Management Cloud, como o Planning, o token do Servidor pode estar em branco (ou inválido)
    • O token do Servidor do Essbase só pode ser em branco
    • O Financial Management requer o parâmetro do token do Servidor

  • Parâmetros de conexão privada podem ter estes valores:

    • Vazio: a conexão padrão

    • HsActive: a conexão associada ativa

    • O nome definido pelo usuário de uma conexão privada

    Se você especificar uma conexão privada, o nome da conexão deverá preceder o PDV.

  • O PDV é composto de pares de dimension#member, por exemplo:

    Entity#Connecticut

  • Relações pai-filho podem ser especificadas por um ponto, (.), por exemplo:

    Entity#UnitedStates.Maine

  • A conexão e cada par dimension#member de PDV podem ser divididos em parâmetros separados de função, cada parâmetro codificado entre aspas (") e separados por uma vírgula, (,); por exemplo:

    "My_connection","Entity#UnitedStates","Account#Sales"

    Como alternativa, a conexão pode ser separada do PDV por uma vírgula, (,), com todo o PDV codificado entre aspas, ("), e cada par dimension#member separado por ponto e vírgula (;); por exemplo:

    "My_connection","Entity#UnitedStates;Account#Sales"

  • Aliases são suportados em funções da seguinte forma:

    • Não misture o nome de uma dimensão com os respectivos aliases.
    • No caso dos membros, você pode usar o nome do membro ou o respectivo alias na tabela de alias selecionada.
    • A mesma tabela de alias precisa ser usada para todos os aliases.
    • Se estiver usando uma conexão privada nomeada, certifique-se de que a tabela de alias correta esteja configurada para a conexão.
    • Se um rótulo de alias tiver o mesmo valor que outro nome de membro, uma mensagem de "membro inválido" será exibida.