Instructions relatives à la syntaxe de fonction

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 Fusion Cloud Enterprise Performance Management, 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"
  • Les alias sont pris en charge dans les fonctions comme suit :

    • Ne mélangez pas le nom d'une dimension et ses alias.
    • Pour un membre, vous pouvez utiliser son nom ou son alias dans la table des alias sélectionnée.
    • La même table des alias doit être utilisée pour tous les alias.
    • Si vous utilisez une connexion privée nommée, vérifiez que la table des alias correcte est définie pour la connexion.
    • Si un libellé d'alias contient la même valeur qu'un autre nom de membre, un message indiquant que le membre n'est pas valide apparaît.