SAP Web Intelligence Mode d'emploi

Utilisation de fonctions, formules et calculs dans Web Intelligence
■ SAP BusinessObjects Business Intelligence platform 4.0 Support Package 02
2011-04-14
Copyright
© 2011 SAP AG. Tous droits réservés.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign,
SAP Business ByDesign, et les autres produits et services SAP mentionnés dans ce document, ainsi
que leurs logos respectifs, sont des marques commerciales ou des marques déposées de SAP AG
en Allemagne et dans d’autres pays. Business Objects et le logo Business Objects, BusinessObjects,
Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius et les autres produits et services
Business Objects mentionnés dans ce document, ainsi que leurs logos respectifs, sont des marques
commerciales ou des marques déposées de Business Objects S.A. aux Etats-Unis et dans de
nombreux autres pays. Business Objects est une entreprise SAP. Tous les autres noms de produits
et de services mentionnés sont des marques commerciales de leurs entreprises respectives. Les
données contenues dans ce document sont uniquement mentionnées à titre informatif. Les
spécifications des produits peuvent varier d’un pays à l’autre. Ces informations sont susceptibles
d’être modifiées sans préavis. Elles sont fournies par SAP AG et ses filiales («Groupe SAP»)
uniquement à titre informatif, sans engagement ni garantie d’aucune sorte. SAP Group ne pourra en
aucun cas être tenu responsable d’erreurs ou d'omissions relatives à ces informations. Les seules
garanties fournies pour les produits et les services SAP Group sont celles énoncées expressément
dans les déclarations de garantie accompagnant, le cas échéant, lesdits produits et services. Aucune
des informations contenues dans ce document ne saurait constituer une garantie supplémentaire.
2011-04-14
Table des matières
3
Chapitre 1
A propos de ce guide..............................................................................................................7
Chapitre 2
Utilisation de calculs standards et personnalisés...................................................................9
2.1
2.2
2.2.1
2.3
2.3.1
2.3.2
2.3.3
2.3.4
Calculs standard......................................................................................................................9
Chapitre 3
Notions de contextes de calcul.............................................................................................19
3.1
3.1.1
3.1.2
3.2
3.2.1
3.2.2
3.2.3
3.2.4
3.2.5
3.3
3.3.1
3.3.2
Définition des contextes de calcul..........................................................................................19
Chapitre 4
Calcul de valeurs à l'aide d'indicateurs intelligents..............................................................39
4.1
4.2
4.2.1
4.3
4.4
Indicateurs intelligents définis.................................................................................................39
Utilisation de formules pour créer des calculs personnalisés..................................................10
Utilisation de variables pour simplifier des formules................................................................10
Utilisation des fonctions.........................................................................................................11
Insertion de fonctions dans des cellules.................................................................................11
Syntaxe de la fonction............................................................................................................12
Exemples de fonctions...........................................................................................................12
Opérateurs de fonction et de formule.....................................................................................16
Contexte d'entrée..................................................................................................................19
Contexte de sortie.................................................................................................................20
Contextes de calcul par défaut...............................................................................................22
Contextes par défaut dans un tableau vertical........................................................................23
Contextes par défaut dans un tableau horizontal....................................................................24
Contextes par défaut dans un tableau croisé..........................................................................24
Contextes par défaut dans une section..................................................................................25
Contextes par défaut dans une rupture..................................................................................26
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée..........................27
Opérateurs de syntaxe avancée.............................................................................................27
Mots clés de la syntaxe avancée............................................................................................31
Regroupements et indicateurs intelligents..............................................................................39
Gestion des regroupements...................................................................................................40
Indicateurs intelligents et périmètre d'analyse.........................................................................41
Indicateurs intelligents et SQL................................................................................................41
2011-04-14
Table des matières
4
4.4.1
4.5
4.5.1
4.5.2
4.6
4.6.1
4.6.2
4.6.3
4.6.4
Regroupements et opérateur UNION.....................................................................................41
Chapitre 5
Fonctions, opérateurs et mots clés.......................................................................................49
5.1
5.1.1
5.1.2
5.1.3
5.1.4
5.1.5
5.1.6
5.1.7
5.1.8
5.1.9
5.2
5.2.1
5.2.2
5.2.3
5.2.4
5.2.5
5.2.6
5.3
5.3.1
5.3.2
5.3.3
5.3.4
5.3.5
5.4
5.5
Fonctions...............................................................................................................................49
Chapitre 6
Dépannage des formules....................................................................................................197
6.1
6.1.1
Messages d'erreur de formule et d'information....................................................................197
Indicateurs intelligents et formules.........................................................................................43
Indicateurs intelligents et dimensions contenant des formules................................................43
Indicateurs intelligents dans les formules................................................................................44
Indicateurs intelligents et filtres..............................................................................................44
Indicateurs intelligents et filtres sur les dimensions................................................................44
Filtrage des indicateurs intelligents.........................................................................................45
Indicateurs intelligents et filtres d'exploration.........................................................................46
Indicateurs intelligents et filtres OR imbriqués........................................................................47
Fonction Agrégat....................................................................................................................49
Fonctions du groupe Caractère..............................................................................................73
Fonctions Date et heure.........................................................................................................88
Fonctions du groupe Fournisseur de données........................................................................99
Fonctions Document............................................................................................................110
Fonctions du groupe Logique...............................................................................................117
Fonctions du groupe Numérique..........................................................................................124
Fonctions d'ensemble..........................................................................................................144
Fonctions diverses...............................................................................................................152
Opérateurs de fonction et de formule...................................................................................171
Opérateurs mathématiques..................................................................................................171
Opérateurs conditionnels.....................................................................................................171
Opérateurs logiques.............................................................................................................172
Opérateurs spécifiques à la fonction....................................................................................174
Opérateurs de syntaxe avancée...........................................................................................182
Opérateurs définis................................................................................................................186
Mots clés de la syntaxe avancée..........................................................................................187
Mot clé Bloc........................................................................................................................187
Mot clé Corps......................................................................................................................188
Mot clé Saut........................................................................................................................189
Mot clé Rapport...................................................................................................................190
Mot clé Section....................................................................................................................191
Arrondir et tronquer des nombres........................................................................................192
Référence à des membres et des ensembles de membres des hiérarchies..........................193
#CALCUL............................................................................................................................197
2011-04-14
Table des matières
6.1.2
6.1.3
6.1.4
6.1.5
6.1.6
6.1.7
6.1.8
6.1.9
6.1.10
6.1.11
6.1.12
6.1.13
6.1.14
6.1.15
6.1.16
6.1.17
6.1.18
6.1.19
#CONTEXTE........................................................................................................................197
Chapitre 7
Comparaison de valeurs à l'aide de fonctions....................................................................205
7.1
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.2.5
Comparaison de valeurs à l'aide de la fonction Précédent....................................................205
Annexe A
Informations supplémentaires.............................................................................................215
Index
5
#SYNCDONNEES...............................................................................................................198
#DIV/0.................................................................................................................................198
#ERREUR............................................................................................................................199
#EXTERNE...........................................................................................................................199
#INCOMPATIBLE................................................................................................................199
#MELANGER.......................................................................................................................199
#VALEURMULTI..................................................................................................................199
#DEBORDEMENT...............................................................................................................200
#RESULTATPARTIEL...........................................................................................................200
#CLASSEMENT...................................................................................................................200
#RECURSIF.........................................................................................................................201
#ACTUALISER.....................................................................................................................201
#FORMULERAPPT..............................................................................................................201
#SECURITE.........................................................................................................................202
#SYNTAXE..........................................................................................................................202
#TOREFRESH......................................................................................................................202
#INDISPONIBLE..................................................................................................................202
Comparaison de valeurs à l'aide de la fonction ValeurRelative..............................................205
Dimensions de découpage et fonction ValeurRelative..........................................................206
Dimensions de découpage et sections.................................................................................208
Ordre des dimensions de découpage...................................................................................210
Dimensions de découpage et tris.........................................................................................212
Utilisation de ValeurRelative dans les tableaux croisés.........................................................213
217
2011-04-14
Table des matières
6
2011-04-14
A propos de ce guide
A propos de ce guide
Le guide Utilisation de fonctions, de formules et de calculs dans Web Intelligence fournit des informations
détaillées sur les fonctionnalités de calcul avancées disponibles lorsque vous effectuez une analyse
interactive. Il sert aussi de référence pour la syntaxe des fonctions et des opérateurs disponibles.
7
2011-04-14
A propos de ce guide
8
2011-04-14
Utilisation de calculs standards et personnalisés
Utilisation de calculs standards et personnalisés
Vous pouvez vous servir des fonctions de calcul standard pour effectuer des calculs rapides sur les
données. Si les calculs standard ne suffisent pas et ne répondent pas à vos besoins, vous pouvez créer
des calculs personnalisés à l'aide du langage utilisé pour les formules.
2.1 Calculs standard
Vous pouvez vous servir des fonctions de calcul standard pour effectuer des calculs rapides sur les
données. Les calculs standard suivants sont disponibles :
Calcul
Description
Somme
Calcule la somme des données sélectionnées.
Nombre
Compte toutes les lignes d'un objet de type indicateur ou compte les différentes lignes d'un objet
de type dimension ou information.
Moyenne
Calcule la moyenne des données.
Minimum
Affiche la valeur minimale des données sélectionnées.
Maximum
Affiche la valeur maximale des données sélectionnées.
Afficher les données sélectionnées sous forme
de pourcentage du total. Les résultats du pourcentage sont affichés dans une colonne ou une ligne
supplémentaire du tableau.
Pourcentage
9
Remarque :
Les pourcentages sont calculés pour l'indicateur
sélectionné relativement aux résultats totaux pour
cet indicateur sur le tableau ou la rupture. Pour
calculer le pourcentage d'un indicateur relativement à un autre indicateur, vous devez créer un
calcul personnalisé.
2011-04-14
Utilisation de calculs standards et personnalisés
Calcul
Description
Par défaut
Applique la fonction d'agrégation par défaut à un
indicateur standard, ou la fonction d'agrégation
de base de données à un indicateur intelligent.
Lorsque vous appliquez des calculs standard à des colonnes de tableau, leurs résultats apparaissent
dans des pieds de page. Un pied de page est ajouté pour chaque calcul.
2.2 Utilisation de formules pour créer des calculs personnalisés
Les calculs personnalisés permettent d'ajouter d'autres calculs à votre rapport en plus des objets de
base et des calculs standard.
L'ajout d'un calcul personnalisé se fait en écrivant une formule. Une formule peut se composer de
variables de rapport de base, de fonctions, d'opérateurs et de contextes de calcul.
Un calcul personnalisé est une formule qui peut être composée d'objets de rapport, de fonctions et
d'opérateurs. Les formules bénéficient d'un contexte de calcul que vous pouvez spécifier de façon
explicite si vous le souhaitez.
Exemple : Affichage de la moyenne de revenus par vente
Imaginons qu'un de vos rapports contient les objets Revenu des ventes et Quantité vendue et que
vous voulez ajouter le revenu par vente. Le calcul [Revenu des ventes]/[Quantité ven
due]génère cette valeur en divisant le revenu par le nombre d'articles vendus pour obtenir le revenu
par article.
Rubriques associées
• Définition des contextes de calcul
2.2.1 Utilisation de variables pour simplifier des formules
Si une formule est complexe, vous pouvez utiliser des variables pour la simplifier. En utilisant des
variables, vous décomposez une formule complexe en parties faciles à gérer et améliorez sa lisibilité,
tout en réduisant le risque d'erreur de génération de formule.
Vous pouvez utiliser dans une formule des variables créées antérieurement, exactement de la même
façon que vous utilisez d'autres objets de rapport. Les variables apparaissent dans l'Editeur de formule
sous le dossier Variables.
10
2011-04-14
Utilisation de calculs standards et personnalisés
Vous pouvez saisir ce nom de variable dans une formule ou le faire glisser dans la barre d'outils Formule
comme pour tout autre objet de rapport.
Rubriques associées
• Simplification d'une formule de variance avec des variables
2.3 Utilisation des fonctions
Un calcul personnalisé ne contient parfois que des objets de rapport, par exemple [Revenu des
ventes]/[Nombre de ventes]. Néanmoins, les calculs peuvent également inclure des fonctions
en plus des objets de rapport.
Une fonction reçoit zéro ou plusieurs valeurs comme entrée et renvoie une sortie basée sur ces valeurs.
Par exemple, la fonction Somme calcule le total de toutes les valeurs d'un indicateur et renvoie le résultat.
La formule Somme([Revenu des ventes]) génère le total des revenus des ventes. Dans ce cas,
l'entrée de la fonction est l'indicateur Revenu des ventes et la sortie est le total de tous les indicateurs
des ventes.
Rubriques associées
• Opérateurs de fonction et de formule
• Fonctions
2.3.1 Insertion de fonctions dans des cellules
Le texte des cellules de rapport commence toujours par "=". Le texte littéral apparaît entouré de
guillemets, au contraire des formules qui apparaissent sans guillemets. Par exemple, la formule
Moyenne([Revenu]) apparaît dans une cellule sous la forme =Moyenne([Revenu]). Le texte "Revenu
moyen ?" apparaît sous la forme ="Revenu moyen ?"
Vous pouvez utiliser seulement du texte dans une cellule, ou bien mélanger des formules et du texte
à l'aide de l'opérateur "+". Si vous voulez qu'une cellule affiche le revenu moyen précédé du texte
"Revenu moyen :", le texte de cette cellule doit se présenter comme suit : ="Revenu moyen :" +
Moyenne([Revenu])
Notez la présence d'un espace à la fin de la chaîne de texte pour que le texte et la valeur ne soient
pas placés directement côte à côte dans la cellule.
11
2011-04-14
Utilisation de calculs standards et personnalisés
2.3.2 Syntaxe de la fonction
Pour utiliser une fonction, vous devez connaître son nom, le nombre de valeurs en entrée dont elle a
besoin et les types de données de ces valeurs. Vous devez également connaître le type de données
que génère la fonction.
Par exemple, la fonction Somme utilise un objet numérique comme entrée (par exemple, un indicateur
présentant un revenu des ventes) et génère des données numériques (la somme de toutes les valeurs
de l'objet indicateur).
Voici la syntaxe de la fonction Abs :
num Abs(number)
Cette syntaxe indique que la fonction Abs prend un seul nombre en entrée et renvoie un nombre en
sortie.
L'Editeur de formule affiche la syntaxe de la fonction lorsque vous sélectionnez cette dernière.
2.3.3 Exemples de fonctions
Exemple : Affichage d'une invite de saisie avec la fonction RéponseUtilisateur
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. L'objet
Etat figure également dans le rapport bien qu'il ne soit pas affiché. Lorsque l'utilisateur exécute le
rapport, une invite s'affiche, lui proposant de choisir un Etat. Vous voulez que l'Etat choisi s'affiche
dans le titre du rapport. Si le fournisseur de données s'appelle "eFashion" et que le texte de l'invite
est "Choisissez un Etat" ("Choose a State", en anglais), la formule pour le titre est la suivante :
"Quarterly Revenues for " + UserResponse( "eFashion";"Choose a State")
Le rapport est le suivant :
12
2011-04-14
Utilisation de calculs standards et personnalisés
Exemple : Calcul d'un pourcentage à l'aide de la fonction Pourcentage
La fonction Pourcentage permet de calculer des pourcentages : Cette fonction calcule le pourcentage
d'un nombre par rapport à son contexte environnant. Par exemple, le tableau suivant présente les
revenus par année et par trimestre. La colonne de pourcentage contient la formule Pourcentage
([Revenu des ventes]).
13
2011-04-14
Utilisation de calculs standards et personnalisés
Dans ce cas, la fonction calcule chaque revenu en tant que pourcentage du revenu total. Le contexte
environnant est le revenu total ; il s'agit du seul chiffre de revenu qui est intéressant, en dehors de la
répartition en année et en trimestre dans le tableau.
Si le rapport est divisé en sections par année, le contexte environnant à l'extérieur du tableau devient
le revenu total de la section.
Si la cellule Pourcentage est placée à l'extérieur du tableau, mais toujours au sein de la section, le
contexte environnant devient le revenu total. Dans ce cas, la fonction Pourcentage calcule le revenu
total pour la section en tant que pourcentage du revenu global total.
Exemple : Calcul d'un pourcentage à l'aide de la fonction Somme
Vous pouvez contrôler davantage le contexte de calcul d'un pourcentage en utilisant la fonction Somme
plutôt que la fonction Pourcentage. Si vous divisez un chiffre faisant partie d'un ensemble de chiffres
par le total de ces chiffres, vous obtenez son pourcentage par rapport au total ; par exemple, la formule
[Revenu des ventes]/Somme([Revenu des ventes]) donne le revenu des ventes en tant que pourcentage
du revenu total.
Dans le tableau suivant, la colonne Pourcentage du total contient la formule
[Sales revenue]/(Sum([Sales revenue] In Report))
14
2011-04-14
Utilisation de calculs standards et personnalisés
et la colonne Pourcentage de Année contient la formule
[Sales revenue]/(Sum([Sales revenue] In Section))
Ces formules utilisent les mots clés de syntaxe avancée Rapport et Section pour demander à la
fonction Somme de calculer respectivement le revenu total global et le revenu annuel.
Rubriques associées
• Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
2.3.3.1 Simplification d'une formule de variance avec des variables
La variance est un terme statistique. La variance d'un ensemble de valeurs mesure l'étendue de ces
valeurs par rapport à leur moyenne. La fonction Var permet de calculer la variance d'un seul coup,
mais le calcul manuel de la variance montre bien comment il est possible de simplifier une formule
complexe en se servant de variables. Pour calculer la variance manuellement, vous devez :
•
•
•
•
calculer le nombre moyen d'articles vendus,
calculer la différence entre chaque nombre d'articles vendus et la moyenne, puis élever cette valeur
au carré,
additionner toutes ces différences élevées au carré,
diviser ce total par le nombre de valeurs – 1.
Vous disposez d'un rapport présentant les nombres d'articles vendus par trimestre et vous voulez
inclure la variance. Sans l'utilisation de variables pour la simplifier, cette formule complexe se présente
comme suit :
Sum((([Quantity sold] - Average([Quantity sold] ForEach [Quarter]) In Report)*([Quantity sold] - Average([Qua
ntity sold] ForEach [Quarter]) In Report)) In [Quarter])/(Count ([Quantity sold] ForEach [Quarter]) - 1)
Création de la formule de variance
Plusieurs étapes sont nécessaires pour créer une formule de variance. Vous encapsulez chacune de
ces étapes dans une variable. Les variables que vous créez sont les suivantes :
• Moyenne du nombre d'articles vendus
15
2011-04-14
Utilisation de calculs standards et personnalisés
•
•
•
Nombre d'observations (soit le nombre de valeurs distinctes du nombre d'articles vendus)
Différence entre une observation et la moyenne (valeur élevée au carré)
Somme de ces différences divisée par le nombre d'observations - 1
Les formules de variable sont les suivantes :
Variable
Formule
Moyenne des ventes
Moyenne([Quantité vendue] Dans ([Trimestre]))
Dans Rapport
Nombre d'observations
Nombre([Quantité vendue] Dans ([Trimestre]))
Dans Rapport
Différence élevée au carré
Puissance(([Quantité vendue] - [Moyenne ventes]);2)
Variance
Somme([Différence élevée au carré] Dans ([Trimestre]))/([Nombre d'observations] - 1)
La formule s'affiche désormais sous la forme suivante :
Sum ([Difference Squared])/[Number of Observations] - 1)
qui est beaucoup plus facile à comprendre. La version simplifiée de la formule donne une vue de niveau
élevé de l'action de la formule, au lieu de vous plonger dans des détails confus. Vous pouvez ensuite
examiner les formules des variables référencées dans la formule de niveau élevé pour comprendre
ses parties constitutives.
Par exemple, la formule fait référence à la variable Différence élevée au carré, qui fait elle-même
référence à la variable Moyenne vendue. En examinant les formules de Différence élevée au carré et
de Moyenne vendue, vous pouvez effectuer une exploration avant de la formule afin de comprendre
en détail ce qu'elle effectue.
2.3.4 Opérateurs de fonction et de formule
Les opérateurs lient les différents composants dans une formule. Les formules peuvent contenir des
opérateurs mathématiques, conditionnels, logiques, spécifiques à une fonction ou de syntaxe avancée.
2.3.4.1 Opérateurs mathématiques
16
2011-04-14
Utilisation de calculs standards et personnalisés
Les opérateurs mathématiques paraissent familiers car ils correspondent aux opérations arithmétiques
de base. Les opérateurs d'addition (+), de soustraction (-), de multiplication (*) et de division (/) permettent
d'effectuer des opérations mathématiques dans une formule. La formule [Chiffre d'affaires]
- [Coût des ventes] contient un opérateur mathématique, la soustraction en l'occurrence.
Remarque :
Lorsqu'il est utilisé avec des chaînes de caractères, l'opérateur "+" devient un opérateur de concaténation
de chaînes. Autrement dit, il permet de joindre des chaînes de caractères. Par exemple, la formule
"Jean" + " Durand" renvoie "Jean Durand".
2.3.4.2 Opérateurs conditionnels
Les opérateurs conditionnels déterminent le type de comparaison à effectuer entre des valeurs.
Opérateur
Description
=
Egal à
>
Supérieur à
<
Inférieur à
>=
Supérieur ou égal à
<=
Inférieur ou égal à
<>
Différent de
Vous utilisez les opérateurs conditionnels avec la fonction Si, comme dans :
If [Revenue]>10000 Then "High" Else "Low"
qui renvoie "Elevé" pour toutes les lignes où le revenu est supérieur ou égal à 10 000 et "Bas" pour
toutes les autres lignes.
2.3.4.3 Opérateurs logiques
Les opérateurs logiques sont Et, Ou, Pas, Entre et DansListe. Les opérateurs logiques sont utilisés
dans des expressions booléennes qui renvoient Vrai ou Faux.
17
2011-04-14
Utilisation de calculs standards et personnalisés
2.3.4.4 Opérateurs contextuels
Les opérateurs contextuels font partie de la syntaxe de calcul avancée. La syntaxe avancée permet
de définir quelles dimensions un indicateur ou une formule prend en compte dans un calcul.
2.3.4.5 Opérateurs spécifiques à la fonction
Certaines fonctions peuvent se servir d'opérateurs particuliers comme arguments. Par exemple, la
fonction Précédent peut avoir pour argument l'opérateur Lui-même.
Toutes les fonctions entourent les arguments avec ) et (. Les fonctions qui acceptent plusieurs
paramètres utilisent ; pour les séparer.
18
2011-04-14
Notions de contextes de calcul
Notions de contextes de calcul
3.1 Définition des contextes de calcul
Le contexte de calcul correspond aux données qu'un calcul prend en compte pour générer un résultat.
Autrement dit, la valeur donnée par un indicateur est déterminée par les dimensions utilisées pour
calculer cet indicateur.
Un rapport contient deux types d'objet :
•
•
Les dimensions représentent les données professionnelles qui génèrent les chiffres. Les points de
vente, les années ou les régions sont des exemples de données de type dimension. Par exemple,
un point de vente, une année ou une région peuvent générer un revenu et nous pouvons parler du
revenu par point de vente, du revenu par année ou du revenu par région.
Les indicateurs sont les données numériques générées par les données de type dimension. Le
revenu et le nombre de ventes sont des exemples d'indicateurs. Par exemple, nous pouvons parler
du nombre de ventes réalisées dans un magasin particulier.
Les indicateurs peuvent également être générés par des combinaisons de données de type dimension.
Par exemple, nous pouvons parler du revenu généré par un magasin particulier en 2005.
Le contexte de calcul d'un indicateur comprend deux composants :
• la dimension ou la liste de dimensions qui détermine la valeur de l'indicateur,
• la partie des données de type dimension qui détermine la valeur de l'indicateur.
Le contexte de calcul comprend deux composants :
•
•
Contexte d'entrée
Contexte de sortie
Rubriques associées
• Contexte d'entrée
• Contexte de sortie
3.1.1 Contexte d'entrée
Le contexte d'entrée d'un indicateur ou d'une formule est la liste des dimensions qui alimentent le calcul.
19
2011-04-14
Notions de contextes de calcul
La liste de dimensions d'un contexte d'entrée apparaît à l'intérieur des parenthèses de la fonction qui
renvoie la valeur en sortie. La liste de dimensions doit également se trouver entre parenthèses (même
si elle ne contient qu'une seule dimension) et les dimensions doivent être séparées par des
points-virgules.
Exemple : Spécification d'un contexte d'entrée
Dans un rapport comprenant plusieurs sections Année et un bloc par section incluant les colonnes
Client et Revenu, les contextes d'entrée sont les suivants :
Partie de rapport
Contexte d'entrée
En-tête de section et pieds de page de bloc
Année
Lignes du bloc
Année, Client
En d'autres termes, les en-têtes de section et les pieds de page de bloc montrent le revenu agrégé
par année, et chaque ligne du bloc présente le revenu agrégé par année et par client (c'est-à-dire le
revenu généré par ce client au cours de l'année en question).
Lorsqu'ils sont explicitement définis dans une formule, ces contextes d'entrée se présentent comme
suit :
Sum ([Revenue] In ([Year]))
Sum ([Revenue] In ([Year];[Customer]))
Autrement dit, les dimensions du contexte d'entrée apparaissent entre les parenthèses de la fonction
(en l'occurrence, Somme) pour laquelle ce contexte est défini.
3.1.2 Contexte de sortie
Le contexte de sortie entraîne la génération d'une valeur par la formule s'il est placé dans le pied de
page d'un bloc contenant un saut.
Exemple : Spécification d'un contexte de sortie
Le rapport suivant présente le revenu par année et par trimestre, avec une rupture au niveau de
l'année, et le revenu minimal calculé par année :
20
2011-04-14
Notions de contextes de calcul
Comment présenter le revenu annuel minimal dans un bloc sans rupture ? Pour ce faire, vous pouvez
spécifier le contexte de sortie dans une formule. Dans ce cas, la formule se présente comme suit :
Min ([Revenue]) In ([Year])
Autrement dit, le contexte de sortie apparaît après les parenthèses de la fonction pour laquelle vous
spécifiez ce contexte. Dans ce cas, le contexte de sortie calcule le revenu minimal par an.
Si vous rajoutez une colonne contenant cette formule dans le bloc, le résultat est le suivant :
Vous pouvez constater que la colonne Minimum par année contient le revenu minimal qui figure dans
les pieds de rupture du rapport précédent.
21
2011-04-14
Notions de contextes de calcul
Notez que, dans cet exemple, le contexte d'entrée n'est pas spécifié, car il s'agit du contexte par
défaut (Année, Trimestre) pour le bloc. En d'autres termes, le contexte de sortie détermine le revenu
par année et par trimestre à calculer. De forme complète, avec les formules d'entrée et de sortie
spécifiées de façon explicite, la formule se présente comme suit :
Min ([Sales Revenue] In([Year];[Quarter])) In ([Year])
Autrement dit, cette formule permet de calculer les revenus par année et par trimestre, puis d'indiquer
le plus faible de ces revenus pour chaque année.
Que se passe-t-il si vous ne spécifiez pas le contexte de sortie dans la colonne Minimum par année ?
Dans ce cas, les chiffres sont identiques à ceux de la colonne Revenu des ventes. Pourquoi ? N'oubliez
pas que le contexte par défaut d'un bloc inclut les dimensions du bloc. Le revenu minimal annuel par
trimestre est identique au revenu annuel par trimestre parce qu'il n'existe qu'un seul revenu par
combinaison année/trimestre.
3.2 Contextes de calcul par défaut
Un indicateur a un contexte de calcul par défaut, en fonction de sa place dans le rapport. Les chiffres
renvoyés par un indicateur dépendent des dimensions auxquelles cet indicateur est associé. Cette
combinaison de dimensions représente le contexte de calcul.
Vous pouvez modifier le contexte par défaut à l'aide de la syntaxe étendue. En d'autres termes, vous
pouvez déterminer l'ensemble de dimensions utilisé pour générer un indicateur. Il s'agit précisément
de l'action évoquée par la notion de définition du contexte de calcul.
Exemple : Contextes par défaut dans un rapport
Cet exemple décrit le contexte de calcul par défaut des indicateurs d'un rapport simple. Le rapport
présente le revenu généré par les clients et il est divisé en sections par année.
2005
22
Total : 8 000
Client
Revenu
Harris
1 000
Dupont
3 000
Walsh
4 000
Total :
8 000
2011-04-14
Notions de contextes de calcul
Total du rapport : 8 000
Le tableau suivant présente le contexte de calcul des indicateurs dans ce rapport :
Indicateur
Valeur
Contexte
Total du rapport
20 000
Total de tous les revenus du
rapport
Total de l'en-tête de section
8000
Année
Total du client
1000, 3000, 4000
Année;Client
Total du pied de page de bloc
8000
Année
Rubriques associées
• Définition des contextes de calcul
• Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3.2.1 Contextes par défaut dans un tableau vertical
Un tableau vertical est un tableau de rapport standard avec des en-têtes dans la partie supérieure, des
données s'étendant de haut en bas dans le tableau, et des pieds de page dans la partie inférieure du
tableau. Les contextes par défaut dans un tableau vertical sont les suivants :
23
Lorsque le calcul se trouve dans...
Le contexte d'entrée est...
Le contexte de sortie est...
En-tête
Les dimensions et les indicateurs utilisés pour générer le
corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Corps du bloc
Les dimensions et les indicateurs utilisés pour générer la
ligne en cours.
Le même que le contexte d'entrée.
Pied de page
Les dimensions et les indicateurs utilisés pour générer le
corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
2011-04-14
Notions de contextes de calcul
Exemple : Contextes par défaut dans un tableau vertical
Le tableau suivant présente les contextes par défaut dans un tableau vertical :
3.2.2 Contextes par défaut dans un tableau horizontal
Un tableau horizontal ressemble à un tableau vertical couché sur un côté. Les en-têtes figurent sur la
gauche, les données s'échelonnent de gauche à droite et les pieds de page figurent sur la droite. Les
contextes par défaut pour un tableau horizontal sont identiques à ceux d'un tableau vertical.
3.2.3 Contextes par défaut dans un tableau croisé
Un tableau croisé affiche les données dans une matrice avec des indicateurs apparaissant aux
intersections des dimensions. Les contextes par défaut dans un tableau croisé sont les suivants :
24
Le calcul se trouve dans...
Le contexte d'entrée est…
Le contexte de sortie est…
En-tête
Les dimensions et les indicateurs utilisés pour générer le
corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Corps du bloc
Les dimensions et les indicateurs utilisés pour générer le
corps du bloc.
Le même que le contexte d'entrée.
2011-04-14
Notions de contextes de calcul
Le calcul se trouve dans...
Le contexte d'entrée est…
Le contexte de sortie est…
Pied de page
Les dimensions et les indicateurs utilisés pour générer le
corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Pied de page VBody
Les dimensions et les indicateurs utilisés pour générer la
colonne courante.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Pied de page HBody
Les dimensions et les indicateurs utilisés pour générer la
ligne courante.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Pied de page VFooter
Identique au pied de page.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Pied de page HFooter
Identique au pied de page.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Exemple : Contextes par défaut dans un tableau croisé
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
3.2.4 Contextes par défaut dans une section
Une section se compose d'un en-tête, d'un corps et d'un pied de page. Les contextes par défaut dans
une section sont les suivants :
25
Le calcul se trouve dans...
Le contexte d'entrée est…
Le contexte de sortie est…
Corps
Les dimensions et les indicateurs du rapport, filtrés pour limiter les données à celles de la
section.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
2011-04-14
Notions de contextes de calcul
Exemple : Contextes par défaut dans une section
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
3.2.5 Contextes par défaut dans une rupture
Une rupture se compose d'un en-tête, d'un corps et d'un pied de page. Les contextes par défaut dans
une rupture sont les suivants :
26
Le calcul se trouve dans...
Le contexte d'entrée est…
Le contexte de sortie est…
En-tête
Instance en cours de la rupture.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
Pied de page
Instance en cours de la rupture.
Toutes les données sont agrégées, puis la fonction de calcul
renvoie une valeur unique.
2011-04-14
Notions de contextes de calcul
Exemple : Contextes par défaut dans une rupture
Le rapport suivant présente les contextes par défaut dans une rupture :
3.3 Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
La syntaxe avancée fait appel à des opérateurs contextuels que vous ajoutez à une formule ou à un
indicateur pour spécifier son contexte de calcul. Le contexte d'un indicateur ou d'une formule est
constitué d'un contexte d'entrée et d'un contexte de sortie.
3.3.1 Opérateurs de syntaxe avancée
Vous spécifiez explicitement les contextes d'entrée et de sortie avec les opérateurs contextuels. Le
tableau suivant répertorie les opérateurs contextuels :
27
Opérateur
Description
Dans
Spécifie une liste explicite de dimensions à utiliser
dans le contexte
PourChaque
Ajoute des dimensions au contexte par défaut
PourTout
Supprime des dimensions du contexte par défaut
2011-04-14
Notions de contextes de calcul
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte par défaut contient de
nombreuses dimensions. Il est souvent plus facile d'effectuer un ajout ou un retrait du contexte avec
les opérateurs PourTout et PourChaque que de spécifier explicitement la liste avec Dans.
3.3.1.1 Opérateur contextuel Dans
L'opérateur contextuel Dans spécifie les dimensions de façon explicite dans un contexte.
Exemple : Utilisation de l'opérateur Dans pour spécifier les dimensions dans un contexte
Dans cet exemple, vous avez un rapport présentant les valeurs Année et Revenu des ventes. Votre
fournisseur de données contient aussi l'objet Trimestre, mais vous n'incluez pas cette dimension dans
le bloc. Vous choisissez plutôt d'inclure une autre colonne qui affiche le revenu maximal par trimestre
de chaque année. Votre rapport se présente comme suit :
Année
Revenu des ventes
Revenu trimestriel max.
2001
8 096 123,60 €
2 660 699,50 €
2002
13 232 246,00 €
4 186 120,00 €
2003
15 059 142,80 €
4 006 717,50 €
Vous pouvez voir d'où proviennent les valeurs de la colonne Revenu trimestriel maximum en examinant
ce bloc avec un bloc incluant la dimension Trimestre :
28
2011-04-14
Notions de contextes de calcul
Année
Trimestre
Revenu des ventes
2001
T1
2 660 699,50 €
2001
T2
2 279 003,00 €
2001
T3
1 367 841,00 €
2001
T4
1 788 580,00 €
Max. :
2 660 699,50 €
Année
Année
Trimestre
Revenu des ventes
T1
3 326 172,00 €
T2
2 840 651,00 €
T3
2 879 303,00 €
T4
4 186 120,00 €
Max. :
4 186 120,00 €
Trimestre
Revenu des ventes
T1
3 742 989,00 €
T2
4 006 717,50 €
T3
3 953 395,00 €
T4
3 356 041,00 €
Max. :
4 006 717,50 €
La colonne Revenu trimestriel maximum présente le revenu trimestriel le plus élevé de chaque année.
Par exemple, T4 présentant le revenu le plus élevé pour 2002, la colonne Revenu trimestriel maximum
présente le revenu de T4 sur la ligne affichant les valeurs de 2002.
Avec l'opérateur Dans, la formule pour Revenu trimestriel maximum est
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Cette formule permet de calculer le revenu des ventes maximal pour chaque combinaison
(Année,Trimestre), puis d'indiquer ce chiffre par année.
Remarque :
Comme le contexte de sortie par défaut du bloc est Année, vous n'avez pas besoin de spécifier de
façon explicite le contexte de sortie dans cette formule.
29
2011-04-14
Notions de contextes de calcul
3.3.1.2 Opérateur contextuel PourChaque
L'opérateur PourChaque ajoute des dimensions à un contexte.
Exemple : Utilisation de l'opérateur PourChaque pour ajouter des dimensions à un contexte
Le tableau suivant présente le revenu maximal de chaque trimestre dans un rapport qui contient la
dimension Trimestre, mais ne l'inclut pas dans le bloc :
Année
Revenu des ventes
Revenu trimestriel max.
2001
8 096 123,60
2 660 699,50
2002
13 232 246,00
4 186 120,00
2003
15 059 142,80
4 006 717,50
Il est possible de créer une formule pour la colonne Revenu trimestriel maximum n'incluant pas
l'opérateur PourChaque :
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Si vous optez pour l'opérateur contextuel PourChaque, vous pouvez obtenir le même résultat avec la
formule suivante :
Max ([Sales Revenue] ForEach ([Quarter])) In ([Year])
Pourquoi ? Parce que la dimension Année est le contexte d'entrée par défaut du bloc. En vous servant
de l'opérateur PourChaque, vous ajoutez la dimension Trimestre au contexte, en donnant le contexte
d'entrée ([Année];[Trimestre]).
3.3.1.3 Opérateur contextuel PourTout
L'opérateur contextuel PourTout supprime les dimensions d'un contexte.
Exemple : Utilisation de l'opérateur PourTout pour supprimer les dimensions d'un contexte
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes, et vous
voulez ajouter une colonne qui présente le revenu total de chaque année, comme indiqué dans le
bloc suivant :
30
2011-04-14
Notions de contextes de calcul
Pour que le total de chiffre d'affaires par année soit effectué, le contexte d'entrée doit être (Année) ;
par défaut, il s'agit de (Année; Trimestre). Par conséquent, vous pouvez supprimer Trimestre du
contexte d'entrée en spécifiant PourTout ([Trimestre]) dans la formule, comme suit :
Sum([Sales Revenue] ForAll ([Quarter]))
Sachez que l'opérateur Dans vous permet d'aboutir au même résultat ; dans ce cas, la formule est :
Sum([Sales Revenue] In ([Year]))
Cette version de la formule spécifie de façon explicite Année comme contexte, au lieu de supprimer
Trimestre pour conserver Année.
3.3.2 Mots clés de la syntaxe avancée
Les mots clés de la syntaxe avancée constituent une sorte de "notation abrégée" qui vous permet de
faire référence à des dimensions en syntaxe avancée sans spécifier de façon explicite ces dimensions.
Cette opération garantit des rapports toujours optimaux ; si les formules ne contiennent pas de références
figées dans le code à des dimensions, elles restent valables même en cas d'ajout ou de suppression
de dimensions dans le rapport.
Il existe cinq mots clés de syntaxe avancée : Rapport, Section, Rupture, Bloc et Corps.
3.3.2.1 Mot clé Rapport
Le tableau ci-après décrit les données auxquelles fait référence le mot clé Rapport, selon son
emplacement dans un rapport :
31
2011-04-14
Notions de contextes de calcul
Placé dans…
Fait référence à…
Un bloc
Toutes les données du rapport
Une rupture de bloc (en-tête ou pied)
Toutes les données du rapport
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Toutes les données du rapport
A l'extérieur des blocs ou sections
Toutes les données du rapport
Exemple : Mot clé Rapport
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. Le rapport
contient une colonne, Rapport total, qui affiche le total de tous les revenus du rapport.
La formule pour la colonne Rapport total est Somme([Chiffre d'affaires]) Dans Rapport. Sans le mot
clé Rapport, cette colonne dupliquerait les chiffres de la colonne Revenu des ventes, car le contexte
de sortie par défaut serait utilisé ([Année];[Trimestre]).
3.3.2.2 Mot clé Section
Le tableau ci-après décrit les données auxquelles fait référence le mot clé Section, selon son
emplacement dans un rapport :
32
Placé dans…
Fait référence à…
Un bloc
Toutes les données de la section
Une rupture de bloc (en-tête ou pied)
Toutes les données de la section
2011-04-14
Notions de contextes de calcul
Placé dans…
Fait référence à…
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Toutes les données de la section
A l'extérieur des blocs ou sections
Non applicable
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes.
Le rapport contient une section basée sur Année. La colonne Total section contient la formule :
Sum ([Sales Revenue]) In Section
Les chiffres de la colonne Total section représentent le revenu total pour 2001, car la rupture de
section se produit au niveau de l'objet Année. Sans le mot clé Section, cette colonne dupliquerait les
chiffres de la colonne Revenu des ventes car le contexte de sortie par défaut ([Année];[Trimestre])
serait utilisé.
3.3.2.3 Mot clé Saut
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Saut, selon son
emplacement dans un rapport :
33
Placé dans…
Fait référence à…
Un bloc
Toutes les données dans la partie du bloc délimité
par un saut
Un saut de bloc (en-tête ou pied)
Toutes les données dans la partie du bloc délimité
par un saut
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Non applicable
A l'extérieur des blocs ou sections
Non applicable
2011-04-14
Notions de contextes de calcul
Exemple : Mot clé Saut
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes :
Année
Trimestre
Revenu des ventes
Total Saut
2001
T1
2 660 700 €
8 096 124 €
T2
2 279 003 €
8 096 124 €
T3
1 367 841 €
8 096 124 €
T4
1 788 580 €
8 096 124 €
Le rapport comporte un saut au niveau de Année. La colonne Total saut contient la formule :
Sum ([Sales Revenue]) In Break
Sans le mot clé Saut, cette colonne dupliquerait les chiffres de la colonne Revenu des ventes, car le
contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
3.3.2.4 Mot clé Bloc
La table suivante décrit les dimensions référencées par le mot-clé Bloc, en fonction de sa place dans
un rapport : le mot-clé Bloc rassemble souvent les mêmes données que le mot-clé Section. La différence
entre les deux réside dans le fait que Bloc tient compte des filtres placés sur un bloc alors que Section
les ignore.
Placé dans…
Fait référence à…
Un bloc
Toutes les données du bloc, sans tenir compte
des ruptures, en respectant les filtres
Une rupture de bloc (en-tête ou pied)
Toutes les données du bloc, sans tenir compte
des ruptures, en respectant les filtres
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Non applicable
A l'extérieur des blocs ou sections
Non applicable
Exemple : Mot clé Bloc
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. Le rapport
contient une section basée sur Année. Le bloc est filtré de façon à exclure les troisième et quatrième
trimestres.
34
2011-04-14
Notions de contextes de calcul
La colonne Moyenne annuelle contient la formule
Average([Sales revenue] In Section)
et la colonne Moyenne du premier semestre contient la formule
Average ([Sales revenue]) In Block
Vous pouvez voir comment le mot clé Bloc prend en compte le filtre sur le bloc.
3.3.2.5 Mot clé Corps
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Corps, selon son
emplacement dans un rapport :
35
Placé dans…
Fait référence à…
Un bloc
Toutes les données du bloc
Une rupture de bloc (en-tête ou pied)
Toutes les données du bloc
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Toutes les données de la section
2011-04-14
Notions de contextes de calcul
Placé dans…
Fait référence à…
A l'extérieur des blocs ou sections
Toutes les données du rapport
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes, avec une
rupture sur Année. Le rapport contient une section basée sur Année et une rupture au niveau de
Trimestre.
Année
Trimestre
Revenu des ventes
Corps
2001
T1
2 660 700
2 660 699,5
T2
2 279 003
2 279 003
T3
1 367 841
1 367 840,7
T4
1 788 580
1 788 580,4
2001
8 096 123,6
La colonne Corps contient la formule
Sum ([Sales Revenue]) In Body
Les totaux de la colonne Corps sont égaux à ceux de la colonne Revenu des ventes, car le mot clé
Corps fait référence aux données du bloc. Si vous deviez supprimer l'objet Mois, les chiffres de la
colonne Bloc changeraient pour correspondre aux chiffres modifiés de la colonne Revenu des ventes.
Si vous deviez placer la formule dans le pied de page du rapport, elle renverrait le revenu total pour
le bloc.
3.3.2.6 Utilisation de mots clés pour rendre des rapports génériques
Les mots clés de syntaxe avancée permettent de protéger durablement votre rapport contre les
modifications. Si vous faites référence aux données de façon explicite (en spécifiant des dimensions
à l'aide de Dans, PourTout et PourChaque), vos rapports risquent de renvoyer des données inattendues
en cas d'ajout ou de suppression de dimensions. L'exemple suivant illustre ce cas de figure.
Exemple : Utilisation du mot clé Rapport pour afficher des pourcentages
Dans cet exemple, vous disposez d'un bloc contenant les objets Année, Trimestre et Revenu des
ventes. Vous voulez afficher les revenus par année et par trimestre, ainsi que le pourcentage du
revenu total dans le rapport représenté par chaque revenu individuel, comme indiqué :
36
2011-04-14
Notions de contextes de calcul
La formule pour la colonne Pourcentage du total est la suivante :
([Sales revenue]/(Sum([Sales revenue]) In Report)) * 100
Dans un bloc, le mot clé Rapport inclut toutes les données du rapport, donc il serait possible d'écrire
la formule suivante :
([Sales revenue]/Sum([Sales revenue] ForAll ([Year];[Quarter]))) * 100
Cette formule permet de supprimer Année et Trimestre du contexte de sortie, autrement dit, de calculer
un total général, car le rapport ne contient aucune autre dimension. La formule divise ensuite chaque
revenu par le total général pour obtenir un pourcentage du total.
Même si vous pouvez utiliser PourTout dans ce cas, il est nettement préférable d'utiliser le mot clé
Rapport. Pourquoi ? Que se passe-t-il si la dimension Mois est rajoutée par la suite au rapport ? La
version de la formule qui utilise le mot clé Rapport calcule toujours chaque pourcentage correctement,
mais la version qui spécifie de façon explicite les dimensions Année et Trimestre est désormais fausse :
37
2011-04-14
Notions de contextes de calcul
Pour quelle raison ? Le problème vient de :
Sum ([Sales Revenue] ForAll ([Year];[Quarter))
Lorsque Année et Trimestre étaient les seules dimensions du rapport, la formule revenait à calculer
"un total général de tous les revenus". Une fois que vous ajoutez la dimension Mois, cette expression
supprime Année et Trimestre du contexte de sortie par défaut mais laisse Mois.
La formule contient désormais une "rupture" au niveau du mois. Autrement dit, dans toutes les lignes
où le Mois est 1, cette expression signifie à présent "le total des revenus de tous les mois 1". Dans
toutes les lignes où le Mois est 2, elle signifie "le total des revenus de tous les mois 2". Par conséquent,
les pourcentages ne sont pas ceux que vous attendez.
38
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
Calcul de valeurs à l'aide d'indicateurs intelligents
4.1 Indicateurs intelligents définis
Les “indicateurs intelligents” sont des indicateurs dont les valeurs sont calculées par la base de données
(relationnelle ou OLAP) sur laquelle est basé l'univers. Ils sont différents des indicateurs classiques
qui, eux, sont calculés à partir des valeurs détaillées renvoyées par la base de données. Les données
renvoyées par des indicateurs intelligents sont agrégées d'une manière qui n'est pas, à l'origine, prise
en charge par le composant Web Intelligence de la plateforme SAP BusinessObjects de Business
Intelligence.
Les requêtes contenant des indicateurs intelligents calculent les indicateurs dans tous les contextes
de calcul requis du rapport. Ces contextes peuvent changer lorsque le rapport est modifié. En
conséquence, la requête est modifiée à chaque actualisation des données résultant de la modification
des contextes requis.
Les indicateurs intelligents se comportent différemment des indicateurs classiques, qui prennent en
charge un ensemble basique de fonctions d'agrégation (Max, Min, Nombre, Somme, Moyenne) qui
peuvent être calculées dans tous les contextes sans l'aide de la base de données. Par exemple, si
vous créez une requête contenant les dimensions [Pays] et [Région], et l'indicateur [Chiffre d'affaires]
(qui calcule la somme des chiffres d'affaires), l'affichage initial affiche Pays, Région et Chiffre d'affaires
dans un bloc. Si vous supprimez Région du bloc, le chiffre d'affaires total de chaque pays peut tout de
même être calculé, sans avoir à actualiser les données, en additionnant les chiffres d'affaires de toutes
les régions du pays. Dans le cas d'un indicateur intelligent, dans cette situation, il est nécessaire
d'actualiser les données.
Les contextes de calcul sont représentés par des “regroupements” dans le SQL généré.
4.2 Regroupements et indicateurs intelligents
Un “regroupement” est un ensemble de dimensions qui génère un résultat pour un indicateur. Le SQL
généré qui renvoie les données d'un indicateur intelligent inclut les regroupements de toutes les
agrégations de cet indicateur comprises dans le rapport.
39
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
Exemple : Regroupements dans une requête
Une requête contient les dimensions [Pays], [Région], [Ville] et l'indicateur intelligent [Revenu]. Ces
objets impliquent que les regroupements suivants calculent le revenu dans tous les contextes possibles :
• Valeur d'indicateur intelligent totale
• Valeur d'indicateur intelligent par (Pays, Région, Ville)
• Valeur d'indicateur intelligent par (Pays, Ville)
• Valeur d'indicateur intelligent par (Ville)
• Valeur d'indicateur intelligent par (Région, Ville)
• Valeur d'indicateur intelligent par (Région)
• Valeur d'indicateur intelligent par (Pays, Région)
• Valeur d'indicateur intelligent par (Pays)
Si la base de données prend en charge UNION, chaque regroupement est représenté dans une clause
UNION dans le SQL généré.
Les regroupements sont mis à jour en fonction des contextes de calcul requis par le rapport, lesquels
peuvent changer suite aux modifications apportées à la structure du rapport.
4.2.1 Gestion des regroupements
Lorsque vous créez et exécutez pour la première fois une requête contenant des indicateurs intelligents,
les SQL générés incluent les regroupements nécessaires pour calculer les indicateurs intelligents au
niveau d'information le plus détaillé subséquent aux objets de la requête.
Par exemple, si vous créez une requête contenant les dimensions [Pays], [Région], [Ville] et l'indicateur
intelligent [Chiffre d'affaires], le regroupement (Pays, Région, Ville) s'affiche dans le SQL généré. Le
regroupement le plus détaillé apparaît toujours dans le SQL. D'autres regroupements sont ajoutés et
supprimés en réponse aux modifications apportées au rapport.
Si vous supprimez la dimension [Ville] du bloc, le regroupement (Pays, Région) est requis pour renvoyer
les valeurs du chiffre d'affaires. Ce regroupement n'est pas encore disponible dans le SQL de la requête
et, par conséquent, #TOREFRESH apparaît dans les cellules [Chiffre d'affaires]. A l'actualisation des
données, les valeurs du chiffre d'affaires remplacent #TOREFRESH.
Si vous replacez ensuite la dimension [Ville] dans le bloc, le regroupement (Pays, Région) n'est plus
nécessaire. Il est supprimé du SQL de la requête et ses valeurs sont rejetées quand les données sont
à nouveau actualisées.
A chaque actualisation des données du rapport, les regroupements sont inclus ou rejetés conformément
aux contextes de calcul requis par le rapport.
Dans certaines situations, il est impossible d'afficher la valeur d'un indicateur intelligent. Dans ce cas,
#INDISPONIBLE apparaît dans les cellules de l'indicateur.
40
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
4.3 Indicateurs intelligents et périmètre d'analyse
Lorsque vous créez une requête avec un périmètre d'analyse, le regroupement initial contient les objets
du résultat, mais pas les objets du périmètre. La requête ne génère pas tous les regroupements possibles
résultant de la combinaison des objets du résultat et des objets du périmètre.
Exemple : Requête avec un périmètre d'analyse et un indicateur intelligent
Une requête a les objets du résultat [Pays] et [Revenu]. Le périmètre d'analyse contient les dimensions
[Région] et [Ville]. Lorsque vous exécutez la requête, son SQL contient le regroupement (Pays) et
affiche [Pays] et [Chiffre d'affaires] dans un bloc.
4.4 Indicateurs intelligents et SQL
4.4.1 Regroupements et opérateur UNION
Certaines bases de données prennent en charge les regroupements d'ensembles de façon explicite
avec l'opérateur GROUPING SETS. Lorsque vous créez une requête contenant des indicateurs intelligents,
le SQL généré utilise plusieurs ensembles de résultats ainsi que l'opérateur UNION pour simuler l'effet
REGROUPEMENTS.
Exemple : Regroupements extraits avec l'opérateur UNION
Cet exemple décrit une requête contenant les dimensions [Pays], [Région], [Ville] et l'indicateur
intelligent [Revenu].
Remarque :
Pour plus de simplicité, l'indicateur intelligent calcule une somme. En pratique, cette agrégation ne
nécessite pas d'indicateurs intelligents car les sommes sont, à l'origine, prises en charge dans Web
Intelligence.
Lorsque la requête est exécutée pour la première fois, le regroupement est (Pays, Région, Ville). La
requête SQL complète renvoie ce regroupement et l'opérateur UNION n'est absolument pas nécessaire
dans le SQL.
41
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
Si vous supprimez la dimension [Ville] du tableau, le regroupement (Pays, Région) est nécessaire
pour afficher le chiffre d'affaires (qui apparaît initialement en tant qu'erreur #TOREFRESH). Après
l'actualisation des données, le SQL se présente comme suit :
SELECT
SELECT
0 AS GID,
country.country_name,
region.region_name,
NULL,
sum(city.revenue)
FROM
country,
region,
city
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name,
region.region_name
UNION
SELECT
1 AS GID,
country.country_name,
region.region_name,
city.city_name,
sum(city.revenue)
FROM
country,
region,
city
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name,
region.region_name,
city.city_name
)
)
)
)
Chaque regroupement est représenté par une instruction SELECT et a son propre ID (dans la colonne
GID). Les regroupements qui ne contiennent pas l'ensemble de dimensions intégral incluent des
colonnes vides (SELECT '') car chaque instruction SELECT d'une requête incluant l'opérateur UNION
doit avoir le même nombre de colonnes.
Si vous ajoutez au rapport un nouveau bloc contenant [Pays] et [Chiffre d'affaires], le regroupement
(Pays) est requis. Le SQL généré inclut maintenant les trois regroupements suivants :
SELECT
0 AS GID,
country.country_name,
region.region_name,
NULL,
sum(city.revenue)
FROM
country,
region,
city
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name,
region.region_name
UNION
SELECT
1 AS GID,
country.country_name,
NULL,
NULL,
sum(city.revenue)
FROM
42
)
)
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
country,
city,
region
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name
UNION
SELECT
2 AS GID,
country.country_name,
region.region_name,
city.city_name,
sum(city.revenue)
FROM
country,
region,
city
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name,
region.region_name,
city.city_name
)
)
)
)
4.5 Indicateurs intelligents et formules
4.5.1 Indicateurs intelligents et dimensions contenant des formules
Si une formule ou une variable apparaît en tant que dimension dans le contexte de calcul d'un indicateur
intelligent et que cette formule détermine le regroupement requis par l'indicateur, les valeurs de
l'indicateur intelligent ne peuvent s'afficher.
Par exemple, un rapport contient une variable, Semestre, avec la formule suivante :
If [Quarter] = "Q1" or [Quarter] = "Q2" Then "H1" Else "H2"
Placée dans un bloc, la variable Semestre renvoie le résultat suivant :
43
Semestre
Revenu
H1
#INDISPONIBLE
H2
#INDISPONIBLE
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
4.5.2 Indicateurs intelligents dans les formules
Les indicateurs intelligents peuvent renvoyer des valeurs lorsqu'ils sont inclus dans une formule, même
lorsque la formule requiert un contexte de calcul différent de celui impliqué par la position de la formule.
Par exemple, un rapport contient un bloc défini comme suit :
Pays
Région
Revenu
Etats-Unis
Nord
10 000
Etats-Unis
Sud
15 000
Etats-Unis
Est
14 000
Etats-Unis
Ouest
12 000
Si vous incluez une colonne supplémentaire dans ce tableau avec la formule
[Revenue] ForAll ([Region])
la valeur initiale de la colonne est #TOREFRESH car la formule, qui ne prend pas en compte les régions
dans le calcul, requiert le regroupement (Pays). L'actualisation des données ajoute le regroupement
(Pays) à la requête et affiche les valeurs de l'indicateur.
Rubriques associées
• Opérateur contextuel PourTout
4.6 Indicateurs intelligents et filtres
4.6.1 Indicateurs intelligents et filtres sur les dimensions
Si un filtre à plusieurs valeurs est appliqué à une dimension dont dépend la valeur d'un indicateur
intelligent mais que cette dimension n'apparaît pas explicitement dans le contexte de calcul de l'indicateur,
l'indicateur intelligent ne peut renvoyer aucune valeur et la cellule affiche donc l'erreur #INDISPONIBLE.
44
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
#INDISPONIBLE apparaît car l'indicateur doit être filtré dans le rapport, puis agrégé ; or, un indicateur
intelligent ne peut être agrégé après l'application d'un filtre de niveau de rapport. Il est possible de
calculer l'indicateur en ajoutant un filtre de requête au SQL généré. Par contre, cette solution risque
d'influencer les autres rapports basés sur la même requête.
Remarque :
•
•
Un filtre à plusieurs valeurs filtre plusieurs valeurs à l'aide d'opérateurs tels que Supérieur à, Dans
liste, Inférieur à. Vous pouvez appliquer des filtres à valeur unique tels que Egal à sans pour autant
générer l'erreur #INDISPONIBLE.
Une solution de contournement existe dans les cas qui ne nécessitent pas d'agrégation : Définissez
la formule sous forme de variable dont la qualification désigne un indicateur, puis veillez à ce que
la dimension utilisée soit incluse dans le bloc avec la variable (vous pouvez masquer cette colonne
pour un meilleur affichage).
Exemple : Un indicateur intelligent et un filtre sur une dimension
Une requête contient les dimensions Pays et Lieu de séjour, et l'indicateur intelligent Chiffre d'affaires.
Pays et Chiffre d'affaires sont affichés dans un bloc. Si vous appliquez un filtre de rapport qui limite
les valeurs de Lieu de séjour à "Côte d'azur" ou "Plage des Bahamas", #INDISPONIBLE apparaît
dans les cellules Chiffre d'affaires.
Pays
Chiffre d'affaires
France
#INDISPONIBLE
Etats-Unis
#INDISPONIBLE
Somme :
#INDISPONIBLE
Si vous limitez Lieu de séjour à "Plage des Bahamas", les valeurs s'affichent.
Pays
Chiffre d'affaires
Etats-Unis
971 444
Somme :
971 444
4.6.2 Filtrage des indicateurs intelligents
Si vous appliquez un filtre sur un indicateur intelligent dans un contexte où l'indicateur intelligent est
agrégé à différents niveaux d'informations, il renvoie l'erreur #INDISPONIBLE lorsqu'il est agrégé à un
niveau d'information inférieur.
45
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
Exemple : Filtrage d'un indicateur intelligent
Prenez l'exemple d'un bloc qui affiche le chiffre d'affaires par pays et par lieu de séjour et où Chiffre
d'affaires est l'indicateur intelligent.
Pays
Lieu de séjour
Chiffre d'affaires
France
Côte d'Azur
835 420
US
Bahamas Beach
971 444
US
Hawaiian Club
1 479 660
Somme :
3 286 524
Si vous appliquez un filtre Chiffre d'affaires > 900 000 au bloc, le total affiche
#INDISPONIBLE.
Pays
Lieu de séjour
Chiffre d'affaires
Etats-Unis
Bahamas Beach
971 444
US
Hawaiian Club
1 479 660
Somme :
#INDISPONIBLE
#INDISPONIBLE s'affiche car le chiffre d'affaires du bloc est agrégé par le regroupement (Pays, Lieu
de séjour) mais le chiffre d'affaires du pied de page, également affecté par le filtre, est agrégé à un
niveau d'information inférieur à celui de (Pays, Ressource).
4.6.3 Indicateurs intelligents et filtres d'exploration
En général, il est impossible de renvoyer les valeurs des indicateurs intelligents lorsqu'un filtre est
appliqué à une dimension qui affecte le calcul de l'indicateur. Les dimensions filtrées par des filtres
d'exploration sont l'exception à cette règle.
Exemple : Filtre d'exploration affectant un indicateur intelligent
Un bloc contient les objets [Pays] et [Revenu]. Vous explorez l'objet [Pays] pour afficher [Région],
[Chiffre d'affaires] dans le bloc et déplacer le filtre sur [Pays] dans la barre d'outils d'exploration.
Pour cela, le regroupement (Pays, Région) est ajouté à la requête. Le résultat est ensuite filtré pour
n'afficher que les régions contenues dans le pays exploré. Il n'est pas nécessaire d'ajouter un filtre
au niveau de la requête pour filtrer les régions en fonction du pays auquel elles appartiennent.
46
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
4.6.4 Indicateurs intelligents et filtres OR imbriqués.
Les filtres OR imbriqués dans lesquels au moins une des dimensions filtrées n'apparaît pas dans un
bloc génèrent l'erreur #INDISPONIBLE pour un indicateur intelligent du bloc.
Exemple :
•
•
47
Le filtre [Pays] = "Etats-Unis" OR [Pays] = "France" renvoie #INDISPONIBLE pour
un indicateur intelligent qui utilise la dimension [Pays] si [Pays] n'apparaît pas dans le bloc.
Le filtre [Pays] = "Etats-Unis" OR [Année] = 2008 renvoie #INDISPONIBLE pour un
indicateur intelligent qui utilise les dimensions [Pays] ou [Année] si ni [Pays] ni [Année] n'apparaît
dans le bloc.
2011-04-14
Calcul de valeurs à l'aide d'indicateurs intelligents
48
2011-04-14
Fonctions, opérateurs et mots clés
Fonctions, opérateurs et mots clés
5.1 Fonctions
Les fonctions se divisent en plusieurs catégories qui sont les suivantes :
Catégorie
Description
Agrégat
Données agrégées (par exemple, en effectuant
le total ou la moyenne d'un ensemble de valeurs)
Caractère
Manipule des chaînes de caractères
Date et heure
Renvoie des données de date et heure
Document
Renvoie des données relatives à un document
Fournisseur de données
Renvoie des données sur le fournisseur de données d'un document
Logique
Renvoie VRAI ou FAUX
Numérique
Renvoie des données numériques
Divers
Fonctions ne correspondant à aucune des catégories précédentes
Ensemble
Renvoie des ensembles de membres de hiérarchies
5.1.1 Fonction Agrégat
49
2011-04-14
Fonctions, opérateurs et mots clés
5.1.1.1 Agrégat
Description
Renvoie l'agrégation par défaut d'un indicateur pour un ensemble de membres donné
Groupe de fonctions
Agrégat
Syntaxe
num Agréger(indicateur[;ensemble_de_membres]
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
ensemble_de_me- Ensemble de membres utilisé pour calculer Ensemble de meNon
mbres
l'agrégation
mbres
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Agréger.
Si vous incluez ensemble_de_membres, la fonction Agréger renvoie la valeur agrégée de
l'indicateur de tous les membres de l'ensemble.
ensemble_de_membres peut inclure plusieurs ensembles séparés par des points virgules (;).
La liste de l'ensemble des membres doit être entre {}.
Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchie
est utilisée, l'erreur #MULTIVALUE se produit.
Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel de
la hiérarchie est utilisé.
Exemples
Si l'agrégation par défaut de l'indicateur [Chiffre d'affaires] est Somme et que [Californie] désigne un
membre de la hiérarchie [Géographie] (Pays > Etat > Ville), Agréger([Chiffre d'affaires];De
scendants([Géographie]&[EU].[Californie];1)) renvoie le chiffre d'affaires total de toutes
les villes de Californie.
Rubriques associées
• Référence à des membres et des ensembles de membres des hiérarchies
50
2011-04-14
Fonctions, opérateurs et mots clés
5.1.1.2 Moyen
Description
Renvoie la valeur moyenne d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num Moyenne(indicateur[;ensemble_de_membres][;InclureVide])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
ensemble_de_membres
Un ensemble de membres
Ensemble de
membres
Non
InclureVide
Inclut les lignes vides dans
le calcul
Mot clé
Non
(les lignes vides sont exclues par défaut)
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Moyenne.
Si vous incluez ensemble_de_membres, la fonction Moyenne renvoie la valeur moyenne de
l'indicateur de tous les membres de l'ensemble.
ensemble_de_membres peut inclure plusieurs ensembles séparés par des points virgules (;).
La liste de l'ensemble des membres doit être entre {}.
Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchie
est utilisée, l'erreur #MULTIVALUE se produit.
Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel de
la hiérarchie est utilisé.
Exemples
Si l'indicateur [Chiffre d'affaires] comporte les valeurs 41 569, 30 500, 40 000 et 50 138, Moye
nne([Chiffre d'affaires]) renvoie 40 552.
Si [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , Moye
nne([Chiffre d'affaires];[Géographie]&[EU].[Californie].enfants) renvoie le chiffre
d'affaires moyen de toutes les villes de Californie.
51
2011-04-14
Fonctions, opérateurs et mots clés
Rubriques associées
• Référence à des membres et des ensembles de membres des hiérarchies
• Opérateur InclureVide
5.1.1.3 Nombre
Description
Renvoie le nombre de valeurs d'un ensemble de valeurs
Groupe de fonctions
Agrégat
Syntaxe
entier Nombre(données_agrégées[;ensemble_de_membres][;InclureVide][;Distinct|Tous])
Entrée
Paramètre Description
Type
Obligatoire
donTout indicateur, dimension, hiérarchie, niveau ou Dimension, indicateur,
nées_agré- ensemble de membres
hiérarchie, ensemble de
gées
membres
Oui
enseEnsemble de membres utilisé pour calculer le
mble_de_me- nombre
mbres
Ensemble de membres
Non
InclureVide Inclut des valeurs vides dans le calcul
Mot clé
Non
Inclut les valeurs distinctes uniquement (par dé- Mot clé
faut pour les dimensions) ou toutes les valeurs
(par défaut pour les indicateurs) dans le calcul
Non
Distinct|Tout
Remarques
•
•
•
•
•
•
52
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Nombre.
Si vous spécifiez InclureVide comme deuxième argument, la fonction tient compte des valeurs
vides (nulles) pour le calcul.
Si vous ne spécifiez pas le paramètre Distinct|Tous, les valeurs par défaut sont Distinct pour
les dimensions et Tous pour les indicateurs.
Si vous incluez ensemble_de_membres, la fonction Nombre compte uniquement le nombre de
valeurs à l'intérieur de ensemble_de_membres.
ensemble_de_membres peut inclure plusieurs ensembles séparés par des points virgules (;).
La liste de l'ensemble des membres doit être entre {}.
2011-04-14
Fonctions, opérateurs et mots clés
•
•
Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchie
est utilisée, l'erreur #MULTIVALUE se produit.
Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel de
la hiérarchie est utilisé.
Exemples
Nombre("Test") renvoie 1
Nombre([Ville];Distinct) renvoie 5 s'il existe 5 villes différentes dans une liste de villes, même
si la liste contient plus de 5 lignes en raison des doublons.
Nombre([Ville];Tout) renvoie 10 s'il existe 10 villes différentes dans une liste de villes, même si
certaines sont des doublons.
Nombre ([Ville];InclureVide) renvoie 6 s'il existe 5 villes et une ligne vide dans une liste de
villes.
Nombre([Produit];{Géographie]&[Etat) renvoie le nombre total de membres au niveau [Etat]
de la hiérarchie [Géographie].
Rubriques associées
• Opérateur InclureVide
• Opérateurs Distinct/Tout
5.1.1.4 Premier
Description
Renvoie la première valeur d'un ensemble de données
Groupe de fonctions
Agrégat
Syntaxe
type_entrée Premier(dimension|indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
dimension|indicateur
Toute dimension ou tout indica- Dimension ou indica- Oui
teur
teur
Remarques
•
•
53
Lorsque Premier est placé dans un pied de rupture, la première valeur de la rupture est renvoyée.
Lorsque Premier est placé dans un pied de section, la première valeur de la section est renvoyée.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
Lorsque Premier([Chiffre d'affaires]) est placé dans un pied de tableau, la première valeur
de [Chiffre d'affaires] est renvoyée dans le tableau.
5.1.1.5 Dernier
Description
Renvoie la dernière valeur d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
type_entrée Dernier(dimension|indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
dimension|indicateur
Toute dimension ou tout indica- Dimension ou indica- Oui
teur
teur
Remarques
•
•
Lorsque Dernier est placé dans un pied de rupture, la dernière valeur de la rupture est renvoyée.
Lorsque Dernier est placé dans un pied de section, la dernière valeur de la section est renvoyée.
Exemples
Lorsque Premier([Chiffre d'affaires]) est placé dans un pied de tableau, la première valeur
de [Chiffre d'affaires] est renvoyée dans le tableau.
5.1.1.6 Max
Description
Renvoie la plus grande valeur d'un ensemble de valeurs
Groupe de fonctions
Agrégat
Syntaxe
type_de_saisie Max(données_agrégées[;ensemble_de_membres])
54
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
donTout indicateur, dimension, hiérarchie,
nées_agré- niveau ou ensemble de membres
gées
Dimension, indicateur, hiérarchie, niveau ou ensemble de
membres
Oui
enseUn ensemble de membres
mble_de_membres
Ensemble de membres
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Max.
Si vous incluez ensemble_de_membres, la fonction Max renvoie la valeur maximale des données
agrégées pour tous les membres de l'ensemble.
ensemble_de_membres peut inclure plusieurs ensembles séparés par des points virgules (;).
La liste de l'ensemble des membres doit être entre {}.
Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchie
est utilisée, l'erreur #MULTIVALUE se produit.
Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel de
la hiérarchie est utilisé.
Exemples
Si les valeurs de l'indicateur [Chiffre d'affaires] sont 3 000, 60 034 et 901 234, Max([Chiffre d'af
faires]) renvoie 901 234.
Si les valeurs de la dimension [Ville] sont "Aberdeen" et "Londres", Max([Ville]) renvoie "Londres".
Si [Etats-Unis] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , Max([Chiffre
d'affaires];[Géographie].[Etats-Unis].Enfants) renvoie le chiffre d'affaires le plus élevé
pour un Etat américain.
5.1.1.7 Median
Description
Renvoie la médiane (valeur centrale) d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique Médiane(indicateur)
55
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
Si l'ensemble de nombres comporte un nombre de valeurs pair, la fonction Médiane prend la moyenne
des deux valeurs centrales.
Exemples
Médiane([Chiffre d'affaires]) renvoie 971 444 si [Chiffre d'affaires] possède les valeurs
835 420, 971 444 et 1 479 660.
5.1.1.8 Min
Description
Renvoie la plus petite valeur d'un ensemble de valeurs
Groupe de fonctions
Agrégat
Syntaxe
tout_type Min(données_agrégées[;ensemble_de_membres])
Entrée
Paramètre
Description
Type
Obligatoire
donTout indicateur, dimension, hiérarchie,
nées_agré- niveau ou ensemble de membres
gées
Dimension, indicateur, hiérarchie, niveau ou ensemble de
membres
Oui
enseUn ensemble de membres
mble_de_membres
Ensemble de membres
Non
Remarques
•
•
•
•
•
56
Vous pouvez utiliser des opérateurs de contexte de syntaxe étendue avec Min.
Si vous incluez ensemble_de_membres, la fonction Min renvoie la valeur minimale des données
agrégées pour tous les membres de l'ensemble.
ensemble_de_membres peut inclure plusieurs ensembles séparés par des points virgules (;).
La liste de l'ensemble des membres doit être entre {}.
Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchie
est utilisée, l'erreur #MULTIVALUE se produit.
2011-04-14
Fonctions, opérateurs et mots clés
•
Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel de
la hiérarchie est utilisé.
Exemples
Si l'indicateur Chiffre d'affaires comporte les valeurs 3 000, 60 034 et 901 234, Min([Chiffre
d'affaires]) renvoie 3 000.
Si les valeurs de la dimension [Ville] sont "Aberdeen" et "Londres", Min([Ville]) renvoie "Aberdeen".
Min([Chiffre d'affaires];[Géographie]&[EU].enfants) renvoie le chiffre d'affaires le
plus faible d'un état américain si [EU] désigne un membre de la hiérarchie [Géographie] de niveaux
[Pays] > [Etat] > [Ville].
5.1.1.9 Mode
Description
Renvoie la valeur d'un ensemble de données qui apparaît le plus souvent
Groupe de fonctions
Agrégat
Syntaxe
input_type Mode(dimension|measure)
Entrée
Paramètre
Description
Type
dimension|indicateur
Toute dimension ou indica- Indicateur
teur
Obligatoire
Oui
Remarques
•
Mode renvoie la valeur Nul si aucune des valeurs de l'ensemble de données n'apparaît plus souvent
que les autres.
Exemples
Mode([Chiffres d'affaires]) renvoie 200 si la variable [Chiffre d'affaires] a les valeurs 100,
200, 300, 200.
Mode([Pays]) renvoie la valeur [Pays] qui apparaît le plus souvent.
57
2011-04-14
Fonctions, opérateurs et mots clés
5.1.1.10 Pourcentage
Description
Exprime une valeur d'indicateur en tant que pourcentage de son contexte
Groupe de fonctions
Agrégat
Syntaxe
num Pourcentage(indicateur[;Saut][;Ligne|Col])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Rupture
Prend en compte les ruptures de Mot clé
tableau
Non
Ligne|Col
Définit le sens du calcul
Non
Mot clé
Exemples
Dans le tableau suivant, la colonne Pourcentage contient la formule Pourcentage ([Revenu des
ventes]).
Année
Chiffre d'affaires
Pourcentage
2001
1 000
10
2002
5 000
50
2003
4 000
40
Somme :
10 000
100
Par défaut, le contexte d'intégration est le total de l'indicateur dans le tableau. Vous pouvez faire en
sorte que la fonction prenne en compte une rupture dans le tableau en utilisant l'argument facultatif
Rupture. Dans ce cas, le contexte d'intégration par défaut devient la section de tableau.
Dans le tableau suivant, la colonne Pourcentage contient la formule Pourcentage([Chiffre
d'affaires];Rupture)
58
Année
Trimestre
Revenu des ventes
Pourcentage
2001
T1
1 000
10
2011-04-14
Fonctions, opérateurs et mots clés
T2
2 000
20
T3
5 000
50
T4
2 000
20
2001
Somme :
10 000
100
Année
Trimestre
Revenu des ventes
Pourcentage
2002
T1
2 000
20
T2
2 000
20
T3
5 000
50
T4
1 000
10
Somme :
10 000
100
2002
Vous pouvez utiliser la fonction Pourcentage sur plusieurs colonnes ou lignes ; l'argument facultatif
Ligne|Col vous permet de le préciser explicitement. Par exemple, dans le tableau croisé suivant, la
colonne % contient la formule Pourcentage ([Revenu des ventes];Ligne).
T1
%
T2
%
T3
%
T4
%
2001
1 000
10
2 000
20
5 000
50
2 000
20
2002
2 000
20
2 000
20
5 000
50
1 000
10
5.1.1.11 Centile
Description
Renvoie le nième centile d'un indicateur
Groupe de fonctions
Numérique
Syntaxe
numérique Centile(indicateur;centile)
59
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
centile
Un pourcentage exprimé sous forme
décimale
Nombre
Oui
Remarques
Le nième centile est un nombre supérieur ou égal à n % des nombres d'un ensemble. Vous exprimez
n % sous la forme 0.n.
Exemples
Si [indicateur] possède l'ensemble de nombres (10;20;30;40;50), Centile([indicateur];0.3)
renvoie 22, qui est supérieur ou égal à 30 % des nombres de l'ensemble.
5.1.1.12 Produit
Description
Multiplie les valeurs d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique Produit(indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Exemples
Produit([Indicateur]) renvoie 30 si [Indicateur] a les valeurs 2, 3, 5.
5.1.1.13 MoyenneCumulative
Description
Renvoie la moyenne cumulative d'un indicateur
60
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Agrégat
Syntaxe
num MoyenneCumulative(indicateur[;Ligne|Col][;InclureVide][;(réinit_dims)])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Ligne|Col
Définit le sens du calcul
Mot clé
Non
InclureVide
Inclut des valeurs vides dans le calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les dimensions Liste Dimension
spécifiées
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser des opérateurs de contexte de syntaxe étendue avec MoyenneCumulative.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et Col.
Si vous appliquez un tri sur l'indicateur référencé par MoyenneCumulative, le calcul de la moyenne
cumulative a lieu après le tri de l'indicateur.
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.
MoyenneCumulative ne réinitialise pas automatiquement la moyenne après un saut de bloc ou
une nouvelle section.
Exemples
MoyenneCumulative([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Moyenne cumulative
US
Hawaiian Club
1 479 660
835 420
US
Bahamas Beach
971 444
1 225 552
France
Côte d'Azur
835 420
1 095 508
MoyenneCumulative([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau
suivant :
61
Pays
Lieu de séjour
Chiffre d'affaires
Moyenne cumulative
US
Hawaiian Club
1 479 660
835 420
2011-04-14
Fonctions, opérateurs et mots clés
US
Bahamas Beach
971 444
1 225 552
France
Côte d'Azur
835 420
835 420
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
5.1.1.14 NombreCumulatif
Description
Renvoie le total cumulatif d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
num NombreCumulatif(dimension|indicateur[;Ligne|Col][;InclureVide][;(réinit_dims)])
Entrée
Paramètre
Description
Type
Obligatoire
dimension|indica- Toute dimension ou tout indicateur
teur
Dimension ou indi- Oui
cateur
Ligne|Col
Définit le sens du calcul
Mot clé
Non
InclureVide
Inclut des valeurs vides dans le calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les dimensions Liste Dimension
spécifiées
Non
Remarques
•
•
•
•
•
62
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction NombreCumu
latif.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et Col.
Si vous appliquez un tri sur l'indicateur référencé par NombreCumulatif, le calcul du nombre
cumulatif a lieu après le tri de l'indicateur.
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.
2011-04-14
Fonctions, opérateurs et mots clés
•
NombreCumulatif ne réinitialise pas automatiquement le total après un saut de bloc ou une
nouvelle section.
Exemples
NombreCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Nombre cumulatif
US
Hawaiian Club
1 479 660
1
US
Bahamas Beach
971 444
2
France
Côte d'Azur
835 420
3
NombreCumulatif([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau
suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Nombre cumulatif
US
Hawaiian Club
1 479 660
1
US
Bahamas Beach
971 444
2
France
Côte d'Azur
835 420
1
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
• Opérateur InclureVide
• Opérateur InclureVide
5.1.1.15 MaxCumulatif
Description
Renvoie le maximum cumulatif d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
input_type RunningMax(dimension|measure[;Row|Col][;(reset_dims)])
63
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dimension|indica- Toute dimension ou tout indicateur
teur
Dimension ou indi- Oui
cateur
Ligne|Col
Définit le sens du calcul
Mot clé
dim_redéfinies
Réinitialise le calcul selon les dimensions Liste Dimension
spécifiées
Non
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction MaxCumulatif.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et Col.
Si vous appliquez un tri sur l'indicateur référencé par MaxCumulatif, le calcul du maximum cumulatif
a lieu après le tri de l'indicateur.
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.
MaxCumulatif ne réinitialise pas automatiquement le maximum après un saut de bloc ou une
nouvelle section.
Exemples
MinCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Maximum cumulatif
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
971 444
US
Hawaiian Club
1 479 660
1 479 660
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
5.1.1.16 MinCumulatif
Description
Renvoie le minimum cumulatif d'une dimension ou d'un indicateur
64
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Agrégat
Syntaxe
type_entrée MinCumulatif(dimension|indicateur;[Ligne|Col];[(réinit_dimensions)])
Entrée
Paramètre
Description
Type
Obligatoire
dimension|détail|in- Toute dimension ou indicateur
dicateur
Dimension ou indi- Oui
cateur
Ligne|Col
Définit le sens du calcul
Mot clé
dim_redéfinies
Réinitialise le calcul selon les dimensions Liste Dimension
spécifiées
Non
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction MinCumulatif.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et Col.
Si vous appliquez un tri sur l'indicateur référencé par MinCumulatif, le calcul du minimum cumulatif
a lieu après le tri de l'indicateur.
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.
MinCumulatif ne réinitialise pas automatiquement le minimum après un saut de bloc ou une
nouvelle section.
Exemples
MinCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Minimum cumulatif
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
835 420
US
Hawaiian Club
1 479 660
835 420
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
65
2011-04-14
Fonctions, opérateurs et mots clés
5.1.1.17 ProduitCumulatif
Description
Renvoie le produit cumulatif d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num ProduitCumulatif(indicateur[;Ligne|Col][;(réinit_dims)])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Ligne|Col
Définit le sens du calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les dimensions Liste Dimension
spécifiées
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction ProduitCu
mulatif.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et Col.
Si vous appliquez un tri sur l'indicateur référencé par ProduitCumulatif, le calcul du produit
cumulatif a lieu après le tri de l'indicateur.
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.
ProduitCumulatif ne réinitialise pas automatiquement le produit après un saut de bloc ou une
nouvelle section.
Exemples
ProduitCumulatif([Nombre d'invités]) renvoie ces résultats dans le tableau suivant :
66
Pays d'origine
Ville
Nombre d'invités
Produit cumulatif
Japon
Kobe
6
6
Japon
Osaka
4
24
US
Chicago
241
5 784
2011-04-14
Fonctions, opérateurs et mots clés
ProduitCumulatif([Nombre d'invités]);([Pays d'origine]) renvoie ces résultats dans
le tableau suivant :
Pays d'origine
Ville
Nombre d'invités
Produit cumulatif
Japon
Kobe
6
6
Japon
Osaka
4
24
US
Chicago
241
5 784
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
5.1.1.18 SommeCumulative
Description
Renvoie la somme cumulative d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num SommeCumulative(indicateur[;Ligne|Col][;(réinit_dims)])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Ligne|Col
Définit le sens du calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les dimensions Liste Dimension
spécifiées
Non
Remarques
•
•
•
67
Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction SommeCumu
lative.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et Col.
Si vous appliquez un tri sur l'indicateur référencé par SommeCumulative, le calcul de la somme
cumulative a lieu après le tri de l'indicateur.
2011-04-14
Fonctions, opérateurs et mots clés
•
•
•
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.
SommeCumulative ne réinitialise pas automatiquement la somme après un saut de bloc ou une
nouvelle section.
Exemple
SommeCumulative([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Somme cumulative
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
1 806 864
US
Hawaiian Club
1 479 660
3 286 524
SommeCumulative([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau
suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Somme cumulative
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
971 444
US
Hawaiian Club
1 479 660
2 451 104
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
5.1.1.19 ValeurServeur
Description
Renvoie la valeur de la base de données d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num ValeurServeur([indicateur])
68
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
•
ValeurServeur ignore l'ensemble des filtres appliqués aux dimensions ou hiérarchies utilisées
pour calculer l'indicateur
Exemple
ValeurServeur([Montant des ventes sur Internet] renvoie la valeur de la base de données
de l'indicateur [Montant des ventes sur Internet]
5.1.1.20 Ecartype
Description
Renvoie l'écart type d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique EcartType(indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
L'écart type est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculée
comme suit :
• calcul de la moyenne d'un ensemble de nombres
• soustraction de la moyenne de chaque nombre dans l'ensemble et élévation de la différence au
carré
• addition de toutes ces différences élevées au carré
• division de cette somme par le nombre de nombres de l'ensemble - 1)
• calcul de la racine carrée du résultat.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), EcartType([indicateur]) renvoie
2,58.
69
2011-04-14
Fonctions, opérateurs et mots clés
Rubriques associées
• Var
5.1.1.21 EcartTypeP
Description
Renvoie l'écart type de population d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique EcartTypeP(indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
L'écart type de population est un indicateur de variation statistique dans un ensemble de nombres. Elle
est calculée comme suit :
• calcul de la moyenne d'un ensemble de nombres ;
• soustraction de la moyenne de chaque nombre dans l'ensemble et élévation de la différence au
carré ;
• addition de toutes ces différences élevées au carré ;
• division de cette somme par le (nombre de nombres de l'ensemble) ;
• calcul de la racine carrée du résultat.
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction EcartTypeP.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), EcartTypeP([indicateur]) renvoie
2,24.
5.1.1.22 Sum (Somme)
70
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie la somme d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num Somme(indicateur[;ensemble_de_membres])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
ensemble_de_membres Un ensemble de membres
Ensemble de membres Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Somme.
Si vous incluez ensemble_de_membres, Somme renvoie la somme de l'indicateur de tous les
membres de l'ensemble.
ensemble_de_membres peut inclure plusieurs ensembles séparés par des points virgules (;).
La liste de l'ensemble des membres doit être entre {}.
Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchie
est utilisée, l'erreur #MULTIVALUE se produit.
Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel de
la hiérarchie est utilisé.
Exemples
Si l'indicateur Chiffre d'affaires comporte les valeurs 2 000, 3 000, 4 000 et 1 000, Somme([Chiffre
d'affaires]) renvoie 10 000.
Si [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , So
mme([Chiffre d'affaires];Descendants([Géographie]&[EU].[Californie];1)) renvoie
le chiffre d'affaires total de toutes les villes de Californie.
5.1.1.23 Var
Description
Renvoie la variance d'un indicateur
Groupe de fonctions
Agrégat
71
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
numérique Var(indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
La variance est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculée
comme suit :
• calcul de la moyenne d'un ensemble de nombres
• soustraction de la moyenne de chaque nombre dans l'ensemble et élévation de la différence au
carré
• addition de toutes ces différences élevées au carré
• division de cette somme par le nombre de nombres de l'ensemble - 1)
La variance est le carré de l'écart type.
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Var.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), Var([indicateur]) renvoie 6,67.
Rubriques associées
• Ecartype
5.1.1.24 VarP
Description
Renvoie la variance de population d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique VarP(indicateur)
72
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
La variance de population est un indicateur de variation statistique dans un ensemble de nombres. Elle
est calculée comme suit :
• calcul de la moyenne d'un ensemble de nombres
• soustraction de la moyenne de chaque nombre dans l'ensemble et élévation de la différence au
carré
• addition de toutes ces différences élevées au carré
• division de cette somme par le (nombre de nombres de l'ensemble)
La variance de population est le carré de l'écart type de population.
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction VarP.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), VarP([indicateur]) renvoie 5.
Rubriques associées
• EcartTypeP
5.1.2 Fonctions du groupe Caractère
5.1.2.1 Asc
Description
Renvoie la valeur ASCII d'un caractère
Groupe de fonctions
Caractère
Syntaxe
entier Asc(chaîne)
73
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
chaîne
N'importe quelle chaîne Chaîne
Obligatoire
Oui
Remarques
Si chaîne contient plusieurs caractères, la fonction renvoie la valeur ASCII du premier caractère dans
la chaîne.
Exemples
Asc("A") renvoie 65.
Asc("ab") renvoie 97.
Asc([Pays]) renvoie 85 lorsque la valeur de [Pays] est "US".
5.1.2.2 Car
Description
Renvoie le caractère associé à un code ASCII
Groupe de fonctions
Caractère
Syntaxe
chaîne Car(code_ascii)
Entrée
Paramètre
Description
Type
Obligatoire
code_ascii
Un code ASCII
Nombre
Oui
Remarques
Si nombre est un décimal, la fonction ignore la partie décimale.
Exemple
s
Car(123) renvoie "{".
74
2011-04-14
Fonctions, opérateurs et mots clés
5.1.2.3 Concaténation
Description
Concatène (joint) deux chaînes de caractères.
Groupe de fonctions
Caractère
Syntaxe
chaîne Concaténation(première_chaîne;seconde_chaîne)
Entrée
Paramètre
Description
Type
Obligatoire
première_chaîne
La première chaîne
Chaîne
Oui
deuxième_chaîne
La seconde chaîne
Chaîne
Oui
Remarques
Vous pouvez également utiliser l'opérateur "+" pour concaténer des chaînes.
"Premier " + "Second" renvoie "Premier Second".
"Premier " + "Second" + " Troisième" renvoie "Premier Second Troisième".
Vous pouvez utiliser la concaténation pour inclure plusieurs dimensions dans une fonction d'agrégation.
Par exemple, Nombre([Représentant]+[Trimestre]+[Lieu de séjour] est équivalent à la
syntaxe Nombre<Représentant>,<Trimestre>,<Lieu de séjour> autorisée par Desktop
Intelligence.
Exemples
Concaténation("Premier ";"Second") renvoie "Premier Second"
Concaténation("Premier ";Concaténation("Second ";"Troisième")) renvoie "Premier
Second Troisième".
5.1.2.4 Remplissage
Description
Construit une chaîne en répétant une chaîne n fois
75
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne Remplir(répétition_chaîne;nombre_répétitions)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_à_répéter
La chaîne à répéter
Chaîne
Oui
nombre_de_répétitions
Le nombre de répétitions Nombre
Oui
Exemples
Remplir("New York";2) renvoie "New York New York".
5.1.2.5 FormatDeDate
Description
Formate une date selon le format spécifié
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatDeDate(date;chaîne_format)
Entrée
Paramètre
Description
Type
date
La date à laquelle appliquer le format de Date
date
Oui
chaîne_format
Le format à appliquer
Oui
Chaîne
Obligatoire
Remarques
•
•
Le format du résultat dépend du format de date appliqué à la cellule.
Vous ne pouvez pas appliquer les chaînes de mise en forme des couleurs (par exemple [Rouge],
[Bleu], etc.) à la fonction FormatDeDate.
Exemples
FormatDeDate(DateActuelle();"dd/MM/yyyy") renvoie "15/12/2005" si la date actuelle est le
15 décembre 2005.
76
2011-04-14
Fonctions, opérateurs et mots clés
5.1.2.6 FormatDeNombre
Description
Formate un nombre selon un format spécifié
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatDeNombre(nombre;chaîne_format)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à formater
Nombre
Oui
chaîne_format
Le format à appliquer
Chaîne
Oui
Remarques
•
•
Le format du résultat dépend du format de nombre appliqué à la cellule.
Vous ne pouvez pas appliquer les chaînes de mise en forme des couleurs (par exemple [Rouge],
[Bleu] etc.) à la fonction FormatDeNombre.
Exemples
FormatDeNombre[Revenu des ventes];"# ###,00") renvoie 835 420,00 si [Revenu des ventes]
est d'une valeur de 835 420.
5.1.2.7 HTMLEncode
Description
Applique des règles d'encodage HTML à une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne HTMLEncode(html)
77
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
html
Une chaîne HTML
Chaîne
Oui
Exemples
HTMLEncode("http://www.businessobjects.com") renvoie
"http%3A%2F%2Fwww%2Ebusinessobjects%2Ecom ".
5.1.2.8 Capitale
Description
Met en majuscule la première lettre d'une chaîne de caractères
Groupe de fonctions
Caractère
Syntaxe
chaîne Capitale(chaîne)
Entrée
Paramètre
Description
Type
chaîne
La chaîne à mettre en majus- Chaîne
cules
Obligatoire
Oui
Exemples
Capitale("ces vérités sont évidentes") renvoie "Ces vérités sont évidentes".
5.1.2.9 Gauche
Description
Retourne les caractères les plus à gauche dans une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne Gauche(chaîne;nombre_car)
78
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne entrée.
chaîne
Oui
nombre_car
Le nombre de caractères à retourner à
partir de la gauche
nombre
Oui
Exemples
Gauche([Pays];2) retourne "Fr" si [Pays] est "France".
5.1.2.10 RemplissageGauche
Description
Remplit une chaîne à gauche avec une autre chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne RemplissageGauche(chaîne_complétée,longueur,chaîne_gauche)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_complétée La chaîne d'origine
Chaîne
Oui
longueur
la longueur de la chaîne de sortie
Nombre
Oui
chaîne_gauche
La chaîne à ajouter à gauche de la
chaîne_complétée
Chaîne
Oui
Remarques
•
•
•
Si longueur est inférieure à la longueur combinée de chaîne_gauche et de chaîne_complétée,
chaîne_gauche est tronquée.
Si longueur est inférieure ou égale à la longueur de chaîne_complétée, la fonction renvoie
chaîne_complétée.
Si longueur est supérieure à la longueur combinée de chaîne_complétée et de chaîne_gauche,
chaîne_gauche est répétée entièrement ou en partie le nombre de fois nécessaire pour remplir
la longueur.
Exemples
RemplissageGauche("York";8;"New ") renvoie "New York"
79
2011-04-14
Fonctions, opérateurs et mots clés
RemplissageGauche("York",6,"New") renvoie "NeYork".
RemplissageGauche("York";11;"New ") renvoie "New NewYork"
RemplissageGauche("New "; 2;"York") renvoie "New".
5.1.2.11 SupprEspGauche
Description
Supprime les espaces à gauche d'une chaîne de caractères
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspGauche(chaîne_à_traiter)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_raccourcie
La chaîne à traiter.
Chaîne
Oui
Exemples
SupprEspGauche([Pays]) renvoie "France" si [Pays] est " France".
5.1.2.12 Longueur
Description
Renvoie le nombre de caractères d'une chaîne.
Groupe de fonctions
Caractère
Syntaxe
entier Longueur(chaîne)
80
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne entrée.
Chaîne
Oui
Exemples
Longueur([Nom]) renvoie 6 si [Nom] est "Martin".
5.1.2.13 Minuscule
Description
Convertit une chaîne en minuscules
Groupe de fonctions
Caractère
Syntaxe
chaîne Minuscule(chaîne)
Entrée
Paramètre
Description
Type
chaîne
La chaîne à convertir en minus- Chaîne
cules
Obligatoire
Oui
Exemples
Minuscule("New York") renvoie "new york".
5.1.2.14 Comparaison
Description
détermine si une chaîne correspond à un modèle.
Groupe de fonctions
Caractère
Syntaxe
booléen Comparer(chaîne_test;modèle)
81
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
chaîne_test
La chaîne à comparer au modèle chaîne
de texte
modèle
La
Obligatoire
Oui
chaîne du modèle de Oui
texte
Remarques
•
Le modèle peut contenir le caractère générique "*" (remplace n'importe quel ensemble de caractères)
ou "?" (remplace n'importe quel caractère unique).
Exemples
Comparer([Pays];"F*") renvoie Vrai si [Pays] est "France".
Comparer([Pays];"?S?") renvoie Vrai si [Pays] est "USA".
Comparer("New York";"P*") renvoie la valeur Faux.
5.1.2.15 Pos
Description
Renvoie la position de départ d'une chaîne de caractères dans une chaîne
Groupe de fonctions
Caractère
Syntaxe
entier Pos(chaîne_test;modèle)
Entrée
Paramètre
Description
Type
chaîne_test
La chaîne à vérifier dans le modèle chaîne
de texte
Oui
modèle
La
Oui
chaîne du modèle
de texte
Obligatoire
Remarques
•
82
Si le modèle apparaît plusieurs fois, Pos renvoie la position de la première occurrence.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
Pos("New York";"Ne") renvoie 1.
Pos("New York, New York";"Ne") renvoie 1.
Pos("New York"; "York") renvoie 5.
5.1.2.16 Remplacer
Description
remplace une partie d'une chaîne par une autre chaîne.
Groupe de fonctions
Caractère
Syntaxe
chaîne Remplacer(remplacer_dans;chaîne_remplacée;chaîne_de_remplacement)
Entrée
Paramètre
Description
Type
Obligatoire
remplacer_dans
La chaîne dans laquelle le texte est
remplacé
chaîne
Oui
chaîne_remplacée
Le texte à remplacer
chaîne
Oui
chaîne_de_rempla- Le texte qui remplace chaîne_rem chaîne
cement
placée
Oui
Exemples
Remplacer("New YORK";"ORK";"ork") renvoie "New York"
5.1.2.17 Droit
Description
Renvoie les caractères les plus à droite dans une chaîne
Groupe de fonctions
Caractère
83
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
chaîne Droite(chaîne;nombre_de_caractères)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
N'importe quelle chaîne
chaîne
Oui
nombre
Oui
nombre_de_carac- Le nombre de caractères à renvoyer à
tères
partir de la droite
Exemples
Droite([Pays];2) renvoie "ce" si [Pays] est "France".
5.1.2.18 RemplissageDroite
Description
Remplit une chaîne à droite avec une autre chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne RemplissageDroite(chaîne_complétée;longueur;chaîne_droite)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_complétée La chaîne d'origine
Chaîne
Oui
longueur
la longueur de la chaîne de sortie
Nombre
Oui
chaîne_droite
La chaîne à ajouter à droite de la
chaîne_complétée
Chaîne
Oui
Remarques
•
•
•
84
Si longueur est inférieure à la longueur combinée de chaîne_droite et à la chaîne_complétée,
chaîne_droite est tronquée.
Si longueur est inférieure ou égale à la longueur de chaîne_complétée, la fonction renvoie
chaîne_complétée.
Si longueur est supérieure à la longueur combinée de chaîne_complétée et de chaîne_droite,
chaîne_droite est répétée entièrement ou en partie le nombre de fois nécessaire pour remplir
la longueur.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
RemplissageDroite("New ";8;"York") renvoie "New York"
RemplissageDroite("New "; 6;"York") renvoie "New Yo"
RemplissageDroite("New ";11;"York") renvoie "New YorkYor"
RemplissageDroite("New "; 2;"York") renvoie "New".
5.1.2.19 SupprEspDroite
Description
Supprime les espaces de fin de chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspDroite(chaîne_raccourcie)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_raccourcie
La chaîne à traiter.
Chaîne
Oui
Exemples
SupprEspDroite([Pays]) renvoie "France" si [Pays] est "France ".
5.1.2.20 SousChaîne
Description
Renvoie une partie d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne SousChaîne(chaîne;début;longueur)
85
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
N'importe quelle chaîne
Chaîne
Oui
début
La position de départ de la chaîne
extraite
Nombre
Oui
longueur
La longueur de la chaîne extraite
Nombre
Oui
Exemples
SousChaîne("Grande Bretagne";1;6) renvoie "Grande".
SousChaîne("Grande Bretagne";8;8) renvoie "Bretagne".
5.1.2.21 SupprEspace
Description
Supprime les espaces de début et de fin d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspace(chaîne_raccourcie)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne à traiter.
Chaîne
Oui
Exemples
SupprEspace(" Grande Bretagne ") renvoie "Grande Bretagne".
5.1.2.22 Majuscule
Description
Convertit une chaîne en majuscules
86
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne Majuscule(chaîne)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne à convertir
Chaîne
Oui
Exemples
Majuscule("New York") renvoie "NEW YORK".
5.1.2.23 UrlEncode
Description
Applique des règles d'encodage URL à une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne UrlEncode(html)
Entrée
Paramètre
Description
Type
Obligatoire
html
L'URL à encoder
Chaîne
Oui
Exemples
UrlEncode("http://www.businessobjects.com") renvoie
"http%3A%2F%2Fwww%2Ebusinessobjects%2Ecom".
5.1.2.24 CapitaleMot
Description
Met en majuscule la première lettre de chaque mot d'une chaîne
87
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne CapitaleMot(chaîne)
Entrée
Paramètre
Description
Type
chaîne
La chaîne qui va être mise en ma- Chaîne
juscules
Obligatoire
Oui
Exemples
CapitaleMot("Chiffre d'affaires de mars") renvoie "Chiffre D'affaires De Mars".
5.1.3 Fonctions Date et heure
5.1.3.1 CurrentDate
Description
Renvoie la date actuelle au format conforme aux paramètres régionaux
Groupe de fonctions
Date et heure
Syntaxe
date DateCourante()
Exemples
DateActuelle() renvoie 10 septembre 2002 si la date est le 10 septembre 2002.
5.1.3.2 CurrentTime
Description
Renvoie l'heure actuelle au format conforme aux paramètres régionaux
88
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
heure HeureCourante()
Exemples
HeureActuelle renvoie 11:15 si l'heure actuelle est 11 h 15.
5.1.3.3 NomDuJour
Description
Renvoie le nom du jour correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne NomDuJour(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
NomDuJour([Date de réservation]) renvoie "samedi' si [Date de réservation] est 15 décembre
2001 (ce qui correspond à un samedi).
Remarque
La date saisie doit être une variable. Vous ne pouvez pas spécifier directement la date, comme dans
NomDuJour("07/15/2001").
5.1.3.4 NuméroDuJourDuMois
Description
Renvoie le numéro du jour dans un mois
89
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDuMois(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
NuméroDuJourDuMois([Date de réservation]) renvoie 15 si [Date de réservation] est "15
décembre 2001".
5.1.3.5 NuméroDuJourDeLaSemaine
Description
Renvoie le numéro du jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDeLaSemaine(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Remarques
Le lundi est considéré comme premier jour de la semaine avec cette fonction.
Exemples
NuméroDuJourDeLaSemaine([Date de réservation]) renvoie 1 si la date figurant dans [Date
de réservation] est le 2 mai 2005 (ce qui correspond à un lundi).
5.1.3.6 NuméroDuJourDeAnnée
90
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie le numéro du jour dans une année
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDeAnnée(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
NuméroDuJourDeAnnée([Date de réservation]) renvoie 349 si [Date de réservation] est "15
décembre 2001".
5.1.3.7 JoursEntre
Description
renvoie le nombre de jours compris entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier JoursEntre(première_date;dernière_date)
Entrée
Paramètre
Description
Type
Obligatoire
première_date
La première date
Date
Oui
dernière_date
La dernière date
Date
Oui
Exemples
JoursEntre([Date de la vente];[Date de facture]) renvoie 2 si [Date de la vente]
correspond au 15 décembre 2001 et [Date de facture] au 17 décembre 2001.
91
2011-04-14
Fonctions, opérateurs et mots clés
5.1.3.8 DernierJourDuMois
Description
Renvoie la date du dernier jour d'un mois
Groupe de fonctions
Date et heure
Syntaxe
date DernierJourDuMois(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
N'importe quelle date du
mois
Date
Oui
Exemples
DernierJourDuMois([Date de la vente]) renvoie 31 décembre 2005 si [Date de la vente]
correspond au 11 décembre 2005.
5.1.3.9 DernierJourDeLaSemaine
Description
Renvoie la date du dernier jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
date DernierJourDeLaSemaine(date)
92
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
date
N'importe quelle date de la se- Date
maine
Obligatoire
Oui
Remarques
Le lundi est considéré comme premier jour de la semaine avec cette fonction.
Exemples
DernierJourDeLaSemaine([Date de la vente]) renvoie 15 mai 2005 (un dimanche) si [Date
de la vente] correspond au 11 mai 2005.
5.1.3.10 Mois
Description
Renvoie le nom du mois correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne Mois(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
Mois([Date de réservation]) renvoie "Décembre" si la date figurant dans [Date de réservation]
correspond au 15 décembre 2005.
5.1.3.11 NuméroDuMoisDeAnnée
Description
Renvoie le numéro du mois correspondant à une date
93
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuMoisDeAnnée(date)
Entrée
Paramètre
Description
Type
date
N'importe quelle date de l'an- Date
née
Obligatoire
Oui
Exemple
NuméroDuMoisDeAnnée([Date de réservation]) renvoie 12 si la date figurant dans [Date de
réservation] correspond au 15 décembre 2005.
5.1.3.12 MoisEntre
Description
Renvoie le nombre de mois entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier MoisEntre(première_date;dernière_date)
Entrée
Paramètre
Description
Type
Obligatoire
première_date
La première date
Date
Oui
dernière_date
La dernière date
Date
Oui
Exemples
MoisEntre([Date de la vente];[Date de facture]) renvoie 1 si [Date de la vente] correspond
au 2 décembre 2005 et [Date de facture] au 2 janvier 2006.
5.1.3.13 Trimestre
94
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie le numéro du trimestre correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
entier Trimestre(date)
Entrée
Paramètre
Description
Type
date
N'importe quelle date du trime- Date
stre
Obligatoire
Oui
Exemples
Trimestre([Date de réservation]) renvoie 4 si la date figurant dans [Date de réservation]
correspond au 15 décembre 2005.
5.1.3.14 DateRelative
Description
Renvoie une date relative à une autre date
Groupe de fonctions
Date et heure
Syntaxe
date DateRelative(date_début;nombre_de_jours)
Entrée
Paramètre
Description
Type
Obligatoire
date_début
La date de début
Date
Oui
nombre_de_jours
Le nombre de jours à partir de la date Nombre
de début
Oui
Remarques
Le paramètre nombre_de_jours peut être négatif pour renvoyer une date antérieure à date_début.
95
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
DateRelative([Date de réservation];2) renvoie 17 décembre 2005 si [Date de réservation]
correspond au 15 décembre 2005;
DateRelative([Date de réservation];-3) renvoie 9 janvier 2007 si [Date de réservation]
correspond au 12 janvier 2007.
5.1.3.15 DimTemp
Description
La dimension temporelle DimTemp permet de construire un axe de temps à partir d'un objet d'univers
de type Date. DimTemp renvoie les données des dates données comme premier paramètre au cours
des périodes données comme second paramètre. Si certaines périodes ne comportent pas de données,
le premier jour de chaque période vide est renvoyé. Cela permet d'avoir un axe complet pour la période
donnée. Cela garantit que :
• L'axe conserve l'ordre chronologique naturel (les objets les plus anciens en premier, les plus récents
en dernier).
• L'axe contient toutes les périodes situées entre les dates minimum et maximum du contexte actuel.
Groupe de fonctions
Date et heure
Syntaxe
DimTemp([Type de date]; Type de période)
Entrée
Paramètre
Description
Type
Obligatoire
Type de date L'objet de date pour le rapport, DateFacture par exemple. Date
Oui
Type de période
Facultatif
La période pour les résultats, à partir des valeurs suiva- Date
ntes :
• PériodeJour
• PériodeMois
• PériodeTrimestre
• PériodeAnnée
Quand aucune valeur n'est sélectionnée, PériodeJour est
utilisé par défaut.
Utilisez la fonction ci-dessus conjointement avec les fonctions suivantes :
• NomDuJour
• NuméroDuJourDuMois
96
2011-04-14
Fonctions, opérateurs et mots clés
•
•
•
•
•
•
•
NuméroDuJourDeLaSemaine
NuméroDuJourDeAnnée
Mois
NuméroDuMoisDeAnnée
Trimestre
Année
FormatDeDate
Exemple
Le premier tableau contient les données qui ne concernent que certaines dates. Les exemples de
requête suivants montrent comment sont interprétés les résultats.
Date de la facture
Chiffre d'affaires
1/3/00
31 607
1/8/00
31 244
7/3/00
38 154
La requête NomDuJour(DimTemp([Date Facture] ; PériodeTrimestre) renvoie les valeurs
quotidiennes du tableau ci-dessous.
Date de la facture
Chiffre d'affaires
1/3/00
31 607
1/8/00
31 244
4/1/00
7/3/00
38 154
Vous devez mettre en forme les résultats de la fonction DimTemp avec la fonction Trimestre pour
renvoyer les résultats par trimestre (T1, T2, ...) afin d'obtenir le tableau de résultats suivant :
Date de la facture
Chiffre d'affaires
T1
62 851
T2
T3
38 154
5.1.3.16 EnDate
97
2011-04-14
Fonctions, opérateurs et mots clés
Description
renvoie une chaîne de caractères spécifiant la date indiquée dans le format défini.
Groupe de fonctions
Date et heure
Syntaxe
date EnDate(chaîne_date;format)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_date
Date à formater
chaîne
Oui
format
Le format de date
chaîne
Oui
Exemples
EnDate("15/12/2002";"dd/MM/yyyy") renvoie 15 décembre 2002.
5.1.3.17 Semaine
Description
Renvoie le numéro de la semaine de l'année
Groupe de fonctions
Date et heure
Syntaxe
entier Semaine(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
Semaine([Date de réservation]) renvoie 1 si la date figurant dans [Date de réservation] est le
4 janvier 2004 (ce qui correspond à la première semaine de l'année 2004).
98
2011-04-14
Fonctions, opérateurs et mots clés
5.1.3.18 Année
Description
Renvoie l'année correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
entier Année(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
Année([Date de réservation]) renvoie 2005 si la date figurant dans [Date de réservation] est
le 15 décembre 2005.
5.1.4 Fonctions du groupe Fournisseur de données
5.1.4.1 Connexion
Description
Renvoie les paramètres de la connexion à la base de données utilisée par un fournisseur de données.
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne Connexion(dp)
99
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
Vous devez mettre le nom du fournisseur de données entre crochets.
Pour des raisons de sécurité, le résultat de la fonction n'inclut pas le nom d'hôte de la base de
données, le nom de l'utilisateur ni le mot de passe de l'utilisateur.
5.1.4.2 FournisseurDeDonnées
Description
Renvoie le nom d'un fournisseur de données contenant un objet de rapport
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne FournisseurDeDonnées(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Un objet de rapport
Objet rapport
Oui
Exemples
FournisseurDeDonnées([Revenu total]) renvoie "Ventes" si l'indicateur [Revenu total] se trouve
dans un fournisseur de données appelé "Ventes".
5.1.4.3 DateCléFournisseurDonnées
Description
Renvoie la date clé d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
100
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
date DateCléFournisseurDonnées(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
Vous devez mettre le nom du fournisseur de données entre crochets.
La date clé renvoyée est dotée d'un format conforme à celui des paramètres régionaux du document.
Exemples
DateCléFournisseurDonnées([Ventes]) renvoie le 3 août 2007 si la date clé du fournisseur de
données Ventes est le 3 août 2007.
5.1.4.4 LégendeDateCléFournisseurDonnées
Description
Renvoie la légende de la date clé d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne LégendeDateCléFournisseurDonnées(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
LégendeDateCléFournisseurDonnées([Ventes]) renvoie la "Date actuelle du calendrier" si la
légende de date clé du fournisseur de données Ventes est "Date actuelle du calendrier".
101
2011-04-14
Fonctions, opérateurs et mots clés
5.1.4.5 SQLDuFournisseur
Description
Renvoie le SQL généré par un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne SQLDuFournisseur(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
SQLDuFournisseur([Requête 1]) renvoie SELECT pays.nom_pays FROM pays si le SQL du
fournisseur de données est SELECT pays.nom_pays FROM pays.
5.1.4.6 TypeDuFournisseur
Description
Renvoie le type d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne TypeDuFournisseur(dp)
102
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
TypeDuFournisseur renvoie "Univers" pour les fournisseurs de données d'univers ou "Données
personnelles" pour les fournisseurs de données personnelles.
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
TypeDuFournisseur([Ventes]) renvoie "Univers" si le fournisseur de données "Ventes" est basé
sur un univers.
5.1.4.7 RéponseInvite
Description
Détermine si une réponse a été donnée à l'invite
Groupe de fonctions
Fournisseur de données
Syntaxe
bool RéponseInvite([fd;]chaîne_invite)
Entrée
Paramètre
Description
Type
dp
Le fournisseur de données contenant Fournisseur de don- Non
l'invite
nées
chaîne_invite
Texte de l'invite
Chaîne
Obligatoire
Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
RéponseInvite("Choisir une ville") renvoie la valeur Vrai si une réponse a été donnée à
l'invite identifiée par le texte "Choisir une ville".
RéponseInvite ([Ventes];"Choisir une ville") renvoie la valeur Vrai si une réponse a été
donnée à l'invite identifiée par le texte "Choisir une ville" dans le fournisseur de données [Ventes].
103
2011-04-14
Fonctions, opérateurs et mots clés
5.1.4.8 DateDeLaDernièreExécution
Description
Renvoie la date de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateDeLaDernièreExécution(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
•
Si votre rapport ne comporte qu'un fournisseur de données, vous pouvez omettre le paramètre dp
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.
Exemples
DateDeLaDernièreExécution([Requête ventes]) renvoie "4/3/2002" si le fournisseur de
données Requête ventes a été actualisé pour la dernière fois le 4 mars 2002.
Rubriques associées
• FournisseurDeDonnées
5.1.4.9 DuréeDernièreExécution
Description
Renvoie la durée, exprimée en secondes, de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
104
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
numérique DuréeDernièreExécution(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
DuréeDernièreExécution([Ventes]) renvoie 3 s'il a fallu 3 secondes au fournisseur de données
"Ventes" pour renvoyer ses données lors de la dernière exécution.
5.1.4.10 HeureDeLaDernièreExécution
Description
Renvoie l'heure de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
heure HeureDeLaDernièreExécution(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
•
Si votre rapport ne comporte qu'un fournisseur de données, vous pouvez omettre le paramètre dp.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
HeureDeLaDernièreExécution([Requête ventes]) renvoie "2:48:00 PM" si le fournisseur de
données Requête ventes a été actualisé pour la dernière fois à 14 h 48.
105
2011-04-14
Fonctions, opérateurs et mots clés
Rubriques associées
• FournisseurDeDonnées
5.1.4.11 NombreDeFournisseurs
Description
Renvoie le nombre de fournisseurs de données dans un rapport
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NombreDeFournisseurs()
Exemples
NombreDeFournisseurs() renvoie 2 si le rapport comporte deux fournisseurs de données.
5.1.4.12 NombreDeLignes
Description
Renvoie le nombre de lignes dans un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NombreDeLignes(dp)
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
106
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
NombreDeLignes([Requête 1]) renvoie 10 si le fournisseur de données "Requête 1" comporte
10 lignes.
Rubriques associées
• FournisseurDeDonnées
5.1.4.13 DateDeLaValeurDeRéférence
Description
Renvoie la date des données de référence utilisées dans le cadre du suivi des données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateDeLaValeurDeRéférence()
Exemples
DateDeLaValeurDeRéférence() renvoie 15 décembre 2008 si la date de référence correspond
au 15 décembre 2008.
5.1.4.14 RéponseUtilisateurValeurRéf
Description
Renvoie la réponse à une invite lorsque les données de référence étaient les données actuelles
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateurValeurDeRéférence([fd;]chaîne_invite[;Index])
107
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur
de données
Non
Chaîne
Oui
Indique à la fonction de renvoyer les clés primaires de Mot clé
base de données des valeurs d'invite
Non
chaîne_invite Texte de l'invite
Index
Remarques
•
•
•
•
Cette fonction renvoie une chaîne vide si le suivi des données n'est pas activé.
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.
Si vous avez sélectionné plusieurs valeurs en réponse à une invite, la fonction renvoie une chaîne
constituée d'une liste de valeurs (ou de clés primaires si l'opérateur Index est spécifié) séparées
par des points-virgules.
Exemples
RéponseUtilisateurValeurRéf( "Quelle ville ?" ) renvoie "Madrid" si vous avez saisi
"Madrid" dans l'invite "Quelle ville ?" lorsque les données de référence étaient les données actuelles.
RéponseUtilisateurValeurRéf([Requête ventes];"Quelle ville ?") renvoie "Madrid"
si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes"
lorsque les données de référence étaient les données actuelles.
5.1.4.15 NomDeUnivers
Description
Renvoie le nom de l'univers sur lequel est basé le fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne NomDeUnivers(dp)
108
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de données Oui
Remarques
•
•
•
La valeur dp de la formule est automatiquement mise à jour si le nom du fournisseur de données
change. Si le fournisseur de données est renommé "T1", la formule devient NomUnivers([T1]).
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.
Exemples
NomDeUnivers([Requête 1]) renvoie "eMode" si le fournisseur de données [Requête 1] est basé
sur l'univers eMode.
Rubriques associées
• FournisseurDeDonnées
5.1.4.16 RéponseUtilisateur
Description
Renvoie la réponse à une invite
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateur([fd;]chaîne_invite[;Index])
109
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur
de données
Non
chaîne_invite
Texte de l'invite
Chaîne
Oui
Index
Indique à la fonction de renvoyer les clés primaires de Mot clé
base de données des valeurs d'invite
Non
Remarques
•
•
•
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.
Si vous sélectionnez plusieurs valeurs en réponse à une invite, la fonction renvoie une chaîne
constituée d'une liste de valeurs (ou de clés primaires si l'opérateur Index est spécifié) séparées
par des points-virgules.
Exemples
RéponseUtilisateur( "Quelle ville ?" ) renvoie "Los Angeles" si vous avez saisi "Los
Angeles" dans l'invite "Quelle ville ?".
RéponseUtilisateur ([Requête ventes];"Quelle ville ?") renvoie "Los Angeles" si
vous avez saisi "Los Angeles" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes".
RéponseUtilisateur ([Requête ventes];"Quelle ville ?";Index) renvoie 23 si vous
avez saisi "Los Angeles" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes" et
que la clé primaire de base de données de Los Angeles est 23.
5.1.5 Fonctions Document
5.1.5.1 AuteurDuDocument
Description
Renvoie l'identification InfoView de l'auteur du document
Groupe de fonctions
Document
110
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
chaîne AuteurDuDocument()
Exemples
AuteurDuDocument() renvoie "gkn" si le nom de connexion de l'auteur du document est "gkn".
5.1.5.2 DateDeCréationDuDocument
Description
Renvoie la date à laquelle un document a été créé
Groupe de fonctions
Document
Syntaxe
date DateDeCréationDuDocument()
Exemples
DateDeCréationDuDocument renvoie 15 décembre 2008 si le document a été créé le
15 décembre 2008.
5.1.5.3 HeureDeCréationDuDocument
Description
Renvoie l'heure à laquelle un document a été créé
Groupe de fonctions
Document
Syntaxe
heure HeureDeCréationDuDocument()
Exemples
HeureDeCréationDuDocument() renvoie 11:15 si le document a été créé à 11 h 15.
5.1.5.4 DateDuDocument
111
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie la date à laquelle un document a été enregistré pour la dernière fois
Groupe de fonctions
Document
Syntaxe
date DateDuDocument()
Exemples
DateDuDocument() renvoie 8 août 2005 si le document a été enregistré pour la dernière fois le 8
août 2005.
5.1.5.5 NomDuDocument
Description
renvoie le nom du document.
Groupe de fonctions
Document
Syntaxe
chaîne NomDuDocument()
Exemples
NomDuDocument() renvoie "Rapport des ventes" si le document se nomme "Rapport des ventes".
5.1.5.6 PropriétaireDocument
Description
Renvoie le nom d'utilisateur/les informations de connexion à InfoView du propriétaire du document (la
dernière personne à avoir enregistré le document). (Pour renvoyer l'auteur/le créateur initial du document,
utilisez la fonction AuteurDocument.)
Groupe de fonctions
Document
Syntaxe
chaîne PropriétaireDocument()
112
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
PropriétaireDocument() renvoie "gkn" si la dernière personne à avoir enregistré le document
contient un nom d'utilisateur ou une connexion "gkn".
5.1.5.7 DocumentPartiellementActualisé
Description
Détermine si un document est partiellement actualisé
Groupe de fonctions
Document
Syntaxe
booléen DocumentPartiellementActualisé()
Remarques
DocumentPartiellementActualisé renvoie une valeur booléenne que vous pouvez utiliser dans
la fonction Si.
Exemples
DocumentPartiellementActualisé() renvoie Vrai si le document est partiellement actualisé.
5.1.5.8 HeureDuDocument
Description
Renvoie l'heure à laquelle un document a été enregistré pour la dernière fois
Groupe de fonctions
Document
Syntaxe
heure HeureDuDocument()
Remarques
Le format de l'heure renvoyée varie en fonction du format de cellule.
Exemple
HeureDuDocument() renvoie 15:45 si le document a été enregistré pour la dernière fois à 15h:45.
113
2011-04-14
Fonctions, opérateurs et mots clés
5.1.5.9 FiltresExploration
Description
Renvoie les filtres d'exploration appliqués à un document ou à un objet en mode Exploration
Groupe de fonctions
Document
Syntaxe
chaîne FiltresExploration(obj|séparateur)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Un objet de rapport
Objet rapport
Soit obj, soit sépara
teur requis
séparateur
Le séparateur du filtre d'explo- Chaîne
ration
Soit obj, soit sépara
teur requis
Remarques
•
•
Vous pouvez insérer FiltresExploration directement sans saisir manuellement la formule en
insérant une cellule de filtres d'exploration.
Si vous ne spécifiez aucun objet, la fonction renvoie tous les filtres d'exploration appliqués au
document.
Exemples
FiltresExploration() renvoie "US" si le document possède un filtre d'exploration restreignant
l'objet [Pays] à US.
FiltresExploration() renvoie "US - 1999" si le document possède un filtre limitant les objets
[Pays] à "US" et [Année] à 1999.
FiltresExploration("/") renvoie "US / 1999" si le document possède des filtres limitant les objets
[Pays] à "US" et [Année] à 1999.
FiltresExploration ([Trimestre]) renvoie "T3" si le document possède un filtre d'exploration
limitant l'objet [Trimestre] à "T3".
5.1.5.10 RésuméInvite
114
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie le texte de l'invite et la réponse utilisateur de toutes les invites d'un document
Groupe de fonctions
Document
Syntaxe
string PromptSummary()
Exemples
Exemples d'entrées de la fonction RésuméInvite :
Enter Quantity Sold: 5000
Enter value(s) for State (optional): California, Texas, Utah
Enter Customer (optional):
5.1.5.11 RésuméRequête
Description
Renvoie des informations sur les requêtes d'un document
Groupe de fonctions
Document
Syntaxe
chaîne RésuméRequête([dp])
Entrée
Paramètre
Description
Type
Obligatoire
dp
Un fournisseur de données
Fournisseur de données Non
Remarques
•
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
RésuméRequête() renvoie des informations sur toutes les requêtes d'un document.
RésuméRequête([Requête 1]) renvoie des informations sur toutes les requêtes basées sur le
fournisseur de données [Requête 1].
115
2011-04-14
Fonctions, opérateurs et mots clés
Exemple de sortie :
Query 1:
Universe: eFashion
Last execution time: 1s
NB of rows: 34500
Result objects: State, Year, Sales Revenue
Scope of analysis: State, City, Year, Quarter, Month
Filters:
(State inlist{"US";"France";}
And (Sales Revenue Greater Than 1000000
Or Sales Revenue Less Than 10000))
Query 2:
Source file: D:\Data\datacar.xls
Result objects: State, Year, Sales Revenue
5.1.5.12 FiltreRapport
Description
Renvoie les filtres de rapport appliqués à un objet ou un rapport
Groupe de fonctions
Document
Syntaxe
chaîne FiltreRapport(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Un objet de rapport
Objet rapport
Oui
Exemples
FiltreRapport([Pays]) renvoie "US" si un filtre de rapport limite l'objet Pays à "US".
5.1.5.13 RésuméFiltreRapport
Description
Renvoie un résumé des filtres de rapport d'un document ou d'un rapport
Groupe de fonctions
Document
116
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
string ReportFilterSummary(report_name)
Entrée
Paramètre
Description
Type
Obligatoire
nom_rapport
Le nom du rapport
Chaîne
Non
Remarques
Si nom_rapport est omis, RésuméFiltreRapport renvoie un résumé de tous les filtres de rapport
du document.
Exemples
RésuméFiltreRapport() renvoie des informations sur tous les filtres de rapport d'un document.
RésuméFiltreRapport("Rapport1") renvoie des informations sur les filtres du rapport "Rapport1".
Exemples d'entrées de la fonction RésuméFiltreRapport :
Filters on Report1:
(Sales Revenue Greater Than 1000000
Or (Sales Revenue Less Than 3000))
Filters on Section on City:
(City InList{"Los Angeles";"San Diego";})
Ranking Filter:
(Top 10 & Bottom 10 [Customer] Based on [Sales Revenue] (Count))
5.1.6 Fonctions du groupe Logique
5.1.6.1 Pair
Description
Détermine si un nombre est pair
Groupe de fonctions
Logique
Syntaxe
booléen Pair(nombre)
117
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Remarques
•
•
Pair renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez Pair directement dans une colonne, le système renvoie un entier (1=true ; 0=false).
Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
Pair(4) renvoie Vrai.
Pair(3) renvoie Faux.
Pair(23,2) renvoie Faux.
Pair(-4) renvoie Vrai.
Pair(-2,2) renvoie Faux.
5.1.6.2 Estdate
Description
Détermine si une valeur est une date
Groupe de fonctions
Logique
Syntaxe
booléen EstDate(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
•
EstDate renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez EstDate directement dans une colonne, le système renvoie un entier (1=true ;
0=false). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstDate([Date de réservation]) renvoie Vrai si la variable [Date de réservation] est une date.
118
2011-04-14
Fonctions, opérateurs et mots clés
Si(EstDate([Date de réservation] Alors "Date" Sinon "Pas date") renvoie "Date"
si [Date de réservation] est une date.
Rubriques associées
• Si...Alors...Sinon
5.1.6.3 EstErreur
Description
Détermine si un objet renvoie une erreur
Groupe de fonctions
Logique
Syntaxe
booléen EstErreur(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
•
EstErreur() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez EstErreur directement dans une colonne, la fonction renvoie un nombre entier
(1=vrai ; 0=faux). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstErreur([Chiffre d'affaires]) renvoie la valeur Faux si la variable [Chiffre d'affaires] ne
renvoie pas d'erreur.
EstErreur([Nombre moyen d'invités]) renvoie Vrai si la variable [Nombre moyen d'invités]
renvoie une erreur de division par zéro (#DIV/0).
Si EstErreur([Nombre moyen d'invités]) Alors "Erreur" Sinon "Pas d'erreur"
renvoie "Erreur" si la variable [Nombre moyen d'invités] renvoie une erreur de division par zéro (#DIV/0).
Rubriques associées
• Si...Alors...Sinon
119
2011-04-14
Fonctions, opérateurs et mots clés
5.1.6.4 EstLogique
Description
Détermine si une valeur est booléenne
Groupe de fonctions
Logique
Syntaxe
booléen EstLogique(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
•
EstLogique() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez EstLogique directement dans une colonne, le système renvoie un entier (1=true ;
0=false). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstLogique(EstChaîne([Pays])) renvoie Vrai.
EstLogique([Pays]) renvoie Faux si [Pays] renvoie tout type de données autre que booléen.
Si EstLogique(EstDate([Pays])) Alors "Booléen" Sinon "Non booléen" renvoie
"Booléen".
Rubriques associées
• Si...Alors...Sinon
5.1.6.5 EstNul
Description
Détermine si une valeur est nulle
Groupe de fonctions
Logique
120
2011-04-14
Fonctions, opérateurs et mots clés
Syntaxe
booléen EstNul(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
•
EstNul() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez EstNul directement dans une colonne, le système renvoie un entier (1=true ; 0=false).
Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstNul([Chiffre d'affaires]) renvoie la valeur Faux si la variable [Chiffre d'affaires] n'est pas
nulle.
EstNul([Nombre moyen d'invités]) renvoie la valeur Vrai si la variable [Nombre moyen d'invités]
est nulle.
Rubriques associées
• Si...Alors...Sinon
5.1.6.6 EstNombre
Description
Détermine si une valeur est un nombre
Groupe de fonctions
Logique
Syntaxe
booléen EstNombre(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
121
EstNombre renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
2011-04-14
Fonctions, opérateurs et mots clés
•
Si vous placez EstNombre directement dans une colonne, le système renvoie un entier (1=true ;
0=false). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstNombre([Chiffre d'affaires]) renvoie la valeur Vrai si la variable [Chiffre d'affaires] est un
nombre.
EstNombre([Nom du client]) renvoie Faux si la variable [Nom du client] n'est pas un nombre.
Si EstNombre([Nom du client]) Alors "Nombre" Sinon "Pas un nombre" renvoie "Pas
un nombre" si la variable [Nom du client] n'est pas un nombre.
Rubriques associées
• Si...Alors...Sinon
5.1.6.7 EstChaîne
Description
Détermine si une valeur est une chaîne
Groupe de fonctions
Logique
Syntaxe
booléen EstChaîne(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
•
EstChaîne() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez EstChaîne directement dans une colonne, le système renvoie un entier (1=true ;
0=false). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstChaîne([Chiffre d'affaires]) renvoie la valeur Faux si la variable [Chiffre d'affaires] n'est
pas une chaîne.
EstChaîne([Nom du client]) renvoie Vrai si la variable [Nom du client] est une chaîne.
Si EstChaîne([Nom client]) Alors "Chaîne" Sinon "Pas chaîne" renvoie "Chaîne" si
la variable [Nom client] est une chaîne.
122
2011-04-14
Fonctions, opérateurs et mots clés
Rubriques associées
• Si...Alors...Sinon
5.1.6.8 EstHeure
Description
Détermine si une variable est une variable d'heure
Groupe de fonctions
Logique
Syntaxe
booléen EstHeure(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
•
•
EstHeure renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez EstHeure directement dans une colonne, le système renvoie un entier (1=true ;
0=false). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
EstHeure([Heure de réservation]) renvoie la valeur Vrai si la variable [Heure de réservation]
est une variable d'heure.
EstHeure([Nombre moyen d'invités]) renvoie la valeur Faux si la variable [Nombre moyen
d'invités] n'est pas une variable d'heure.
Si EstHeure([Nombre moyen d'invités]) Alors "Heure" Sinon "Pas heure" renvoie
"Pas heure" si la variable [Nombre moyen d'invités] n'est pas une variable d'heure.
Rubriques associées
• Si...Alors...Sinon
5.1.6.9 Impair
123
2011-04-14
Fonctions, opérateurs et mots clés
Description
Détermine si un nombre est impair
Groupe de fonctions
Logique
Syntaxe
booléen Impair(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Remarques
•
•
•
Impair renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Si vous placez Impair directement dans une colonne, le système renvoie un entier (1=true ; 0=false).
Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Impair ignore les fractions des nombres décimaux.
Exemples
Impair(5) renvoie la valeur Vrai.
Impair(4) renvoie la valeur Faux.
Impair(23.2) renvoie la valeur Vrai.
Impair(24.2) renvoie la valeur Vrai.
Impair(-23.2) renvoie la valeur Vrai.
Impair(-24.2) renvoie la valeur Vrai.
Rubriques associées
• Si...Alors...Sinon
5.1.7 Fonctions du groupe Numérique
5.1.7.1 Abs
124
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie la valeur absolue d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Abs(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Exemples
Abs(25) renvoie 25.
Abs(-11) renvoie 11.
5.1.7.2 Plafond
Description
Renvoie un nombre arrondi à l'entier supérieur
Groupe de fonctions
Numérique
Syntaxe
numérique Plafond( nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Exemples
Plafond(2,4) renvoie 3.
Plafond(3,1) renvoie 4.
Plafond(-3,1) renvoie -3.
125
2011-04-14
Fonctions, opérateurs et mots clés
5.1.7.3 Cos
Description
Renvoie le cosinus d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Cos(angle)
Entrée
Paramètre
Description
Type
Obligatoire
angle
Un angle en radians
Nombre
Oui
Exemples
Cos(180) renvoie -0,6.
5.1.7.4 ConvertirDepuisEuro
Description
Convertit un montant en euros dans une autre devise
Groupe de fonctions
Numérique
Syntaxe
numérique ConvertirDepuisEuro(montant_euro;code_dev;niveau_arrondi)
126
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
montant_euro
Le montant en euros
Nombre
Oui
code_dev
Le code ISO de la devise cible
Chaîne
Oui
niveau_arrondi
Le nombre de décimales selon lequel le résul- Nombre
tat doit être arrondi
Oui
Remarques
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs
ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction
renvoie #ERROR. Les devises sont les suivantes :
BEF
Franc belge
DEM
Mark allemand
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Exemples
ConvertirDepuisEuro(1000;"FRF";2) renvoie 6559,57.
ConvertirDepuisEuro(1000;"FRF";1) renvoie 6559,60.
ConvertirDepuisEuro(1000.04;"DEM";2) renvoie 1955,83.
ConvertirDepuisEuro(1000.04;"DEM";1) renvoie 1955,80.
Rubriques associées
• Arrondir et tronquer des nombres
127
2011-04-14
Fonctions, opérateurs et mots clés
5.1.7.5 ConvertirEnEuro
Description
Convertit un montant en euros
Groupe de fonctions
Numérique
Syntaxe
numérique ConvertirEnEuro(montant_non_euro;code_dev;niveau_arrondi)
Entrée
Paramètre
Description
Type
Obligatoire
montant_non_euro
Le montant dans la devise qui n'est pas en euros Nombre
Oui
code_dev
Le code ISO de la devise qui n'est pas en euros Chaîne
Oui
niveau_arrondi
Le nombre de décimales selon lequel le résultat Nombre
doit être arrondi
Oui
Exemple
ConvertirEnEuro(6559;"FRF";2) renvoie 999,91.
ConvertirEnEuro(6559;"FRF";1) renvoie 999,90.
ConvertirEnEuro(1955;"DEM";2) renvoie 999,58.
ConvertirEnEuro(1955;"DEM";1) renvoie 999,60.
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs
ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction
renvoie #ERROR. Les devises sont les suivantes :
128
BEF
Franc belge
DEM
Mark allemand
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
2011-04-14
Fonctions, opérateurs et mots clés
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Rubriques associées
• Arrondir et tronquer des nombres
5.1.7.6 ErreurEuroParArrondi
Description
Renvoie l'erreur d'arrondi dans une conversion à partir d'euros
Groupe de fonctions
Numérique
Syntaxe
numérique ErreurEuroParArrondi(montant_euro;code_dev;niveau_arrondi)
Entrée
Paramètre
Description
Type
Obligatoire
montant_euro
Le montant en euros
Nombre
Oui
code_dev
Le code ISO de la devise cible
Chaîne
Oui
niveau_arrondi
Le nombre de décimales selon lequel le résultat Nombre
doit être arrondi
Oui
Résultat
L'erreur d'arrondi du calcul
Exemples
ErreurEuroParArrondi(1000;"FRF";2) renvoie 0. (Il n'y a pas de différence entre la conversion
non arrondie et la conversion arrondie à 2 positions décimales.)
129
2011-04-14
Fonctions, opérateurs et mots clés
ErreurEuroParArrondi(1000;"FRF";1) renvoie 0,03. (La conversion non arrondie est 6559,57.
La conversion arrondie à 1 position décimale est 6559,60. L'erreur d'arrondi est 0,03.)
ErreurEuroParArrondi(1000;"DEM";2) renvoie 0. (Il n'y a pas de différence entre la conversion
non arrondie et la conversion arrondie à 2 positions décimales.)
ErreurEuroParArrondi(1000;"DEM";1) renvoie -0,01. (La conversion non arrondie est 1955,83.
La conversion arrondie à 1 position décimale est 1995,80. L'erreur d'arrondi est de -0,03.)
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs
ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction
renvoie #ERROR. Les devises sont les suivantes :
BEF
Franc belge
DEM
Mark allemand
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Rubriques associées
• Arrondir et tronquer des nombres
5.1.7.7 ErreurEuroVersArrondi
Description
Renvoie l'erreur d'arrondi dans un calcul de conversion en euros
130
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Numérique
Syntaxe
numérique ErreurEuroVersArrondi(montant_non_euro;code_dev;niveau_arrondi)
Entrée
Paramètre
Description
Type
Obligatoire
montant_non_euro
Le montant dans la devise qui n'est pas en euros Nombre
Oui
code_dev
Le code ISO de la devise qui n'est pas en euros Chaîne
Oui
niveau_arrondi
Le nombre de décimales selon lequel le résultat Nombre
doit être arrondi
Oui
Exemples
ErreurArrondiConvertirEnEuro(6559;"FRF";2) renvoie 0. (Il n'y a pas de différence entre la
conversion non arrondie et la conversion arrondie à 2 positions décimales.)
ErreurArrondiConvertirEnEuro(6559;"FRF";1) renvoie -0,01. (La conversion non arrondie
est 999,91. La conversion arrondie à 1 position décimale est 999,90. L'erreur d'arrondi est de -0,01.)
ErreurArrondiConvertirEnEuro(1955;"DEM";2) renvoie 0. (Il n'y a pas de différence entre la
conversion non arrondie et la conversion arrondie à 2 positions décimales.)
ErreurArrondiConvertirEnEuro(1955;"DEM";1) renvoie 0,02. (La conversion non arrondie
est 999,58. La conversion arrondie à 1 position décimale est 999,60. L'erreur d'arrondi est de -0,02.)
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs
ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction
renvoie #ERROR. Les devises sont les suivantes :
131
BEF
Franc belge
DEM
Mark allemand
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
2011-04-14
Fonctions, opérateurs et mots clés
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Rubriques associées
• Arrondir et tronquer des nombres
5.1.7.8 Exp
Description
Renvoie une valeur exponentielle (e élevée à une puissance)
Groupe de fonctions
Numérique
Syntaxe
numérique Exp(puissance)
Entrée
Paramètre
Description
Type
Obligatoire
puissance
La puissance
Nombre
Oui
Remarques
Une valeur exponentielle est la constante e (2,718...) élevée à une puissance.
Exemples
Exp(2.2) renvoie 9,03.
5.1.7.9 Fact
Description
Renvoie le factoriel d'un nombre
132
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Numérique
Syntaxe
entier Fact(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Remarques
Le factoriel de nombre est le produit de tous les nombres entiers compris entre 1 et nombre.
Exemples
Fact(4) renvoie 24.
Fact(5,9) renvoie 120.
5.1.7.10 Floor
Description
Renvoie un nombre arrondi à l'entier inférieur le plus proche
Groupe de fonctions
Numérique
Syntaxe
entier Plancher(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Exemple
Plancher(24,4) renvoie 24.
5.1.7.11 Interpolation
133
2011-04-14
Fonctions, opérateurs et mots clés
Description
Calcule les valeurs d'indicateur manquantes par interpolation
Groupe de fonctions
Numérique
Syntaxe
num Interpolation(measure[;PointToPoint|Linear][;NotOnBreak|(reset_dims)][;Row|Col])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
PointAPoint|Linéaire
La méthode d'interpolation :
•
•
PasSurSaut| •
réinit_dims
•
Ligne|Col
Mot clé
PointAPoint : interpolation de point à
point
Linéaire : régression linéaire avec interpolation des moindres carrés.
Non
(PointAPoint est utilisé
par défaut)
PasSurSaut : empêche la fonction de réini- Mot clé| liste Non
tialiser le calcul au niveau des sauts de se- des dimensions
ction et de bloc
réinit_dims : liste des dimensions utilisées pour réinitialiser l'interpolation.
Définit le sens du calcul
Mot clé
(Ligne, par défaut)
Remarques
•
•
•
•
•
•
•
134
Interpolation est très utile pour créer un graphique linéaire pour un indicateur dont certaines
valeurs sont manquantes. L'utilisation de cette fonction permet de s'assurer que le diagramme trace
une ligne continue (et non des lignes et des points discontinus).
La régression linéaire avec interpolation des moindres carrés calcule les valeurs manquantes en
calculant une équation de droite de type f(x) = ax + b qui passe, le plus précisément possible, par
toutes les valeurs disponibles de l'indicateur.
L'interpolation de point à point calcule les valeurs manquantes en calculant une équation de droite
de type f(x) = ax + b qui passe par les deux valeurs adjacentes à la valeur manquante.
L'ordre de tri de l'indicateur a une incidence sur les valeurs renvoyées par Interpolation.
Vous ne pouvez pas appliquer de tri ni de classement à une formule contenant Interpolation.
Si la liste de valeurs ne comporte qu'une seule valeur, Interpolation l'utilise pour fournir toutes
les valeurs manquantes.
Les filtres appliqués à un indicateur interpolé peuvent modifier les valeurs renvoyées par Interpo
lation en fonction des valeurs concernées par les filtres.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
Interpolation([Valeur]) fournit les valeurs manquantes suivantes en utilisant la méthode
d'interpolation de point à point par défaut :
Jour
Valeur
Interpolation([Valeur])
Lundi
12
12
Mardi
14
14
Mercredi
Jeudi
15
16
16
Vendredi
17
Samedi
18
Dimanche
19
19
Rubriques associées
• Opérateur Linéaire
• Opérateur PointAPoint
5.1.7.12 Ln
Description
renvoie le logarithme naturel d'un nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique Ln(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Exemples
Ln(10) renvoie 2.
135
2011-04-14
Fonctions, opérateurs et mots clés
5.1.7.13 Journal
Description
Renvoie le logarithme d'un nombre d'une base spécifiée
Groupe de fonctions
Numérique
Syntaxe
numérique Log(nombre;base)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
base
La base du logarithme
Nombre
Oui
Exemples
Log(125;5) renvoie 3.
5.1.7.14 Log10
Description
Renvoie le logarithme de base 10 d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Log10(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Exemples
Log10(100) renvoie 2.
136
2011-04-14
Fonctions, opérateurs et mots clés
5.1.7.15 Mod
Description
Renvoie le reste d'une division de deux nombres
Groupe de fonctions
Numérique
Syntaxe
numérique Mod(dividende;diviseur)
Entrée
Paramètre
Description
Type
Obligatoire
dividende
Le dividende
Nombre
Oui
diviseur
Le diviseur.
Nombre
Oui
Exemples
Mod(10;4) renvoie 2.
Mod (10.2;4.2) renvoie 1.8.
5.1.7.16 Puissance
Description
Renvoie un nombre élevé à une puissance
Groupe de fonctions
Numérique
Syntaxe
numérique Puissance(nombre;puissance)
137
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à élever à une puis- Nombre
sance
Oui
puissance
La puissance
Oui
Nombre
Exemple
Puissance(10;2) renvoie 100.
5.1.7.17 Classement
Description
Classe un indicateur selon des dimensions
Groupe de fonctions
Numérique
Syntaxe
entier Classement(indicateur;[dims_classement][;Premiers|Derniers][;(réinit_dims)])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
L'indicateur à classer
Indicateur
Oui
dim_classe- Les dimensions utilisées pour classer l'indicateur Liste Dimen- Non
ment
sion
Premiers/Derniers
Définit l'ordre de classement.
• Premiers : décroissant
• Bas : croissant
Mot clé
Non (Premiers est la
configuration par défaut)
dim_redéfinies
Les dimensions qui réinitialisent le classement
Liste Dimen- Non
sion
Remarques
•
•
•
138
La fonction utilise le contexte de calcul par défaut pour calculer le classement si vous ne spécifiez
pas de dimension de classement.
Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions de
classement ou redéfinies ne contient qu'une entrée.
Lorsque vous spécifiez un ensemble de dimensions de classement ou redéfinies, vous devez les
séparer par des points-virgules.
2011-04-14
Fonctions, opérateurs et mots clés
•
Par défaut, le classement est réinitialisé sur une section ou une rupture de bloc.
Exemples
Dans le tableau suivant, le rang est indiqué par Classement([Chiffre d'affaires]);([Pays])):
Pays
Chiffre d'affaires
Classement
France
835 420
2
US
2 451 104
1
Dans le tableau suivant, le classement est donné par Classement([Chiffre d'af
faires];([Pays]);Derniers). L'argument Derniers signifie que les indicateurs sont classés
par ordre décroissant.
Pays
Chiffre d'affaires
Classement
France
835 420
1
US
2 451 104
2
Dans le tableau suivant, le classement est indiqué par Classement([Chiffre d'af
faires];([Pays];[Lieu de séjour])):
Pays
Lieu de séjour
Chiffre d'affaires
Classement
France
Côte d'Azur
835 420
3
US
Bahamas Beach
971 444
2
US
Hawaiian Club
1 479 660
1
Dans le tableau suivant, le classement est indiqué par Classement([Chiffre d'af
faires];([Pays];[Année]);([Pays])). Le rang est réinitialisé dans la dimension Pays.
139
Pays
Année
Chiffre d'affaires
Classement
France
FY1998
295 940
1
France
1999
280 310
2
France
2000
259 170
3
US
FY1998
767 614
3
US
1999
826 930
2
US
2000
856 560
1
2011-04-14
Fonctions, opérateurs et mots clés
Rubriques associées
• Opérateurs Derniers/Premiers
5.1.7.18 Arrondi
Description
Arrondit un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Arrondi (nombre;niveau_arrondi)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à arrondir
Nombre
Oui
niveau_arrondi
Nombre de décimales selon lequel le no- Nombre
mbre est arrondi
Oui
Exemples
Arrondi(9.44;1) renvoie 9,4.
Arrondi(9.45;1) renvoie 9,5.
Arrondi(9.45;0) renvoie 9.
Arrondi(9.45;-1) renvoie 10.
Arrondi(4.45;-1) renvoie 0.
Rubriques associées
• Arrondir et tronquer des nombres
5.1.7.19 Signe
140
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie le signe d'un nombre
Groupe de fonctions
Numérique
Syntaxe
entier Signe(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Remarques
Signe renvoie -1 si nombre est négatif, 0 si nombre est zéro et 1 si nombre est positif.
Exemples
Signe(3) renvoie 1.
Signe(-27,5) renvoie -1.
5.1.7.20 Sin
Description
Retourne le sinus d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Sin(angle)
Entrée
Paramètre
Description
Type
Obligatoire
angle
Un angle en radians
Nombre
Oui
Exemple
Sin(234542) renvoie -0,116992.
141
2011-04-14
Fonctions, opérateurs et mots clés
5.1.7.21 RacineCarrée
Description
Calcule la racine carrée d'un nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique RacineCarrée(nombre)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
Exemple
Racine(25) renvoie 5.
5.1.7.22 Tan
Description
Renvoie la tangente d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Tan(angle)
Entrée
Paramètre
Description
Type
Obligatoire
angle
Un angle en radians
Nombre
Oui
Exemples
Tan(90) renvoie -2.
142
2011-04-14
Fonctions, opérateurs et mots clés
5.1.7.23 EnNombre
Description
renvoie une chaîne sous la forme de nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique EnNombre(chaîne)
Entrée
Paramètre
Description
Type
chaîne
Un nombre sous forme de chaîne de Chaîne
caractères
Obligatoire
Oui
Remarques
Si chaîne ne correspond pas à un nombre, la fonction EnNombre renvoie #ERREUR.
Exemples
EnNombre("45") renvoie 45.
5.1.7.24 Truncate
Description
Tronque un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Tronquer(nombre;niveau_troncature)
143
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à arrondir
Nombre
Oui
niveau_troncature Nombre de décimales selon lequel le no- Nombre
mbre est tronqué
Oui
Remarques
Exemple
Tronquer(3,423;2) renvoie 3,42.
Rubriques associées
• Arrondir et tronquer des nombres
5.1.8 Fonctions d'ensemble
5.1.8.1 Children
Description
Renvoie les membres enfant d'un membre
Groupe de fonctions
Ensemble
Syntaxe
member_set member.Children
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
Remarques
•
•
144
La fonction Enfant 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
2011-04-14
Fonctions, opérateurs et mots clés
indiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeur
vide.
Exemples
[Géographie].[Etats-Unis].[Californie].Enfants renvoie [Los Angeles], [San Francisco],
[San Diego].
[Géographie].Enfants renvoie [Los Angeles], [San Francisco], [San Diego] si [Californie] est le
membre actuel de la hiérarchie [Géographie].
Rubriques associées
• Agrégat
• Moyen
• Nombre
• Max
• Min
• Sum (Somme)
5.1.8.2 Profondeur
Description
Renvoie la profondeur d'un membre dans la hiérarchie
Groupe de fonctions
Ensemble
Syntaxe
ent membre.Profondeur
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
Remarques
•
•
•
145
La profondeur désigne la distance qui sépare le membre du niveau supérieur de la hiérarchie.
Le niveau supérieur d'une hiérarchie et le niveau 0.
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.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
[Géographie].[Etats-Unis].[Californie].[Los Angeles].Profondeur renvoie 2.
5.1.8.3 Descendants
Description
Renvoie les membres descendants d'un membre
Groupe de fonctions
Ensemble
Syntaxe
member_set Decendants(member[;level|distance][;desc_flag])
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
niveau
Niveau des descendants
niveau
Non (le niveau de membre est
le niveau par défaut)
distance
Distance entre le niveau du descen- int
dant et le niveau actuel
indicateur_de- Détermine quels membres descenda- mot clé
sc
nts sont renvoyés
Non (le niveau de membre est
le niveau par défaut)
Non (la valeur par défaut est
Self)
Remarques
•
•
•
•
•
•
146
Descendants ne peut pas s'utiliser 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.
Self dans indicateur_desc se rapporte au niveau indiqué par le paramètre niveau|distance.
Before dans indicateur_desc se rapporte à tous les niveaux au-dessus du niveau indiqué par
le paramètre niveau|distance.
After dans indicateur_desc se rapporte à tous les niveaux au-dessous du niveau indiqué par
le paramètre niveau|distance.
Les valeurs de indicateur_desc sont les suivantes :
2011-04-14
Fonctions, opérateurs et mots clés
Self
Renvoie les descendants qui se trouvent au niveau indiqué par le paramètre
niveau|distance, y compris le membre actuel s'il se trouve à ce niveau.
Before
Renvoie le membre actuel et tous les descendants qui se trouvent au-dessus
du niveau indiqué par le paramètreniveau|distance.
After
Renvoie les descendants qui se trouvent au-dessous du niveau indiqué par le
paramètre niveau|distance.
Self_Before
Renvoie le membre actuel et tous les descendants qui se trouvent au niveau
indiqué par le paramètreniveau|distance ou au-dessus.
Self_After
Renvoie le membre actuel et tous les descendants qui se trouvent au niveau
indiqué par le paramètreniveau|distance ou au-dessous.
Before_After
Renvoie le membre actuel et tous les descendants, sauf ceux qui se trouvent
au niveau indiqué par le paramètreniveau|distance.
Self_Before_After Renvoie le membre actuel et tous les descendants.
Leaves
•
Renvoie tous les membres qui se trouvent entre le membre actuel et le niveau
indiqué par le paramètreniveau|distance et qui n'ont pas de membres enfant.
La distance doit être positive.
Exemples
Tous les exemples reposent sur les données suivantes :
Etats-Unis
Californie
Los Angeles
San Diego
Nevada
San Francisco
Las Vegas
Reno
Carson City
Descendants([Géographie].[Etats-Unis].[Californie];[Géographie].[Ville])
renvoie [San Francisco], [San Diego], [Los Angeles].
Descendants([Géographie];1) renvoie [Californie], [Nevada] si le membre actuel est [Etats-Unis].
Descendants([Géographie].[Etats-Unis];2;Après) renvoie [Etats-Unis], [Californie], [Nevada].
Descendants([Géographie].[Etats-Unis]:[Géographie].[Ville];Self_Before) renvoie
[Etats-Unis], [Californie], [Nevada], [San Francisco], [San Diego], [Los Angeles], [Las Vegas], [Reno],
[Carson City].
Descendants([Géographie];[Géographie].[Etat];After) renvoie [San Francisco], [San
Diego], [Los Angeles], [Las Vegas], [Reno], [Carson City] si le membre actuel est [Etats-Unis].
147
2011-04-14
Fonctions, opérateurs et mots clés
Descendants([Géographie];1;Self_After) renvoie [Etats-Unis], [Californie], [Nevada], [San
Francisco], [San Diego], [Los Angeles], [Las Vegas], [Reno], [Carson City] si le membre actuel est
[Etats-Unis].
Descendants([Géographie].[Etats-Unis]:[Géographie].[Etat];Before_After) renvoie
[Etats-Unis], [San Francisco], [San Diego], [Los Angeles], [Las Vegas], [Reno], [Carson City].
Descendants([Géographie].[Etats-Unis]:[Géographie].[Etat];Self_Before_After)
renvoie [Etats-Unis], [Californie], [Nevada], [San Francisco], [San Diego], [Los Angeles], [Las Vegas],
[Reno], [Carson City].
Descendants([Géographie].[Etats-Unis]:[Géographie].[Ville];Leaves) renvoie [San
Francisco], [San Diego], [Los Angeles], [Las Vegas], [Reno], [Carson City].
Rubriques associées
• Agrégat
• Moyen
• Nombre
• Max
• Min
• Sum (Somme)
5.1.8.4 IsLeaf
Description
Détermine si un membre est un membre feuille.
Groupe de fonctions
Divers
Syntaxe
bool membre.EstFeuille
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
Remarques
•
•
148
Un membre feuille est un membre qui n'a aucun membre enfant.
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
2011-04-14
Fonctions, opérateurs et mots clés
indiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeur
vide.
Exemples
[Géographie].[Etats-Unis].[Californie].EstFeuille renvoie Faux si [Californie] a les
membres enfant [Los Angeles], [San Diego], [San Francisco].
[Géographie].EstFeuille renvoie Vrai si le membre actuel de la hiérarchie [Géographie] est
[Nevada] et si [Nevada] n'a aucun membre enfant.
5.1.8.5 Clé
Description
Renvoie la clé d'un membre.
Syntaxe
chaîne membre.Clé
Groupe de fonctions
Ensemble
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
Remarques
•
•
La clé est l'identificateur interne d'un membre.
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.
Exemple
[Géographie].[Etats-Unis].Clé renvoie "XYZ" si la clé du membre [Etats-Unis] est "XYZ".
5.1.8.6 Lag
149
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie un membre qui se trouve au même niveau que le membre actuel et à une distance donnée
avant ce dernier.
Syntaxe
membre membre.Décalage(distance)
Groupe de fonctions
Ensemble
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
distance
Distance entre le membre en question et le
membre actuel
int
Oui
Remarques
•
•
•
•
Décalage ne peut pas s'utiliser 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.
Si la valeur distance est positive, Décalage renvoie le membre qui se trouve à la distance
spécifiée avant membre. Si la valeur distance est négative, Décalage renvoie le membre qui se
trouve à la distance spécifiée après membre.
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.
Décalage se sert de l'ordre des membres dans la hiérarchie et dans la requête pour renvoyer le
membre correspondant.
Exemples
[Géographie].[Etats-Unis].[Californie].[San Francisco].Décalage(1) renvoie [San
Diego] si [San Diego] est le membre juste avant [San Francisco] au niveau Ville.
Rubriques associées
• Agrégat
• Moyen
• Nombre
• Max
• Min
• Sum (Somme)
150
2011-04-14
Fonctions, opérateurs et mots clés
5.1.8.7 Parent
Description
Renvoie le membre parent d'un membre
Groupe de fonctions
Ensemble
Syntaxe
member member.Parent
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
Remarques
•
•
Parent ne peut pas s'utiliser 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.
Exemples
[Géographie].[Etats-Unis].[Californie].[Los Angeles].Parent renvoie [Californie].
Rubriques associées
• Agrégat
• Moyen
• Nombre
• Max
• Min
• Sum (Somme)
5.1.8.8 Eléments de niveau identique
151
2011-04-14
Fonctions, opérateurs et mots clés
Description
Renvoie les membres de même niveau qu'un membre
Groupe de fonctions
Ensemble
Syntaxe
member_set member.Siblings
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
Remarques
•
•
•
Elément de même niveau ne peut pas s'utiliser 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.
Les membres de même niveau sont des membres qui ont le même niveau et le même parent qu'un
membre.
Exemples
[Géographie].[Etats-Unis].[Californie].Eléments de niveau identique renvoie
[Nevada], [Arizona] si [Nevada] et [Arizona] sont au même niveau que [Californie].
Rubriques associées
• Agrégat
• Moyen
• Nombre
• Max
• Min
• Sum (Somme)
5.1.9 Fonctions diverses
152
2011-04-14
Fonctions, opérateurs et mots clés
5.1.9.1 Ascendant
Description
Renvoie un membre ascendant d'un membre
Groupe de fonctions
Divers
Syntaxe
member Ancestor(member;level|distance)
Entrée
Paramètre
Description
Type
Obligatoire
membre
Tout membre
membre
Oui
niveau
Le niveau de l'ascendant
niveau
Le niveau ou la dista
nce est requis
distance
La distance du niveau de l'ascendant par int
rapport au niveau actuel
Le niveau ou la dista
nce est requis
Remarques
•
•
•
La fonction Ascendant 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
Los Angeles
San Diego
Nevada
San Francisco
Las Vegas
Reno
Carson City
Ascendant([Géographie].[Etats-Unis].[Californie].[Los Angeles];1) renvoie
[Californie].
153
2011-04-14
Fonctions, opérateurs et mots clés
Ascendant([Géographie];[Géographie].[Etat]) renvoie [Californie] si le membre actuel est
[San Diego].
Rubriques associées
• Agrégat
• Moyen
• Nombre
• Max
• Min
• Sum (Somme)
5.1.9.2 NomDuBloc
Description
Renvoie le nom du bloc
Groupe de fonctions
Divers
Syntaxe
chaîne NomDuBloc()
Exemples
Si NomDuBloc est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
5.1.9.3 NuméroDeColonne
Description
Renvoie le numéro de la colonne
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeColonne()
Exemples
NuméroDeColonne() renvoie 2 si la formule est placée dans la deuxième colonne d'un tableau.
154
2011-04-14
Fonctions, opérateurs et mots clés
5.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 UtilisateurActuel()
Exemples
UtilisateurActuel() renvoie "gkn" si son nom d'utilisateur est "gkn".
5.1.9.5 ForcerFusion
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)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Résultat
Résultat du calcul tenant compte des dimensions synchronisées
Remarques
•
•
155
Appliqué à un indicateur intelligent, ForcerFusion renvoie #VALEURMULTI car le groupe
nécessaire pour calculer l'indicateur intelligent n'existe pas.
La fonction ForcerFusion est l'équivalent de la fonction MultiCube de BusinessObjects/Desktop
Intelligence.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
ForcerFusion([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].
5.1.9.6 ObtenirVariablesRégionalesDeContenu
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 ObtenirVariablesRégionalesDeContenu()
Remarques
Les paramètres régionaux du document sont utilisés pour mettre en forme les données dans un
document.
Exemples
ObtenirVariablesRégionalesDeContenu() renvoie "fr_FR" si les paramètres régionaux du
document sont "Français (France)".
5.1.9.7 ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents
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
•
156
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
2011-04-14
Fonctions, opérateurs et mots clés
•
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
ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents renvoie "en_US" lorsque
le paramètre régional de visualisation préféré est "Anglais (Nouvelle-Zélande)".
Rubriques associées
• ObtenirParamètresRégionauxDeVisualisationPréférés
5.1.9.8 ObtenirVarRég
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 ObtenirVarRég()
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
ObtenirVarRég() renvoie "en_US" si le paramètre régional du produit est "Anglais (US)".
5.1.9.9 ObtentionTraduction
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])
157
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne à traduire
chaîne
Oui
comment (commen- Un commentaire pour aider les traduc- chaîne
taire)
teurs
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, ObtentionTraduction("Product Total";"Max
20 characters") et ObtentionTraduction("Product Total";"Use no more than
20 characters") peuvent renvoyer des traductions différentes.
Exemples
ObtentionTraduction("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".
ObtentionTraduction("Total for all products";"Try not to use more than 20
characters") 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.
Rubriques associées
• ObtenirParamètresRégionauxDeVisualisationPréférés
5.1.9.10 ObtenirParamètresRégionauxDeVisualisationPréférés
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 ObtenirParamètresRégionauxDeVisualisationPréférés()
158
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
ObtenirParamètresRégionauxDeVisualisationPréférés renvoie "en_US" si les Paramètres
régionaux de visualisation préférés sont "English (US)".
Rubriques associées
• ObtentionTraduction
• ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents
5.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]
Entrée
Paramètre
Description
Type
Obligatoire
valeur_bool
Une valeur booléenne
Booléen
Oui
valeur_vrai
La valeur à renvoyer si valeur_bool N'importe lequel
est vraie
Oui
valeur_faux
La valeur à renvoyer si valeur_bool N'importe lequel
est fausse
Oui si Sinon est inclus
Remarques
•
•
•
valeur_vrai et valeur_faux 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…]
•
159
La syntaxe d'origine de la fonctionSi, Si(valeur_bool; valeur_vrai; valeur_faux) est
également prise en charge.
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
Si [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.
Si [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.
Si [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.
Si [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
• Si
• And (opérateur)
• Opérateur Entre
• DansListe (opérateur)
• Ou (opérateur)
• Pas (not x)
5.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)
160
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
valeur_bool
Une valeur booléenne
Booléen
Oui
valeur_vrai
La valeur à renvoyer si valeur_bool N'importe lequel
est vraie
Oui
valeur_faux
La valeur à renvoyer si valeur_bool N'importe lequel
est fausse
Oui
Remarques
•
•
valeur_vrai et valeur_faux peuvent combiner les types de données.
Vous pouvez imbriquer les conditions Si en remplaçant valeur_faux 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
• Si...Alors...Sinon
5.1.9.13 NuméroDeLigne
Description
Renvoie le numéro de ligne dans un tableau
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeLigne()
Remarques
La numérotation des lignes d'un tableau commence par l'en-tête, qui est la ligne 1.
161
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
NuméroDeLigne() renvoie 2 lorsque la fonction apparaît au niveau de la deuxième ligne d'un tableau.
5.1.9.14 NomDe
Description
Renvoie le nom d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomDe(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Remarques
La fonction NomDe apparaît dans les en-têtes de colonne et de ligne des rapports ;.
Exemples
NomDe([Date de réservation]) renvoie "Date de réservation".
5.1.9.15 AucunFiltre
Description
Ignore les filtres lors du calcul d'une valeur
Groupe de fonctions
Divers
Syntaxe
type_saisie AucunFiltre(obj[;Tous|Explorer])
162
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
obj
Tout objet rapport
Objet rapport Oui
Tout|Explora- •
tion
•
•
Aucun mot clé spécifié : ignorer les filtres de rapport Mot clé
et de bloc
Tout : ignorer tous les filtres
Exploration : ignorer les filtres de rapport et d'exploration
Obligatoire
Non
Remarques
•
•
AucunFiltre(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 AucunFiltre(ob
jet;Exploration) est appliqué.
Exemples
Lorsque AucunFiltre(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.
AucunFiltre(Somme([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.
AucunFiltre(Somme([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].
5.1.9.16 NombreDePages
Description
Renvoie le nombre de pages dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier NombreDePages()
Exemples
NombreDePages() renvoie 2 si le rapport contient deux pages.
163
2011-04-14
Fonctions, opérateurs et mots clés
5.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;
5.1.9.18 Précédent
Description
Renvoie une valeur précédente d'un objet
Groupe de fonctions
Divers
Syntaxe
type_entrée Précédent(dimension|indicateur|Auto[;(réinit_dims)][;décalage][;NonNul])
164
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
dimenLa dimension ou l'indicateur dont la valeur précédente Dimension, indi- Oui
sion|indica- est renvoyée par la fonction, ou le mot clé Auto
cateur ou mot
teur|Auto
clé
dimensions_redéfinies
La liste des dimensions utilisées pour réinitialiser le
calcul
Liste Dimension Non
offset
Indique la valeur de dimension ou d'indicateur Entier
présentant un décalage de lignes avant la ligne actuelle
Non (la valeur
par défaut est 1)
NonNul
Demande à la fonction de renvoyer la première valeur Mot clé
non nulle à partir du décalage
Non
Remarques
•
•
•
•
•
•
•
•
•
•
•
•
•
La valeur par défaut d'offset est 1. Précédent([Chiffre d'affaires];1) et Précédent
([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 Précédent.
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.
Précédent 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 Précédent.
Si Précédent 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.
Précédent ignore les ruptures en cas de placement à l'extérieur d'un en-tête ou d'un pied de page
de rupture.
Précédent renvoie la valeur de l'instance précédente du pied de page en cas de placement dans
un pied de page de rupture.
Précédent est réinitialisé dans chaque section de rapport.
Lorsqu'elle est utilisée dans un tableau croisé, l'option Précédent ne traite pas la dernière valeur
d'une ligne comme la première valeur de la ligne suivante.
Exemples
Précédent([Pays)];1) renvoie les valeurs suivantes dans le tableau qui suit :
Pays
165
Chiffre d'affaires
Précédent
2011-04-14
Fonctions, opérateurs et mots clés
US
5 000 000
Royaume-Uni
2 000 000
Etats-Unis
France
2 100 000
Royaume-Uni
Précédent([Chiffre d'affaires)]) renvoie les valeurs suivantes dans le tableau qui suit :
Pays
Chiffre d'affaires
Précédent
US
5 000 000
Royaume-Uni
2 000 000
5 000 000
France
2 100 000
2 000 000
Précédent([Chiffre d'affaires];([Pays]) renvoie les valeurs suivantes dans le tableau qui
suit :
Pays
Région
Chiffre d'affaires
Etats-Unis
Nord
5 000 000
Sud
7 000 000
Nord
3 000 000
Sud
4 000 000
Royaume-Uni
Précédent
5 000 000
3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau croisé qui suit :
2004
Précédent
2005
Précédent
US
5 000 000
6 000 000
5 000 000
Royaume-Uni
2 000 000
2 500 000
2 000 000
France
3 000 000
2 000 000
3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau qui suit avec
une rupture sur [Pays] :
166
Pays
Région
Chiffre d'affaires
Etats-Unis
Nord
5 000 000
Sud
7 000 000
Précédent
5 000 000
2011-04-14
Fonctions, opérateurs et mots clés
Etats-Unis
12 000 000
Pays
Région
Chiffre d'affaires
Précédent
Royaume-Uni
Nord
3 000 000
7 000 000
Sud
4 000 000
3 000 000
7 000 000
12 000 000
Royaume-Uni
Précédent([Chiffre d'affaires]);2;NonNul) renvoie les valeurs suivantes dans le tableau
qui suit :
Année
Trimestre
Chiffre d'affaires
2008
T1
500
2008
T2
2008
T3
400
500
2008
T4
700
500
2008
T1
300
400
2008
T2
700
2008
T3
300
2008
T4
200
Précédent
300
2*Précédent(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Rubriques associées
• Comparaison de valeurs à l'aide de la fonction Précédent
• Opérateur Auto
5.1.9.19 ValeurRéf
Description
Renvoie la valeur de référence d'un objet rapport lorsque le suivi de données est activé
167
2011-04-14
Fonctions, opérateurs et mots clés
Groupe de fonctions
Divers
Syntaxe
type_entrée ValeurRéf(obj)
Exemples
ValeurRéf([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.
ValeurRéf([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.
5.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
Description
Type
Obligatoire
indicateur|dé- Tout indicateur ou détail d'une dimension dans le bloc
tail
Indicateur ou Oui
détail
dim_découpage
Les dimensions qui donnent le contexte du calcul
Liste Dimen- Oui
sion
offset
Indique la valeur de l'indicateur ou du détail qui est Entier
de offset lignes supprimées de la ligne actuelle
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.
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.
•
168
Une dimension utilisée comme maître de section peut être spécifiée en tant que dimension de
découpage.
2011-04-14
Fonctions, opérateurs et mots clés
•
•
•
•
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)
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Dupont
2 000
2007
T3
Martin
1 500
2007
T4
Harris
3 000
2008
T1
Durand
4 000
1 000
2008
T2
Dupont
3 400
2 000
2008
T3
Martin
2 000
1 500
2008
T4
Harris
1 700
3 000
Rubriques associées
• #CALCUL
• Comparaison de valeurs à l'aide de la fonction ValeurRelative
5.1.9.21 NomRapport
Description
Renvoie le nom d'un rapport
Groupe de fonctions
Divers
Syntaxe
Chaîne NomRapport()
169
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
Si NomRapport() est placé dans un rapport appelé "Rapport des ventes", alors "Rapport des ventes"
est renvoyé.
5.1.9.22 IndexationDesLignes
Description
Renvoie le numéro d'une ligne
Groupe de fonctions
Divers
Syntaxe
entier IndexationDesLignes()
Remarques
•
•
La numérotation des lignes commence à 0.
IndexationDesLignes renvoie #VALEURMULTI lorsqu'elle est placée dans l'en-tête ou le pied
de page d'un tableau.
Exemples
IndexationDesLignes renvoie 0 lorsqu'elle apparaît sur la première ligne d'un tableau.
5.1.9.23 NomUniqueDe
Description
Renvoie le nom unique d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomUniqueDe(obj)
170
2011-04-14
Fonctions, opérateurs et mots clés
Entrée
Paramètre
Description
Type
Obligatoire
obj
Tout objet rapport
Objet rapport
Oui
Exemples
NomUniqueDe([Date de réservation]) renvoie "Date de réservation".
5.2 Opérateurs de fonction et de formule
Les opérateurs lient les différents composants dans une formule. Les formules peuvent contenir des
opérateurs mathématiques, conditionnels, logiques, spécifiques à une fonction ou de syntaxe avancée.
5.2.1 Opérateurs mathématiques
Les opérateurs mathématiques paraissent familiers car ils correspondent aux opérations arithmétiques
de base. Les opérateurs d'addition (+), de soustraction (-), de multiplication (*) et de division (/) permettent
d'effectuer des opérations mathématiques dans une formule. La formule [Chiffre d'affaires]
- [Coût des ventes] contient un opérateur mathématique, la soustraction en l'occurrence.
Remarque :
Lorsqu'il est utilisé avec des chaînes de caractères, l'opérateur "+" devient un opérateur de concaténation
de chaînes. Autrement dit, il permet de joindre des chaînes de caractères. Par exemple, la formule
"Jean" + " Durand" renvoie "Jean Durand".
5.2.2 Opérateurs conditionnels
Les opérateurs conditionnels déterminent le type de comparaison à effectuer entre des valeurs.
171
Opérateur
Description
=
Egal à
>
Supérieur à
<
Inférieur à
2011-04-14
Fonctions, opérateurs et mots clés
Opérateur
Description
>=
Supérieur ou égal à
<=
Inférieur ou égal à
<>
Différent de
Vous utilisez les opérateurs conditionnels avec la fonction Si, comme dans :
If [Revenue]>10000 Then "High" Else "Low"
qui renvoie "Elevé" pour toutes les lignes où le revenu est supérieur ou égal à 10 000 et "Bas" pour
toutes les autres lignes.
5.2.3 Opérateurs logiques
Les opérateurs logiques sont Et, Ou, Pas, Entre et DansListe. Les opérateurs logiques sont utilisés
dans des expressions booléennes qui renvoient Vrai ou Faux.
5.2.3.1 And (opérateur)
Description
L'opérateur Et relie des valeurs booléennes. Si toutes les valeurs booléennes reliées par Et renvoient
Vrai, la combinaison de toutes les valeurs renvoie également Vrai.
Syntaxe
valeur_bool Et valeur_bool [Et valeur_bool...]
Exemples
Si [Lieu de séjour] = "Bahamas Beach" Et [Chiffre d'affaires]>100 000 Alors
"CA élevé de Bahamas" renvoie "Revenu élevé Bahamas" si [Lieu de séjour] = "Bahamas Beach"
Et [Chiffres d'affaires]>100 000.
5.2.3.2 Ou (opérateur)
172
2011-04-14
Fonctions, opérateurs et mots clés
Description
L'opérateur Ou relie les valeurs booléennes. Si une valeur booléenne reliée par Ou renvoie Vrai, la
combinaison de toutes les valeurs renvoie également Vrai.
Syntaxe
valeur_bool Ou valeur_bool [Ou valeur_bool...]
Exemples
Si [Lieu de séjour] = "Bahamas Beach" Ou [Lieu de séjour]="Hawaiian Club"
Alors "Etats-Unis" Sinon "France" renvoie "Etats-Unis" si [Lieu de séjour]="Bahamas Beach"
ou "Hawaiian Club", et renvoie "France" dans les autres cas.
5.2.3.3 Pas (not x)
Description
L'opérateur Non renvoie l'inverse d'une valeur booléenne.
Syntaxe
booléen Non(valeur_bool)
Exemples
Si Non([Pays] = "Etats-Unis") Alors "Pas Etats-Unis" renvoie "Pas Etats-Unis" si
[Pays] a une valeur autre que "Etats-Unis".
5.2.3.4 Opérateur Entre
Description
L'opérateur Entre détermine si une variable est comprise entre deux valeurs.
Syntaxe
booléen Entre(première_valeur;seconde_valeur)
Remarques
•
•
Vous pouvez utiliser Entre avec la fonction Si et l'opérateur Où.
La modification des paramètres régionaux du document peut avoir un impact sur le résultat renvoyé
par l'opérateur Entre.
Exemples
Si [Chiffre d'affaires] Entre(800000;900000) Alors "Revenu moyen" renvoie "Revenu
moyen" si [Chiffres d'affaires] est compris entre 800 000 et 900 000.
173
2011-04-14
Fonctions, opérateurs et mots clés
[Chiffre d'affaires] Entre (10000;20000) renvoie Vrai si le chiffre d'affaires est compris
entre 10 000 et 20 000.
Si ([Chiffre d'affaires] Entre (200000;500000);"Revenu moyen";"Revenu
bas/élevé") renvoie "Revenu moyen" si [Chiffre d'affaires] est égal à 300 000.
Rubriques associées
• Si...Alors...Sinon
• Opérateur Où
5.2.3.5 DansListe (opérateur)
Description
L'opérateur DansListe détermine si une valeur fait partie d'une liste de valeurs.
Syntaxe
booléen valeur_test DansListe(liste_valeurs)
Remarques
C'est la combinaison de valeur_test et de DansListe qui renvoie une valeur booléenne, et non
DansListe seul.
Exemples
Si Non ([Pays] DansListe("Angleterre";"Ecosse";"Pays de Galles")) Alors "Pas
Grande Bretagne" Sinon "Grande Bretagne" renvoie "Pas Grande Bretagne" si [Pays] n'est
pas égal à "Angleterre", "Ecosse" ou "Pays de Galles", et renvoie "Grande Bretagne" dans le cas
contraire.
Si [Lieu de séjour] DansListe("Bahamas Beach";"Hawaiian Club") Alors "Lieu
de séjour Etats-Unis" renvoie "Lieu de séjour Etats-Unis" si [Lieu de séjour] est égal à "Bahamas
Beach" ou "Hawaiian Club".
Rubriques associées
• Si...Alors...Sinon
• Opérateur Où
5.2.4 Opérateurs spécifiques à la fonction
174
2011-04-14
Fonctions, opérateurs et mots clés
Certaines fonctions peuvent se servir d'opérateurs particuliers comme arguments. Par exemple, la
fonction Précédent peut avoir pour argument l'opérateur Lui-même.
Toutes les fonctions entourent les arguments avec ) et (. Les fonctions qui acceptent plusieurs
paramètres utilisent ; pour les séparer.
5.2.4.1 Opérateur Tout
L'opérateur Tout invite la fonction AucunFiltre à ignorer tous les filtres ou la fonction Nombre à
compter toutes les valeurs, y compris les doublons.
Rubriques associées
• Nombre
• Opérateurs Distinct/Tout
• AucunFiltre
• Opérateurs Tout/Exploration
5.2.4.2 Opérateurs Tout/Exploration
Description
Les opérateurs Tout/Exploration détermine quels sont les filtres ignorés par la fonction Aucun
Filtre.
•
•
•
Non spécifié : AucunFiltre ignore les filtres de rapport et de bloc
Tout : AucunFiltre ignore tous les filtres
Exploration : AucunFiltre ignore les filtres de rapport et les filtres d'exploration
5.2.4.3 Opérateurs Derniers/Premiers
Description
Les opérateurs Derniers/Premiers indiquent à la fonctionClassement de classer par ordre croissant
ou décroissant.
• Premiers : établit un classement par ordre décroissant
• Derniers : établit un classement par ordre croissant
175
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
Classement([Chiffres d'affaires];([Pays]);Premiers classe les pays par ordre décroissant
de chiffre d'affaires.
Rubriques associées
• Classement
5.2.4.4 Opérateur Rupture
Description
L'opérateur Rupture invite la fonction Pourcentage à prendre en compte les ruptures de tableau.
Exemples
La formule Pourcentage([Chiffre d'affaires]) donne le résultat indiqué dans le tableau
suivant (les pourcentages sont calculés sur le chiffre d'affaires total du bloc) :
Année
Trimestre
Chiffre d'affaires
Pourcentage
2005
T1
10 000
10 %
2005
T2
20 000
20 %
2006
T1
30 000
30 %
2006
T2
40 000
40 %
La formule Pourcentage([Chiffre d'affaires];Rupture) donne le résultat indiqué dans le
tableau suivant (les pourcentages sont calculés sur le chiffre d'affaires total de chaque partie du bloc) :
176
Année
Trimestre
Chiffre d'affaires
Pourcentage
2005
T1
10 000
33,3 %
2005
T2
20 000
66,6 %
2006
T1
30 000
42,9%
2006
T2
40 000
57,1%
2011-04-14
Fonctions, opérateurs et mots clés
Rubriques associées
• Pourcentage
5.2.4.5 Opérateurs Distinct/Tout
Les opérateurs Distinct/Tout indiquent à la fonction Nombre de compter les valeurs distinctes
uniquement ou toutes les valeurs.
Exemples
Nombre([Chiffre d'affaires];Distinct) renvoie 3 si [Chiffre d'affaires] a les valeurs (5;5;6;4).
Nombre([Chiffre d'affaires];Tout) renvoie 4 si [Chiffre d'affaires] a les valeurs (5;5;6;4).
Rubriques associées
• Nombre
5.2.4.6 Opérateur InclureVide
Description
L'opérateur InclureVide invite certaines fonctions d'agrégat à inclure des valeurs vides dans les
calculs.
Exemples
Moyenne([Chiffre d'affaires];InclureVide) renvoie 3 si [Chiffre d'affaires] a les valeurs
(5;3;<vide>;4).
Rubriques associées
• Moyen
• Nombre
• MoyenneCumulative
• NombreCumulatif
177
2011-04-14
Fonctions, opérateurs et mots clés
5.2.4.7 Opérateur Index
Description
L'opérateur Index indique aux fonctions RéponseUtilisateur et RéponseUtilisateurValeur
DeRéférence de renvoyer la clé primaire de base de données de la réponse d'invite.
Rubriques associées
• RéponseUtilisateur
• RéponseUtilisateurValeurRéf
5.2.4.8 Opérateur Linéaire
Description
L'opérateur Linéaire stipule que la fonction Interpolation doit utiliser la régression linéaire avec
l'interpolation des moindres carrés pour donner les valeurs d'indicateur manquantes.
La régression linéaire avec interpolation des moindres carrés calcule les valeurs manquantes en
calculant une équation de droite de type f(x) = ax + b qui passe, le plus précisément possible, par toutes
les valeurs disponibles de l'indicateur.
Rubriques associées
• Interpolation
5.2.4.9 Opérateur NonNul
Description
L'opérateur NonNul invite la fonction Précédent à ignorer les valeurs nulles.
Lorsque Précédent est utilisé avec NonNul, il renvoie la première valeur non nulle de l'objet, en
remontant à partir des lignes offset de la cellule située avant la ligne actuelle.
Rubriques associées
• Précédent
178
2011-04-14
Fonctions, opérateurs et mots clés
5.2.4.10 Opérateur PasSurSaut
Description
L'opérateur PasSurSaut invite la fonction Interpolation à ignorer les ruptures de section et de
bloc.
Rubriques associées
• Interpolation
5.2.4.11 Opérateur PointAPoint
Description
L'opérateur PointAPoint stipule que la fonction Interpolation doit utiliser l'interpolation de point
à point pour donner les valeurs d'indicateur manquantes.
L'interpolation de point à point calcule les valeurs manquantes en calculant une équation de droite de
type f(x) = ax + b qui passe par les deux valeurs adjacentes à la valeur manquante.
Rubriques associées
• Interpolation
5.2.4.12 Opérateurs Ligne/Col
Description
Vous pouvez utiliser les opérateurs Ligne/Col pour définir le sens du calcul des fonctions suivantes :
Pourcentage, MoyenneCumulative, NombreCumulatif, MaxCumulatif, MinCumulatif,
ProduitCumulatif, SommeCumulative.
Remarques
L'opérateur Ligne calcule chaque valeur de la ligne sous la forme d'un pourcentage de la valeur totale
de toutes les lignes du contexte d'incorporation. L'opérateur Col calcule chaque valeur de la colonne
sous la forme d'un pourcentage de la valeur totale de toutes les colonnes du contexte d'incorporation.
179
2011-04-14
Fonctions, opérateurs et mots clés
Dans un tableau croisé, par défaut, la valeur de chaque cellule est calculée sous la forme d'un
pourcentage de la valeur totale du tableau croisé. L'opérateur Ligne calcule les valeurs des lignes
sous la forme de pourcentages de la valeur totale de la ligne. L'opérateur Col calcule les valeurs des
colonnes sous la forme de pourcentages de la valeur totale de la colonne.
Exemples
Dans un tableau croisé, Pourcentage([Indicateur]) donne le résultat suivant :
Indicateur
Pourcentage
Indicateur
Pourcentage
100
10 %
500
50 %
200
20 %
200
20 %
Pourcentage([Indicateur];Ligne) donne le résultat suivant :
Indicateur
Pourcentage
Indicateur
Pourcentage
100
16,7 %
500
83,3 %
200
50 %
200
50 %
Pourcentage([Indicateur];Col) donne le résultat suivant :
Indicateur
Pourcentage
Indicateur
Pourcentage
100
33,3 %
500
83,3 %
200
66,6 %
200
16,7 %
L'opérateur Ligne calcule l'agrégat cumulatif par ligne. L'opérateur Col calcule l'agrégat cumulatif par
colonne.
Dans un tableau croisé, SommeCumulative([indicateur]) ou SommeCumulative([indica
teur];Ligne) donne le résultat suivant :
Indicateur
SommeCumulative
Indicateur
SommeCumulative
100
100
200
300
400
700
250
950
Dans un tableau croisé, SommeCumulative([Indicateur];Col) donne le résultat suivant :
Indicateur
180
SommeCumulative
Indicateur
SommeCumulative
2011-04-14
Fonctions, opérateurs et mots clés
100
100
200
700
400
500
250
950
Rubriques associées
• Pourcentage
• MoyenneCumulative
• NombreCumulatif
• MaxCumulatif
• MinCumulatif
• ProduitCumulatif
• SommeCumulative
5.2.4.13 Opérateur Auto
Description
Fait référence à la fonction Précédent pour la cellule précédente si celle-ci ne contient pas d'objet de
rapport.
Exemples
5 +
Précédent(Auto) renvoie la séquence 5, 10, 15, 20, 25, 30...
1 + 0,5 * Précédent(Auto) renvoie la séquence 1, 1,5, 1,75, 1,88...
Rubriques associées
• Précédent
5.2.4.14 Opérateur Où
Description
L'opérateur Où limite les données utilisées pour calculer un indicateur.
Exemples
La formule Moyenne ([Chiffre d'affaires]) Où ([Pays] = "USA") calcule les ventes
moyennes où le pays est "USA".
181
2011-04-14
Fonctions, opérateurs et mots clés
La formule Moyenne ([Chiffre d'affaires]) Où ([Pays] = "USA" Ou [Pays] = "Fra
nce") calcule les ventes moyennes où le pays est "USA" ou "France".
La formule [Chiffre d'affaires] Où (Pas ([Pays] DansListe ("USA"; France)))
calcule le chiffre d'affaires pour les pays autres que les Etats-Unis et la France.
La variable [Chiffre d'affaires élevé] est dotée de la formule [Chiffre d'affaires] Où [Chiffre
d'affaires > 500 000]. Lorsque la variable [Chiffre d'affaires élevé] est placée dans un bloc, elle
renvoie le chiffre d'affaires lorsque sa valeur est supérieure à 500 000 ou bien aucune valeur. Lorsque
la variable est placée dans le pied de la colonne [Chiffre d'affaires élevé], la formule Moyenne
([Chiffre d'affaires élevé]) renvoie la moyenne des chiffre d'affaires supérieurs à 500 000.
Rubriques associées
• And (opérateur)
• Opérateur Entre
• DansListe (opérateur)
• Ou (opérateur)
• Pas (not x)
5.2.5 Opérateurs de syntaxe avancée
Vous spécifiez explicitement les contextes d'entrée et de sortie avec les opérateurs contextuels. Le
tableau suivant répertorie les opérateurs contextuels :
Opérateur
Description
Dans
Spécifie une liste explicite de dimensions à utiliser
dans le contexte
PourChaque
Ajoute des dimensions au contexte par défaut
PourTout
Supprime des dimensions du contexte par défaut
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte par défaut contient de
nombreuses dimensions. Il est souvent plus facile d'effectuer un ajout ou un retrait du contexte avec
les opérateurs PourTout et PourChaque que de spécifier explicitement la liste avec Dans.
5.2.5.1 Opérateur contextuel Dans
L'opérateur contextuel Dans spécifie les dimensions de façon explicite dans un contexte.
182
2011-04-14
Fonctions, opérateurs et mots clés
Exemple : Utilisation de l'opérateur Dans pour spécifier les dimensions dans un contexte
Dans cet exemple, vous avez un rapport présentant les valeurs Année et Revenu des ventes. Votre
fournisseur de données contient aussi l'objet Trimestre, mais vous n'incluez pas cette dimension dans
le bloc. Vous choisissez plutôt d'inclure une autre colonne qui affiche le revenu maximal par trimestre
de chaque année. Votre rapport se présente comme suit :
Année
Revenu des ventes
Revenu trimestriel max.
2001
8 096 123,60 €
2 660 699,50 €
2002
13 232 246,00 €
4 186 120,00 €
2003
15 059 142,80 €
4 006 717,50 €
Vous pouvez voir d'où proviennent les valeurs de la colonne Revenu trimestriel maximum en examinant
ce bloc avec un bloc incluant la dimension Trimestre :
183
2011-04-14
Fonctions, opérateurs et mots clés
Année
Trimestre
Revenu des ventes
2001
T1
2 660 699,50 €
2001
T2
2 279 003,00 €
2001
T3
1 367 841,00 €
2001
T4
1 788 580,00 €
Max. :
2 660 699,50 €
Année
Année
Trimestre
Revenu des ventes
T1
3 326 172,00 €
T2
2 840 651,00 €
T3
2 879 303,00 €
T4
4 186 120,00 €
Max. :
4 186 120,00 €
Trimestre
Revenu des ventes
T1
3 742 989,00 €
T2
4 006 717,50 €
T3
3 953 395,00 €
T4
3 356 041,00 €
Max. :
4 006 717,50 €
La colonne Revenu trimestriel maximum présente le revenu trimestriel le plus élevé de chaque année.
Par exemple, T4 présentant le revenu le plus élevé pour 2002, la colonne Revenu trimestriel maximum
présente le revenu de T4 sur la ligne affichant les valeurs de 2002.
Avec l'opérateur Dans, la formule pour Revenu trimestriel maximum est
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Cette formule permet de calculer le revenu des ventes maximal pour chaque combinaison
(Année,Trimestre), puis d'indiquer ce chiffre par année.
Remarque :
Comme le contexte de sortie par défaut du bloc est Année, vous n'avez pas besoin de spécifier de
façon explicite le contexte de sortie dans cette formule.
184
2011-04-14
Fonctions, opérateurs et mots clés
5.2.5.2 Opérateur contextuel PourChaque
L'opérateur PourChaque ajoute des dimensions à un contexte.
Exemple : Utilisation de l'opérateur PourChaque pour ajouter des dimensions à un contexte
Le tableau suivant présente le revenu maximal de chaque trimestre dans un rapport qui contient la
dimension Trimestre, mais ne l'inclut pas dans le bloc :
Année
Revenu des ventes
Revenu trimestriel max.
2001
8 096 123,60
2 660 699,50
2002
13 232 246,00
4 186 120,00
2003
15 059 142,80
4 006 717,50
Il est possible de créer une formule pour la colonne Revenu trimestriel maximum n'incluant pas
l'opérateur PourChaque :
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Si vous optez pour l'opérateur contextuel PourChaque, vous pouvez obtenir le même résultat avec la
formule suivante :
Max ([Sales Revenue] ForEach ([Quarter])) In ([Year])
Pourquoi ? Parce que la dimension Année est le contexte d'entrée par défaut du bloc. En vous servant
de l'opérateur PourChaque, vous ajoutez la dimension Trimestre au contexte, en donnant le contexte
d'entrée ([Année];[Trimestre]).
5.2.5.3 Opérateur contextuel PourTout
L'opérateur contextuel PourTout supprime les dimensions d'un contexte.
Exemple : Utilisation de l'opérateur PourTout pour supprimer les dimensions d'un contexte
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes, et vous
voulez ajouter une colonne qui présente le revenu total de chaque année, comme indiqué dans le
bloc suivant :
185
2011-04-14
Fonctions, opérateurs et mots clés
Pour que le total de chiffre d'affaires par année soit effectué, le contexte d'entrée doit être (Année) ;
par défaut, il s'agit de (Année; Trimestre). Par conséquent, vous pouvez supprimer Trimestre du
contexte d'entrée en spécifiant PourTout ([Trimestre]) dans la formule, comme suit :
Sum([Sales Revenue] ForAll ([Quarter]))
Sachez que l'opérateur Dans vous permet d'aboutir au même résultat ; dans ce cas, la formule est :
Sum([Sales Revenue] In ([Year]))
Cette version de la formule spécifie de façon explicite Année comme contexte, au lieu de supprimer
Trimestre pour conserver Année.
5.2.6 Opérateurs définis
Les opérateurs agissent sur les membres de données hiérarchiques.
5.2.6.1 Opérateur de plage
Description
L'opérateur de plage (:) renvoie un ensemble de membres qui comprend deux membres d'un même
niveau et tous ceux qui se trouvent entre les deux.
Syntaxe
premier_membre:dernier_membre
186
2011-04-14
Fonctions, opérateurs et mots clés
Exemples
[Géographie]&[EU].[Californie].[Los Angeles]:[Géographie]&[EU].[Califor
nie].[San Francisco] renvoie [Los Angeles], [San Diego], [San Francisco] si les membres de
ce niveau viennent dans l'ordre ... [Los Angeles], [San Diego], [San Francisco]...
Somme([Chiffre d'affaires];{[Géographie]&[EU].[Californie].[Los Angeles]:[Géo
graphie]&[EU].[Californie].[San Francisco]}) renvoie le chiffre d'affaires total pour Los
Angeles, San Diego et San Francisco.
5.3 Mots clés de la syntaxe avancée
Les mots clés de la syntaxe avancée constituent une sorte de "notation abrégée" qui vous permet de
faire référence à des dimensions en syntaxe avancée sans spécifier de façon explicite ces dimensions.
Cette opération garantit des rapports toujours optimaux ; si les formules ne contiennent pas de références
figées dans le code à des dimensions, elles restent valables même en cas d'ajout ou de suppression
de dimensions dans le rapport.
Il existe cinq mots clés de syntaxe avancée : Rapport, Section, Rupture, Bloc et Corps.
5.3.1 Mot clé Bloc
La table suivante décrit les dimensions référencées par le mot-clé Bloc, en fonction de sa place dans
un rapport : le mot-clé Bloc rassemble souvent les mêmes données que le mot-clé Section. La différence
entre les deux réside dans le fait que Bloc tient compte des filtres placés sur un bloc alors que Section
les ignore.
187
Placé dans…
Fait référence à…
Un bloc
Toutes les données du bloc, sans tenir compte
des ruptures, en respectant les filtres
Une rupture de bloc (en-tête ou pied)
Toutes les données du bloc, sans tenir compte
des ruptures, en respectant les filtres
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Non applicable
A l'extérieur des blocs ou sections
Non applicable
2011-04-14
Fonctions, opérateurs et mots clés
Exemple : Mot clé Bloc
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. Le rapport
contient une section basée sur Année. Le bloc est filtré de façon à exclure les troisième et quatrième
trimestres.
La colonne Moyenne annuelle contient la formule
Average([Sales revenue] In Section)
et la colonne Moyenne du premier semestre contient la formule
Average ([Sales revenue]) In Block
Vous pouvez voir comment le mot clé Bloc prend en compte le filtre sur le bloc.
5.3.2 Mot clé Corps
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Corps, selon son
emplacement dans un rapport :
188
Placé dans…
Fait référence à…
Un bloc
Toutes les données du bloc
Une rupture de bloc (en-tête ou pied)
Toutes les données du bloc
2011-04-14
Fonctions, opérateurs et mots clés
Placé dans…
Fait référence à…
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Toutes les données de la section
A l'extérieur des blocs ou sections
Toutes les données du rapport
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes, avec une
rupture sur Année. Le rapport contient une section basée sur Année et une rupture au niveau de
Trimestre.
Année
Trimestre
Revenu des ventes
Corps
2001
T1
2 660 700
2 660 699,5
T2
2 279 003
2 279 003
T3
1 367 841
1 367 840,7
T4
1 788 580
1 788 580,4
2001
8 096 123,6
La colonne Corps contient la formule
Sum ([Sales Revenue]) In Body
Les totaux de la colonne Corps sont égaux à ceux de la colonne Revenu des ventes, car le mot clé
Corps fait référence aux données du bloc. Si vous deviez supprimer l'objet Mois, les chiffres de la
colonne Bloc changeraient pour correspondre aux chiffres modifiés de la colonne Revenu des ventes.
Si vous deviez placer la formule dans le pied de page du rapport, elle renverrait le revenu total pour
le bloc.
5.3.3 Mot clé Saut
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Saut, selon son
emplacement dans un rapport :
189
Placé dans…
Fait référence à…
Un bloc
Toutes les données dans la partie du bloc délimité
par un saut
Un saut de bloc (en-tête ou pied)
Toutes les données dans la partie du bloc délimité
par un saut
2011-04-14
Fonctions, opérateurs et mots clés
Placé dans…
Fait référence à…
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Non applicable
A l'extérieur des blocs ou sections
Non applicable
Exemple : Mot clé Saut
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes :
Année
Trimestre
Revenu des ventes
Total Saut
2001
T1
2 660 700 €
8 096 124 €
T2
2 279 003 €
8 096 124 €
T3
1 367 841 €
8 096 124 €
T4
1 788 580 €
8 096 124 €
Le rapport comporte un saut au niveau de Année. La colonne Total saut contient la formule :
Sum ([Sales Revenue]) In Break
Sans le mot clé Saut, cette colonne dupliquerait les chiffres de la colonne Revenu des ventes, car le
contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
5.3.4 Mot clé Rapport
Le tableau ci-après décrit les données auxquelles fait référence le mot clé Rapport, selon son
emplacement dans un rapport :
190
Placé dans…
Fait référence à…
Un bloc
Toutes les données du rapport
Une rupture de bloc (en-tête ou pied)
Toutes les données du rapport
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Toutes les données du rapport
A l'extérieur des blocs ou sections
Toutes les données du rapport
2011-04-14
Fonctions, opérateurs et mots clés
Exemple : Mot clé Rapport
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. Le rapport
contient une colonne, Rapport total, qui affiche le total de tous les revenus du rapport.
La formule pour la colonne Rapport total est Somme([Chiffre d'affaires]) Dans Rapport. Sans le mot
clé Rapport, cette colonne dupliquerait les chiffres de la colonne Revenu des ventes, car le contexte
de sortie par défaut serait utilisé ([Année];[Trimestre]).
5.3.5 Mot clé Section
Le tableau ci-après décrit les données auxquelles fait référence le mot clé Section, selon son
emplacement dans un rapport :
Placé dans…
Fait référence à…
Un bloc
Toutes les données de la section
Une rupture de bloc (en-tête ou pied)
Toutes les données de la section
Une section (en-tête, pied ou à l'extérieur d'un
bloc)
Toutes les données de la section
A l'extérieur des blocs ou sections
Non applicable
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes.
191
2011-04-14
Fonctions, opérateurs et mots clés
Le rapport contient une section basée sur Année. La colonne Total section contient la formule :
Sum ([Sales Revenue]) In Section
Les chiffres de la colonne Total section représentent le revenu total pour 2001, car la rupture de
section se produit au niveau de l'objet Année. Sans le mot clé Section, cette colonne dupliquerait les
chiffres de la colonne Revenu des ventes car le contexte de sortie par défaut ([Année];[Trimestre])
serait utilisé.
5.4 Arrondir et tronquer des nombres
Plusieurs fonctions contiennent un paramètre permettant de déterminer le niveau auquel la fonction
arrondit ou tronque la valeur qu'elle renvoie. Ce paramètre accepte un nombre entier supérieur, égal
ou inférieur à 0. Le tableau ci-dessous explique comment les nombres sont arrondis ou tronqués dans
les différents cas :
192
2011-04-14
Fonctions, opérateurs et mots clés
Paramètre
>0
Description
La fonction arrondit/tronque à <paramètre> décimales.
Exemples :
Arrondi(3.13;1) renvoie 3,1
Arrondi(3.157;2) renvoie 3,16
0
La fonction arrondit/tronque à l'entier le plus proche.
Exemples :
Tronquer(3.7;0) renvoie 3
Tronquer(4.164;0) renvoie 4
<0
La fonction arrondit/tronque à la dizaine (paramètre = -1), à la centaine (paramètre
= -2), au millier (paramètre = -3), etc., le plus proche.
Exemples :
Arrondi(123.76;-1) renvoie 120
Arrondi(459.9;-2) renvoie 500
Tronquer(1600;-3) renvoie 1000
Remarque :
Les nombres sont représentés de manière interne comme doubles et sont précis à seize chiffres près.
Rubriques associées
• Arrondi
• Truncate
• ConvertirEnEuro
• ConvertirDepuisEuro
• ErreurEuroParArrondi
• ErreurEuroVersArrondi
5.5 Référence à des membres et des ensembles de membres des hiérarchies
Pour faire référence à des membres et des ensembles de membres dans les fonctions, utilisez la
syntaxe [hiérarchie]&chemin.fonction. Les parties chemin et fonction sont facultatives.
193
2011-04-14
Fonctions, opérateurs et mots clés
Dans chemin, faites référence à chaque membre entre crochets en séparant chacun par un point. Les
noms des membres et les niveaux sont sensibles à la casse.
Remarque :
Vous utilisez des ensembles de membres pour remplacer le contexte de calcul par défaut pour une
hiérarchie. Dans les fonctions qui acceptent les ensembles de membres, placez {} autour de l'ensemble
de membres.
Vous faites référence aux plages des membres utilisant un deux-points (:) entre le membre de début
et le membre de fin, et comportant le chemin d'accès complet spécifié pour chaque membre. Une plage
inclut tous les membres du même niveau que celui des membres choisis.
Voici un exemple de syntaxe : [Hiérarchie des ventes]&[Type_Client].[ENTERPRISE];[Gra
nde].[Nancy Davolio] : [Hiérarchie des ventes]&[Type_Client].[ENTERPRISE];[Gra
nde].[Andrew Smith].
Exemple : Référence à des membres et des ensembles de membres
Vous disposez de la hiérarchie suivante :
Hiérarchie Ventes
Montant commande
Client_Type
277 290 434
ENTERPRISE
180 063 361
Grande
GENERAL
•
•
•
•
•
194
113 905 997
Nancy Davolio
44 855 689
Janet Leverling
44 050 308
Andrew Smith
30 000 000
91 157 363
[Hiérarchie Ventes]&[Client_Type].[ENTREPRISE];[Grande].Enfants fait référence
aux membres [Nancy Davolio], [Janet Leverling] et [Andrew Smith].
Somme([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTER
PRISE].[Grande].enfants}) renvoie 113 905 997 (la somme de l'indicateur des trois membres
enfant).
[Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Janet Leverling]
fait référence au membre [Janet Leverling].
Somme([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTER
PRISE].[Grande].[Janet Leverling];[Hiérarchie Ventes]&[Client_Type].[EN
TERPRISE].[Grande].[Nancy Davolio]}) renvoie 88 905 997 (la somme de l'indicateur
des deux membres).
[Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Nancy Davo
lio]:[Hiérarchie des ventes]&[Type_Client].[ENTERPRISE].[Grande].[Andrew
Smith] fait référence aux membres [Nancy Davolio], [Janet Leverling] et [Andrew Smith].
2011-04-14
Fonctions, opérateurs et mots clés
•
•
•
195
Somme([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTER
PRISE].[Grande].[Nancy Davolio]:[Hiérarchie des ventes]&[Type_Client].[EN
TERPRISE].[Grande].[Andrew Smith]}) renvoie 113 905 997 (la somme de l'indicateur
pour les trois membres de la plage).
[Hiérarchie Ventes].enfants fait référence à tous les membres de la hiérarchie [Hiérarchie
Ventes].
Somme([Montant commande];{Hiérarchie Ventes].enfants}) renvoie 277 290,434.
2011-04-14
Fonctions, opérateurs et mots clés
196
2011-04-14
Dépannage des formules
Dépannage des formules
6.1 Messages d'erreur de formule et d'information
Dans certains cas, une formule ne peut pas renvoyer de valeur et renvoie un message d'erreur ou
d'information commençant par "'#". Le message apparaît dans la cellule cible de la formule.
Vous pouvez mettre en forme les données d'un rapport qui renvoient des messages d'erreur à l'aide
de la mise en forme conditionnelle.
6.1.1 #CALCUL
Le message #CALCUL apparaît lorsqu'une dimension de découpage spécifiée dans la fonction Valeur
Relative n'est plus disponible dans le contexte de calcul du bloc où se trouve la fonction.
#CALCUL apparaît également lorsqu'un objet fusionné contenant une hiérarchie est inclus dans un
rapport.
Le message #CALCUL est lié à une mauvaise utilisation des opérateurs de contexte dans une formule.
Pour en savoir plus, voir le guide Utilisation de fonction, de formule et de calcul dans Interactive Analysis
Rubriques associées
• ValeurRelative
6.1.2 #CONTEXTE
#CONTEXTE apparaît dans un indicateur lorsque le contexte de celui-ci est non existant.
#CONTEXTE est lié aux messages d'erreur #INCOMPATIBLE et #SYNCDONNEES, qui apparaissent
dans les dimensions lorsqu'un bloc contient un contexte de calcul inexistant.
197
2011-04-14
Dépannage des formules
Dans le cas de l'erreur #INCOMPATIBLE, le contexte est inexistant car les dimensions sont
incompatibles ; dans le cas de l'erreur #SYNCDONNEES, le contexte est inexistant car les dimensions
proviennent de plusieurs fournisseurs de données non synchronisés.
Exemple : Contexte de calcul non existant dans une requête
Si un bloc basé sur l'univers Océan Voyages contient les objets Année de réservation et Revenu, le
message d'erreur #CONTEXTE apparaît parce qu'il n'est pas possible de regrouper le revenu par
année de réservation. (Les réservations n'ont pas encore généré de revenu.)
6.1.3 #SYNCDONNEES
L'erreur #SYNCDONNEES se produit lorsque vous placez une dimension d'un fournisseur de données
différent dans un bloc qui contient des dimensions provenant d'un autre fournisseur de données, les
deux fournisseurs de données n'étant pas synchronisés via une dimension fusionnée. #SYNCDONNEES
apparaît dans toutes les dimensions du bloc et #CONTEXTE apparaît dans les indicateurs.
Exemple : Dimensions provenant de fournisseurs de données différents dans un bloc
Si un rapport basé sur l'univers Océan Voyages contient des fournisseurs de données comportant
les objets (Année, Revenu) et (Trimestre), un bloc contenant Année, Trimestre et Revenu affiche
l'erreur #SYNCDONNEES dans les colonnes Années et Trimestre, car les deux fournisseurs de
données ne sont pas synchronisés via une dimension fusionnée.
6.1.4 #DIV/0
L'erreur #DIV/0 se produit lorsqu'une formule tente de diviser un nombre par zéro, ce qui est
mathématiquement impossible. Zéro ne peut jamais apparaître comme diviseur.
Exemple : Détermination du revenu par article
Vous disposez d'un rapport qui présente les revenus des ventes, le nombre d'articles vendus et le
revenu par article (qui est calculé en divisant le revenu des ventes par le nombre d'articles vendus).
Vous avez connu un très mauvais trimestre au cours duquel vous n'avez généré aucun revenu ; la
colonne Revenu par article renvoie #DIV/0 pour ce trimestre, parce que la formule essaie d'effectuer
une division par zéro, c'est-à-dire de diviser par zéro le nombre d'articles vendus.
198
2011-04-14
Dépannage des formules
6.1.5 #ERREUR
#ERREUR est le message d'erreur par défaut qui couvre toutes les erreurs non couvertes par les autres
messages d'erreur.
6.1.6 #EXTERNE
#EXTERNE apparaît lorsqu'une formule fait référence à une fonction externe non disponible dans Web
Intelligence.
6.1.7 #INCOMPATIBLE
L'erreur #INCOMPATIBLE se produit lorsqu'un bloc contient des objets incompatibles.
Exemple : Objets incompatibles dans une requête
Si un bloc basé sur l'univers Océan Voyages contient les dimensions Année et Année de réservation,
les colonnes contenant ces dimensions affichent l'erreur #INCOMPATIBLE parce que ces objets sont
incompatibles.
6.1.8 #MELANGER
#MELANGER apparaît lorsqu'un indicateur agrégé possède différentes unités. Par exemple, une cellule
affiche #MELANGER lorsqu'elle agrège des valeurs monétaires en différentes devises.
6.1.9 #VALEURMULTI
L'erreur #VALEURMULTI se produit lorsque vous placez une formule qui renvoie plusieurs valeurs
dans une cellule n'en générant qu'une seule.
199
2011-04-14
Dépannage des formules
Exemple : Valeurs multiples dans une cellule
Vous disposez d'un rapport présentant les objets Pays, Lieux de séjour et Revenu, et vous ajoutez
une cellule contenant la formule [Revenu] PourChaque ([Pays]). Cette cellule renvoie l'erreur
#VALEURMULTI car Pays contient deux valeurs dans le rapport : "Etats-Unis" et "France".
Une cellule ne peut pas afficher simultanément le revenu pour les Etats-Unis et la France. Placée en
dehors du tableau, une cellule contenant des revenus peut uniquement agréger les revenus du tableau
(par exemple, en les totalisant ou en effectuant leur moyenne).
Si le rapport est divisé en sections au niveau de Pays, la formule est correcte lorsqu'elle est placée
dans une section car il n'existe qu'une valeur de Pays par section. Sinon, en dehors d'une section, la
formule renvoie systématiquement l'erreur #VALEURMULTI.
6.1.10 #DEBORDEMENT
#DEPASSEMENT apparaît lorsqu'un calcul renvoie une valeur trop importante pour que le logiciel
puisse la supporter. Cette valeur, sous sa forme exponentielle, est 1,7E308 (1,7 suivi de 307 zéros).
6.1.11 #RESULTATPARTIEL
#RESULTATPARTIEL apparaît lorsque toutes les lignes associées à un objet de rapport n'ont pas été
extraites.
Si #RESULTATPARTIEL apparaît souvent dans vos rapports et que vous possédez les droits de sécurité
appropriés, modifiez la propriété de requête Max lignes extraites pour permettre d'extraire plus de
données. Si vous ne possédez pas les droits pour modifier la requête, voir votre administrateur.
Si votre rapport contient des indicateurs intelligents, il est plus que probable qu'il affiche
#RESULTATPARTIEL étant donné que ces indicateurs intelligents requièrent l'extraction d'un nombre
de données plus important que les indicateurs classiques.
6.1.12 #CLASSEMENT
L'erreur #CLASSEMENT se produit lorsque vous essayez d'établir un classement des données en
fonction d'un objet qui dépend de l'ordre des valeurs. (Les objets qui utilisent la fonction Précédent
ou toute fonction d'agrégation en cours d'exécution dépendent de l'ordre des valeurs). L'établissant
d'un classement engendre un nouveau calcul des valeurs de ces objets, ce qui modifie le classement
200
2011-04-14
Dépannage des formules
et provoque ainsi une dépendance circulaire. Une telle dépendance peut survenir lorsque vous utilisez
la boîte de dialogue Classement pour générer un classement ou lorsque vous utilisez la fonction Cla
ssement.
Exemple : Etablissement d'un classement de la moyenne cumulative ou des valeurs
précédentes
Si vous essayez de classer un bloc dans une colonne qui contient la fonction Précédent ou toute
fonction d'agrégation en cours d'exécution, le bloc entier renvoie #CLASSEMENT.
6.1.13 #RECURSIF
#RECURSIF apparaît lorsqu'il n'est pas possible d'effectuer un calcul en raison d'une dépendance
circulaire.
Exemple : Utilisation de la fonction NombreDePages()
Si vous placez la fonction NombreDePages dans une cellule dont les propriétés Ajuster
automatiquement la hauteur ou Ajuster automatiquement la largeur sont activées, la cellule renvoie
#RECURSIF car le fait de placer cette formule dans une cellule ajustée automatiquement crée une
dépendance circulaire. La fonction a besoin de la taille exacte du rapport pour renvoyer une valeur
mais la taille de la cellule, qui affecte la taille du rapport, est déterminée par son contenu.
6.1.14 #ACTUALISER
#ACTUALISER apparaît dans les cellules d'un rapport dont les valeurs sont dérivées d'objets supprimés
d'une requête et ajoutés à nouveau. Les objets sont supprimés d'une requête lorsque la propriété de
requête Activer la suppression des requêtes est activée et qu'ils ne contribuent à aucun rapport
basé sur la requête.
Les cellules sont à nouveau renseignées avec les valeurs des objets lorsque la requête est actualisée.
6.1.15 #FORMULERAPPT
Impossible de trouver une équivalence Web Intelligence.
201
2011-04-14
Dépannage des formules
6.1.16 #SECURITE
L'erreur #SECURITE se produit lorsque vous essayez d'utiliser une fonction pour laquelle vous ne
disposez pas des droits de sécurité.
Exemple : Utilisation de la fonction SQLDuFournisseur()
Si un utilisateur ne disposant pas du droit de visualiser le SQL du fournisseur de données place la
fonction SQLDuFournisseur() dans une cellule, le message #SECURITE apparaît dans la cellule.
6.1.17 #SYNTAXE
L'erreur #SYNTAXE se produit lorsqu'une formule fait référence à un objet qui n'existe plus dans le
rapport.
Exemple : Référence à un objet non existant
Vous disposez d'un rapport qui affichait initialement les objets Année, Trimestre et Revenu des ventes,
avec une colonne supplémentaire pour montrer la différence entre le revenu et le revenu moyen
annuel. Ce chiffre est généré par la variable Différence de moyenne annuelle.
Si la variable Différence de moyenne annuelle est supprimée du rapport, la colonne qui la contient
renvoie l'erreur #SYNTAXE.
6.1.18 #TOREFRESH
L'erreur #TOREFRESH apparaît dans les cellules basées sur des indicateurs intelligents lorsque la
valeur renvoyée par l'indicateur intelligent n'est pas disponible. Cette situation se produit lorsque le
“regroupement” contenant la valeur n'est pas disponible dans le fournisseur de données.
Vous pouvez supprimer l'erreur #TOREFRESH en actualisant les données.
6.1.19 #INDISPONIBLE
202
2011-04-14
Dépannage des formules
#NON DISPONIBLE apparaît lorsqu'il est impossible de calculer la valeur d'un indicateur intelligent.
Cela se produit lorsqu'il est impossible d'afficher les valeurs dans un indicateur intelligent sans appliquer
de filtre à la requête. D'autres rapports basés sur la même requêtes risquant d'être affectés, aucun
filtre n'est appliqué.
203
2011-04-14
Dépannage des formules
204
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Comparaison de valeurs à l'aide de fonctions
7.1 Comparaison de valeurs à l'aide de la fonction Précédent
La fonction Précédent renvoie une valeur précédente comparative d'une expression. La valeur
renvoyée dépend de la présentation du rapport.
Si vous voulez utiliser une fonctionnalité de comparaison plus puissante, utilisez la fonction ValeurRe
lative. ValeurRelative renvoie une valeur précédente ou suivante comparative d'une expression.
La valeur renvoyée ne dépend pas de la présentation du rapport.
Rubriques associées
• Précédent
• ValeurRelative
• Comparaison de valeurs à l'aide de la fonction ValeurRelative
7.2 Comparaison de valeurs à l'aide de la fonction ValeurRelative
La fonction ValeurRelative renvoie les valeurs comparatives d'une expression. La fonction renvoie
ces valeurs quelle que soit la présentation du rapport.
Lorsque vous utilisez la fonction ValeurRelative, vous spécifiez les éléments suivants :
•
•
•
L'expression dont vous voulez trouver la valeur comparative (l'expression doit être un indicateur ou
un détail d'une dimension disponible dans le bloc).
La liste des “dimensions de découpage”
L'offset.
La fonction utilise les dimensions de découpage, l'offset et les “dimensions de sous-axe” (impliquées
par les dimensions de découpage) pour renvoyer une valeur comparative. Les dimensions de sous-axe
correspondent à toutes les dimensions du contexte de calcul, sauf les dimensions de découpage.
Exprimée en termes généraux, ValeurRelative renvoie la valeur de l'expression de la ligne qui,
dans la liste de valeurs des dimensions de découpage, correspond aux lignes situées à offset lignes
de la ligne actuelle, et où les valeurs des dimensions de sous-axe sont identiques à celles de la ligne
actuelle.
205
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Remarque :
Toutes les dimensions de découpage se trouvent obligatoirement dans le contexte de calcul du bloc
dans lequel se trouve la fonction. Si une dimension de découpage est ensuite supprimée, la fonction
renvoie l'erreur #CALCUL.
Exemple :
Dans cet exemple, la colonne ValeurRelative contient la formule suivante :
RelativeValue([Revenue];([Year]);-1)
•
•
•
L'expression est [Chiffre d'affaires];
La dimension de découpage est [Année];
L'offset est -1 (la fonction renvoie la valeur située immédiatement avant dans la liste).
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Dupont
2 000
2007
T3
Martin
1 500
2007
T4
Harris
3 000
2008
T1
Durand
4 000
1 000
2008
T2
Dupont
3 400
2 000
2008
T3
Martin
2 000
1 500
2008
T4
Harris
1 700
3 000
Exprimée sous la forme d'une question sur l'activité, la formule renvoie le chiffre d'affaires généré par
le même vendeur au même trimestre de l'année précédente.
Exprimée sous la forme d'un calcul formé de mots, la formule renvoie la valeur de [Chiffre d'affaires]
(l'expression) dans la ligne où la valeur de [Année] (la dimension de découpage) est la valeur
précédente de la liste de valeurs de l'objet [Année] et où les valeurs de [Trimestre] et de [Vendeur]
(les dimensions de sous-axe) sont identiques à celles de la ligne active.
Rubriques associées
• ValeurRelative
7.2.1 Dimensions de découpage et fonction ValeurRelative
206
2011-04-14
Comparaison de valeurs à l'aide de fonctions
La fonction ValeurRelative utilise la liste de valeurs des dimensions de découpage pour trouver la
ligne comparative. La fonction renvoie la valeur comparative de l'expression spécifiée dans la fonction
qui se trouve à offset lignes dans la liste des dimensions de découpage.
En conséquence, l'ordre de tri des dimensions de découpage est essentiel pour déterminer le résultat
de la fonction.
Exemple : Dimensions de découpage multiples
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
•
•
•
L'expression est [Chiffre d'affaires];
Les dimensions de découpage sont ([Année];[Trimestre]);
L'offset est -1 (la fonction renvoie la valeur située immédiatement avant dans la liste).
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Durand
2 000
2007
T3
Durand
1 500
2007
T4
Durand
3 000*
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T3
Dupont
2 000
2007
T4
Dupont
1 700
2008
T1
Durand
5 000**
3 000*
2008
T2
Durand
3 000***
5 000**
2008
T3
Durand
2 700****
3 000***
2008
T4
Durand
6 800
2 700****
Exprimée sous la forme d'une question sur l'activité, la formule renvoie le chiffre d'affaires généré par
le même vendeur au trimestre précédent.
Exprimée sous la forme d'un calcul formé de mots, la formule renvoie la valeur de [Chiffre d'affaires]
dans la ligne où les valeurs de [Année] et de [Trimestre] représentent la valeur précédente de la liste
de valeurs ([Année];[Trimestre]) et où la valeur de [Vendeur] est identique à celle de la ligne active.
La fonction se sert de la liste des valeurs des dimensions de découpage pour trouver le chiffre d'affaires
comparatif.
207
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Année
Trimestre
2007
T1
2007
T2
2007
T3
2007
T4
*
2008
T1
**
2008
T2
***
2008
T3
****
2008
T4
L'ordre de tri des dimensions de découpage détermine le résultat de la fonction. Dans les tableaux,
l'ordre de tri est signalé par le signe *.
Rubriques associées
• ValeurRelative
7.2.2 Dimensions de découpage et sections
Une dimension de découpage peut être dans la cellule maître d'une section de rapport.
Exemple :
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
2007
208
Trimestre
Vendeur
Chiffre d'affaires
T1
Durand
1 000
T2
Durand
2 000
T3
Durand
1 500
T4
Durand
3 000*
ValeurRelative
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
T1
Dupont
4 000
T2
Dupont
3 400
T3
Dupont
2 000
T4
Dupont
1 700
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
T1
Durand
5 000**
3 000*
T2
Durand
3 000***
5 000**
T3
Durand
2 700 ****
3 000***
T4
Durand
6 800
2 700****
2008
La fonction se sert de la liste des valeurs des dimensions de découpage pour trouver le chiffre d'affaires
comparatif.
Année
Trimestre
2007
T1
2007
T2
2007
T3
2007
T4
*
2008
T1
**
2008
T2
***
2008
T3
****
2008
T4
L'ordre de tri des dimensions de découpage détermine le résultat de la fonction. Dans les tableaux,
l'ordre de tri est signalé par le signe *.
Rubriques associées
• ValeurRelative
209
2011-04-14
Comparaison de valeurs à l'aide de fonctions
7.2.3 Ordre des dimensions de découpage
Etant donné que l'ordre de tri de la liste de valeurs des dimensions de découpage détermine le résultat
de ValeurRelative, l'ordre dans lequel les dimensions de découpage sont spécifiées a une incidence
sur le résultat de la fonction.
Exemple : Ordre des dimensions de découpage
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Durand
2 000
2007
T3
Durand
1 500
2007
T4
Durand
3 000*
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T3
Dupont
2 000
2007
T4
Dupont
1 700
2008
T1
Durand
5 000**
3 000*
2008
T2
Durand
3 000***
5 000**
2008
T3
Durand
2 700****
3 000***
2008
T4
Durand
6 800
2 700****
Exprimée sous la forme d'une question sur l'activité, la formule renvoie le chiffre d'affaires généré par
le même vendeur au trimestre précédent.
L'ordre de tri des dimensions de découpage est le suivant :
210
Année
Trimestre
2007
T1
2007
T2
2007
T3
2007
T4
*
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Année
Trimestre
2008
T1
**
2008
T2
***
2008
T3
****
2008
T4
La fonction devient :
RelativeValue([Revenue];([Quarter];[Year]);-1)
L'ordre de tri des dimensions de découpage devient :
Trimestre
Année
T1
2007
*
T1
2008
**
T2
2007
***
T2
2008
****
T3
2007
*****
T3
2008
******
T4
2007
*******
T4
2008
********
L'impact de l'ordre de tri sur le résultat de la fonction est le suivant :
211
Année
Trimestre
Vendeur
Chiffre d'affaires
2007
T1
Durand
1 000*
2007
T2
Durand
2 000***
2007
T3
Durand
1 500*****
2007
T4
Durand
3 000*******
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T3
Dupont
2 000
2007
T4
Dupont
1 700
2008
T1
Durand
5 000**
ValeurRelative
1 000*
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2008
T2
Durand
3 000****
2 000***
2008
T3
Durand
2 700******
1 500*****
2008
T4
Durand
6 800********
3 000*******
Exprimée sous la forme d'une question sur l'activité, la formule renvoie maintenant le chiffre d'affaires
généré par le même vendeur au même trimestre de l'année précédente.
La modification de l'ordre de tri de la dimension de découpage modifie la signification de la formule.
Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées
• ValeurRelative
7.2.4 Dimensions de découpage et tris
Etant donné que l'ordre de tri de la liste de valeurs des dimensions de découpage détermine le résultat
de la fonction, le tri appliqué à toutes les dimensions de découpage a une incidence sur le résultat de
la fonction.
Exemple : Tri personnalisé appliqué à une dimension de découpage
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
Un tri personnalisé (T1, T2, T4, T3) est appliqué à [Trimestre] et le résultat de la fonction est le suivant :
212
Année
Trimestre
Vendeur
Chiffre d'affaires
2007
T1
Durand
1 000
2007
T2
Durand
2 000
2007
T4
Durand
3 000
2007
T3
Durand
1 500*
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T4
Dupont
1 700
ValeurRelative
2011-04-14
Comparaison de valeurs à l'aide de fonctions
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T3
Dupont
2 000
2008
T1
Durand
5 000**
1 500*
2008
T2
Durand
3 000***
5 000**
2008
T4
Durand
6 800****
3 000***
2008
T3
Durand
2 700
6 800****
La liste triée des dimensions de découpage est la suivante :
Année
Trimestre
2007
T1
2007
T2
2007
T4
2007
T3
*
2008
T1
**
2008
T2
***
2008
T4
****
2008
T3
Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées
• ValeurRelative
7.2.5 Utilisation de ValeurRelative dans les tableaux croisés
La fonction ValeurRelative fonctionne exactement de la même façon dans les tableaux croisés et dans
les tableaux verticaux. La présentation des données dans un tableau croisé n'a pas d'incidence sur le
résultat de la fonction.
Rubriques associées
• ValeurRelative
213
2011-04-14
Comparaison de valeurs à l'aide de fonctions
214
2011-04-14
Informations supplémentaires
Informations supplémentaires
Ressources d'informations
Emplacement
Informations sur le produit SAP
BusinessObjects
http://www.sap.com
Naviguez vers http://help.sap.com/businessobjects/ et cliquez sur Tous
les produits dans le panneau latéral "Présentation de SAP BusinessObjects".
SAP Help Portal
Vous pouvez accéder à la toute dernière documentation relative aux
produits SAP BusinessObjects et à leur déploiement sur le portail SAP
Help Portal. Il est également possible de télécharger des versions PDF
ou des bibliothèques HTML installables.
Certains guides résident sur SAP Service Marketplace et ne sont, par
conséquent, pas disponibles sur le portail SAP Help Portal. Le portail
d'aide répertorie ces guides et propose un lien vers SAP Service Marketplace. Les clients qui bénéficient d'un contrat de maintenance disposent
d'un ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez votre support technique.
http://service.sap.com/bosap-support > Documentation
•
•
SAP Service Marketplace
215
Guides d'installation : https://service.sap.com/bosap-instguides
Notes de version : http://service.sap.com/releasenotes
SAP Service Marketplace comprend certains guides d'installation, guides
de migration et de mise à niveau, guides de déploiement, notes de version
et des documents concernant les plates-formes prises en charge. Les
clients qui bénéficient d'un contrat de maintenance disposent d'un ID
utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez
votre support technique. Si vous êtes redirigé vers SAP Service Marketplace à partir du site SAP Help Portal, utilisez le menu situé dans le panneau de navigation à gauche pour sélectionner la catégorie contenant
la documentation que vous souhaitez consulter.
2011-04-14
Informations supplémentaires
Ressources d'informations
Emplacement
https://cw.sdn.sap.com/cw/community/docupedia
Docupedia
Docupedia fournit des ressources de documentation supplémentaires,
un environnement de création collaboratif et un canal de commentaires
interactif.
Ressources à l'attention des développeurs
https://boc.sdn.sap.com/
Articles SAP BusinessObjects sur
SAP Community Network
https://www.sdn.sap.com/irj/boc/businessobjects-articles
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
Ces articles étaient précédemment appelées notes techniques.
https://service.sap.com/notes
Remarques
Forums sur SAP Community Network
Ces remarques étaient précédemment appelées des articles de la base
de connaissances.
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Formation
Nous pouvons vous fournir un module de formation qui réponde à vos
besoins et convienne à votre style d'apprentissage préféré, sous forme
de stage traditionnel ou de séminaires plus ciblés.
http://service.sap.com/bosap-support
Support client en ligne
Le site SAP Support Portal présente des informations sur les programmes
et services de support technique. Il propose également des liens vers
de nombreuses informations techniques ainsi que des téléchargements.
Les clients qui bénéficient d'un contrat de maintenance disposent d'un
ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez
votre support technique.
http://www.sap.com/services/bysubject/businessobjectsconsulting
Conseil
216
Les consultants peuvent vous accompagner dans votre démarche, depuis
la phase initiale d'analyse jusqu'à la phase finale de livraison de votre
projet de déploiement. Ils peuvent vous faire bénéficier de leur expertise
en matière de bases de données relationnelles et multidimensionnelles,
de connectivité, d'outils de conception de base de données et de techno
logie d'intégration personnalisée.
2011-04-14
Index
Symboles
#ACTUALISER, message d'erreur 201
#CALCUL, message d'erreur 168, 197
#CLASSEMENT, message d'erreur
200
#CONTEXTE, message d'erreur 197,
198
#DEBORDEMENT, message d'erreur
200
#DIV/0, message d'erreur 198
#ERREUR, message d'erreur 126,
128, 129, 130, 143, 199
#EXTERNE, message d'erreur 199
#FORMULERAPPT, message d'erreur
201
#INCOMPATIBLE, message d'erreur
197, 198, 199
#INDISPONIBLE
et indicateurs intelligents 45
#INDISPONIBLE, message d'erreur
44, 203
et indicateurs intelligents 203
#MELANGER, message d'erreur 199
#RECURSIF, message d'erreur 201
#RESULTATPARTIEL, message
d'erreur 200
et indicateurs intelligents 200
#SECURITE, message d'erreur 202
#SYNCDONNEES, message d'erreur
197, 198
#SYNTAXE, message d'erreur 202
#TOREFRESH, message d'erreur 40,
44, 202
et indicateurs intelligents 202
#VALEURMULTI, message d'erreur
170, 199
A
Abs, fonction 125
actualiser les données 40
afficher l'auteur de documents 110
afficher l'heure du dernier
enregistrement d'un document 113
afficher la date de création des
documents 111
afficher la date du dernier
enregistrement d'un document 112
afficher le nombre de pages dans un
rapport 163
217
afficher le numéro de ligne 170
afficher le propriétaire des documents
112
afficher les informations de connexion
de l'auteur d'un document 110
afficher les informations de connexion
du propriétaire d'un document 112
afficher les noms d'univers 108
afficher les noms des diagrammes 154
afficher les noms des objets rapport
162
afficher les noms des tableaux 154
afficher les numéros de colonne 154
afficher les numéros de page 164
afficher les réponses aux invites 109
Agrégat, fonction 50
agrégation, fonctions
inclure plusieurs dimensions dans
75
Année, fonction 99
appliquer un format aux nombres 77
Arrondi, fonction 140, 192
arrondir les nombres 125
arrondir les valeurs 192
Asc, fonction 73
Ascendant, fonction 153
ASCII, valeurs 73
renvoyer des caractères associés
à 74
AucunFiltre, fonction 162, 175
AuteurDuDocument, fonction 110
Auto, opérateur 164, 181
avancée, syntaxe 18
modifier le contexte de calcul par
défaut à l'aide de 27
mot clé Bloc 34, 187
mot clé Corps 35, 188
mot clé Rapport 31, 36, 190
mot clé Saut 33, 189
mot clé Section 32, 191
opérateur Dans 27, 28, 182
PourChaque (opérateur) 27, 30,
182, 185
PourTout (opérateur) 27, 30, 182,
185
Average, fonction
à l'aide de mots clés de syntaxe
avancée 34, 187
B
Bas, opérateur 138
Bloc, mot clé 34, 187
blocs
afficher les noms 154
booléennes, expressions
lier à l'opérateur Et 172
renvoyer l'opposé 173
booléennes, valeurs
identifier 120
tester 159, 160
C
calcul par défaut, contextes
dans les ruptures 26
dans les sections 25
dans les tableaux horizontaux 24
dans les tableaux verticaux 23
modifier à l'aide d'une syntaxe
étendue 27
tableaux croisés 24
calcul standard par défaut 9
calculer des erreurs d'arrondi 129, 130
calculer le sinus d'un angle 141
calculer un centile 59
calculer un cosinus 126
calculer un écart type 69
calculer un écart type de population 70
calculer un factoriel 132
calculer un logarithme en base 10 136
calculer un logarithme en base n 136
calculer un logarithme naturel 135
calculer un maximum cumulatif 63
calculer un minimum cumulatif 64
calculer un mode 57
calculer un nombre cumulatif 62
calculer un pourcentage 12, 58
calculer un produit 60
calculer un produit cumulatif 66
calculer une fonction exponentielle 132
calculer une médiane 55
calculer une moyenne 51
calculer une moyenne cumulative 60
calculer une racine carrée 142
calculer une somme 70
calculer une somme cumulative 67
calculer une tangente 142
calculer une valeur maximum 54
calculer une valeur minimum 56
2011-04-14
Index
calculer une variance 71
calculer une variance de population 72
calculs
personnalisés 9
standard 9
calculs personnalisés 9
utiliser des formules pour créer 10
calculs personnalisés, créer à l'aide de
formules 10
calculs standard 9
Capitale, fonction 78
CapitaleMot, fonction 87
Car, fonction 74
caractères
afficher depuis des valeurs ASCII
74
renvoyer les valeurs ASCII 73
cellules
inclure du texte dans 11
inclure les fonctions dans 11
centile 59
Centile, fonction 59
chaînes
identifier 122
chaînes de caractères
appliquer des règles d'encodage
URL à 87
calculer la longueur 80
convertir en minuscules 81
extraire des sections de 85
faire correspondre à un modèle 81
joindre/concaténer 16, 75, 171
mettre en majuscules la première
lettre de 78
mettre en majuscules les premières
lettres 87
mettre en majuscules toutes les
premières lettres dans 87
remplacer des parties 83
remplir avec d'autres chaînes 79,
84
renvoyer les caractères les plus à
droite 83
renvoyer les caractères les plus à
gauche 78
répéter 75
supprimer les espaces à droite 86
supprimer les espaces à gauche
80, 86
supprimer les espaces à la fin
d'une chaîne de caractères 85
transformer en majuscules 86
transformer en nombres 143
Children, fonction 144
218
classement
et fonctions d'agrégat cumulatives
200
Classement, fonction 138, 175
classer les données 138
Clé, fonction 149
Col, opérateur 60, 63, 64, 66, 67, 179
colonnes
afficher les nombres 154
comparer les valeurs à l'aide de
Précédent 205
comparer les valeurs à l'aide de
RelativeValue 205, 206, 208, 210,
212, 213
Comparer, fonction 81
comptage, fonction 52
compter les lignes dans les tableaux
161
compter les valeurs 62
Concaténation, fonction 75
concaténer des chaînes de caractères
16, 75, 171
condition Si...Alors...Sinon 159
conditionnels, opérateurs 17, 171
Connexion, fonction 99
contexte d'entrée
définition 19
contexte de sortie
définition 20
contexte, opérateurs 18
contextes de calcul
contexte d'entrée 19
contexte de sortie 19, 20
définition 19
et indicateurs intelligents 44
modifier à l'aide d'une syntaxe
étendue 22
par défaut 22
convertir à partir d'euros 126
convertir en euros 128
ConvertirDepuisEuro, fonction 126,
192
ConvertirEnEuro, fonction 128, 192
Corps, mot clé 35, 188
Cos, fonction 126
cosinus 126
Count, fonction 177
CurrentDate, fonction 88
CurrentTime, fonction 88
D
Dans, opérateur 28, 182
DansListe, opérateur 17, 172, 174
DateCléFournisseurDonnées, fonction
100
DateDeLaDernièreExécution, fonction
104
DateDeLaValeurDeRéférence, fonction
107
DateDuDocument, fonction 112
DateRelative, fonction 95
dates
calculer les dates relatives 95
identifier 118
mettre en forme 76, 98
découpage, dimensions 205
et les sections 208
impact de l'ordre de tri 206, 210,
212
ordre 210
Dernier, fonction 54
DernierJourDeLaSemaine, fonction 92
DernierJourDuMois, fonction 92
Derniers, opérateur 175
Descendants, fonction 146
devises
convertir entre devises
européennes 126, 128
devises européennes
convertir entre 126, 128
diagrammes
afficher les noms 154
dimensions
ajouter au contexte de calcul 30,
185
dimensions de découpage 205,
206
et message d'erreur
#INCOMPATIBLE 199
et message d'erreur
#SYNCDONNEES 198
et regroupements 43
inclure plusieurs dimensions dans
les fonctions d'agrégat 75
spécifier dans le contexte de calcul
28, 182
supprimer du contexte de calcul
30, 185
Distinct, opérateur 177
document, afficher les paramètres
régionaux 156
document, paramètres régionaux
afficher 156
DocumentPartiellementActualisé,
fonction 113
documents
afficher l'auteur 110
afficher l'heure du dernier
enregistrement 113
afficher la date de création 111
2011-04-14
Index
documents (suite)
afficher la date du dernier
enregistrement 112
afficher le nom 112
afficher le propriétaire de 112
visualiser les requêtes dans 115
données
actualiser 40
données de référence
renvoyer la date 107
Droite, fonction 83
DuréeDernièreExécution, fonction 104
E
écart type 69
écart type, population 70
EcartTypeP, fonction 70
Ecartype, fonction 69
Editeur de formule
afficher la syntaxe de la fonction
dans 12
Eléments de niveau identique, fonction
151
EnDate, fonction 98
EnNombre, fonction 143
Entre, opérateur 17, 172, 173
ErreurEuroParArrondi, fonction 129,
192
ErreurEuroVersArrondi, fonction 130,
192
erreurs
identifier 119
erreurs d'arrondi 129, 130
espaces à droite
supprimer des chaînes de
caractères 85, 86
espaces à gauche
supprimer des chaînes de
caractères 80, 86
EstChaîne, fonction 122
EstDate, fonction 118
EstErreur, fonction 119
EstHeure, fonction 123
EstLogique, fonction 120
EstNombre, fonction 121
EstNul, fonction 120
Et, opérateur 17, 172
euros
convertir à partir de 126
convertir en 128
Exp, fonction 132
Exploration, opérateur 162, 175
219
fonctions (suite)
DateActuelle 88
Fact, fonction 132
DateCléFournisseurDonnées 100
factoriel 132
DateDeCréationDuDocument 111
FiltreRapport, fonction 116
DateDeLaDernièreExécution 104
filtres
DateDeLaValeurDeRéférence 107
afficher les filtres d'exploration 175
DateDuDocument 112
afficher tout 175
DateRelative 95
bloc 116
décalage 149
et indicateurs intelligents 46
définition 11
explorer 175
Dernier 54
filtrer des indicateurs intelligents
DernierJourDeLaSemaine 92
45
DernierJourDuMois 92
filtres d'exploration 46
Descendants 146
rapport 116, 175
DocumentPartiellementActualisé 113
section 116
Droite 83
sur les dimensions 44
DuréeDernièreExécution 104
filtres d'exploration 175
EcartTypeP 70
afficher 175
élément de niveau identique 151
et indicateurs intelligents 46
EnDate 98
ignorer 175
enfants 144
filtres de rapport 116, 175
EnNombre 143
ignorer 175
ErreurEuroParArrondi 129, 192
visualiser un résumé 116
ErreurEuroVersArrondi 130, 192
filtres sur les dimensions
EstChaîne 122
impact sur les indicateurs
EstErreur 119
intelligents de 44
EstFeuille 148
FiltresExploration, fonction 114
EstHeure 123
Floor, fonction 133
EstLogique 120
fonction exponentielle 132
EstNombre 121
fonction, syntaxe
exemples 12
exemple 12
Exp 132
fonctions
Fact 132
Abs 125
faire référence à des ensembles de membres dan
Agrégat 50
faire référence à des membres dans 193
Année 99
FiltreRapport 116
Arrondi 140, 192
FiltresExploration 114
Asc 73
Floor 133
Ascendant 153
fonction DateDeCréationDuDocument 111
AucunFiltre 162, 175
fonction HeureDeCréationDuDocument 111
AuteurDuDocument 110
fonction HeureDeLaDernièreExécution 105
Average 34, 51, 177, 187
fonction Interpolation 179
Capitale 78
fonction MaxCumulatif 179
CapitaleMot 87
fonction MinCumulatif 64, 179
Car 74
fonction MoyenneCumulative 179
catégories 49
fonction NombreCumulatif 179
Centile 59
fonction Pourcentage 179
Classement 138, 175
fonction ProduitCumulatif 179
Clé 149
fonction SommeCumulative 179
combiner avec du texte dans les cellules 11
ForcerFusion 155
Comparer 81
FormatDeDate 76
Concaténation 75
FormatDeNombre 77
Connexion 99
FournisseurDeDonnées 100
ConvertirDepuisEuro 126, 192
Gauche 78
ConvertirEnEuro 128, 192
HeureDeCréationDuDocument 111
Cos 126
HeureDuDocument 113
F
2011-04-14
Index
fonctions (suite)
fonctions (suite)
fonctions diverses
HTMLEncode 77
Précédent 164, 178, 181, 200, 205
description 49
Impair 124
Premier 53
fonctions document
IndexationDesLignes 170
produit 60
description 49
insérer dans des cellules 11
ProduitCumulatif 66, 179
fonctions du fournisseur de données
Interpolation 134, 178, 179
profondeur 145
description 49
IsDate 118
PropriétaireDocument 112
fonctions logiques
IsNull 120
Puissance 137
description 49
JoursEntre 91
Racine 142
fonctions numériques
LégendeDateCléFournisseurDonnées 101Remplacer 83
description 49
Ln 135
RemplissageDroite 84
ForcerFusion, fonction 155
Log 136
RemplissageGauche 79
FormatDeDate, fonction 76
Log10 136
Répéter 75
FormatDeNombre, fonction 77
Longueur 80
RéponseInvite 103
formules
Majuscule 86
RéponseUtilisateur 12, 109, 178
créer des calculs personnalisés à
Max 30, 54, 185
RéponseUtilisateurValeurRéf 107, 178
l'aide de 10
MaxCumulatif 63, 179
RésuméFiltreRapport 116
et indicateurs intelligents 43
Médiane 55
RésuméInvite 115
indicateurs intelligents dans 44
Min 56
RésuméRequête 115
messages d'erreur générés par
MinCumulatif 64, 179
Semaine 98
197
Minuscule 81
Si 17, 160, 171
simplifier avec des variables 10, 15
Mode 57
Signe 140
utiliser les opérateurs dans 16, 171
Modulo 137
Sin 141
FournisseurDeDonnées, fonction 100
Mois 93
Somme, fonction 70
fournisseurs de données 106
MoisEntre 94
SommeCumulative 67, 179
afficher le nom de l'univers 108
MoyenneCumulative 60, 177, 179
SousChaîne 85
afficher le nombre de lignes dans
Nombre 52, 175, 177
SQLDuFournisseur 102
106
NombreCumulatif 62, 177, 179
StdDev 69
visualiser le code SQL généré par
NombreDeFournisseurs 106
Sum 12, 30, 31, 32, 33, 35, 36, 70, 185, 188, 102
189, 190, 191
NombreDeLignes 106
SupprEspace 86
NombreDePages 163, 201
SupprEspDroite 85
G
NomDe 162
SupprEspGauche 80
NomDeUnivers 108
syntaxe de la fonction 12
Gauche, fonction 78
NomDuBloc 154
Tan 142
guide des fonctions, formules et
NomDuDocument 112
Trimestre 95
calculs, utilisation
NomDuJour 89
Tronquer 192
à propos de 7
NomRapport 169
Truncate 143
NomUniqueDe 170
TypeDuFournisseur 102
H
NuméroDeColonne 154
URLEncode 87
NuméroDeLigne 161
UtilisateurCourant 155
heure, valeurs
NuméroDuJourDeAnnée 91
ValeurRéf 167
identifier
NuméroDuJourDeLaSemaine 90
ValeurRelative 168, 197, 205, 208, 210, 212,
213 123
HeureDeLaDernièreExécution,
fonction
NuméroDuJourDuMois 89
ValeurServeur 68
105
NuméroDuMoisDeAnnée 93
Var 71
HeureDuDocument, fonction 113
ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents
VarP 72
HTMLEncode, fonction 77
156
fonctions caractère
ObtenirParamètresRégionauxDeVisualisationPréférés
description 49
158
ObtenirVariablesRégionalesDeContenu
fonctions
156
d'agrégat
I
ObtenirVarRég 157
description 49
ObtentionTraduction 157
fonctions d'agrégat cumulatives
identifier des chaînes 122
Page 164
et classement 200
identifier des dates 118
Pair 117
et message d'erreur
identifier des nombres 121
Parent 151
#CLASSEMENT 200
identifier les erreurs 119
Plafond 125
fonctions de date et d'heure
identifier les nombres impairs 117, 124
Pos 82
description 49
identifier les nombres pairs 117, 124
Pourcentage 12, 58, 176, 179
identifier les valeurs booléennes 120
220
2011-04-14
Index
identifier les valeurs d'heure 123
identifier les valeurs nulles 120
Impair, fonction 124
InclureVide, opérateur 177
Index, opérateur 109
IndexationDesLignes, fonction 170
indicateur, valeurs
interpoler 134, 179
indicateurs
et contextes de calcul par défaut
22
indicateurs intelligents définis 39
renvoyer les valeurs précédentes
168
renvoyer les valeurs suivantes 168
indicateurs intelligents
définition 39
et calculs standards 9
et filtres d'exploration 46
et formules 43, 44
et l'erreur #INDISPONIBLE 45
et message d'erreur
#INDISPONIBLE 203
et message d'erreur
#RESULTATPARTIEL 200
et message d'erreur
#TOREFRESH 202
et opérateurs de contexte 44
et périmètre d'analyse 41
et regroupements 39
et variables 43
filtrer 45
impact des filtres sur 44
impossibilité de calculer 203
indicateurs intelligents, filtrer 45
individuelles, cellules
et message d'erreur
#VALEURMULTI 199
Interpolation, fonction 134, 178, 179
interpoler des valeurs d'indicateur 134,
179
invites
afficher les réponses 12, 107, 109
IsLeaf, fonction 148
J
joindre des chaînes de caractères 16,
75, 171
JoursEntre, fonction 91
L
Lag, fonction 149
LégendeDateCléFournisseurDonnées,
fonction 101
221
Ligne, opérateur 60, 63, 64, 66, 67,
179
lignes
afficher le nombre de lignes dans
le fournisseur de données 106
afficher le numéro de ligne 170
compter dans les tableaux 161
compter les valeurs distinctes 175
compter toutes les valeurs 175
Linéaire, opérateur 134, 178
Ln, fonction 135
Log, fonction 136
Log10, fonction 136
logarithme naturel 135
logarithmes 135, 136
logarithmes en base 10 136
logarithmes en base n 136
Longueur, fonction 80
M
Majuscule, fonction 86
mathématiques, opérateurs 16, 171
Max, fonction 54
utiliser avec les opérateurs de
contexte 30, 185
MaxCumulatif, fonction 63
maximum, calcul standard 9
maximum, valeurs
calculer un maximum cumulatif 63
médian 55
Median, fonction 55
membres
faire référence dans les fonctions
193
membres, ensemble
faire référence dans les fonctions
193
messages d'erreur
#ACTUALISER 201
#CALCUL 168, 197
#CLASSEMENT 200
#CONTEXTE 197, 198
#DEBORDEMENT 200
#DIV/0 198
#ERREUR 126, 128, 129, 130,
143, 199
#EXTERNE 199
#FORMULERAPPT 201
#INCOMPATIBLE 197, 198, 199
#INDISPONIBLE 44, 203
#MELANGER 199
#RECURSIF 201
#RESULTATPARTIEL 200
#SECURITE 202
#SYNCDONNEES 197, 198
messages d'erreur (suite)
#SYNTAXE 202
#TOREFRESH 40, 44, 202
#VALEURMULTI 170, 199
messages d'erreur relatifs aux
formules 197
Min, fonction 56
minimum, calcul standard 9
minimum, valeurs
calculer un minimum cumulatif 64
Minuscule, fonction 81
mode 57
Mode, fonction 57
Modulo, fonction 137
Mois, fonction 93
MoisEntre, fonction 94
mots clés
Bloc 34, 187
Corps 35, 188
mots clés de la syntaxe avancée
31, 187
rapport 31, 36, 190
rendre les rapports génériques
avec 36
Saut 33, 189
Section 32, 191
moyenne
calculer une moyenne cumulative
60
moyenne, calcul standard 9
Moyenne, fonction 51, 177
MoyenneCumulative, fonction 60, 177
multiplier des nombres 60, 66
N
nombre cumulatif 62
nombre, calcul standard 9
nombre, calculer la valeur absolue 125
Nombre, fonction 175, 177
NombreCumulatif, fonction 62, 177
NombreDeFournisseurs, fonction 106
NombreDeLignes, fonction 106
NombreDePages, fonction 163
et message d'erreur #RECURSIF
201
nombres
arrondir 125, 140
arrondir à inférieur 133
arrondir les nombres 140
arrondir les nombres à inférieur
133
calculer un modulo 137
déterminer si impair ou pair 117,
124
diviser 137
2011-04-14
Index
nombres (suite)
élever à une puissance 137
identifier 121
mettre en forme 77
modulo 137
multiplier 60, 66
transformer des chaînes de
caractères en 143
tronquer 143
tronquer des nombres 143
nombres impairs
identifier 117, 124
nombres pairs
identifier 117, 124
NomDe, fonction 162
NomDeUnivers, fonction 108
NomDuBloc, fonction 154
NomDuDocument, fonction 112
NomDuJour, fonction 89
NomRapport, fonction 169
NomUniqueDe, fonction 170
Non, opérateur 17, 172, 173
NonNul, opérateur 164, 178
nulles, valeurs
identifier 120
NuméroDeColonne, fonction 154
NuméroDeLigne, fonction 161
NuméroDuJourDeAnnée, fonction 91
NuméroDuJourDeLaSemaine, fonction
90
NuméroDuJourDuMois, fonction 89
NuméroDuMoisDeAnnée, fonction 93
numéros de page
afficher dans les rapports 164
O
objets
afficher le nom 170
visualiser des filtres sur 116
ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents,
Fonction 156
ObtenirParamètresRégionauxDeVisualisationPréférés,
fonction 158
ObtenirVariablesRégionalesDeContenu,
fonction 156
ObtenirVarRég, fonction 157
ObtentionTraduction, fonction 157
opérateurs
Auto 164, 181
Bas 138
Col 60, 62, 63, 64, 66, 67, 179
conditionnels 17, 171
contexte 18
Dans 28, 182
DansListe 17, 172, 174
222
opérateurs (suite)
définir 186
définition 16, 171
Derniers 175
Distinct 177
Entre 17, 172, 173
Et 17, 172
Exploration 162, 175
InclureVide 62, 177
Index 109, 178
Ligne 60, 62, 63, 64, 66, 67, 179
Linéaire 134, 178
logiques 17, 172
mathématiques 16, 171
Non 17, 172, 173
NonNul 164, 178
opérateur Index 178
opérateurs spécifiques à la fonction
18, 174
Ou 17, 172
Où 181
PasSurSaut 134, 179
plage 186
PointAPoint 134, 179
PourChaque 30, 185
PourTout 30, 36, 185
Premiers 138, 175
Rupture 176
spécifiques à la fonction 18, 174
Tout 162, 175, 177
opérateurs définis 186
opérateurs logiques 17, 172
ordre de tri
et dimensions de découpage 206,
210, 212
Ou, opérateur 17, 172
Où, opérateur 181
P
Page, fonction 164
pages
afficher le nombre de pages dans
les rapports 163
Pair, fonction 117
paramètres régionaux
afficher les paramètres régionaux
de document 156
afficher les paramètres régionaux
de visualisation préférés
dominants 156
afficher les paramètres régionaux
du produit 157
Paramètres régionaux de visualisation
préférés
afficher 158
paramètres régionaux de visualisation
préférés dominants, afficher 156
paramètres régionaux de visualisation
préférés, afficher 158
paramètres régionaux de visualisation
préférés, dominants
afficher 156
Parent, fonction 151
PasSurSaut, opérateur 134, 179
périmètre d'analyse
et indicateurs intelligents 41
et regroupements 41
Plafond, fonction 125
plage, opérateur 186
PointAPoint, opérateur 134, 179
Pos, fonction 82
pourcentage, calcul standard 9
Pourcentage, fonction 12, 58
PourChaque, opérateur 30, 185
PourTout, opérateur 30, 36, 185
Précédent, fonction 164, 178, 181
comparer des valeurs 205
et message d'erreur
#CLASSEMENT 200
Premier, fonction 53
Premiers, opérateur 138, 175
produit, afficher les paramètres
régionaux 157
Produit, fonction 60
produit, paramètres régionaux
afficher 157
ProduitCumulatif, fonction 66
produits
calculer un produit cumulatif 66
Profondeur, fonction 145
PropriétaireDocument, fonction 112
propriétés de requête
Nombre max. de lignes extraites
200
Puissance, fonction 137
R
racine carrée 142
Racine, fonction 142
Rapport, mot clé 31, 36, 190
rapports
afficher le nombre de pages dans
163
afficher les noms des objets dans
162
afficher les numéros de page dans
164
visualiser les noms 169
regroupements 39
définition 39
2011-04-14
Index
regroupements (suite)
et opérateur UNION 41
et périmètre d'analyse 41
exemple de gestion de 41
gestion de 40
Remplacer, fonction 83
RemplissageDroite, fonction 84
RemplissageGauche, fonction 79
Répéter, fonction 75
RéponseInvite, fonction 103
RéponseUtilisateur, fonction 12, 109,
178
RéponseUtilisateurValeurRéf, fonction
107, 178
requêtes
visualiser un résumé 115
RésuméFiltreRapport, fonction 116
RésuméInvite, fonction 115
RésuméRequête, fonction 115
Rupture, opérateur 176
ruptures
contextes de calcul par défaut dans
26
S
Saut, mot clé 33, 189
Section, mot clé 32, 191
sections
contextes de calcul par défaut dans
25
et dimensions de découpage 208
et la fonction ValeurRelative 208
Semaine, fonction 98
Si, fonction 17, 160, 171
Signe, fonction 140
simplifier des formules avec des
variables 10, 15
Sin, fonction 141
sinus 141
somme, calcul standard 9
Somme, fonction 12
à l'aide de mots clés de syntaxe
avancée 31, 32, 33, 35, 36,
188, 189, 190, 191
223
Somme, fonction (suite)
utiliser avec les opérateurs de
contexte 30, 185
SommeCumulative, fonction 67
SousChaîne, fonction 85
SQL 102
et actualisation des données 40
et regroupements 39, 40
opérateur GROUPING SETS 41
UNION, opérateur 39, 41
SQLDuFournisseur, fonction 102
SupprEspace, fonction 86
SupprEspDroite, fonction 85
SupprEspGauche, fonction 80
syntaxe avancée, mots clés 31, 187
rendre les rapports génériques
avec 36
utiliser avec la fonction Moyenne
34, 187
utiliser avec la fonction Somme 31,
32, 33, 35, 188, 189, 190, 191
syntaxe de la fonction, afficher 12
T
tableaux
afficher les noms 154
compter les lignes dans 161
horizontaux 24
verticaux 23
tableaux croisés
contextes de calcul par défaut dans
24
et la fonction ValeurRelative 213
tableaux horizontaux
contextes de calcul par défaut dans
24
Tan, fonction 142
tangentes 142
tester les valeurs booléennes 159, 160
Tout, opérateur 162, 175, 177
Trimestre, fonction 95
tris
et dimensions de découpage 206,
210, 212
tronquer les valeurs 192
Tronquer, fonction 192
Truncate, fonction 143
TypeDuFournisseur, fonction 102
U
UNION, opérateur 41
univers
afficher les noms 108
URL
appliquer des règles d'encodage à
87
URLEncode, fonction 87
UtilisateurCourant, fonction 155
V
ValeurRéf, fonction 167
ValeurRelative, fonction 168
comparer des valeurs 205, 206,
208, 210, 212, 213
et dimensions de découpage 206,
208, 212
et les sections 208
et message d'erreur #CALCUL 197
et tableaux croisés 213
valeurs
arrondir 192
comparer à l'aide de Précédent
205
comparer à l'aide de RelativeValue
205, 206, 208, 210, 212, 213
compter 52, 62
précision de 192
tronquer 192
ValeurServeur, fonction 68
Var, fonction 71
variables
et indicateurs intelligents 43
simplifier les formules avec 10, 15
variance 71
variance, population 72
VarP, fonction 72
vertical, tableau
contextes de calcul par défaut dans
23
2011-04-14
Index
224
2011-04-14
">