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 :
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"
Les alias sont pris en charge dans les fonctions comme suit :