Como Criar Funções Manualmente

Consulte a documentação e o site de suporte da Microsoft para obter informações sobre caracteres e outras limitações de função do Excel.

Para criar uma função manualmente:

No Excel, clique na célula em que você deseja inserir a função.
Insira um sinal de igual (=).
Digite o nome da função, por exemplo, HsSetValue
Informe parâmetros para a função, de acordo com as regras descritas em Exemplo 17-1, usando as informações específicas para cada função em Descrições de Função.
Para atualizar a planilha, acesse o menu do Oracle Smart View for Office e selecione Atualizar.

As funções só são validadas depois de atualizadas.

Exemplo 17-1 Diretrizes de Sintaxe

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"
```
Não combine o nome de uma dimensão com os respectivos aliases em funções. No entanto, no caso dos membros, você pode usar o nome do membro ou o respectivo alias na tabela de alias selecionada.