Fonctions, opérateurs et mots clés
6.1.9 Fonctions diverses
155
6.1.9.1 Ancestor
Description
Renvoie un membre ascendant d'un membre
Groupe de fonctions
Divers
Syntaxe
member Ancestor(member;level|distance)
Entrée
Paramètre
membre niveau
Description
Tout membre
Le niveau de l'ascendant distance La distance du niveau de l'ascendant par rapport au niveau actuel
Type
membre niveau int
Obligatoire
Oui
Le niveau ou la dista nce est requis
Le niveau ou la dista nce est requis
Remarques
• La fonction Ancestor n'est pas utilisée en tant que fonction autonome. Elle est utilisée dans le paramètre d'entrée des fonctions d'agrégation qui spécifie l'ensemble des membres pour l'agrégation.
• Le membre est indiqué explicitement ou il s'agit du membre actuel d'une hiérarchie. Si vous indiquez le membre explicitement, vous devez préciser le chemin d'accès complet dans la hiérarchie. Si vous indiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeur vide.
• La distance doit être positive.
Exemples
Tous les exemples sont basés sur la hiérarchie [Géographie] (Pays > Etat > Ville). Le tableau suivant montre un sous-ensemble des données de la hiérarchie.
Etats-Unis
Californie Nevada
2012-05-10
Fonctions, opérateurs et mots clés
Los Angeles
San Diego
San Francisco
Las Vegas Reno Carson City
Ancestor([Géographie].[Etats-Unis].[Californie].[Los Angeles];1) renvoie
[Californie].
Ancestor([Géographie];[Géographie].[Etat]) renvoie [Californie] si le membre actuel est
[San Diego].
Rubriques associées
•
•
•
•
•
•
6.1.9.2 BlockName
Description
Renvoie le nom du bloc
Groupe de fonctions
Divers
Syntaxe
chaîne BlockName()
Exemples
Si BlockName est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
6.1.9.3 Numéro de colonne
Description
Renvoie le numéro de la colonne
156 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Divers
Syntaxe
entier ColumnNumber()
Exemples
ColumnNumber() renvoie 2 si la formule est placée dans la deuxième colonne d'un tableau.
6.1.9.4 CurrentUser
Description
Renvoie le nom d'utilisateur de l'utilisateur actuel pour accéder à la zone de lancement BI
Groupe de fonctions
Divers
Syntaxe
chaîne CurrentUser()
Exemples
CurrentUser() renvoie "gkn" si son nom d'utilisateur est "gkn".
6.1.9.5 ForceMerge
Description
Inclut des dimensions synchronisées dans les calculs d'indicateurs lorsque les dimensions n'apparaissent pas dans le contexte du calcul.
Groupe de fonctions
Divers
Syntaxe
num ForceMerge(measure)
157 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
Oui
Résultat
Résultat du calcul tenant compte des dimensions synchronisées
Remarques
• Appliqué à un indicateur intelligent, ForceMerge renvoie #VALEURMULTI car le groupe nécessaire pour calculer l'indicateur intelligent n'existe pas.
• La fonction ForceMerge est l'équivalent de la fonction MultiCube de BusinessObjects/Desktop
Intelligence.
Exemples
ForceMerge([Chiffre d'affaires]) renvoie la valeur de [Chiffre d'affaires] en tenant compte des dimensions synchronisées qui n'apparaissent pas dans le même bloc que l'indicateur [Chiffre d'affaires].
6.1.9.6 GetContentLocale
Description
Renvoie les paramètres régionaux des données contenues dans le document (les paramètres régionaux du document)
Groupe de fonctions
Divers
Syntaxe
chaîne GetContentLocale()
Remarques
Les paramètres régionaux du document sont utilisés pour mettre en forme les données dans un document.
Exemples
GetContentLocale() renvoie "fr_FR" si les paramètres régionaux du document sont "Français
(France)".
158 2012-05-10
Fonctions, opérateurs et mots clés
6.1.9.7 GetDominantPreferredViewingLocale
Description
Renvoie les paramètres régionaux dans le groupe paramètres régionaux de visualisation préférés de l'utilisateur
Groupe de fonctions
Divers
Syntaxe
string GetDominantPreferredViewingLocale()
Remarques
• Chaque groupe de paramètres régionaux associés possède des paramètres régionaux de document utilisés comme base pour tous les autres paramètres régionaux du groupe. Par exemple, Anglais
US ("en_US") constitue le paramètre régional prévalent dans le groupe des paramètres régionaux anglais. L'anglais de Nouvelle-Zélande ("en_NZ") est également un membre de ce groupe.
• Le Guide du Gestionnaire de traduction répertorie tous les paramètres régionaux de visualisation préférés dominants.
Exemples
GetDominantPreferredViewingLocale renvoie "en_US" lorsque le paramètre régional de visualisation préféré est "Anglais (Nouvelle-Zélande)".
Rubriques associées
•
159
6.1.9.8 GetLocale
Description
Renvoie les paramètres régionaux de l'utilisateur utilisés pour mettre en forme l'interface utilisateur (les paramètres régionaux du produit)
Groupe de fonctions
Divers
Syntaxe
chaîne GetLocale()
2012-05-10
Fonctions, opérateurs et mots clés
Remarques
Les paramètres régionaux du produit sont ceux utilisés par l'interface utilisateur (par exemple, les
éléments de menu et le texte des boutons).
Exemples
GetLocale() renvoie "en_US" si le paramètre régional du produit est "Anglais (US)".
160
6.1.9.9 GetLocalized
Description
Renvoie une chaîne localisée conformément aux paramètres régionaux de visualisation préférés de l'utilisateur
Syntaxe
string GetLocalized(string[;comment])
Entrée
Paramètre
chaîne
Description
La chaîne à traduire
Type
chaîne comment (commentaire)
Un commentaire pour aider les traducteurs chaîne
Obligatoire
Oui
Non
Remarques
• Le paramètre de la chaîne peut être une chaîne dans une formule quelle qu'elle soit (par exemple, dans une cellule, un message d'alerteur ou une définition de variable).
• Lors de la conception d'un rapport, vous pouvez utiliser le paramètrecommentaire afin de fournir de plus amples informations pour aider le traducteur à traduire la chaîne. Le commentaire apparaît avec la chaîne dans l'outil Gestionnaire de traduction que les traducteurs utilisent pour traduire les rapports.
• Chaque paire chaîne + commentaire génère une chaîne distincte à traduire dans l'outil
Gestionnaire de traduction. En conséquence, GetLocalized("Product Total";"Max 20 characters") et GetLocalized("Product Total";"Use no more than 20 charac ters") peuvent renvoyer des traductions différentes.
Exemples
GetLocalized("Total for all products") renvoie la traduction de "Total for all products" si le paramètre régional de visualisation préféré est "fr_FR".
GetLocalized("Total for all products";"Try not to use more than 20 charac ters") renvoie la traduction allemande de "Total for all products" si le paramètre régional de visualisation préféré est "de_DE". La fonction prévient également le traducteur s'il ne doit pas utiliser plus de 20 caractères, si possible, pour la traduction de la chaîne.
2012-05-10
Fonctions, opérateurs et mots clés
Rubriques associées
•
6.1.9.10 GetPreferredViewingLocale
Description
Renvoie les paramètres régionaux préférés de l'utilisateur pour visualiser les données du document
(les paramètres régionaux de visualisation préférés)
Groupe de fonctions
Divers
Syntaxe
chaîne GetPreferredViewingLocale()
Exemples
GetPreferredViewingLocale renvoie "en_US" si les Paramètres régionaux de visualisation préférés sont "English (US)".
Rubriques associées
•
•
GetDominantPreferredViewingLocale
6.1.9.11 Si...Alors...Sinon
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
If bool_value Then true_value [Else false_value]
161 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
valeur_bool valeur_true valeur_false
Description
Une valeur booléenne
Type
Booléen
La valeur à renvoyer si valeur_bool est vraie
N'importe lequel
La valeur à renvoyer si valeur_bool est fausse
N'importe lequel
Obligatoire
Oui
Oui
Oui si Sinon est inclus
Remarques
• valeur_true et valeur_false peuvent combiner les types de données.
• Vous pouvez utiliser les opérateurs booléens Et, Entre, DansListe, Ou et Pas avec Si.
• Vous pouvez imbriquer les conditions Si en remplaçant les clauses Sinon par des clauses Sinon si
. Cette syntaxe décrit un niveau d'imbrication :
If bool_value Then true_value [ElseIf bool_value Then true_value Else false_value…]
• La syntaxe d'origine de la fonctionIf, If(valeur_bool; valeur_true; valeur_false) est
également prise en charge.
Exemples
If [Chiffre d'affaires]>1 000 000 Alors "CA élevé" renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et aucune valeur pour les autres lignes.
If [Chiffre d'affaires] >1 000 000 Alors "CA élevé" Sinon [Chiffre d'affaires] renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres lignes.
If [Chiffre d'affaires]>1 000 000 Alors "CA élevé" Sinon "CA faible" renvoie
"CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et "CA faible" pour toutes les lignes dont le chiffre d'affaires est inférieur à 1 000 000.
If [Chiffre d'affaires]>1 000 000 Alors "CA élevé" Sinon si [Chiffre d'af faires]> 800 000 Alors "CA moyen" Sinon "CA faible" renvoie "CA élevé" pour toutes les lignes dont le revenu dépasse 1 000 000, "CA moyen" pour toutes les lignes dont le chiffre d'affaires est compris entre 800 000 et 1 000 000 et "CA faible" pour toutes les autres lignes.
Rubriques associées
•
•
•
•
•
•
162 2012-05-10
Fonctions, opérateurs et mots clés
163
6.1.9.12 Si
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
If(bool_value;true_value;false_value)
Entrée
Paramètre
valeur_bool valeur_true valeur_false
Description
Une valeur booléenne
Type
Booléen
La valeur à renvoyer si valeur_bool est vraie
N'importe lequel
La valeur à renvoyer si valeur_bool est fausse
N'importe lequel
Obligatoire
Oui
Oui
Oui
Remarques
• valeur_true et valeur_false peuvent combiner les types de données.
• Vous pouvez imbriquer les conditions Si en remplaçant valeur_false par des conditions Si supplémentaires. Cette syntaxe affiche un niveau d'imbrication :
If(bool_value;true_value;If(bool_value;true_value;false_value);false_value)
• La syntaxe Si...Alors...Sinon est également prise en charge.
Exemples
Si([Revenu des ventes]>1000000;"Revenu élevé";"Revenu bas") renvoie "Revenu
élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et "Revenu bas" pour toutes les lignes dont le chiffre d'affaires est inférieur à 1 000 000.
Si([Revenu des ventes]>1 000 000;"Revenu élevé";[Chiffre d'affaires]) renvoie
"Revenu élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres lignes.
Rubriques associées
•
2012-05-10
Fonctions, opérateurs et mots clés
164
6.1.9.13 LineNumber
Description
Renvoie le numéro de ligne dans un tableau
Groupe de fonctions
Divers
Syntaxe
entier LineNumber()
Remarques
La numérotation des lignes d'un tableau commence par l'en-tête, qui est la ligne 1.
Exemples
LineNumber() renvoie 2 lorsque la fonction apparaît au niveau de la deuxième ligne d'un tableau.
6.1.9.14 NameOf
Description
Renvoie le nom d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NameOf(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
La fonction NameOf apparaît dans les en-têtes de colonne et de ligne des rapports ;.
Exemples
NameOf([Date de réservation]) renvoie "Date de réservation".
2012-05-10
Fonctions, opérateurs et mots clés
6.1.9.15 NoFilter
Description
Ignore les filtres lors du calcul d'une valeur
Groupe de fonctions
Divers
Syntaxe
type_saisie AucunFiltre(obj[;Tous|Explorer])
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Tout|Exploration
• Aucun mot clé spécifié : ignorer les filtres de rapport et de bloc
•
Tout
: ignorer tous les filtres
•
Exploration
: ignorer les filtres de rapport et d'exploration
Mot clé
Obligatoire
Objet rapport Oui
Non
Remarques
•
NoFilter(obj;Exploration) ne fonctionne pas en mode d'exploration de requête, car les filtres d'exploration sont ajoutés à la requête, et non appliqués aux données de rapport.
• Si vous quittez le mode d'exploration lorsque des filtres d'exploration sont activés, ces derniers deviennent des filtres de rapport et peuvent modifier la valeur des objets auxquels NoFilter(ob jet;Exploration) est appliqué.
Exemples
Lorsque NoFilter(Somme([Chiffre d'affaires])) est placé dans un pied de bloc, le chiffre d'affaires total de toutes les lignes du bloc est renvoyé, même si certaines lignes sont exclues du bloc.
NoFilter(Sum([Chiffre d'affaires]);Tout) renvoie la somme du chiffre d'affaires de tous les pays, y compris la France, même si un filtre exclut la France du rapport.
NoFilter(Sum([Chiffre d'affaires]);Exploration) renvoie la somme du chiffre d'affaires de tous les pays, même si un filtre d'exploration filtre la dimension [Pays].
165 2012-05-10
Fonctions, opérateurs et mots clés
166
6.1.9.16 NumberOfPages
Description
Renvoie le nombre de pages dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier NumberOfPages()
Exemples
NumberOfPages() renvoie 2 si le rapport contient deux pages.
6.1.9.17 Page
Description
Renvoie le numéro de la page actuelle dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier Page()
Exemple
Page() renvoie 2 s'il apparaît dans la deuxième page du rapport;
6.1.9.18 Previous
Description
Renvoie une valeur précédente d'un objet
Groupe de fonctions
Divers
2012-05-10
Fonctions, opérateurs et mots clés
167
Syntaxe
type_entrée Rank(dimension|indicateur|Auto[;(réinit_dims)][;décalage][;NonNul])
Entrée
Paramètre
dimension|indicateur|Auto
Description Type Obligatoire
La dimension ou l'indicateur dont la valeur précédente est renvoyée par la fonction, ou le mot clé Auto
Dimension, indicateur ou mot clé
Oui dimensions_redéfinies offset
NonNul
La liste des dimensions utilisées pour réinitialiser le calcul
Indique la valeur de dimension ou d'indicateur présentant un décalage de lignes avant la ligne actuelle
Liste Dimension Non
Entier
Demande à la fonction de renvoyer la première valeur non nulle à partir du décalage
Mot clé
Non (la valeur par défaut est 1)
Non
Remarques
• La valeur par défaut d'offset est 1. Previous([Chiffre d'affaires];1) et Previous
([Chiffre d'affaires]) sont identiques du point de vue fonctionnel.
• Lorsque l'argument NonNul est inclus, la fonction renvoie la première valeur non nulle de l'objet en remontant à partir des lignes offset de la cellule situées avant la ligne actuelle.
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec Previous.
• L'opérateur Auto permet de faire référence à la valeur précédente d'une cellule lorsque son contenu n'est pas un objet rapport.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
•
Previous est appliqué après chaque filtre de rapport, de section et de bloc, et tous les tris sont appliqués.
• Vous ne pouvez pas appliquer de tris ou de filtres sur les formules utilisant Previous.
• Si Previous est appliqué à un indicateur et que l'indicateur renvoie une valeur non définie, Précé dent renvoie une valeur non définie même si la ligne précédente a renvoyé une valeur.
•
Previous ignore les ruptures en cas de placement à l'extérieur d'un en-tête ou d'un pied de page de rupture.
•
Previous renvoie la valeur de l'instance précédente du pied de page en cas de placement dans un pied de page de rupture.
•
Previous est réinitialisé dans chaque section de rapport.
• Lorsqu'elle est utilisée dans un tableau croisé, l'option Previous ne traite pas la dernière valeur d'une ligne comme la première valeur de la ligne suivante.
Exemples
Previous([Pays)];1) renvoie les valeurs suivantes dans le tableau qui suit :
2012-05-10
Fonctions, opérateurs et mots clés
168
Pays
US
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
Précédent
Etats-Unis
Royaume-Uni
Previous([Chiffre d'affaires)]) renvoie les valeurs suivantes dans le tableau qui suit :
Précédent Pays
US
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
5 000 000
2 000 000
Previous([Chiffre d'affaires];([Pays]) renvoie les valeurs suivantes dans le tableau qui suit :
Pays
Etats-Unis
Royaume-Uni
Région
Nord
Sud
Nord
Sud
Chiffre d'affaires
5 000 000
7 000 000
3 000 000
4 000 000
Précédent
5 000 000
3 000 000
Previous([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau croisé qui suit :
Précédent
US
Royaume-Uni
France
2004
5 000 000
2 000 000
3 000 000
2005
6 000 000
2 500 000
2 000 000
Précédent
5 000 000
2 000 000
3 000 000
Previous([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau qui suit avec une rupture sur [Pays] :
Pays
Etats-Unis
Région
Nord
Chiffre d'affaires
5 000 000
Précédent
2012-05-10
Fonctions, opérateurs et mots clés
Etats-Unis
Sud 7 000 000
12 000 000
5 000 000
Pays
Royaume-Uni
Royaume-Uni
Région
Nord
Sud
Chiffre d'affaires
3 000 000
4 000 000
7 000 000
Précédent
7 000 000
3 000 000
12 000 000
Année
2008
2008
2008
2008
2008
2008
2008
2008
Previous([Chiffre d'affaires]);2;NonNul) renvoie les valeurs suivantes dans le tableau qui suit :
Trimestre
T1
T2
T3
T4
T1
T2
T3
T4
Chiffre d'affaires
500
400
700
300
200
Précédent
500
500
400
700
300
300
2*Previous(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Rubriques associées
•
Comparaison de valeurs à l'aide de la fonction Previous
•
6.1.9.19 RefValue
169 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie la valeur de référence d'un objet rapport lorsque le suivi de données est activé
Groupe de fonctions
Divers
Syntaxe
type_entrée RefValue(obj)
Exemples
RefValue([Région ayant les meilleurs résultats]) renvoie "Sud-ouest" si la valeur de la variable [Région ayant les meilleurs résultats] est "Sud-ouest" dans les données de référence.
RefValue([Chiffre d'affaires]) renvoie 1 000 si la valeur de l'indicateur [Chiffre d'affaires] est 1 000 dans les données de référence.
6.1.9.20 ValeurRelative
Description
Renvoie les valeurs antérieures ou suivantes d'un objet
Groupe de fonctions
Divers
Syntaxe
input_type RelativeValue(measure|detail;slicing_dims;offset)
Entrée
Paramètre
dim_découpage offset
Description
indicateur|détail
Tout indicateur ou détail d'une dimension dans le bloc
Type Obligatoire
Indicateur ou détail
Oui
Les dimensions qui donnent le contexte du calcul Liste Dimension
Oui
Indique la valeur de l'indicateur ou du détail qui est de offset lignes supprimées de la ligne actuelle
Entier Oui
Remarques
• L'objet doit être un indicateur ou un détail d'une dimension disponible dans le bloc.
• L'ordre de tri de la liste de valeurs des dimensions de découpage permet de déterminer le résultat de la fonction.
170 2012-05-10
Fonctions, opérateurs et mots clés
Année
2007
2007
2007
2007
2008
2008
2008
2008
Deux facteurs définissent l'ordre de tri : les tris appliqués aux dimensions de découpage et l'ordre dans lequel les dimensions de découpage sont répertoriées dans la fonction.
• Une dimension utilisée comme maître de section peut être spécifiée en tant que dimension de découpage.
• Toutes les dimensions de découpage doivent être présentes dans le bloc ou dans l'en-tête de section du bloc dans lequel se trouve la fonction. Si une dimension de découpage est supprimée ultérieurement du bloc, la fonction renvoie l'erreur #CALCUL.
• Si l'offset dépasse le nombre de lignes de la liste de valeurs de la dimension de découpage, le résultat de la fonction est nul.
•
ValeurRelative ne peut être utilisé de façon récursive.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions de découpage ne contient qu'une entrée.
Exemples
La colonne ValeurRelative du tableau ci-dessous contient le formule suivante :
RelativeValue([Revenue];([Year]);-1)
T4
T1
T2
T3
T4
Trimestre
T1
T2
T3
Vendeur
Durand
Dupont
Martin
Harris
Durand
Dupont
Martin
Harris
Chiffre d'affaires
1 000
2 000
1 500
3 000
4 000
3 400
2 000
1 700
ValeurRelative
1 000
2 000
1 500
3 000
Rubriques associées
•
•
Comparaison de valeurs à l'aide de la fonction ValeurRelative
6.1.9.21 ReportName
Description
Renvoie le nom d'un rapport
171 2012-05-10
Fonctions, opérateurs et mots clés
172
Groupe de fonctions
Divers
Syntaxe
Chaîne NomRapport()
Exemples
Si NomRapport() est placé dans un rapport appelé "Rapport des ventes", alors "Rapport des ventes" est renvoyé.
6.1.9.22 RowIndex
Description
Renvoie le numéro d'une ligne
Groupe de fonctions
Divers
Syntaxe
entier RowIndex()
Remarques
• La numérotation des lignes commence à 0.
•
RowIndex renvoie #VALEURMULTI lorsqu'elle est placée dans l'en-tête ou le pied de page d'un tableau.
Exemples
RowIndex renvoie 0 lorsqu'elle apparaît sur la première ligne d'un tableau.
6.1.9.23 UniqueNameOf
Description
Renvoie le nom unique d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomUniqueDe(obj)
2012-05-10
Lien public mis à jour
Le lien public vers votre chat a été mis à jour.
