Création manuelle de fonctions

Pour plus d'informations sur les limitations de caractères et les autres limitations de fonction Excel, reportez-vous à la documentation et au site de support Microsoft.

Pour créer une fonction manuellement, procédez comme suit :

Dans Excel, cliquez sur la cellule dans laquelle vous voulez entrer la fonction.
Entrez le signe égal (=).
Entrez le nom de la fonction, par exemple HsSetValue
Entrez les paramètres de la fonction conformément aux règles décrites dans Exemple 17-1, à l'aide des informations propres à chaque fonction indiquées dans Descriptions des fonctions.
Pour actualiser la feuille de calcul, dans le menu Oracle Smart View for Office, sélectionnez Actualiser.

Les fonctions sont validées uniquement lorsque vous les actualisez.

Exemple 17-1 Instructions relatives à la syntaxe

Pour obtenir la syntaxe des fonctions individuelles, reportez-vous à Descriptions des fonctions.

Pour utiliser une connexion partagée, vous devez ajouter l'identifiant WSFN à la fonction. Celui-ci spécifie une fonction Workspace ainsi qu'une chaîne de connexion. Le format est le suivant :
```
"WSFN|ProviderType|Server|Application|Database","POV"
```
Par exemple, dans la fonction HsGetValue pour une connexion partagée à une source de données Oracle Essbase, la chaîne de connexion et l'identifiant WSFN sont ajoutés à la fonction comme suit :
```
=HsGetValue("WSFN|Essbase|myserver|Sample|Basic","Market#South")
```
Pour ProviderType, utilisez l'une des chaînes suivantes en respectant la casse :
- Essbase (pour Essbase sur site uniquement ; Oracle Essbase cloud requiert une syntaxe de connexion privée)
- HFM (pour Oracle Hyperion Financial Management)
- HP (pour Oracle Hyperion Planning, Planning, les modules Planning, Financial Consolidation and Close, Tax Reporting)
Pour Financial Management, le paramètre Database peut être omis ou identique au paramètre Application. Pour une meilleure cohérence, Oracle recommande de saisir le nom de l'application pour le paramètre Database.
Pour utiliser une connexion URL, vous devez ajouter l'identifiant URLFN à la fonction. Celui-ci spécifie une fonction URL ainsi qu'une chaîne de connexion. Le format est le suivant :

URLFN|URL|Server|Application|Database

Voici un exemple de syntaxe de fonction HsGetValue avec une URL permettant de se connecter à un processus métier Planning :

HsGetValue("URLFN|URL|Server|Application|Database","POV")

Toutes les informations nécessaires à la connexion font partie du jeton, comme indiqué ci-dessus. Si le jeton contient des informations non valides, une erreur #NoConnection survient, avec les exceptions suivantes pour le jeton de serveur :
- Pour les processus métier Oracle Enterprise Performance Management Cloud, comme Planning, le jeton de serveur peut être vide (ou non valide).
- Le jeton de serveur Essbase peut uniquement être vide.
- Financial Management requiert le paramètre de jeton de serveur.
Les paramètres de connexion privée peuvent prendre les valeurs suivantes :
- Vide : connexion par défaut
- HsActive : connexion associée active
- Nom de la connexion privée défini par l'utilisateur
Si vous indiquez une connexion privée, elle doit précéder le PDV.
Le PDV est composé de paires dimension#membre, par exemple :
```
Entity#Connecticut
```
Les relations parent-enfant sont désignées par un point (.), par exemple :
```
Entity#UnitedStates.Maine
```
La connexion et chaque paire dimension#membre du PDV peuvent être séparées en paramètres de fonction distincts, chaque paramètre étant placé entre guillemets (") et séparé par une virgule (,) ; par exemple :
```
"My_connection","Entity#UnitedStates","Account#Sales"
```
La connexion peut également être séparée du PDV par une virgule (,), l'intégralité du PDV étant placée entre guillemets (") et chaque paire dimension#membre séparée par un point-virgule (;) ; par exemple :
```
"My_connection","Entity#UnitedStates;Account#Sales"
```
Ne mélangez pas le nom d'une dimension et ses alias dans les fonctions. En revanche, pour un membre, vous pouvez utiliser son nom ou son alias dans la table des alias sélectionnée.