SAP 4.0 Feature Pack 3 Manuel utilisateur
Utilisation de fonctions, formules et calculs dans Web Intelligence
■ SAP BusinessObjects Business Intelligence Suite 4.0 Feature Pack 3
2012-05-10
Copyright © 2012 SAP AG. Tous droits réservés.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign,
SAP BusinessObjects Explorer, StreamWork, SAP HANA 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 ainsi que 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 Software Ltd. Business Objects est une société du Groupe SAP. Sybase et Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, et les autres produits et services Sybase mentionnés dans ce document, ainsi que leurs logos respectifs, sont des marques commerciales ou des marques déposées de Sybase, Inc. Sybase est une société du Groupe SAP. Crossgate, m@gic EDDY, B2B
360°, B2B 360° Services sont des marques commerciales ou des marques déposées de Crossgate
AG en Allemagne ainsi que dans d'autres pays. Crossgate est une société du Groupe SAP. Tous les autres noms de produits et de services mentionnés sont des marques commerciales ou des marques déposées 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. Les informations du présent document 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. Le Groupe SAP ne pourra en aucun cas être tenu pour responsable des erreurs ou omissions relatives à ces informations. Les seules garanties fournies pour les produits et les services du Groupe SAP sont celles énoncées expressément à titre 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.
2012-05-10
Table des matières
3
Historique des documents : Fonctions, formules et calculs Web Intelligence.......................7
2012-05-10
4
Table des matières
Référence à des membres et des ensembles de membres des hiérarchies..........................195
2012-05-10
5
Table des matières
2012-05-10
Table des matières
6 2012-05-10
7
Historique des documents : Fonctions, formules et calculs Web Intelligence
Historique des documents : Fonctions, formules et calculs Web Intelligence
La table suivante fournit un récapitulatif des principales modifications effectuées dans le document :
Version
SAP BusinessObjects Interactive
Analysis 4.0
SAP BusinessObjects Interactive
Analysis 4.0 Service Pack 1
Date
30 novembre 2011
25 février 2011
BusinessObjects Web Intelligence 4.0
Service Pack 2
15 juin 2011
BusinessObjects Web Intelligence 4.0
Feature Pack 3
20 février 2012
Description
Initialement renommé Interactive Analysis
Première version de ce document
Support Package 1
Support Package 2 Renommé ensuite Web
Intelligence
Feature Pack 3
2012-05-10
Historique des documents : Fonctions, formules et calculs Web Intelligence
8 2012-05-10
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 de données. Il sert aussi de référence pour la syntaxe des fonctions et des opérateurs disponibles.
9 2012-05-10
A propos de ce guide
10 2012-05-10
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.
3.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
Somme
Nombre
Moyenne
Minimum
Maximum
Pourcentage
Description
Calcule la somme des données sélectionnées.
Compte toutes les lignes d'un objet de type indicateur ou compte les différentes lignes d'un objet de type dimension ou information.
Calcule la moyenne des données.
Affiche la valeur minimale des données sélectionnées.
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.
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é.
11 2012-05-10
Utilisation de calculs standards et personnalisés
Calcul
Par défaut
Description
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.
3.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
3.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.
12 2012-05-10
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
3.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 Sum calcule le total de toutes les valeurs d'un indicateur et renvoie le résultat.
La formule Sum([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
•
3.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
Average([Revenu]) apparaît dans une cellule sous la forme =Average([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 :" +
Average([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.
13 2012-05-10
Utilisation de calculs standards et personnalisés
3.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 Sum 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.
3.3.3 Exemples de fonctions
Exemple : Affichage d'une invite de saisie avec la fonction UserResponse
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 a l'apparence suivante si l'utilisateur a choisi Illinois comme Etat lors de l'actualisation du fournisseur de données :
14 2012-05-10
Utilisation de calculs standards et personnalisés
15
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])
.
2012-05-10
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.
16
Exemple : Calcul d'un pourcentage à l'aide de la fonction Sum
Vous pouvez contrôler davantage le contexte de calcul d'un pourcentage en utilisant la fonction Sum plutôt que la fonction Percentage. 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]/Sum([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))
2012-05-10
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 Sum 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
17
3.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
2012-05-10
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
Moyenne des ventes
Nombre d'observations
Différence élevée au carré
Variance
Formule
Average([Quantité vendue] Dans ([Trimestre]))
Dans Rapport
Count([Quantité vendue] Dans ([Trimestre])) Dans
Rapport
Power(([Quantité vendue] - [Moyenne ventes]);2)
Sum([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 explorer en avant la formule afin de comprendre en détail ce qu'elle effectue.
3.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.
3.3.4.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
18 2012-05-10
Utilisation de calculs standards et personnalisés 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".
3.3.4.2 Opérateurs conditionnels
19
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.
3.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 True ou False.
3.3.4.4 Opérateurs contextuels
2012-05-10
Utilisation de calculs standards et personnalisés
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.
3.3.4.5 Opérateurs spécifiques à la fonction
Certaines fonctions peuvent se servir d'opérateurs particuliers comme arguments. Par exemple, la fonction Previous 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.
20 2012-05-10
Notions de contextes de calcul
Notions de contextes de calcul
4.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
•
•
4.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.
21 2012-05-10
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
En-tête de section et pieds de page de bloc
Lignes du bloc
Contexte d'entrée
Année
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, Sum) pour laquelle ce contexte est défini.
4.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 une rupture.
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 :
22 2012-05-10
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 :
23
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.
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
2012-05-10
Notions de contextes de calcul 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.
4.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 Total : 8 000
Client
Harris
Dupont
Walsh
Total :
Total du rapport : 8 000
Revenu
1 000
3 000
4 000
8000
24 2012-05-10
Notions de contextes de calcul
Le tableau suivant présente le contexte de calcul des indicateurs dans ce rapport :
Indicateur Valeur
Total du rapport
Total de l'en-tête de section
Total du client
Total du pied de page de bloc
20 000
8000
1000, 3000, 4000
8000
Contexte
Total de tous les revenus du rapport
Année
Année;Client
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
4.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 :
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
Pied de page
Les dimensions et les indicateurs utilisés pour générer la ligne en cours.
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Le même que le contexte d'entrée.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
25 2012-05-10
Notions de contextes de calcul
4.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.
4.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 :
Le calcul se trouve dans...
En-tête
Corps du bloc
Pied de page
Pied de page VBody
Pied de page HBody
Pied de page VFooter
Pied de page HFooter
Le contexte d'entrée est…
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Les dimensions et les indicateurs utilisés pour générer la colonne courante.
Les dimensions et les indicateurs utilisés pour générer la ligne courante.
Identique au pied de page.
Identique au pied de page.
Le contexte de sortie est…
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Le même que le contexte d'entrée.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
26 2012-05-10
Notions de contextes de calcul
Exemple : Contextes par défaut dans un tableau croisé
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
4.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 :
Le calcul se trouve dans...
Corps
Le contexte d'entrée est… Le contexte de sortie est…
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.
Exemple : Contextes par défaut dans une section
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
27 2012-05-10
Notions de contextes de calcul
4.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 :
Le calcul se trouve dans...
En-tête
Pied de page
Le contexte d'entrée est… Le contexte de sortie est…
Instance en cours de la rupture.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Instance en cours de la rupture.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Exemple : Contextes par défaut dans une rupture
Le rapport suivant présente les contextes par défaut dans une rupture :
28 2012-05-10
Notions de contextes de calcul
4.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.
4.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 :
Opérateur
Dans
PourChaque
PourTout
Description
Spécifie une liste explicite de dimensions à utiliser dans le contexte
Ajoute des dimensions au contexte par défaut
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.
29 2012-05-10
Notions de contextes de calcul
4.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
2001
2002
2003
Revenu des ventes
8 096 123,60 €
13 232 246,00 €
15 059 142,80 €
Revenu trimestriel max.
2 660 699,50 €
4 186 120,00 €
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 :
30 2012-05-10
Notions de contextes de calcul
Année
2001
2001
2001
2001
Année
Trimestre
T1
T2
T3
T4
Max. :
Trimestre
T1
T2
T3
T4
Max. :
Revenu des ventes
2 660 699,50 €
2 279 003,00 €
1 367 841,00 €
1 788 580,00 €
2 660 699,50 €
Revenu des ventes
3 326 172,00 €
2 840 651,00 €
2 879 303,00 €
4 186 120,00 €
4 186 120,00 €
Année Trimestre
T1
T2
T3
T4
Max. :
Revenu des ventes
3 742 989,00 €
4 006 717,50 €
3 953 395,00 €
3 356 041,00 €
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.
31 2012-05-10
Notions de contextes de calcul
32
4.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
2001
2002
2003
Revenu des ventes
8 096 123,60
13 232 246,00
15 059 142,80
Revenu trimestriel max.
2 660 699,50
4 186 120,00
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]).
4.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 :
2012-05-10
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.
4.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.
4.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 :
33 2012-05-10
Notions de contextes de calcul
Placé dans…
Un bloc
Une rupture de bloc (en-tête ou pied)
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Toutes les données du rapport
Toutes les données du rapport
Toutes les données du rapport
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.
34
La formule pour la colonne Rapport total est Sum([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]).
4.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 :
Placé dans…
Un bloc
Une rupture de bloc (en-tête ou pied)
Fait référence à…
Toutes les données de la section
Toutes les données de la section
2012-05-10
Notions de contextes de calcul
Placé dans…
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Toutes les données de la section
Non applicable
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes.
35
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é.
4.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 :
Placé dans…
Un bloc
Un saut de bloc (en-tête ou pied)
Fait référence à…
Toutes les données dans la partie du bloc délimité par un saut
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)
A l'extérieur des blocs ou sections
Non applicable
Non applicable
2012-05-10
Notions de contextes de calcul
36
Exemple : Mot clé Saut
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes :
Année
2001
Trimestre
T1
T2
T3
T4
Revenu des ventes
2 660 700 €
2 279 003 €
1 367 841 €
1 788 580 €
Total Saut
8 096 124 €
8 096 124 €
8 096 124 €
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é Rupture, cette colonne dupliquerait les chiffres de la colonne Chiffres d'affaires, car le contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
4.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…
Un bloc
Une rupture de bloc (en-tête ou pied)
Fait référence à…
Toutes les données du bloc, sans tenir compte des ruptures, en respectant les filtres
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)
A l'extérieur des blocs ou sections
Non applicable
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.
2012-05-10
Notions de contextes de calcul
37
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.
4.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 :
Placé dans…
Un bloc
Une rupture de bloc (en-tête ou pied)
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Toutes les données du bloc
Toutes les données du bloc
Toutes les données de la section
Toutes les données du rapport
2012-05-10
Notions de contextes de calcul
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
2001
2001
Trimestre
T1
T2
T3
T4
Revenu des ventes
2 660 700
2 279 003
1 367 841
1 788 580
8 096 123,6
Corps
2 660 699,5
2 279 003
1 367 840,7
1 788 580,4
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 corps.
4.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é :
38 2012-05-10
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 :
39 2012-05-10
Notions de contextes de calcul
40
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.
2012-05-10
Calcul de valeurs à l'aide d'indicateurs intelligents
Calcul de valeurs à l'aide d'indicateurs intelligents
5.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.
Lorsque vous modifiez ce type de rapport, le message #TOREFRESH est automatiquement inséré dans le rapport pour vous rappeler que ce dernier doit être actualisé pour pouvoir visualiser les modifications apportées.
Les indicateurs intelligents se comportent différemment des indicateurs classiques, qui prennent en charge un ensemble basique de fonctions d'agrégation (Max, Min, Count, Sum, Average) 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 la requête générée.
5.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.
41 2012-05-10
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.
5.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.
42 2012-05-10
Calcul de valeurs à l'aide d'indicateurs intelligents
5.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.
5.4 Indicateurs intelligents et SQL
5.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.
43 2012-05-10
Calcul de valeurs à l'aide d'indicateurs intelligents
44
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
2012-05-10
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
5.5 Indicateurs intelligents et formules
5.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 :
Semestre
H1
H2
Revenu
#INDISPONIBLE
#INDISPONIBLE
45 2012-05-10
Calcul de valeurs à l'aide d'indicateurs intelligents
5.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
Etats-Unis
Etats-Unis
Etats-Unis
Etats-Unis
Région
Nord
Sud
Est
Ouest
Revenu
10 000
15 000
14 000
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
•
5.6 Indicateurs intelligents et filtres
5.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.
46 2012-05-10
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
France
Etats-Unis
Somme :
Chiffre d'affaires
#INDISPONIBLE
#INDISPONIBLE
#INDISPONIBLE
Si vous limitez Lieu de séjour à "Plage des Bahamas", les valeurs s'affichent.
Pays
Etats-Unis
Somme :
Chiffre d'affaires
971 444
971 444
5.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.
47 2012-05-10
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
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Somme :
Chiffre d'affaires
835 420
971 444
1 479 660
3 286 524
Si vous appliquez un filtre Chiffre d'affaires > 900 000 au bloc, le total affiche
#INDISPONIBLE.
Pays
Etats-Unis
US
Lieu de séjour
Bahamas Beach
Hawaiian Club
Somme :
Chiffre d'affaires
971 444
1 479 660
#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).
5.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.
48 2012-05-10
Calcul de valeurs à l'aide d'indicateurs intelligents
5.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 :
• 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.
49 2012-05-10
Calcul de valeurs à l'aide d'indicateurs intelligents
50 2012-05-10
Fonctions, opérateurs et mots clés
Fonctions, opérateurs et mots clés
6.1 Fonctions
Les fonctions se divisent en plusieurs catégories qui sont les suivantes :
Catégorie
Aggregate
Caractère
Date et heure
Document
Fournisseur de données
Logique
Numérique
Divers
Ensemble
Description
Données agrégées (par exemple, en effectuant le total ou la moyenne d'un ensemble de valeurs)
Manipule des chaînes de caractères
Renvoie des données de date et heure
Renvoie des données relatives à un document
Renvoie des données sur le fournisseur de données d'un document
Renvoie VRAI ou FAUX
Renvoie des données numériques
Fonctions ne correspondant à aucune des catégories précédentes
Renvoie des ensembles de membres de hiérarchies
6.1.1 Fonction du groupe Aggregate
51 2012-05-10
Fonctions, opérateurs et mots clés
6.1.1.1 Aggregate
Description
Renvoie l'agrégation par défaut d'un indicateur pour un ensemble de membres donné
Groupe de fonctions
Aggregate
Syntaxe
num Aggregate(indicateur[;ensemble_de_membres]
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
Oui ensemble_de_membres
Ensemble de membres utilisé pour calculer l'agrégation
Ensemble de membres
Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Aggregate.
• Si vous incluez ensemble_de_membres, la fonction Aggregate 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 Sum et que [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), Aggregate([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
52 2012-05-10
Fonctions, opérateurs et mots clés
53
6.1.1.2 Average
Description
Renvoie la valeur moyenne d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
num Average(indicateur[;ensemble_de_membres][;InclureVide])
Entrée
Paramètre
indicateur ensemble_de_membres
InclureVide
Description
Tout indicateur
Un ensemble de membres
Inclut les lignes vides dans le calcul
Type
Indicateur
Ensemble de membres
Mot clé
Obligatoire
Oui
Non
Non
(les lignes vides sont exclues par défaut)
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Average.
• Si vous incluez ensemble_de_membres, la fonction Average 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, Ave rage([Chiffre d'affaires]) renvoie 40 552.
Si [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , Ave rage([Chiffre d'affaires];[Géographie]&[EU].[Californie].enfants) renvoie le chiffre d'affaires moyen de toutes les villes de Californie.
2012-05-10
Fonctions, opérateurs et mots clés
Rubriques associées
•
Référence à des membres et des ensembles de membres des hiérarchies
•
6.1.1.3 Count
Description
Renvoie le nombre de valeurs d'un ensemble de valeurs
Groupe de fonctions
Aggregate
Syntaxe
entier Count(données_agrégées[;ensemble_de_membres][;InclureVide][;Distinct|Tous])
Entrée
Paramètre Description Type
données_agrégées
Tout indicateur, dimension, hiérarchie, niveau ou ensemble de membres
Dimension, indicateur, hiérarchie, ensemble de membres ensemble_de_membres
Ensemble de membres utilisé pour calculer le nombre
Ensemble de membres
InclureVide Inclut des valeurs vides dans le calcul
Distinct|Tout
Inclut les valeurs distinctes uniquement (par défaut pour les dimensions) ou toutes les valeurs
(par défaut pour les indicateurs) dans le calcul
Mot clé
Mot clé
Obligatoire
Oui
Non
Non
Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Count.
• 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 Count 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 {}.
54 2012-05-10
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
Count("Test") renvoie 1
Count([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.
Count([Ville];Tout) renvoie 10 s'il existe 10 villes différentes dans une liste de villes, même si certaines sont des doublons.
Count ([Ville];InclureVide) renvoie 6 s'il existe 5 villes et une ligne vide dans une liste de villes.
Count([Produit];{Géographie]&[Etat) renvoie le nombre total de membres au niveau [Etat] de la hiérarchie [Géographie].
Rubriques associées
•
•
55
6.1.1.4 Premier
Description
Renvoie la première valeur d'un ensemble de données
Groupe de fonctions
Aggregate
Syntaxe
type_entrée First(dimension|indicateur)
Entrée
Paramètre
dimension|indicateur
Description Type
Toute dimension ou tout indicateur
Dimension ou indicateur
Obligatoire
Oui
Remarques
• Lorsque First est placé dans un pied de rupture, la première valeur de la rupture est renvoyée.
• Lorsque First est placé dans un pied de section, la première valeur de la section est renvoyée.
2012-05-10
Fonctions, opérateurs et mots clés
Exemples
Lorsque First([Chiffre d'affaires]) est placé dans un pied de tableau, la première valeur de
[Chiffre d'affaires] est renvoyée dans le tableau.
56
6.1.1.5 Dernier
Description
Renvoie la dernière valeur d'une dimension ou d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
type_entrée Dernier(dimension|indicateur)
Entrée
Paramètre
dimension|indicateur
Description Type
Toute dimension ou tout indicateur
Dimension ou indicateur
Obligatoire
Oui
Remarques
• Lorsque Last est placé dans un pied de rupture, la dernière valeur de la rupture est renvoyée.
• Lorsque Last est placé dans un pied de section, la dernière valeur de la section est renvoyée.
Exemples
Lorsque First([Chiffre d'affaires]) est placé dans un pied de tableau, la première valeur de
[Chiffre d'affaires] est renvoyée dans le tableau.
6.1.1.6 Max
Description
Renvoie la plus grande valeur d'un ensemble de valeurs
Groupe de fonctions
Aggregate
Syntaxe
type_de_saisie Max(données_agrégées[;ensemble_de_membres])
2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre Description
données_agrégées
Tout indicateur, dimension, hiérarchie, niveau ou ensemble de membres ensemble_de_membres
Un ensemble de membres
Type
Dimension, indicateur, hiérarchie, niveau ou ensemble de membres
Ensemble de membres
Obligatoire
Oui
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.
6.1.1.7 Median
Description
Renvoie la médiane (valeur centrale) d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
numérique Median(indicateur)
57 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
Oui
Remarques
Si l'ensemble de nombres comporte un nombre de valeurs pair, la fonction Median prend la moyenne des deux valeurs centrales.
Exemples
Median([Chiffre d'affaires]) renvoie 971 444 si [Chiffre d'affaires] possède les valeurs
835 420, 971 444 et 1 479 660.
58
6.1.1.8 Min
Description
Renvoie la plus petite valeur d'un ensemble de valeurs
Groupe de fonctions
Aggregate
Syntaxe
tout_type Min(données_agrégées[;ensemble_de_membres])
Entrée
Paramètre Description
données_agrégées
Tout indicateur, dimension, hiérarchie, niveau ou ensemble de membres ensemble_de_membres
Un ensemble de membres
Type
Dimension, indicateur, hiérarchie, niveau ou ensemble de membres
Ensemble de membres
Obligatoire
Oui
Non
Remarques
• 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.
2012-05-10
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].
6.1.1.9 Mode
Description
Renvoie la valeur d'un ensemble de données qui apparaît le plus souvent
Groupe de fonctions
Aggregate
Syntaxe
input_type Mode(dimension|measure)
Entrée
Paramètre
dimension|indicateur
Description Type
Toute dimension ou indicateur
Indicateur
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.
59 2012-05-10
Fonctions, opérateurs et mots clés
60
6.1.1.10 Pourcentage
Description
Exprime une valeur d'indicateur en tant que pourcentage de son contexte
Groupe de fonctions
Aggregate
Syntaxe
num Percentage(indicateur[;Rupture][;Ligne|Col])
Entrée
Paramètre
indicateur
Rupture
Ligne|Col
Description
Tout indicateur
Type
Indicateur
Prend en compte les ruptures de tableau
Mot clé
Définit le sens du calcul Mot clé
Obligatoire
Oui
Non
Non
Exemples
Dans le tableau suivant, la colonne Pourcentage contient la formule Percentage ([Revenu des ventes])
.
Année
2001
2002
2003
Somme :
Chiffre d'affaires
1 000
5 000
4 000
10 000
Pourcentage
10
50
40
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)
Année
2001
Trimestre
T1
Revenu des ventes
1 000
Pourcentage
10
2012-05-10
Fonctions, opérateurs et mots clés
2001
T2
T3
T4
Somme :
2 000
5 000
2 000
10 000
20
50
20
100
Année
2002
2002
Trimestre
T1
T2
T3
T4
Somme :
Revenu des ventes
2 000
2 000
5 000
1 000
10 000
Pourcentage
20
20
50
10
100
Vous pouvez utiliser la fonction Percentage 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 Percentage ([Revenu des ventes];Ligne).
2001
2002
T1
1 000
2 000
%
10
20
T2
2 000
2 000
%
20
20
T3
5 000
5 000
%
50
50
T4
2 000
1 000
%
20
10
6.1.1.11 Percentile
Description
Renvoie le nième centile d'un indicateur
Groupe de fonctions
Numérique
Syntaxe
numérique Percentile(indicateur;centile)
61 2012-05-10
Fonctions, opérateurs et mots clés
62
Entrée
Paramètre
indicateur centile
Description
Tout indicateur
Un pourcentage exprimé sous forme décimale
Type
Indicateur
Nombre
Obligatoire
Oui
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.
6.1.1.12 Product
Description
Multiplie les valeurs d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
numérique Product(indicateur)
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Exemples
Product([Indicateur]) renvoie 30 si [Indicateur] a les valeurs 2, 3, 5.
Obligatoire
Oui
6.1.1.13 RunningAverage
Description
Renvoie la moyenne cumulative d'un indicateur
2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Aggregate
Syntaxe
num RunningAverage(indicateur[;Ligne|Col][;InclureVide][;(réinit_dims)])
Entrée
Paramètre
indicateur
Ligne|Col
InclureVide dim_redéfinies
Description
Tout indicateur
Définit le sens du calcul
Inclut des valeurs vides dans le calcul
Type
Indicateur
Mot clé
Mot clé
Réinitialise le calcul selon les dimensions spécifiées
Liste Dimension
Obligatoire
Oui
Non
Non
Non
Remarques
• Vous pouvez utiliser des opérateurs de contexte de syntaxe étendue avec RunningAverage.
• 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 RunningAverage, 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.
•
RunningAverage ne réinitialise pas automatiquement la moyenne après un saut de bloc ou une nouvelle section.
Exemples
RunningAverage([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
US
US
France
Lieu de séjour
Hawaiian Club
Bahamas Beach
Côte d'Azur
Chiffre d'affaires
1 479 660
971 444
835 420
Moyenne cumulative
835 420
1 225 552
1 095 508
RunningAverage([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Pays
US
Lieu de séjour
Hawaiian Club
Chiffre d'affaires
1 479 660
Moyenne cumulative
835 420
63 2012-05-10
Fonctions, opérateurs et mots clés
US
France
Rubriques associées
•
•
Bahamas Beach
Côte d'Azur
971 444
835 420
1 225 552
835 420
6.1.1.14 RunningCount
Description
Renvoie le total cumulatif d'un ensemble de nombres
Groupe de fonctions
Aggregate
Syntaxe
num RunningCount(dimension|indicateur[;Ligne|Col][;InclureVide][;(réinit_dims)])
Entrée
Paramètre
dimension|indicateur
Ligne|Col
InclureVide dim_redéfinies
Description
Toute dimension ou tout indicateur
Définit le sens du calcul
Inclut des valeurs vides dans le calcul
Réinitialise le calcul selon les dimensions spécifiées
Type Obligatoire
Dimension ou indicateur
Oui
Mot clé
Mot clé
Liste Dimension
Non
Non
Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction RunningCount.
• 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 RunningCount, 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.
64 2012-05-10
Fonctions, opérateurs et mots clés
•
RunningCount ne réinitialise pas automatiquement le total après un saut de bloc ou une nouvelle section.
Exemples
RunningCount([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
US
US
France
Lieu de séjour
Hawaiian Club
Bahamas Beach
Côte d'Azur
Chiffre d'affaires
1 479 660
971 444
835 420
2
3
Nombre cumulatif
1
RunningCount([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Pays
US
US
France
Lieu de séjour
Hawaiian Club
Bahamas Beach
Côte d'Azur
Chiffre d'affaires
1 479 660
971 444
835 420
Nombre cumulatif
1
2
1
Rubriques associées
•
•
•
•
6.1.1.15 RunningMax
Description
Renvoie le maximum cumulatif d'une dimension ou d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
input_type RunningMax(dimension|measure[;Row|Col][;(reset_dims)])
65 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
dimension|indicateur
Ligne|Col dim_redéfinies
Description
Toute dimension ou tout indicateur
Type Obligatoire
Dimension ou indicateur
Oui
Définit le sens du calcul Mot clé
Réinitialise le calcul selon les dimensions spécifiées
Liste Dimension
Non
Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction RunningMax.
• 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 RunningMax, 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.
•
RunningMax ne réinitialise pas automatiquement le maximum après un saut de bloc ou une nouvelle section.
Exemples
RunningMax([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Chiffre d'affaires
835 420
971 444
1 479 660
Maximum cumulatif
835 420
971 444
1 479 660
Rubriques associées
•
•
6.1.1.16 RunningMin
Description
Renvoie le minimum cumulatif d'une dimension ou d'un indicateur
66 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Aggregate
Syntaxe
type_entrée RunningMin(dimension|indicateur;[Ligne|Col];[(réinit_dimensions)])
Entrée
Paramètre Description
dimension|détail|indicateur
Toute dimension ou indicateur
Ligne|Col dim_redéfinies
Type
Définit le sens du calcul Mot clé
Réinitialise le calcul selon les dimensions spécifiées
Liste Dimension
Obligatoire
Dimension ou indicateur
Oui
Non
Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction RunningMin.
• 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 RunningMin, 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.
•
RunningMin ne réinitialise pas automatiquement le minimum après un saut de bloc ou une nouvelle section.
Exemples
RunningMin([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Chiffre d'affaires
835 420
971 444
1 479 660
Minimum cumulatif
835 420
835 420
835 420
Rubriques associées
•
•
67 2012-05-10
Fonctions, opérateurs et mots clés
68
6.1.1.17 RunningProduct
Description
Renvoie le produit cumulatif d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
num RunningProduct(indicateur[;Ligne|Col][;(réinit_dims)])
Entrée
Paramètre
indicateur
Ligne|Col dim_redéfinies
Description
Tout indicateur
Type
Indicateur
Définit le sens du calcul Mot clé
Réinitialise le calcul selon les dimensions spécifiées
Liste Dimension
Obligatoire
Oui
Non
Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction RunningPro duct
.
• 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 RunningProduct, 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.
•
RunningProduct ne réinitialise pas automatiquement le produit après un saut de bloc ou une nouvelle section.
Exemples
RunningProduct([Nombre d'invités]) renvoie ces résultats dans le tableau suivant :
Pays d'origine
Japon
Japon
US
Ville
Kobe
Osaka
Chicago
Nombre d'invités
6
4
241
Produit cumulatif
6
24
5 784
2012-05-10
Fonctions, opérateurs et mots clés
RunningProduct([Nombre d'invités]);([Pays d'origine]) renvoie ces résultats dans le tableau suivant :
Pays d'origine
Japon
Japon
US
Ville
Kobe
Osaka
Chicago
Nombre d'invités
6
4
241
Produit cumulatif
6
24
5 784
Rubriques associées
•
•
69
6.1.1.18 RunningSum
Description
Renvoie la somme cumulative d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
num RunningSum(indicateur[;Ligne|Col][;(réinit_dims)])
Entrée
Paramètre
indicateur
Ligne|Col dim_redéfinies
Description
Tout indicateur
Définit le sens du calcul
Type
Indicateur
Mot clé
Réinitialise le calcul selon les dimensions spécifiées
Liste Dimension
Obligatoire
Oui
Non
Non
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction RunningSum.
• 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 RunningSum, le calcul de la somme 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.
2012-05-10
Fonctions, opérateurs et mots clés
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
•
RunningSum ne réinitialise pas automatiquement la somme après un saut de bloc ou une nouvelle section.
Exemple
RunningSum([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Chiffre d'affaires
835 420
971 444
1 479 660
Somme cumulative
835 420
1 806 864
3 286 524
RunningSum([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Pays
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Chiffre d'affaires
835 420
971 444
1 479 660
Somme cumulative
835 420
971 444
2 451 104
Rubriques associées
•
•
6.1.1.19 ValeurServeur
Description
Renvoie la valeur de la base de données d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
num ValeurServeur([indicateur])
70 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
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]
71
6.1.1.20 Ecartype
Description
Renvoie l'écart type d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
numérique EcartType(indicateur)
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
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.
2012-05-10
Fonctions, opérateurs et mots clés
Rubriques associées
•
6.1.1.21 EcartTypeP
Description
Renvoie l'écart type de population d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
numérique EcartTypeP(indicateur)
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
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.
6.1.1.22 Sum
72 2012-05-10
Fonctions, opérateurs et mots clés
73
Description
Renvoie la somme d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
num Sum(indicateur[;ensemble_de_membres])
Entrée
Paramètre
indicateur
Description
Tout indicateur ensemble_de_membres Un ensemble de membres
Type
Indicateur
Obligatoire
Oui
Ensemble de membres Non
Remarques
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la fonction Sum.
• Si vous incluez ensemble_de_membres, Sum 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, Sum([Chiffre d'affaires]) renvoie 10 000.
Si [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , Sum([Chiffre d'affaires];Descendants([Géographie]&[EU].[Californie];1)) renvoie le chiffre d'affaires total de toutes les villes de Californie.
6.1.1.23 Var
Description
Renvoie la variance d'un indicateur
Groupe de fonctions
Aggregate
2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
numérique Var(indicateur)
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
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
•
6.1.1.24 VarP
Description
Renvoie la variance de population d'un indicateur
Groupe de fonctions
Aggregate
Syntaxe
numérique VarP(indicateur)
74 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
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
•
6.1.2 Fonctions du groupe Character
6.1.2.1 Asc
Description
Renvoie la valeur ASCII d'un caractère
Groupe de fonctions
Caractère
Syntaxe
entier Asc(chaîne)
75 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
chaîne
Description Type
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".
6.1.2.2 Char
Description
Renvoie le caractère associé à un code ASCII
Groupe de fonctions
Caractère
Syntaxe
chaîne Char(code_ascii)
Entrée
Paramètre
code_ascii
Description
Un code ASCII
Type
Nombre
Remarques
Si nombre est un décimal, la fonction ignore la partie décimale.
Exemple
s
Char(123) renvoie "{".
Obligatoire
Oui
76 2012-05-10
Fonctions, opérateurs et mots clés
77
6.1.2.3 Concaténation
Description
Concatène (joint) deux chaînes de caractères.
Groupe de fonctions
Caractère
Syntaxe
chaîne Concatenation(première_chaîne;seconde_chaîne)
Entrée
Paramètre
première_chaîne deuxième_chaîne
Description
La première chaîne
La seconde chaîne
Type
Chaîne
Chaîne
Obligatoire
Oui
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, Count([Représentant]+[Trimestre]+[Lieu de séjour] est équivalent à la syntaxe Count<Représentant>,<Trimestre>,<Lieu de séjour> autorisée par Desktop
Intelligence.
Exemples
Concatenation("Premier ";"Second") renvoie "Premier Second"
Concatenation("Premier ";Concaténation("Second ";"Troisième")) renvoie "Premier
Second Troisième".
6.1.2.4 Fill
Description
Construit une chaîne en répétant une chaîne n fois
2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne Fill(répétition_chaîne;nombre_répétitions)
Entrée
Paramètre
chaîne_à_répéter nombre_de_répétitions
Description
La chaîne à répéter
Type
Chaîne
Le nombre de répétitions Nombre
Exemples
Fill("New York";2) renvoie "New York New York".
Obligatoire
Oui
Oui
6.1.2.5 FormatDate
Description
Formate une date selon le format spécifié
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatDate(date;chaîne_format)
Entrée
Paramètre
date chaîne_format
Description
Le format à appliquer
Type
La date à laquelle appliquer le format de date
Date
Chaîne
Obligatoire
Oui
Oui
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 FormatDate.
Exemples
FormatDate(DateActuelle();"dd/MM/yyyy") renvoie "15/12/2005" si la date actuelle est le
15 décembre 2005.
78 2012-05-10
Fonctions, opérateurs et mots clés
79
6.1.2.6 FormatNumber
Description
Formate un nombre selon un format spécifié
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatNumber(nombre;chaîne_format)
Entrée
Paramètre
nombre chaîne_format
Description
Le nombre à formater
Le format à appliquer
Type
Nombre
Chaîne
Obligatoire
Oui
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 FormatNumber.
Exemples
FormatNumber[Revenu des ventes];"# ###,00") renvoie 835 420,00 si [Revenu des ventes] est d'une valeur de 835 420.
6.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)
2012-05-10
Fonctions, opérateurs et mots clés
80
Entrée
Paramètre
html
Description
Une chaîne HTML
Type
Chaîne
Obligatoire
Oui
Exemples
HTMLEncode("http://www.sap.com") renvoie "http%3A%2F%2Fwww%2Esap%2Ecom".
6.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 InitCap(chaîne)
Entrée
Paramètre
chaîne
Description Type
La chaîne à mettre en majuscules
Chaîne
Obligatoire
Oui
Exemples
InitCap("ces vérités sont évidentes") renvoie "Ces vérités sont évidentes".
6.1.2.9 Gauche
Description
Retourne les caractères les plus à gauche dans une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne Left(chaîne;nombre_car)
2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
chaîne nombre_car
Description
La chaîne entrée.
Le nombre de caractères à retourner à partir de la gauche
Exemples
Left([Pays];2) retourne "Fr" si [Pays] est "France".
Type
chaîne nombre
Obligatoire
Oui
Oui
6.1.2.10 LeftPad
Description
Remplit une chaîne à gauche avec une autre chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne LeftPad(chaîne_complétée,longueur,chaîne_gauche)
Entrée
Paramètre Description
chaîne_complétée La chaîne d'origine longueur la longueur de la chaîne de sortie chaîne_gauche La chaîne à ajouter à gauche de la chaîne_complétée
Type
Chaîne
Nombre
Chaîne
Obligatoire
Oui
Oui
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
LeftPad("York";8;"New ") renvoie "New York"
81 2012-05-10
Fonctions, opérateurs et mots clés
LeftPad("York",6,"New") renvoie "NeYork".
LeftPad("York";11;"New ") renvoie "New NewYork"
LeftPad("New "; 2;"York") renvoie "New".
6.1.2.11 LeftTrim
Description
Supprime les espaces à gauche d'une chaîne de caractères
Groupe de fonctions
Caractère
Syntaxe
chaîne LeftTrim(chaîne_à_traiter)
Entrée
Paramètre
chaîne_raccourcie
Description
La chaîne à traiter.
Type
Chaîne
Exemples
LeftTrim([Pays]) renvoie "France" si [Pays] est " France".
6.1.2.12 Longueur
Description
Renvoie le nombre de caractères d'une chaîne.
Groupe de fonctions
Caractère
Syntaxe
entier Length(chaîne)
Obligatoire
Oui
82 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
chaîne
Description
La chaîne entrée.
Exemples
Length([Nom]) renvoie 6 si [Nom] est "Martin".
Type
Chaîne
6.1.2.13 Minuscule
Description
Convertit une chaîne en minuscules
Groupe de fonctions
Caractère
Syntaxe
chaîne Lower(chaîne)
Entrée
Paramètre
chaîne
Description Type
La chaîne à convertir en minuscules
Chaîne
Exemples
Lower("New York") renvoie "new york".
6.1.2.14 Comparaison
Description
détermine si une chaîne correspond à un modèle.
Groupe de fonctions
Caractère
Syntaxe
booléen Match(chaîne_test;modèle)
83
Obligatoire
Oui
Obligatoire
Oui
2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
chaîne_test modèle
Description
La chaîne à comparer au modèle de texte chaîne
La
Type
chaîne du modèle de texte
Obligatoire
Oui
Oui
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
Match([Pays];"F*") renvoie True si [Pays] est "France".
Match([Pays];"?S?") renvoie True si [Pays] est "USA".
Match("New York";"P*") renvoie la valeur False.
6.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
chaîne_test modèle
Description
La chaîne à vérifier dans le modèle de texte
La
Type
chaîne chaîne du modèle de texte
Obligatoire
Oui
Oui
Remarques
• Si le modèle apparaît plusieurs fois, Pos renvoie la position de la première occurrence.
84 2012-05-10
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.
6.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
remplacer_dans La chaîne dans laquelle le texte est remplacé
Le texte à remplacer chaîne_remplacée chaîne_de_remplacement
Le texte qui remplace chaîne_rem placée
Type
chaîne chaîne chaîne
Exemples
Remplacer("New YORK";"ORK";"ork") renvoie "New York"
6.1.2.17 Droite
Description
Renvoie les caractères les plus à droite dans une chaîne
Groupe de fonctions
Caractère
Obligatoire
Oui
Oui
Oui
85 2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
chaîne Right(chaîne;nombre_de_caractères)
Entrée
Paramètre
chaîne
Description
N'importe quelle chaîne nombre_de_caractères
Le nombre de caractères à renvoyer à partir de la droite
Exemples
Right([Pays];2) renvoie "ce" si [Pays] est "France".
Type
chaîne nombre
Obligatoire
Oui
Oui
6.1.2.18 RightPad
Description
Remplit une chaîne à droite avec une autre chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne RightPad(chaîne_complétée;longueur;chaîne_droite)
Entrée
Paramètre Description
chaîne_complétée La chaîne d'origine longueur chaîne_droite la longueur de la chaîne de sortie
La chaîne à ajouter à droite de la chaîne_complétée
Type
Chaîne
Nombre
Chaîne
Obligatoire
Oui
Oui
Oui
Remarques
• 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.
86 2012-05-10
Fonctions, opérateurs et mots clés
Exemples
RightPad("New ";8;"York") renvoie "New York"
RightPad("New "; 6;"York") renvoie "New Yo"
RightPad("New ";11;"York") renvoie "New YorkYor"
RightPad("New "; 2;"York") renvoie "New".
6.1.2.19 RightTrim
Description
Supprime les espaces de fin de chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne RightTrim(chaîne_raccourcie)
Entrée
Paramètre
chaîne_raccourcie
Description
La chaîne à traiter.
Type
Chaîne
Exemples
RightTrim([Pays]) renvoie "France" si [Pays] est "France ".
6.1.2.20 Substr
Description
Renvoie une partie d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne Substr(chaîne;début;longueur)
Obligatoire
Oui
87 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
chaîne début longueur
Description
N'importe quelle chaîne
La position de départ de la chaîne extraite
La longueur de la chaîne extraite
Type
Chaîne
Nombre
Nombre
Exemples
Substr("Grande Bretagne";1;6) renvoie "Grande".
Substr("Grande Bretagne";8;8) renvoie "Bretagne".
6.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
chaîne
Description
La chaîne à traiter.
Type
Chaîne
Exemples
Trim(" Grande Bretagne ") renvoie "Grande Bretagne".
6.1.2.22 Majuscule
Description
Convertit une chaîne en majuscules
Obligatoire
Oui
Oui
Oui
Obligatoire
Oui
88 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne Majuscule(chaîne)
Entrée
Paramètre
chaîne
Description
La chaîne à convertir
Type
Chaîne
Exemples
Majuscule("New York") renvoie "NEW YORK".
Obligatoire
Oui
6.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
html
Description
L'URL à encoder
Type
Chaîne
Obligatoire
Oui
Exemples
UrlEncode("http://www.sap.com") renvoie "http%3A%2F%2Fwww%2Esap%2Ecom".
6.1.2.24 WordCap
Description
Met en majuscule la première lettre de chaque mot d'une chaîne
89 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Caractère
Syntaxe
chaîne WordCap(chaîne)
Entrée
Paramètre
chaîne
Description Type
La chaîne qui va être mise en majuscules
Chaîne
Obligatoire
Oui
Exemples
WordCap("Chiffre d'affaires de mars") renvoie "Chiffre D'affaires De Mars".
6.1.3 Fonctions du groupe Date and Time
90
6.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 CurrentDate()
Exemples
CurrentDate() renvoie 10 septembre 2002 si la date est le 10 septembre 2002.
6.1.3.2 CurrentTime
Description
Renvoie l'heure actuelle au format conforme aux paramètres régionaux
2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
heure CurrentTime()
Exemples
CurrentTime renvoie 11:15 si l'heure actuelle est 11 h 15.
6.1.3.3 DayName
Description
Renvoie le nom du jour correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne DayName(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
DayName([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
DayName("07/15/2001")
.
6.1.3.4 DayNumberOfMonth
Description
Renvoie le numéro du jour dans un mois
91 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
entier DayNumberOfMonth(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
DayNumberOfMonth([Date de réservation]) renvoie 15 si [Date de réservation] est "15 décembre
2001".
6.1.3.5 DayNumberOfWeek
Description
Renvoie le numéro du jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
entier DayNumberOfWeek(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Remarques
Le lundi est considéré comme premier jour de la semaine avec cette fonction.
Exemples
DayNumberOfWeek([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).
6.1.3.6 DayNumberOfYear
92 2012-05-10
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 DayNumberOfYear(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
DayNumberOfYear([Date de réservation]) renvoie 349 si [Date de réservation] est "15 décembre
2001".
6.1.3.7 DaysBetween
Description
renvoie le nombre de jours compris entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier DaysBetween(première_date;dernière_date)
Entrée
Paramètre
première_date dernière_date
Description
La première date
La dernière date
Type
Date
Date
Obligatoire
Oui
Oui
Exemples
DaysBetween([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.
93 2012-05-10
Fonctions, opérateurs et mots clés
6.1.3.8 LastDayOfMonth
Description
Renvoie la date du dernier jour d'un mois
Groupe de fonctions
Date et heure
Syntaxe
date LastDayOfMonth(date)
Entrée
Paramètre
date
Description
N'importe quelle date du mois
Type
Date
Obligatoire
Oui
Exemples
LastDayOfMonth([Date de la vente]) renvoie 31 décembre 2005 si [Date de la vente] correspond au 11 décembre 2005.
6.1.3.9 LastDayOfWeek
Description
Renvoie la date du dernier jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
date LastDayOfWeek(date)
94 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
date
Description Type
N'importe quelle date de la semaine
Date
Obligatoire
Oui
Remarques
Le lundi est considéré comme premier jour de la semaine avec cette fonction.
Exemples
LastDayOfWeek([Date de la vente]) renvoie 15 mai 2005 (un dimanche) si [Date de la vente] correspond au 11 mai 2005.
6.1.3.10 Month
Description
Renvoie le nom du mois correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne Month(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
Month([Date de réservation]) renvoie "Décembre" si la date figurant dans [Date de réservation] correspond au 15 décembre 2005.
6.1.3.11 MonthNumberOfYear
Description
Renvoie le numéro du mois correspondant à une date
95 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Date et heure
Syntaxe
entier MonthNumberOfYear(date)
Entrée
Paramètre
date
Description Type
N'importe quelle date de l'année
Date
Obligatoire
Oui
Exemple
MonthNumberOfYear([Date de réservation]) renvoie 12 si la date figurant dans [Date de réservation] correspond au 15 décembre 2005.
6.1.3.12 MonthsBetween
Description
Renvoie le nombre de mois entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier MonthsBetween(première_date;dernière_date)
Entrée
Paramètre
première_date dernière_date
Description
La première date
La dernière date
Type
Date
Date
Obligatoire
Oui
Oui
Exemples
MonthsBetween([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.
6.1.3.13 Quarter
96 2012-05-10
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 Quarter(date)
Entrée
Paramètre
date
Description Type
N'importe quelle date du trimestre
Date
Obligatoire
Oui
Exemples
Quarter([Date de réservation]) renvoie 4 si la date figurant dans [Date de réservation] correspond au 15 décembre 2005.
6.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
date_début nombre_de_jours
Description
La date de début
Type
Date
Le nombre de jours à partir de la date de début
Nombre
Obligatoire
Oui
Oui
Remarques
Le paramètre nombre_de_jours peut être négatif pour renvoyer une date antérieure à date_début.
97 2012-05-10
Fonctions, opérateurs et mots clés
98
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.
6.1.3.15 TimeDim
Description
La dimension temporelle TimeDim permet de construire un axe de temps à partir d'un objet d'univers de type Date. TimeDim renvoie les données correspondant aux dates spécifiées en tant que premier paramètre pour les périodes indiquées comme second paramètre. Si certaines périodes ne comprennent aucune donnée, le premier jour de chaque période vide est renvoyé. On dispose ainsi d'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
TimeDim([Type de date]; Type de période)
Entrée
Paramètre Description Type
Type de date L'objet de date pour le rapport, InvoiceDate par exemple.
Date
Type de période
La période pour les résultats, à partir des valeurs suivantes :
• DayPeriod
• MonthPeriod
• QuarterPeriod
• YearPeriod
Si aucune valeur n'est sélectionnée, DayPeriod est utilisé par défaut. Cet objet doit être un objet de fournisseur de données disponible à partir des objets de rapport. Il ne peut s'agir d'une variable.
Prédéfini
Obligatoire
Oui
Facultatif
Utilisez la fonction ci-dessus conjointement avec les fonctions suivantes :
2012-05-10
Fonctions, opérateurs et mots clés
• DayName
• DayNumberOfMonth
• DayNumberOfWeek
• DayNumberOfYear
• Month
• MonthNumberOfYear
• Quarter
• Year
• FormatDate
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
1/3/00
1/8/00
7/3/00
Chiffre d'affaires
31 607
31 244
38 154
La formule DayName(TimeDim([Date de la facture] ; QuarterPeriod) renvoie les valeurs journalières du tableau ci-dessus.
Date de la facture
1/3/00
1/8/00
4/1/00
7/3/00
Chiffre d'affaires
31 607
31 244
38 154
Vous devez mettre en forme les résultats de la fonction TimeDim avec la fonction Quarter pour renvoyer les résultats par trimestre (T1, T2, etc.) afin d'obtenir le tableau de résultats suivant :
99 2012-05-10
Fonctions, opérateurs et mots clés
Date de la facture
T1
T2
T3
Chiffre d'affaires
62 851
38 154
6.1.3.16 EnDate
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
chaîne_date format
Description
Date à formater
Le format de date
Type
chaîne chaîne
Obligatoire
Oui
Oui
Exemples
EnDate("15/12/2002";"dd/MM/yyyy") renvoie 15 décembre 2002.
6.1.3.17 Week
Description
Renvoie le numéro de la semaine de l'année
Groupe de fonctions
Date et heure
Syntaxe
entier Week(date)
100 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
Week([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).
6.1.3.18 Year
Description
Renvoie l'année correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
entier Year(date)
Entrée
Paramètre
date
Description
La date saisie
Type
Date
Obligatoire
Oui
Exemples
Year([Date de réservation]) renvoie 2005 si la date figurant dans [Date de réservation] est le
15 décembre 2005.
6.1.4 Fonctions du groupe Data Provider
6.1.4.1 Connexion
101 2012-05-10
Fonctions, opérateurs et mots clés
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 Connection(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
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.
6.1.4.2 DataProvider
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 DataProvider(obj)
Entrée
Paramètre
obj
Description
Un objet de rapport
Type
Objet rapport
Obligatoire
Oui
Exemples
DataProvider([Revenu total]) renvoie "Ventes" si l'indicateur [Revenu total] se trouve dans un fournisseur de données appelé "Ventes".
102 2012-05-10
Fonctions, opérateurs et mots clés
6.1.4.3 DataProviderKeyDate
Description
Renvoie la date clé d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DataProviderKeyDate(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
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
DataProviderKeyDate([Ventes]) renvoie le 3 août 2007 si la date clé du fournisseur de données
Ventes est le 3 août 2007.
6.1.4.4 DataProviderKeyDateCaption
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 DataProviderKeyDateCaption(dp)
103 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
Fournisseur de données Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
DataProviderKeyDateCaption([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".
6.1.4.5 DataProviderSQL
Description
Renvoie le SQL généré par un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne DataProviderSQL(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
Fournisseur de données Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
DataProviderSQL([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.
6.1.4.6 DataProviderType
104 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie le type d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne DataProviderType(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
Fournisseur de données Oui
Remarques
•
DataProviderType 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
DataProviderType([Ventes]) renvoie "Univers" si le fournisseur de données "Ventes" est basé sur un univers.
6.1.4.7 IsPromptAnswered
Description
Détermine si une réponse a été donnée à l'invite
Groupe de fonctions
Fournisseur de données
Syntaxe
bool IsPromptAnswered([fd;]chaîne_invite)
105 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
dp chaîne_invite
Description
Texte de l'invite
Type
Chaîne
Obligatoire
Le fournisseur de données contenant l'invite
Fournisseur de données
Non
Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
IsPromptAnswered("Choisir une ville") renvoie la valeur True si une réponse a été donnée
à l'invite identifiée par le texte "Choisir une ville".
IsPromptAnswered([Ventes];"Choisir une ville") renvoie la valeur True 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].
6.1.4.8 LastExecutionDate
Description
Renvoie la date de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date LastExecutionDate(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
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 DataProvider pour fournir une référence à un fournisseur de données.
106 2012-05-10
Fonctions, opérateurs et mots clés
Exemples
LastExecutionDate([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
•
107
6.1.4.9 LastExecutionDuration
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
Syntaxe
numérique LastExecutionDuration(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
Fournisseur de données Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
LastExecutionDuration ([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.
6.1.4.10 LastExecutionTime
Description
Renvoie l'heure de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
heure LastExecutionTime(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
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 DataProvider pour fournir une référence à un fournisseur de données.
• Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
LastExecutionTime([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.
Rubriques associées
•
6.1.4.11 NumberOfDataProviders
Description
Renvoie le nombre de fournisseurs de données dans un rapport
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NumberOfDataProviders()
Exemples
NumberOfDataProviders() renvoie 2 si le rapport comporte deux fournisseurs de données.
6.1.4.12 NumberOfRows
108 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie le nombre de lignes dans un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NumberOfRows(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
Fournisseur de données Oui
Remarques
• Vous devez mettre le nom du fournisseur de données entre crochets.
• Vous pouvez utiliser la fonction DataProvider pour fournir une référence à un fournisseur de données.
Exemples
NumberOfRows([Requête 1]) renvoie 10 si le fournisseur de données "Requête 1" comporte
10 lignes.
Rubriques associées
•
6.1.4.13 RefValueDate
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 RefValueDate()
Exemples
RefValueDate() renvoie 15 décembre 2008 si la date de référence correspond au 15 décembre 2008.
109 2012-05-10
Fonctions, opérateurs et mots clés
110
6.1.4.14 RefValueUserReponse
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 RefValueUserReponse([fd;]chaîne_invite[;Index])
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type
Fournisseur de données chaîne_invite
Index
Texte de l'invite Chaîne
Indique à la fonction de renvoyer les clés primaires de base de données des valeurs d'invite
Mot clé
Obligatoire
Non
Oui
Non
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
RefValueUserReponse( "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.
RefValueUserReponse([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.
6.1.4.15 NomDeUnivers
2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie le nom de l'univers sur lequel repose un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne NomDeUnivers(dp)
Entrée
Paramètre
dp
Description
Le fournisseur de données
Type Obligatoire
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 DataProvider 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
•
6.1.4.16 UserResponse
Description
Renvoie la réponse à une invite
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne UserResponse([fd;]chaîne_invite[;Index])
111 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
dp chaîne_invite
Index
Description
Le fournisseur de données
Type
Fournisseur de données
Texte de l'invite Chaîne
Indique à la fonction de renvoyer les clés primaires de base de données des valeurs d'invite
Mot clé
Obligatoire
Non
Oui
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
UserResponse( "Quelle ville ?" ) renvoie "Los Angeles" si vous avez saisi "Los Angeles" dans l'invite "Quelle ville ?".
UserResponse ([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".
UserResponse ([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.
6.1.5 Fonctions du groupe Document
6.1.5.1 DocumentAuthor
Description
Renvoie l'identification InfoView de l'auteur du document
Groupe de fonctions
Document
112 2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
chaîne DocumentAuthor()
Exemples
DocumentAuthor() renvoie "gkn" si le nom de connexion de l'auteur du document est "gkn".
6.1.5.2 DocumentCreationDate
Description
Renvoie la date à laquelle un document a été créé
Groupe de fonctions
Document
Syntaxe
date DocumentCreationDate()
Exemples
DocumentCreationDate renvoie 15 décembre 2008 si le document a été créé le 15 décembre 2008.
6.1.5.3 DocumentCreationTime
Description
Renvoie l'heure à laquelle un document a été créé
Groupe de fonctions
Document
Syntaxe
heure DocumentCreationTime()
Exemples
DocumentCreationTime() renvoie 11:15 si le document a été créé à 11 h 15.
6.1.5.4 DocumentDate
113 2012-05-10
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 DocumentDate()
Exemples
DocumentDate () renvoie 8 août 2005 si le document a été enregistré pour la dernière fois le 8 août 2005.
6.1.5.5 DocumentName
Description
renvoie le nom du document.
Groupe de fonctions
Document
Syntaxe
chaîne DocumentName()
Exemples
DocumentName() renvoie "Rapport des ventes" si le document se nomme "Rapport des ventes".
114
6.1.5.6 DocumentOwner
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 DocumentOwner()
2012-05-10
Fonctions, opérateurs et mots clés
Exemples
DocumentOwner() renvoie "gkn" si la dernière personne à avoir enregistré le document contient un nom d'utilisateur ou une connexion "gkn".
6.1.5.7 DocumentPartiallyRefreshed
Description
Détermine si un document est partiellement actualisé
Groupe de fonctions
Document
Syntaxe
booléen DocumentPartiallyRefreshed()
Remarques
DocumentPartiallyRefreshed renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si.
Exemples
DocumentPartiallyRefreshed() renvoie True si le document est partiellement actualisé.
6.1.5.8 DocumentTime
Description
Renvoie l'heure à laquelle un document a été enregistré pour la dernière fois
Groupe de fonctions
Document
Syntaxe
heure DocumentTime()
Remarques
Le format de l'heure renvoyée varie en fonction du format de cellule.
Exemple
DocumentTime() renvoie 15:45 si le document a été enregistré pour la dernière fois à 15h:45.
115 2012-05-10
Fonctions, opérateurs et mots clés
116
6.1.5.9 DrillFilters
Description
Renvoie les filtres d'exploration appliqués à un document ou à un objet en mode Exploration
Groupe de fonctions
Document
Syntaxe
chaîne DrillFilters(obj|séparateur)
Entrée
Paramètre
obj
Description
Un objet de rapport séparateur Le séparateur du filtre d'exploration
Type
Objet rapport
Chaîne
Obligatoire
Soit obj, soit sépara teur requis
Soit obj, soit sépara teur requis
Remarques
• Vous pouvez insérer DrillFilters directement sans saisir manuellement la formule en insérant une cellule DrillFilters.
• Si vous ne spécifiez aucun objet, la fonction renvoie tous les filtres d'exploration appliqués au document.
Exemples
DrillFilters() renvoie "US" si le document possède un filtre d'exploration restreignant l'objet [Pays]
à US.
DrillFilters() renvoie "US - 1999" si le document possède un filtre limitant les objets [Pays] à
"US" et [Année] à 1999.
DrillFilters("/") renvoie "US / 1999" si le document possède des filtres limitant les objets [Pays]
à "US" et [Année] à 1999.
DrillFilters ([Trimestre]) renvoie "T3" si le document possède un filtre d'exploration limitant l'objet [Trimestre] à "T3".
6.1.5.10 PromptSummary
2012-05-10
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 PromptSummary :
Enter Quantity Sold: 5000
Enter value(s) for State (optional): California, Texas, Utah
Enter Customer (optional):
6.1.5.11 QuerySummary
Description
Renvoie des informations sur les requêtes d'un document
Groupe de fonctions
Document
Syntaxe
chaîne QuerySummary([dp])
Entrée
Paramètre
dp
Description
Un fournisseur de données
Type Obligatoire
Fournisseur de données Non
Remarques
• Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
QuerySummary() renvoie des informations sur toutes les requêtes d'un document.
QuerySummary([Requête 1]) renvoie des informations sur toutes les requêtes basées sur le fournisseur de données [Requête 1].
117 2012-05-10
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
6.1.5.12 ReportFilter
Description
Renvoie les filtres de rapport appliqués à un objet ou un rapport
Groupe de fonctions
Document
Syntaxe
chaîne ReportFilter(obj)
Entrée
Paramètre
obj
Description
Un objet de rapport
Type
Objet rapport
Obligatoire
Oui
Exemples
ReportFilter([Pays]) renvoie "US" si un filtre de rapport limite l'objet Pays à "US".
6.1.5.13 ReportFilterSummary
Description
Renvoie un résumé des filtres de rapport d'un document ou d'un rapport
Groupe de fonctions
Document
118 2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
string ReportFilterSummary(report_name)
Entrée
Paramètre
nom_rapport
Description
Le nom du rapport
Type
Chaîne
Obligatoire
Non
Remarques
Si nom_rapport est omis, ReportFilterSummary renvoie un résumé de tous les filtres de rapport du document.
Exemples
ReportFilterSummary() renvoie des informations sur tous les filtres de rapport d'un document.
ReportFilterSummary("Rapport1") renvoie des informations sur les filtres du rapport "Rapport1".
Exemples d'entrées de la fonction ReportFilterSummary :
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))
6.1.6 Fonctions du groupe Logical
6.1.6.1 Pair
Description
Détermine si un nombre est pair
Groupe de fonctions
Logique
Syntaxe
booléen Even(nombre)
119 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
nombre
Description
N'importe quel nombre
Type
Nombre
Obligatoire
Oui
Remarques
•
Even renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez Even 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
Even(4) renvoie True.
Even(3) renvoie False.
Even(23,2) renvoie False.
Even(-4) renvoie True.
Even(-2,2) renvoie False.
120
6.1.6.2 IsDate
Description
Détermine si une valeur est une date
Groupe de fonctions
Logique
Syntaxe
booléen IsDate(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsDate renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez IsDate 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
IsDate([Date de réservation]) renvoie True si la variable [Date de réservation] est une date.
2012-05-10
Fonctions, opérateurs et mots clés
Si (IsDate([Date de réservation] Alors "Date" Sinon "Pas date") renvoie "Date" si [Date de réservation] est une date.
Rubriques associées
•
6.1.6.3 IsError
Description
Détermine si un objet renvoie une erreur
Groupe de fonctions
Logique
Syntaxe
booléen IsError(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsError() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez IsError directement dans une colonne, la fonction renvoie un nombre entier (1=true ;
0=false). Vous pouvez appliquer un format à cet entier en utilisant un opérateur booléen.
Exemples
IsError([Chiffre d'affaires]) renvoie la valeur False si la variable [Chiffre d'affaires] ne renvoie pas d'erreur.
IsError([Nombre moyen d'invités]) renvoie True si la variable [Nombre moyen d'invités] renvoie une erreur de division par zéro (#DIV/0).
Si IsError([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
•
121 2012-05-10
Fonctions, opérateurs et mots clés
6.1.6.4 IsLogical
Description
Détermine si une valeur est booléenne
Groupe de fonctions
Logique
Syntaxe
booléen IsLogical(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsLogical() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez IsLogical 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 True.
EstLogique([Pays]) renvoie False 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
•
122
6.1.6.5 IsNull
Description
Détermine si une valeur est nulle
Groupe de fonctions
Logique
2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
booléen IsNull(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsNull() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez IsNull 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
IsNull([Chiffre d'affaires]) renvoie la valeur False si la variable [Chiffre d'affaires] n'est pas nulle.
IsNull([Nombre moyen d'invités]) renvoie la valeur True si la variable [Nombre moyen d'invités] est nulle.
Rubriques associées
•
6.1.6.6 IsNumber
Description
Détermine si une valeur est un nombre
Groupe de fonctions
Logique
Syntaxe
booléen IsNumber(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsNumber renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
123 2012-05-10
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
IsNumber([Chiffre d'affaires]) renvoie la valeur True si la variable [Chiffre d'affaires] est un nombre.
IsNumber([Nom du client]) renvoie False si la variable [Nom du client] n'est pas un nombre.
Si IsNumber([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
•
124
6.1.6.7 IsString
Description
Détermine si une valeur est une chaîne
Groupe de fonctions
Logique
Syntaxe
booléen IsString(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsString() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez IsString 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
IsString([Chiffre d'affaires]) renvoie la valeur False si la variable [Chiffre d'affaires] n'est pas une chaîne.
IsString([Nom du client]) renvoie True si la variable [Nom du client] est une chaîne.
Si IsString([Nom client]) Alors "Chaîne" Sinon "Pas chaîne" renvoie "Chaîne" si la variable [Nom client] est une chaîne.
2012-05-10
Fonctions, opérateurs et mots clés
Rubriques associées
•
6.1.6.8 IsTime
Description
Détermine si une variable est une variable d'heure
Groupe de fonctions
Logique
Syntaxe
booléen IsTime(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
•
IsTime renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez IsTime 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
IsTime([Heure de réservation]) renvoie la valeur True si la variable [Heure de réservation] est une variable d'heure.
IsTime([Nombre moyen d'invités]) renvoie la valeur False si la variable [Nombre moyen d'invités] n'est pas une variable d'heure.
Si IsTime([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
•
6.1.6.9 Odd
125 2012-05-10
Fonctions, opérateurs et mots clés
Description
Détermine si un nombre est impair
Groupe de fonctions
Logique
Syntaxe
bool Odd(nombre)
Entrée
Paramètre
nombre
Description
N'importe quel nombre
Type
Nombre
Obligatoire
Oui
Remarques
•
Odd renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
• Si vous placez Odd 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.
•
Odd ignore les fractions des nombres décimaux.
Exemples
Odd(5) renvoie la valeur True.
Odd(4) renvoie la valeur False.
Odd(23.2) renvoie la valeur True.
Odd(24.2) renvoie la valeur True.
Odd(-23.2) renvoie la valeur True.
Odd(-24.2) renvoie la valeur True.
Rubriques associées
•
6.1.7 Fonctions du groupe Numeric
6.1.7.1 Abs
126 2012-05-10
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
nombre
Description
N'importe quel nombre
Type
Nombre
Exemples
Abs(25) renvoie 25.
Abs(-11) renvoie 11.
6.1.7.2 Ceil
Description
Renvoie un nombre arrondi à l'entier supérieur
Groupe de fonctions
Numérique
Syntaxe
numérique Ceil( nombre)
Entrée
Paramètre
nombre
Description
N'importe quel nombre
Type
Nombre
Exemples
Ceil(2,4) renvoie 3.
Ceil(3,1) renvoie 4.
Ceil(-3,1) renvoie -3.
127
Obligatoire
Oui
Obligatoire
Oui
2012-05-10
Fonctions, opérateurs et mots clés
6.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
angle
Description
Un angle en radians
Exemple
Cos(180) renvoie -0,6.
Type
Nombre
6.1.7.4 EuroConvertFrom
Description
Convertit un montant en euros dans une autre devise
Groupe de fonctions
Numérique
Syntaxe
numérique EuroConvertFrom(montant_euro;code_dev;niveau_arrondi)
Obligatoire
Oui
128 2012-05-10
Fonctions, opérateurs et mots clés
129
Entrée
Paramètre Description
montant_non_euro
Le montant en euros code_dev niveau_arrondi
Type
Nombre
Le code ISO de la devise cible Chaîne
Le nombre de décimales selon lequel le résultat doit être arrondi
Nombre
Obligatoire
Oui
Oui
Oui
NLG
ATS
PTS
FIM
FRF
IEP
ITL
LUF
BEF
DEM
GRD
ESP
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 :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
Exemples
EuroConvertFrom(1000;"FRF";2) renvoie 6559,57.
EuroConvertFrom(1000;"FRF";1) renvoie 6559,60.
EuroConvertFrom(1000.04;"DEM";2) renvoie 1955,83.
EuroConvertFrom(1000.04;"DEM";1) renvoie 1955,80.
Rubriques associées
•
Arrondir et tronquer des nombres
2012-05-10
Fonctions, opérateurs et mots clés
130
6.1.7.5 EuroConvertTo
Description
Convertit un montant en euros
Groupe de fonctions
Numérique
Syntaxe
numérique EuroConvertTo(montant_non_euro;code_dev;niveau_arrondi)
Entrée
Paramètre
montant_non_euro code_dev niveau_arrondi
Description Type
Le montant dans la devise qui n'est pas en euros Nombre
Le code ISO de la devise qui n'est pas en euros Chaîne
Le nombre de décimales selon lequel le résultat doit être arrondi
Nombre
Obligatoire
Oui
Oui
Oui
BEF
DEM
GRD
ESP
FRF
Exemple
EuroConvertTo(6559;"FRF";2) renvoie 999,91.
EuroConvertTo(6559;"FRF";1) renvoie 999,90.
EuroConvertTo(1955;"DEM";2) renvoie 999,58.
EuroConvertTo(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 :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
2012-05-10
Fonctions, opérateurs et mots clés
IEP
ITL
LUF
NLG
ATS
PTS
FIM
Rubriques associées
•
Arrondir et tronquer des nombres
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
6.1.7.6 EuroFromRoundError
Description
Renvoie l'erreur d'arrondi d'une conversion de l'euro
Groupe de fonctions
Numérique
Syntaxe
numérique EuroFromRoundError (montant_euro;code_dev;niveau_arrondi)
Entrée
Paramètre
montant_non_euro code_dev niveau_arrondi
Description
Le montant en euros
Type
Nombre
Le code ISO de la devise cible Chaîne
Le nombre de décimales selon lequel le résultat doit être arrondi
Nombre
Résultat
L'erreur d'arrondi du calcul
Obligatoire
Oui
Oui
Oui
131 2012-05-10
Fonctions, opérateurs et mots clés
NLG
ATS
PTS
FIM
FRF
IEP
ITL
LUF
BEF
DEM
GRD
ESP
Exemples
EuroFromRoundError(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.)
EuroFromRoundError(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.)
EuroFromRoundError(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.)
EuroFromRoundError(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 :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
Rubriques associées
•
Arrondir et tronquer des nombres
6.1.7.7 EuroToRoundError
132 2012-05-10
Fonctions, opérateurs et mots clés
133
Description
Renvoie l'erreur d'arrondi d'une conversion en euros
Groupe de fonctions
Numérique
Syntaxe
numérique EuroToRoundError(montant_non_euro;code_dev;niveau_arrondi)
Entrée
Paramètre
montant_non_euro code_dev niveau_arrondi
Description Type
Le montant dans la devise qui n'est pas en euros Nombre
Le code ISO de la devise qui n'est pas en euros Chaîne
Le nombre de décimales selon lequel le résultat doit être arrondi
Nombre
Obligatoire
Oui
Oui
Oui
BEF
DEM
GRD
ESP
FRF
IEP
Exemples
EuroToRoundError(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.)
EuroToRoundError(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.)
EuroToRoundError(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.)
EuroToRoundError(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 :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
Punt irlandais
2012-05-10
Fonctions, opérateurs et mots clés
ITL
LUF
NLG
ATS
PTS
FIM
Rubriques associées
•
Arrondir et tronquer des nombres
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
6.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
puissance
Description
La puissance
Type
Nombre
Remarques
Une valeur exponentielle est la constante e (2,718...) élevée à une puissance.
Exemples
Exp(2.2) renvoie 9,03.
Obligatoire
Oui
6.1.7.9 Fact
134 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie le factoriel d'un nombre
Groupe de fonctions
Numérique
Syntaxe
entier Fact(nombre)
Entrée
Paramètre
nombre
Description
N'importe quel nombre
Type
Nombre
Obligatoire
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.
6.1.7.10 Floor
Description
Renvoie un nombre arrondi à l'entier inférieur le plus proche
Groupe de fonctions
Numérique
Syntaxe
entier Floor(nombre)
Entrée
Paramètre
nombre
Description
N'importe quel nombre
Type
Nombre
Exemple
Floor(24,4) renvoie 24.
Obligatoire
Oui
135 2012-05-10
Fonctions, opérateurs et mots clés
136
6.1.7.11 Interpolation
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
indicateur
PointAPoint|Linéaire
Description Type
Tout indicateur Indicateur
La méthode d'interpolation :
•
PointAPoint
: interpolation de point à point
•
Linéaire
: régression linéaire avec interpolation des moindres carrés.
Mot clé
Obligatoire
Oui
Non
(PointAPoint est utilisé par défaut)
PasSurSaut| réinit_dims
•
PasSurSaut
: empêche la fonction de réinitialiser le calcul au niveau des sauts de section et de bloc
• réinit_dims
: liste des dimensions utilisées pour réinitialiser l'interpolation.
Mot clé| liste des dimensions
Non
Ligne|Col Définit le sens du calcul Mot clé
(Ligne, par défaut)
Remarques
•
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.
2012-05-10
Fonctions, opérateurs et mots clés
• 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.
Exemples
Interpolation([Valeur]) fournit les valeurs manquantes suivantes en utilisant la méthode d'interpolation de point à point par défaut :
Jour
Lundi
Valeur
12
Interpolation([Valeur])
12
14 Mardi
Mercredi
Jeudi
Vendredi
Samedi
Dimanche
16
19
14
15
16
17
18
19
Rubriques associées
•
•
6.1.7.12 Ln
Description
renvoie le logarithme naturel d'un nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique Ln(nombre)
137 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
nombre
Exemples
Ln(10) renvoie 2.
Description
N'importe quel nombre
Type
Nombre
6.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
nombre base
Description
N'importe quel nombre
La base du logarithme
Type
Nombre
Nombre
Exemples
Log(125;5) renvoie 3.
6.1.7.14 Log10
Description
Renvoie le logarithme de base 10 d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Log10(nombre)
138
Obligatoire
Oui
Obligatoire
Oui
Oui
2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
nombre
Exemples
Log10(100) renvoie 2.
Description
N'importe quel nombre
Type
Nombre
6.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
dividende diviseur
Description
Le dividende
Le diviseur.
Type
Nombre
Nombre
Exemples
Mod(10;4) renvoie 2.
Mod (10.2;4.2) renvoie 1.8.
6.1.7.16 Puissance
Description
Renvoie un nombre élevé à une puissance
Groupe de fonctions
Numérique
139
Obligatoire
Oui
Obligatoire
Oui
Oui
2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
numérique Power(nombre;puissance)
Entrée
Paramètre
nombre puissance
Description
Le nombre à élever à une puissance
Nombre
La puissance
Type
Nombre
Exemple
Power(10;2) renvoie 100.
Obligatoire
Oui
Oui
140
6.1.7.17 Rank
Description
Classe un indicateur selon des dimensions
Groupe de fonctions
Numérique
Syntaxe
entier Rank(indicateur;[dims_classement][;Premiers|Derniers][;(réinit_dims)])
Entrée
Paramètre
indicateur
Description
L'indicateur à classer
Type
Indicateur
Obligatoire
Oui dim_classement
Les dimensions utilisées pour classer l'indicateur Liste Dimension
Non
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 Dimension
Non
Remarques
• 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.
2012-05-10
Fonctions, opérateurs et mots clés
• Lorsque vous spécifiez un ensemble de dimensions de classement ou redéfinies, vous devez les séparer par des points-virgules.
• Par défaut, le classement est réinitialisé sur une section ou une rupture de bloc.
Exemples
Dans le tableau suivant, le classement est indiqué par Rank([Chiffre d'affaires]);([Pays])):
Pays
France
US
Chiffre d'affaires
835 420
2 451 104
Classement
2
1
Dans le tableau suivant, le classement est donné par Rank([Chiffre d'affaires];([Pays]);Der niers)
. L'argument Derniers signifie que les indicateurs sont classés par ordre décroissant.
Pays
France
US
Chiffre d'affaires
835 420
2 451 104
Classement
1
2
Dans le tableau suivant, le classement est indiqué par Rank([Chiffre d'af faires];([Pays];[Lieu de séjour]))
:
Pays
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Chiffre d'affaires
835 420
971 444
1 479 660
Classement
3
2
1
Dans le tableau suivant, le classement est indiqué par Rank([Chiffre d'affaires];([Pays];[An née]);([Pays]))
. Le rang est réinitialisé dans la dimension Pays.
Pays
France
France
France
US
US
Année
FY1998
1999
2000
FY1998
1999
Chiffre d'affaires
295 940
280 310
259 170
767 614
826 930
3
3
2
Classement
1
2
141 2012-05-10
Fonctions, opérateurs et mots clés
US 2000
Rubriques associées
•
856 560 1
6.1.7.18 Round
Description
Arrondit un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Round (nombre;niveau_arrondi)
Entrée
Paramètre
nombre niveau_arrondi
Description
Le nombre à arrondir
Type
Nombre
Nombre de décimales selon lequel le nombre est arrondi
Nombre
Exemples
Round(9.44;1) renvoie 9,4.
Round(9.45;1) renvoie 9,5.
Round(9.45;0) renvoie 9.
Round(9.45;-1) renvoie 10.
Round(4.45;-1) renvoie 0.
Rubriques associées
•
Arrondir et tronquer des nombres
Obligatoire
Oui
Oui
142 2012-05-10
Fonctions, opérateurs et mots clés
6.1.7.19 Signe
Description
Renvoie le signe d'un nombre
Groupe de fonctions
Numérique
Syntaxe
entier Signe(nombre)
Entrée
Paramètre
nombre
Description
N'importe quel nombre
Type
Nombre
Obligatoire
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.
6.1.7.20 Sin
Description
Retourne le sinus d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Sin(angle)
143 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
angle
Description
Un angle en radians
Exemple
Sin(234542) renvoie -0,116992.
Type
Nombre
6.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
nombre
Description
N'importe quel nombre
Type
Nombre
Exemple
Racine(25) renvoie 5.
6.1.7.22 Tan
Description
Renvoie la tangente d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Tan(angle)
144
Obligatoire
Oui
Obligatoire
Oui
2012-05-10
Fonctions, opérateurs et mots clés
145
Entrée
Paramètre
angle
Exemples
Tan(90) renvoie -2.
Description
Un angle en radians
Type
Nombre
Obligatoire
Oui
6.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
chaîne
Description Type
Un nombre sous forme de chaîne de caractères
Chaîne
Obligatoire
Oui
Remarques
Si chaîne ne correspond pas à un nombre, la fonction EnNombre renvoie #ERREUR.
Exemples
EnNombre("45") renvoie 45.
6.1.7.24 Truncate
Description
Tronque un nombre
Groupe de fonctions
Numérique
2012-05-10
Fonctions, opérateurs et mots clés
Syntaxe
numérique Truncate(nombre;niveau_troncature)
Entrée
Paramètre
nombre
Description
Le nombre à arrondir
Type
Nombre niveau_troncature Nombre de décimales selon lequel le nombre est tronqué
Nombre
Remarques
Exemple
Truncate(3,423;2) renvoie 3,42.
Rubriques associées
•
Arrondir et tronquer des nombres
Obligatoire
Oui
Oui
6.1.8 Fonctions d'ensemble
6.1.8.1 Children
Description
Renvoie les membres enfant d'un membre
Groupe de fonctions
Ensemble
Syntaxe
member_set member.Children
146 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
membre
Description
Tout membre
Type
membre
Obligatoire
Oui
Remarques
• La fonction Children 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.
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
•
•
•
•
•
•
6.1.8.2 Depth
Description
Renvoie la profondeur d'un membre dans la hiérarchie
Groupe de fonctions
Ensemble
Syntaxe
ent membre.Profondeur
147 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
membre
Description
Tout membre
Type
membre
Obligatoire
Oui
Remarques
• 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.
Exemples
[Géographie].[Etats-Unis].[Californie].[Los Angeles].Profondeur
renvoie 2.
148
6.1.8.3 Descendants
Description
Renvoie les membres descendants d'un membre
Groupe de fonctions
Ensemble
Syntaxe
member_set Descendants(member[;level|distance][;desc_flag])
Entrée
Paramètre
membre niveau
Description
Tout membre
Niveau des descendants
Type
membre niveau distance Distance entre le niveau du descendant et le niveau actuel int indicateur_desc
Détermine quels membres descendants sont renvoyés mot clé
Obligatoire
Oui
Non (le niveau de membre est le niveau par défaut)
Non (le niveau de membre est le niveau par défaut)
Non (la valeur par défaut est
Self
)
Remarques
•
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.
2012-05-10
Fonctions, opérateurs et mots clés
149
• 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 :
Self
Before
After
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.
Renvoie le membre actuel et tous les descendants qui se trouvent au-dessus du niveau indiqué par le paramètreniveau|distance.
Renvoie les descendants qui se trouvent au-dessous du niveau indiqué par le paramètre niveau|distance.
Self_Before
Self_After
Before_After
Renvoie le membre actuel et tous les descendants qui se trouvent au niveau indiqué par le paramètreniveau|distance ou au-dessus.
Renvoie le membre actuel et tous les descendants qui se trouvent au niveau indiqué par le paramètreniveau|distance ou au-dessous.
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
San Francisco
Las Vegas
Nevada
Reno Carson City
Descendants([Géographie].[Etats-Unis].[Californie];[Géographie].[Ville]) renvoie [San Francisco], [San Diego], [Los Angeles].
2012-05-10
Fonctions, opérateurs et mots clés
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].
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
•
•
•
•
•
•
6.1.8.4 IsLeaf
Description
Détermine si un membre est un membre feuille.
Groupe de fonctions
Divers
Syntaxe
bool membre.EstFeuille
150 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
membre
Description
Tout membre
Type
membre
Obligatoire
Oui
Remarques
• 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 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].IsLeaf
renvoie False si [Californie] a les membres enfant [Los Angeles], [San Diego], [San Francisco].
[Géographie].IsLeaf
renvoie True si le membre actuel de la hiérarchie [Géographie] est [Nevada] et si [Nevada] n'a aucun membre enfant.
6.1.8.5 Clé
Description
Renvoie la clé d'un membre.
Syntaxe
chaîne membre.Key
Groupe de fonctions
Ensemble
Entrée
Paramètre
membre
Description
Tout membre
Type
membre
Obligatoire
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.
151 2012-05-10
Fonctions, opérateurs et mots clés
152
Exemple
[Géographie].[Etats-Unis].Key
renvoie "XYZ" si la clé du membre [Etats-Unis] est "XYZ".
6.1.8.6 Lag
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.Lag(distance)
Groupe de fonctions
Ensemble
Entrée
Paramètre
membre distance
Description
Tout membre
Distance entre le membre en question et le membre actuel
Type
membre int
Obligatoire
Oui
Oui
Remarques
•
Lag 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, Lag renvoie le membre qui se trouve à la distance spécifiée avant membre. Si la valeur distance est négative, Lag renvoie le membre qui se trouve à la dis tance 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
•
2012-05-10
Fonctions, opérateurs et mots clés
•
•
•
•
•
6.1.8.7 Parent
Description
Renvoie le membre parent d'un membre
Groupe de fonctions
Ensemble
Syntaxe
member member.Parent
Entrée
Paramètre
membre
Description
Tout membre
Type
membre
Obligatoire
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
•
•
•
•
•
•
153 2012-05-10
Fonctions, opérateurs et mots clés
6.1.8.8 Eléments de même niveau
Description
Renvoie le membre et les membres de même niveau que celui-ci.
Groupe de fonctions
Ensemble
Syntaxe
member_set member.Siblings
Entrée
Paramètre
membre
Description
Tout membre
Type
membre
Obligatoire
Oui
Remarques
• La fonction 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 frère 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
•
•
•
•
•
•
154 2012-05-10
Fonctions, opérateurs et mots clés
6.1.9 Fonctions diverses
155
6.1.9.1 Ancestor
Description
Renvoie un membre ascendant d'un membre
Groupe de fonctions
Divers
Syntaxe
member Ancestor(member;level|distance)
Entrée
Paramètre
membre niveau
Description
Tout membre
Le niveau de l'ascendant distance La distance du niveau de l'ascendant par rapport au niveau actuel
Type
membre niveau int
Obligatoire
Oui
Le niveau ou la dista nce est requis
Le niveau ou la dista nce est requis
Remarques
• La fonction Ancestor n'est pas utilisée en tant que fonction autonome. Elle est utilisée dans le paramètre d'entrée des fonctions d'agrégation qui spécifie l'ensemble des membres pour l'agrégation.
• Le membre est indiqué explicitement ou il s'agit du membre actuel d'une hiérarchie. Si vous indiquez le membre explicitement, vous devez préciser le chemin d'accès complet dans la hiérarchie. Si vous indiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeur vide.
• La distance doit être positive.
Exemples
Tous les exemples sont basés sur la hiérarchie [Géographie] (Pays > Etat > Ville). Le tableau suivant montre un sous-ensemble des données de la hiérarchie.
Etats-Unis
Californie Nevada
2012-05-10
Fonctions, opérateurs et mots clés
Los Angeles
San Diego
San Francisco
Las Vegas Reno Carson City
Ancestor([Géographie].[Etats-Unis].[Californie].[Los Angeles];1) renvoie
[Californie].
Ancestor([Géographie];[Géographie].[Etat]) renvoie [Californie] si le membre actuel est
[San Diego].
Rubriques associées
•
•
•
•
•
•
6.1.9.2 BlockName
Description
Renvoie le nom du bloc
Groupe de fonctions
Divers
Syntaxe
chaîne BlockName()
Exemples
Si BlockName est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
6.1.9.3 Numéro de colonne
Description
Renvoie le numéro de la colonne
156 2012-05-10
Fonctions, opérateurs et mots clés
Groupe de fonctions
Divers
Syntaxe
entier ColumnNumber()
Exemples
ColumnNumber() renvoie 2 si la formule est placée dans la deuxième colonne d'un tableau.
6.1.9.4 CurrentUser
Description
Renvoie le nom d'utilisateur de l'utilisateur actuel pour accéder à la zone de lancement BI
Groupe de fonctions
Divers
Syntaxe
chaîne CurrentUser()
Exemples
CurrentUser() renvoie "gkn" si son nom d'utilisateur est "gkn".
6.1.9.5 ForceMerge
Description
Inclut des dimensions synchronisées dans les calculs d'indicateurs lorsque les dimensions n'apparaissent pas dans le contexte du calcul.
Groupe de fonctions
Divers
Syntaxe
num ForceMerge(measure)
157 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
indicateur
Description
Tout indicateur
Type
Indicateur
Obligatoire
Oui
Résultat
Résultat du calcul tenant compte des dimensions synchronisées
Remarques
• Appliqué à un indicateur intelligent, ForceMerge renvoie #VALEURMULTI car le groupe nécessaire pour calculer l'indicateur intelligent n'existe pas.
• La fonction ForceMerge est l'équivalent de la fonction MultiCube de BusinessObjects/Desktop
Intelligence.
Exemples
ForceMerge([Chiffre d'affaires]) renvoie la valeur de [Chiffre d'affaires] en tenant compte des dimensions synchronisées qui n'apparaissent pas dans le même bloc que l'indicateur [Chiffre d'affaires].
6.1.9.6 GetContentLocale
Description
Renvoie les paramètres régionaux des données contenues dans le document (les paramètres régionaux du document)
Groupe de fonctions
Divers
Syntaxe
chaîne GetContentLocale()
Remarques
Les paramètres régionaux du document sont utilisés pour mettre en forme les données dans un document.
Exemples
GetContentLocale() renvoie "fr_FR" si les paramètres régionaux du document sont "Français
(France)".
158 2012-05-10
Fonctions, opérateurs et mots clés
6.1.9.7 GetDominantPreferredViewingLocale
Description
Renvoie les paramètres régionaux dans le groupe paramètres régionaux de visualisation préférés de l'utilisateur
Groupe de fonctions
Divers
Syntaxe
string GetDominantPreferredViewingLocale()
Remarques
• Chaque groupe de paramètres régionaux associés possède des paramètres régionaux de document utilisés comme base pour tous les autres paramètres régionaux du groupe. Par exemple, Anglais
US ("en_US") constitue le paramètre régional prévalent dans le groupe des paramètres régionaux anglais. L'anglais de Nouvelle-Zélande ("en_NZ") est également un membre de ce groupe.
• Le Guide du Gestionnaire de traduction répertorie tous les paramètres régionaux de visualisation préférés dominants.
Exemples
GetDominantPreferredViewingLocale renvoie "en_US" lorsque le paramètre régional de visualisation préféré est "Anglais (Nouvelle-Zélande)".
Rubriques associées
•
159
6.1.9.8 GetLocale
Description
Renvoie les paramètres régionaux de l'utilisateur utilisés pour mettre en forme l'interface utilisateur (les paramètres régionaux du produit)
Groupe de fonctions
Divers
Syntaxe
chaîne GetLocale()
2012-05-10
Fonctions, opérateurs et mots clés
Remarques
Les paramètres régionaux du produit sont ceux utilisés par l'interface utilisateur (par exemple, les
éléments de menu et le texte des boutons).
Exemples
GetLocale() renvoie "en_US" si le paramètre régional du produit est "Anglais (US)".
160
6.1.9.9 GetLocalized
Description
Renvoie une chaîne localisée conformément aux paramètres régionaux de visualisation préférés de l'utilisateur
Syntaxe
string GetLocalized(string[;comment])
Entrée
Paramètre
chaîne
Description
La chaîne à traduire
Type
chaîne comment (commentaire)
Un commentaire pour aider les traducteurs chaîne
Obligatoire
Oui
Non
Remarques
• Le paramètre de la chaîne peut être une chaîne dans une formule quelle qu'elle soit (par exemple, dans une cellule, un message d'alerteur ou une définition de variable).
• Lors de la conception d'un rapport, vous pouvez utiliser le paramètrecommentaire afin de fournir de plus amples informations pour aider le traducteur à traduire la chaîne. Le commentaire apparaît avec la chaîne dans l'outil Gestionnaire de traduction que les traducteurs utilisent pour traduire les rapports.
• Chaque paire chaîne + commentaire génère une chaîne distincte à traduire dans l'outil
Gestionnaire de traduction. En conséquence, GetLocalized("Product Total";"Max 20 characters") et GetLocalized("Product Total";"Use no more than 20 charac ters") peuvent renvoyer des traductions différentes.
Exemples
GetLocalized("Total for all products") renvoie la traduction de "Total for all products" si le paramètre régional de visualisation préféré est "fr_FR".
GetLocalized("Total for all products";"Try not to use more than 20 charac ters") renvoie la traduction allemande de "Total for all products" si le paramètre régional de visualisation préféré est "de_DE". La fonction prévient également le traducteur s'il ne doit pas utiliser plus de 20 caractères, si possible, pour la traduction de la chaîne.
2012-05-10
Fonctions, opérateurs et mots clés
Rubriques associées
•
6.1.9.10 GetPreferredViewingLocale
Description
Renvoie les paramètres régionaux préférés de l'utilisateur pour visualiser les données du document
(les paramètres régionaux de visualisation préférés)
Groupe de fonctions
Divers
Syntaxe
chaîne GetPreferredViewingLocale()
Exemples
GetPreferredViewingLocale renvoie "en_US" si les Paramètres régionaux de visualisation préférés sont "English (US)".
Rubriques associées
•
•
GetDominantPreferredViewingLocale
6.1.9.11 Si...Alors...Sinon
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
If bool_value Then true_value [Else false_value]
161 2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
valeur_bool valeur_true valeur_false
Description
Une valeur booléenne
Type
Booléen
La valeur à renvoyer si valeur_bool est vraie
N'importe lequel
La valeur à renvoyer si valeur_bool est fausse
N'importe lequel
Obligatoire
Oui
Oui
Oui si Sinon est inclus
Remarques
• valeur_true et valeur_false peuvent combiner les types de données.
• Vous pouvez utiliser les opérateurs booléens Et, Entre, DansListe, Ou et Pas avec Si.
• Vous pouvez imbriquer les conditions Si en remplaçant les clauses Sinon par des clauses Sinon si
. Cette syntaxe décrit un niveau d'imbrication :
If bool_value Then true_value [ElseIf bool_value Then true_value Else false_value…]
• La syntaxe d'origine de la fonctionIf, If(valeur_bool; valeur_true; valeur_false) est
également prise en charge.
Exemples
If [Chiffre d'affaires]>1 000 000 Alors "CA élevé" renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et aucune valeur pour les autres lignes.
If [Chiffre d'affaires] >1 000 000 Alors "CA élevé" Sinon [Chiffre d'affaires] renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres lignes.
If [Chiffre d'affaires]>1 000 000 Alors "CA élevé" Sinon "CA faible" renvoie
"CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et "CA faible" pour toutes les lignes dont le chiffre d'affaires est inférieur à 1 000 000.
If [Chiffre d'affaires]>1 000 000 Alors "CA élevé" Sinon si [Chiffre d'af faires]> 800 000 Alors "CA moyen" Sinon "CA faible" renvoie "CA élevé" pour toutes les lignes dont le revenu dépasse 1 000 000, "CA moyen" pour toutes les lignes dont le chiffre d'affaires est compris entre 800 000 et 1 000 000 et "CA faible" pour toutes les autres lignes.
Rubriques associées
•
•
•
•
•
•
162 2012-05-10
Fonctions, opérateurs et mots clés
163
6.1.9.12 Si
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
If(bool_value;true_value;false_value)
Entrée
Paramètre
valeur_bool valeur_true valeur_false
Description
Une valeur booléenne
Type
Booléen
La valeur à renvoyer si valeur_bool est vraie
N'importe lequel
La valeur à renvoyer si valeur_bool est fausse
N'importe lequel
Obligatoire
Oui
Oui
Oui
Remarques
• valeur_true et valeur_false peuvent combiner les types de données.
• Vous pouvez imbriquer les conditions Si en remplaçant valeur_false par des conditions Si supplémentaires. Cette syntaxe affiche un niveau d'imbrication :
If(bool_value;true_value;If(bool_value;true_value;false_value);false_value)
• La syntaxe Si...Alors...Sinon est également prise en charge.
Exemples
Si([Revenu des ventes]>1000000;"Revenu élevé";"Revenu bas") renvoie "Revenu
élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et "Revenu bas" pour toutes les lignes dont le chiffre d'affaires est inférieur à 1 000 000.
Si([Revenu des ventes]>1 000 000;"Revenu élevé";[Chiffre d'affaires]) renvoie
"Revenu élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres lignes.
Rubriques associées
•
2012-05-10
Fonctions, opérateurs et mots clés
164
6.1.9.13 LineNumber
Description
Renvoie le numéro de ligne dans un tableau
Groupe de fonctions
Divers
Syntaxe
entier LineNumber()
Remarques
La numérotation des lignes d'un tableau commence par l'en-tête, qui est la ligne 1.
Exemples
LineNumber() renvoie 2 lorsque la fonction apparaît au niveau de la deuxième ligne d'un tableau.
6.1.9.14 NameOf
Description
Renvoie le nom d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NameOf(obj)
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Obligatoire
Oui
Remarques
La fonction NameOf apparaît dans les en-têtes de colonne et de ligne des rapports ;.
Exemples
NameOf([Date de réservation]) renvoie "Date de réservation".
2012-05-10
Fonctions, opérateurs et mots clés
6.1.9.15 NoFilter
Description
Ignore les filtres lors du calcul d'une valeur
Groupe de fonctions
Divers
Syntaxe
type_saisie AucunFiltre(obj[;Tous|Explorer])
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Tout|Exploration
• Aucun mot clé spécifié : ignorer les filtres de rapport et de bloc
•
Tout
: ignorer tous les filtres
•
Exploration
: ignorer les filtres de rapport et d'exploration
Mot clé
Obligatoire
Objet rapport Oui
Non
Remarques
•
NoFilter(obj;Exploration) ne fonctionne pas en mode d'exploration de requête, car les filtres d'exploration sont ajoutés à la requête, et non appliqués aux données de rapport.
• Si vous quittez le mode d'exploration lorsque des filtres d'exploration sont activés, ces derniers deviennent des filtres de rapport et peuvent modifier la valeur des objets auxquels NoFilter(ob jet;Exploration) est appliqué.
Exemples
Lorsque NoFilter(Somme([Chiffre d'affaires])) est placé dans un pied de bloc, le chiffre d'affaires total de toutes les lignes du bloc est renvoyé, même si certaines lignes sont exclues du bloc.
NoFilter(Sum([Chiffre d'affaires]);Tout) renvoie la somme du chiffre d'affaires de tous les pays, y compris la France, même si un filtre exclut la France du rapport.
NoFilter(Sum([Chiffre d'affaires]);Exploration) renvoie la somme du chiffre d'affaires de tous les pays, même si un filtre d'exploration filtre la dimension [Pays].
165 2012-05-10
Fonctions, opérateurs et mots clés
166
6.1.9.16 NumberOfPages
Description
Renvoie le nombre de pages dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier NumberOfPages()
Exemples
NumberOfPages() renvoie 2 si le rapport contient deux pages.
6.1.9.17 Page
Description
Renvoie le numéro de la page actuelle dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier Page()
Exemple
Page() renvoie 2 s'il apparaît dans la deuxième page du rapport;
6.1.9.18 Previous
Description
Renvoie une valeur précédente d'un objet
Groupe de fonctions
Divers
2012-05-10
Fonctions, opérateurs et mots clés
167
Syntaxe
type_entrée Rank(dimension|indicateur|Auto[;(réinit_dims)][;décalage][;NonNul])
Entrée
Paramètre
dimension|indicateur|Auto
Description Type Obligatoire
La dimension ou l'indicateur dont la valeur précédente est renvoyée par la fonction, ou le mot clé Auto
Dimension, indicateur ou mot clé
Oui dimensions_redéfinies offset
NonNul
La liste des dimensions utilisées pour réinitialiser le calcul
Indique la valeur de dimension ou d'indicateur présentant un décalage de lignes avant la ligne actuelle
Liste Dimension Non
Entier
Demande à la fonction de renvoyer la première valeur non nulle à partir du décalage
Mot clé
Non (la valeur par défaut est 1)
Non
Remarques
• La valeur par défaut d'offset est 1. Previous([Chiffre d'affaires];1) et Previous
([Chiffre d'affaires]) sont identiques du point de vue fonctionnel.
• Lorsque l'argument NonNul est inclus, la fonction renvoie la première valeur non nulle de l'objet en remontant à partir des lignes offset de la cellule situées avant la ligne actuelle.
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec Previous.
• L'opérateur Auto permet de faire référence à la valeur précédente d'une cellule lorsque son contenu n'est pas un objet rapport.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
•
Previous est appliqué après chaque filtre de rapport, de section et de bloc, et tous les tris sont appliqués.
• Vous ne pouvez pas appliquer de tris ou de filtres sur les formules utilisant Previous.
• Si Previous est appliqué à un indicateur et que l'indicateur renvoie une valeur non définie, Précé dent renvoie une valeur non définie même si la ligne précédente a renvoyé une valeur.
•
Previous ignore les ruptures en cas de placement à l'extérieur d'un en-tête ou d'un pied de page de rupture.
•
Previous renvoie la valeur de l'instance précédente du pied de page en cas de placement dans un pied de page de rupture.
•
Previous est réinitialisé dans chaque section de rapport.
• Lorsqu'elle est utilisée dans un tableau croisé, l'option Previous ne traite pas la dernière valeur d'une ligne comme la première valeur de la ligne suivante.
Exemples
Previous([Pays)];1) renvoie les valeurs suivantes dans le tableau qui suit :
2012-05-10
Fonctions, opérateurs et mots clés
168
Pays
US
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
Précédent
Etats-Unis
Royaume-Uni
Previous([Chiffre d'affaires)]) renvoie les valeurs suivantes dans le tableau qui suit :
Précédent Pays
US
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
5 000 000
2 000 000
Previous([Chiffre d'affaires];([Pays]) renvoie les valeurs suivantes dans le tableau qui suit :
Pays
Etats-Unis
Royaume-Uni
Région
Nord
Sud
Nord
Sud
Chiffre d'affaires
5 000 000
7 000 000
3 000 000
4 000 000
Précédent
5 000 000
3 000 000
Previous([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau croisé qui suit :
Précédent
US
Royaume-Uni
France
2004
5 000 000
2 000 000
3 000 000
2005
6 000 000
2 500 000
2 000 000
Précédent
5 000 000
2 000 000
3 000 000
Previous([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau qui suit avec une rupture sur [Pays] :
Pays
Etats-Unis
Région
Nord
Chiffre d'affaires
5 000 000
Précédent
2012-05-10
Fonctions, opérateurs et mots clés
Etats-Unis
Sud 7 000 000
12 000 000
5 000 000
Pays
Royaume-Uni
Royaume-Uni
Région
Nord
Sud
Chiffre d'affaires
3 000 000
4 000 000
7 000 000
Précédent
7 000 000
3 000 000
12 000 000
Année
2008
2008
2008
2008
2008
2008
2008
2008
Previous([Chiffre d'affaires]);2;NonNul) renvoie les valeurs suivantes dans le tableau qui suit :
Trimestre
T1
T2
T3
T4
T1
T2
T3
T4
Chiffre d'affaires
500
400
700
300
200
Précédent
500
500
400
700
300
300
2*Previous(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Rubriques associées
•
Comparaison de valeurs à l'aide de la fonction Previous
•
6.1.9.19 RefValue
169 2012-05-10
Fonctions, opérateurs et mots clés
Description
Renvoie la valeur de référence d'un objet rapport lorsque le suivi de données est activé
Groupe de fonctions
Divers
Syntaxe
type_entrée RefValue(obj)
Exemples
RefValue([Région ayant les meilleurs résultats]) renvoie "Sud-ouest" si la valeur de la variable [Région ayant les meilleurs résultats] est "Sud-ouest" dans les données de référence.
RefValue([Chiffre d'affaires]) renvoie 1 000 si la valeur de l'indicateur [Chiffre d'affaires] est 1 000 dans les données de référence.
6.1.9.20 ValeurRelative
Description
Renvoie les valeurs antérieures ou suivantes d'un objet
Groupe de fonctions
Divers
Syntaxe
input_type RelativeValue(measure|detail;slicing_dims;offset)
Entrée
Paramètre
dim_découpage offset
Description
indicateur|détail
Tout indicateur ou détail d'une dimension dans le bloc
Type Obligatoire
Indicateur ou détail
Oui
Les dimensions qui donnent le contexte du calcul Liste Dimension
Oui
Indique la valeur de l'indicateur ou du détail qui est de offset lignes supprimées de la ligne actuelle
Entier Oui
Remarques
• L'objet doit être un indicateur ou un détail d'une dimension disponible dans le bloc.
• L'ordre de tri de la liste de valeurs des dimensions de découpage permet de déterminer le résultat de la fonction.
170 2012-05-10
Fonctions, opérateurs et mots clés
Année
2007
2007
2007
2007
2008
2008
2008
2008
Deux facteurs définissent l'ordre de tri : les tris appliqués aux dimensions de découpage et l'ordre dans lequel les dimensions de découpage sont répertoriées dans la fonction.
• Une dimension utilisée comme maître de section peut être spécifiée en tant que dimension de découpage.
• Toutes les dimensions de découpage doivent être présentes dans le bloc ou dans l'en-tête de section du bloc dans lequel se trouve la fonction. Si une dimension de découpage est supprimée ultérieurement du bloc, la fonction renvoie l'erreur #CALCUL.
• Si l'offset dépasse le nombre de lignes de la liste de valeurs de la dimension de découpage, le résultat de la fonction est nul.
•
ValeurRelative ne peut être utilisé de façon récursive.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions de découpage ne contient qu'une entrée.
Exemples
La colonne ValeurRelative du tableau ci-dessous contient le formule suivante :
RelativeValue([Revenue];([Year]);-1)
T4
T1
T2
T3
T4
Trimestre
T1
T2
T3
Vendeur
Durand
Dupont
Martin
Harris
Durand
Dupont
Martin
Harris
Chiffre d'affaires
1 000
2 000
1 500
3 000
4 000
3 400
2 000
1 700
ValeurRelative
1 000
2 000
1 500
3 000
Rubriques associées
•
•
Comparaison de valeurs à l'aide de la fonction ValeurRelative
6.1.9.21 ReportName
Description
Renvoie le nom d'un rapport
171 2012-05-10
Fonctions, opérateurs et mots clés
172
Groupe de fonctions
Divers
Syntaxe
Chaîne NomRapport()
Exemples
Si NomRapport() est placé dans un rapport appelé "Rapport des ventes", alors "Rapport des ventes" est renvoyé.
6.1.9.22 RowIndex
Description
Renvoie le numéro d'une ligne
Groupe de fonctions
Divers
Syntaxe
entier RowIndex()
Remarques
• La numérotation des lignes commence à 0.
•
RowIndex renvoie #VALEURMULTI lorsqu'elle est placée dans l'en-tête ou le pied de page d'un tableau.
Exemples
RowIndex renvoie 0 lorsqu'elle apparaît sur la première ligne d'un tableau.
6.1.9.23 UniqueNameOf
Description
Renvoie le nom unique d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomUniqueDe(obj)
2012-05-10
Fonctions, opérateurs et mots clés
Entrée
Paramètre
obj
Description
Tout objet rapport
Type
Objet rapport
Exemples
NomUniqueDe([Date de réservation]) renvoie "Date de réservation".
Obligatoire
Oui
6.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.
6.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".
6.2.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 à
173 2012-05-10
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.
6.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 True ou False.
6.2.3.1 Et (opérateur)
Description
L'opérateur Et relie des valeurs booléennes. Si toutes les valeurs booléennes reliées par Et renvoient
True, la combinaison de toutes les valeurs renvoie également True.
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.
6.2.3.2 Ou (opérateur)
174 2012-05-10
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 True, la combinaison de toutes les valeurs renvoie également True.
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.
6.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".
175
6.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 If 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
If [Chiffre d'affaires] Entre(800000;900000) Alors "Revenu moyen" renvoie "Revenu moyen" si [Chiffres d'affaires] est compris entre 800 000 et 900 000.
2012-05-10
Fonctions, opérateurs et mots clés
[Chiffre d'affaires] Entre (10000;20000) renvoie True 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
•
•
6.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
•
•
6.2.4 Opérateurs spécifiques à la fonction
176 2012-05-10
Fonctions, opérateurs et mots clés
Certaines fonctions peuvent se servir d'opérateurs particuliers comme arguments. Par exemple, la fonction Previous 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.
6.2.4.1 Opérateur Tout
L'opérateur Tout invite la fonction NoFilter à ignorer tous les filtres ou la fonction Count à compter toutes les valeurs, y compris les doublons.
Rubriques associées
•
•
•
•
6.2.4.2 Opérateurs Tout/Exploration
Description
Les opérateurs Tout/Exploration détermine quels sont les filtres ignorés par la fonction NoFilter.
• Non spécifié : NoFilter ignore les filtres de rapport et de bloc
• Tout : NoFilter ignore tous les filtres
• Exploration : NoFilter ignore les filtres de rapport et les filtres d'exploration
6.2.4.3 Opérateurs Derniers/Premiers
Description
Les opérateurs Derniers/Premiers indiquent à la fonctionRank de classer par ordre croissant ou décroissant.
•
Premiers
: établit un classement par ordre décroissant
•
Derniers
: établit un classement par ordre croissant
177 2012-05-10
Fonctions, opérateurs et mots clés
Exemples
Rank([Chiffres d'affaires];([Pays]);Premiers classe les pays par ordre décroissant de chiffre d'affaires.
Rubriques associées
•
178
6.2.4.4 Opérateur Rupture
Description
L'opérateur Rupture invite la fonction Percentage à prendre en compte les ruptures de tableau.
Exemples
La formule Percentage([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
2005
2005
Trimestre
T1
T2
Chiffre d'affaires
10 000
20 000
Pourcentage
10 %
20 %
2006
2006
T1
T2
30 000
40 000
30 %
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) :
Année
2005
2005
Trimestre
T1
T2
Chiffre d'affaires
10 000
20 000
Pourcentage
33,3 %
66,6 %
2006
2006
T1
T2
30 000
40 000
42,9%
57,1%
2012-05-10
Fonctions, opérateurs et mots clés
Rubriques associées
•
6.2.4.5 Opérateurs Distinct/Tout
Les opérateurs Distinct/Tout indiquent à la fonction Count de compter les valeurs distinctes uniquement ou toutes les valeurs.
Exemples
Count([Chiffre d'affaires];Distinct) renvoie 3 si [Chiffre d'affaires] a les valeurs (5;5;6;4).
Count([Chiffre d'affaires];Tout) renvoie 4 si [Chiffre d'affaires] a les valeurs (5;5;6;4).
Rubriques associées
•
6.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
Average([Chiffre d'affaires];InclureVide) renvoie 3 si [Chiffre d'affaires] a les valeurs
(5;3;<vide>;4).
Rubriques associées
•
•
•
•
179 2012-05-10
Fonctions, opérateurs et mots clés
180
6.2.4.7 Opérateur Index
Description
L'opérateur Index indique aux fonctions UserResponse et RefValueUserResponse de renvoyer la clé primaire de la base de données de la réponse d'invite.
Rubriques associées
•
•
6.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
•
6.2.4.9 Opérateur NonNul
Description
L'opérateur NonNul invite la fonction Previous à ignorer les valeurs nulles.
Lorsque Previous 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
•
2012-05-10
Fonctions, opérateurs et mots clés
181
6.2.4.10 Opérateur PasSurSaut
Description
L'opérateur PasSurRupture invite la fonction Interpolation à ignorer les ruptures de section et de bloc.
Rubriques associées
•
6.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
•
6.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 :
Percentage
, RunningAverage, RunningCount, RunningMax, RunningMin, RunningProduct,
RunningSum.
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.
2012-05-10
Fonctions, opérateurs et mots clés
182
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
100
200
Pourcentage
10 %
20 %
Indicateur
500
200
Pourcentage
50 %
20 %
Pourcentage([Indicateur];Ligne) donne le résultat suivant :
Indicateur
100
200
Pourcentage
16,7 %
50 %
Indicateur
500
200
Pourcentage
83,3 %
50 %
Pourcentage([Indicateur];Col) donne le résultat suivant :
Indicateur
100
200
Pourcentage
33,3 %
66,6 %
Indicateur
500
200
Pourcentage
83,3 %
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é, RunningSum([indicateur]) ou RunningSum([indicateur];Ligne) donne le résultat suivant :
Indicateur
100
400
RunningSum
100
700
Indicateur
200
250
RunningSum
300
950
Dans un tableau croisé, RunningSum([Indicateur];Col) donne le résultat suivant :
Indicateur RunningSum Indicateur RunningSum
2012-05-10
Fonctions, opérateurs et mots clés
100
400
Rubriques associées
•
•
•
•
•
•
•
100
500
200
250
700
950
6.2.4.13 Opérateur Auto
Description
Fait référence à la fonction Previous pour la cellule précédente si celle-ci ne contient pas d'objet de rapport.
Exemples
5 + Previous(Auto) renvoie la séquence 5, 10, 15, 20, 25, 30...
1 + 0,5 * Previous(Auto) renvoie la séquence 1, 1,5, 1,75, 1,88...
Rubriques associées
•
183
6.2.4.14 Opérateur Où
Description
L'opérateur Où limite les données utilisées pour calculer un indicateur.
Exemples
La formule Average ([Chiffre d'affaires]) Où ([Pays] = "USA") calcule les ventes moyennes où le pays est "USA".
2012-05-10
Fonctions, opérateurs et mots clés
La formule Average ([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 Average
([Chiffre d'affaires élevé]) renvoie la moyenne des chiffre d'affaires supérieurs à 500 000.
Rubriques associées
•
•
•
•
•
6.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
Dans
PourChaque
PourTout
Description
Spécifie une liste explicite de dimensions à utiliser dans le contexte
Ajoute des dimensions au contexte par défaut
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.
6.2.5.1 Opérateur contextuel Dans
L'opérateur contextuel Dans spécifie les dimensions de façon explicite dans un contexte.
184 2012-05-10
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
2001
2002
2003
Revenu des ventes
8 096 123,60 €
13 232 246,00 €
15 059 142,80 €
Revenu trimestriel max.
2 660 699,50 €
4 186 120,00 €
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 :
185 2012-05-10
Fonctions, opérateurs et mots clés
Année
2001
2001
2001
2001
Année
Trimestre
T1
T2
T3
T4
Max. :
Trimestre
T1
T2
T3
T4
Max. :
Revenu des ventes
2 660 699,50 €
2 279 003,00 €
1 367 841,00 €
1 788 580,00 €
2 660 699,50 €
Revenu des ventes
3 326 172,00 €
2 840 651,00 €
2 879 303,00 €
4 186 120,00 €
4 186 120,00 €
Année Trimestre
T1
T2
T3
T4
Max. :
Revenu des ventes
3 742 989,00 €
4 006 717,50 €
3 953 395,00 €
3 356 041,00 €
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.
186 2012-05-10
Fonctions, opérateurs et mots clés
187
6.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
2001
2002
2003
Revenu des ventes
8 096 123,60
13 232 246,00
15 059 142,80
Revenu trimestriel max.
2 660 699,50
4 186 120,00
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]).
6.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 :
2012-05-10
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.
6.2.6 Opérateurs définis
Les opérateurs agissent sur les membres de données hiérarchiques.
6.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
188 2012-05-10
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]...
Sum([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.
6.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.
6.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.
Placé dans…
Un bloc
Une rupture de bloc (en-tête ou pied)
Fait référence à…
Toutes les données du bloc, sans tenir compte des ruptures, en respectant les filtres
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)
A l'extérieur des blocs ou sections
Non applicable
Non applicable
189 2012-05-10
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.
6.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 :
Placé dans…
Un bloc
Une rupture de bloc (en-tête ou pied)
Fait référence à…
Toutes les données du bloc
Toutes les données du bloc
190 2012-05-10
Fonctions, opérateurs et mots clés
Placé dans…
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Toutes les données de la section
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
2001
2001
Trimestre
T1
T2
T3
T4
Revenu des ventes
2 660 700
2 279 003
1 367 841
1 788 580
8 096 123,6
Corps
2 660 699,5
2 279 003
1 367 840,7
1 788 580,4
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 corps.
6.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 :
Placé dans…
Un bloc
Un saut de bloc (en-tête ou pied)
Fait référence à…
Toutes les données dans la partie du bloc délimité par un saut
Toutes les données dans la partie du bloc délimité par un saut
191 2012-05-10
Fonctions, opérateurs et mots clés
Placé dans…
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Non applicable
Non applicable
Exemple : Mot clé Saut
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes :
Année
2001
Trimestre
T1
T2
T3
T4
Revenu des ventes
2 660 700 €
2 279 003 €
1 367 841 €
1 788 580 €
Total Saut
8 096 124 €
8 096 124 €
8 096 124 €
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é Rupture, cette colonne dupliquerait les chiffres de la colonne Chiffres d'affaires, car le contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
6.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 :
Placé dans…
Un bloc
Une rupture de bloc (en-tête ou pied)
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Toutes les données du rapport
Toutes les données du rapport
Toutes les données du rapport
Toutes les données du rapport
192 2012-05-10
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 Sum([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]).
6.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…
Un bloc
Une rupture de bloc (en-tête ou pied)
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Fait référence à…
Toutes les données de la section
Toutes les données de la section
Toutes les données de la section
Non applicable
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes.
193 2012-05-10
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é.
6.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 :
194 2012-05-10
Fonctions, opérateurs et mots clés
Paramètre
> 0
0
< 0
Description
La fonction arrondit/tronque à <paramètre> décimales.
Exemples :
Round(3.13;1) renvoie 3,1
Round(3.157;2) renvoie 3,16
La fonction arrondit/tronque à l'entier le plus proche.
Exemples :
Truncate(3.7;0) renvoie 3
Truncate(4.164;0) renvoie 4
La fonction arrondit/tronque à la dizaine (paramètre = -1), à la centaine (paramètre
= -2), au millier (paramètre = -3), etc., le plus proche.
Exemples :
Round(123.76;-1) renvoie 120
Round(459.9;-2) renvoie 500
Truncate(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
•
•
•
•
•
•
6.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.
195 2012-05-10
Fonctions, opérateurs et mots clés
196
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
Client_Type
ENTERPRISE
GENERAL
Grande
Nancy Davolio
Janet Leverling
Andrew Smith
Montant commande
277 290 434
180 063 361
113 905 997
44 855 689
44 050 308
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].
•
Sum([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Gra nde].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].
•
Sum([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Gra nde].[Janet Leverling];[Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Gra nde].[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].
•
Sum([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Gra nde].[Nancy Davolio]:[Hiérarchie des ventes]&[Type_Client].[ENTER
2012-05-10
Fonctions, opérateurs et mots clés
PRISE].[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].
•
Sum([Montant commande];{Hiérarchie Ventes].enfants}) renvoie 277 290,434.
197 2012-05-10
Fonctions, opérateurs et mots clés
198 2012-05-10
Dépannage des formules
Dépannage des formules
7.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.
7.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.
Rubriques associées
•
7.1.2 #CONTEXTE
#CONTEXTE apparaît dans un indicateur lorsque le contexte de calcul 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.
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.
199 2012-05-10
Dépannage des formules
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.)
7.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.
7.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.
7.1.5 #ERREUR
200 2012-05-10
Dépannage des formules
#ERREUR est le message d'erreur par défaut qui couvre toutes les erreurs non couvertes par les autres messages d'erreur.
7.1.6 #EXTERNE
#EXTERNE apparaît lorsqu'une formule fait référence à une fonction externe non disponible dans Web
Intelligence.
7.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.
7.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.
7.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.
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".
201 2012-05-10
Dépannage des formules
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.
7.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).
7.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 disposez des droits de sécurité appropriés, modifiez la propriété de requête Nombre max. de lignes extraites pour permettre le rafraîchissement de davantage 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.
7.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 Previous 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 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 Rank.
202 2012-05-10
Dépannage des formules
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 Previous ou toute fonction d'agrégation en cours d'exécution, le bloc entier renvoie #CLASSEMENT.
7.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 NumberOfPages()
Si vous placez la fonction NumberOfPages dans une cellule dont les propriétés Ajuster la hauteur automatiquement ou Ajuster la largeur automatiquement sont définies, 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.
7.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.
7.1.15 #FORMULERAPPT
Impossible de trouver une équivalence Web Intelligence.
203 2012-05-10
Dépannage des formules
7.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.
7.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.
7.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.
7.1.19 #INDISPONIBLE
204 2012-05-10
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é.
205 2012-05-10
Dépannage des formules
206 2012-05-10
Comparaison de valeurs à l'aide de fonctions
Comparaison de valeurs à l'aide de fonctions
8.1 Comparaison de valeurs à l'aide de la fonction Previous
La fonction Previous 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
•
•
•
Comparaison de valeurs à l'aide de la fonction ValeurRelative
8.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 supprimées des lignes offset de la ligne actuelle, et où les valeurs des dimensions de sous-axe sont identiques à celles de la ligne actuelle.
207 2012-05-10
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
2007
2007
2007
2007
2008
2008
2008
2008
T1
T2
T3
T4
Trimestre
T1
T2
T3
T4
Vendeur
Durand
Dupont
Martin
Harris
Durand
Dupont
Martin
Harris
Chiffre d'affaires
1 000
2 000
1 500
3 000
4 000
3 400
2 000
1 700
ValeurRelative
1 000
2 000
1 500
3 000
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
•
8.2.1 Dimensions de découpage et fonction ValeurRelative
208 2012-05-10
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
2007
2007
2007
2007
2007
2007
2007
2007
2008
2008
2008
2008
T2
T3
T4
T2
T3
T4
T1
Trimestre
T1
T2
T3
T4
T1
Vendeur
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Dupont
Durand
Durand
Durand
Durand
Chiffre d'affaires
1 000
2 000
1 500
3 000*
4 000
3 400
2 000
1 700
5 000**
3 000***
2 700****
6 800
ValeurRelative
3 000*
5 000**
3 000***
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.
209 2012-05-10
Comparaison de valeurs à l'aide de fonctions
Année
2007
2007
2007
2007
2008
2008
2008
2008
T3
T4
T1
T2
Trimestre
T1
T2
T3
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
•
8.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
Trimestre
T1
T2
T3
T4
Vendeur
Durand
Durand
Durand
Durand
Chiffre d'affaires
1 000
2 000
1 500
3 000*
ValeurRelative
210 2012-05-10
Comparaison de valeurs à l'aide de fonctions
Trimestre
T1
T2
T3
T4
2008
Trimestre
T1
T2
T3
T4
Vendeur
Dupont
Dupont
Dupont
Dupont
Chiffre d'affaires
4 000
3 400
2 000
1 700
ValeurRelative
Vendeur
Durand
Durand
Durand
Durand
Chiffre d'affaires
5 000**
3 000***
2 700 ****
6 800
ValeurRelative
3 000*
5 000**
3 000***
2 700****
Année
2007
2007
2007
2007
2008
2008
2008
2008
La fonction se sert de la liste des valeurs des dimensions de découpage pour trouver le chiffre d'affaires comparatif.
T4
T1
T2
T3
T4
Trimestre
T1
T2
T3
*
**
***
****
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
•
211 2012-05-10
Comparaison de valeurs à l'aide de fonctions
8.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
2007
2007
2007
2007
2007
2007
2007
2007
2008
2008
2008
2008
T2
T3
T4
T2
T3
T4
T1
Trimestre
T1
T2
T3
T4
T1
Vendeur
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Dupont
Durand
Durand
Durand
Durand
Chiffre d'affaires
1 000
2 000
1 500
3 000*
4 000
3 400
2 000
1 700
5 000**
3 000***
2 700****
6 800
ValeurRelative
3 000*
5 000**
3 000***
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 :
Année
2007
2007
2007
2007
Trimestre
T1
T2
T3
T4 *
212 2012-05-10
Comparaison de valeurs à l'aide de fonctions
Année
2008
2008
2008
2008
La fonction devient :
RelativeValue([Revenue];([Quarter];[Year]);-1)
L'ordre de tri des dimensions de découpage devient :
T2
T2
T3
T3
T4
T4
Quarter
T1
T1
Year
2007
2008
2007
2008
2007
2008
2007
2008
Trimestre
T1
T2
T3
T4
**
***
****
*
**
***
****
*****
******
*******
********
Année
2007
2007
2007
2007
2007
2007
2007
2007
2008
L'impact de l'ordre de tri sur le résultat de la fonction est le suivant :
Trimestre
T1
T2
T3
T4
T1
T2
T3
T4
T1
Vendeur
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Dupont
Durand
Chiffre d'affaires
1 000*
2 000***
1 500*****
3 000*******
4 000
3 400
2 000
1 700
5 000**
ValeurRelative
1 000*
213 2012-05-10
Comparaison de valeurs à l'aide de fonctions
Année
2008
2008
2008
Trimestre
T2
T3
T4
Vendeur
Durand
Durand
Durand
Chiffre d'affaires
3 000****
2 700******
6 800********
ValeurRelative
2 000***
1 500*****
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
•
8.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 :
Année
2007
2007
2007
2007
2007
2007
2007
Trimestre
T1
T2
T4
T3
T1
T2
T4
Vendeur
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Chiffre d'affaires
1 000
2 000
3 000
1 500*
4 000
3 400
1 700
ValeurRelative
214 2012-05-10
Comparaison de valeurs à l'aide de fonctions
Année
2007
2008
2008
2008
2008
T2
T4
T3
Trimestre
T3
T1
Vendeur
Dupont
Durand
Durand
Durand
Durand
Année
2007
2007
2007
2007
2008
2008
2008
2008
La liste triée des dimensions de découpage est la suivante :
T3
T1
T2
T4
T3
Trimestre
T1
T2
T4
Chiffre d'affaires
2 000
5 000**
3 000***
6 800****
2 700
ValeurRelative
1 500*
5 000**
3 000***
6 800****
*
**
***
****
Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées
•
8.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
•
215 2012-05-10
Comparaison de valeurs à l'aide de fonctions
216 2012-05-10
Informations supplémentaires
Informations supplémentaires
Ressources d'informations
Informations sur le produit SAP
BusinessObjects
SAP Help Portal
SAP Service Marketplace
Emplacement
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".
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
• 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.
217 2012-05-10
Informations supplémentaires
Ressources d'informations
Docupedia
Emplacement
https://cw.sdn.sap.com/cw/community/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/ https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
Articles SAP BusinessObjects sur
SAP Community Network https://www.sdn.sap.com/irj/boc/businessobjects-articles
Ces articles étaient précédemment appelées notes techniques.
Remarques https://service.sap.com/notes
Ces remarques étaient précédemment appelées des articles de la base de connaissances.
Forums sur SAP Community Network https://www.sdn.sap.com/irj/scn/forums
Formation http://www.sap.com/services/education
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.
Support client en ligne
Conseil http://service.sap.com/bosap-support
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
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.
218 2012-05-10
Index
Symboles
#ACTUALISER, message d'erreur 203
#CALCUL, message d'erreur 170, 199
#CLASSEMENT, message d'erreur
#CONTEXTE, message d'erreur 199,
#DEBORDEMENT, message d'erreur
#ERREUR, message d'erreur 128,
#EXTERNE, message d'erreur 201
#FORMULERAPPT, message d'erreur
#INCOMPATIBLE, message d'erreur
#INDISPONIBLE
et indicateurs intelligents 47
#INDISPONIBLE, message d'erreur
46, 205 et indicateurs intelligents 205
#MELANGER, message d'erreur 201
#RECURSIF, message d'erreur 203
#RESULTATPARTIEL, message
d'erreur 202 et indicateurs intelligents 202
#SECURITE, message d'erreur 204
#SYNCDONNEES, message d'erreur
#SYNTAXE, message d'erreur 204
#TOREFRESH, message d'erreur 42,
46, 204 et indicateurs intelligents 204
#VALEURMULTI, message d'erreur
#VALEURMULTIPLE, message
A
afficher l'auteur de documents 112
afficher le propriétaire des documents
afficher les informations de connexion
afficher les informations de connexion
du propriétaire d'un document 114
afficher les noms des diagrammes 156 afficher les numéros de colonne 156
afficher, date du dernier
enregistrement d'un document 114
afficher, heure du dernier
enregistrement d'un document 115
afficher, la date de création des
afficher, nombre de pages dans un
afficher, noms des objets rapport 164
afficher, noms des tableaux 156
afficher, réponses aux invites 111
aggregation, fonctions inclure plusieurs dimensions dans
analyse, périmètre
et indicateurs intelligents 43 et regroupements 43
appliquer, format aux nombres 79
renvoyer des caractères associés
modifier le contexte de calcul par
PourChaque (opérateur) 32, 187
à l'aide de mots clés de syntaxe
blocs
booléennes, expressions
booléennes, valeurs
B
C calcul par défaut, contextes
dans les tableaux horizontaux 26
dans les tableaux verticaux 25
modifier à l'aide d'une syntaxe
calculer des erreurs d'arrondi 131, 133
calculer le sinus d'un angle 143
calculer un logarithme en base 10 138
calculer un logarithme naturel 137
calculer un maximum cumulatif 65
calculer un minimum cumulatif 66
calculer un nombre cumulatif 64
calculer un produit cumulatif 68
calculer une fonction exponentielle 134
calculer une moyenne cumulative 62
calculer une racine carrée 144
calculer une somme cumulative 69
calculer, écart type de population 72
calculer, logarithme en base n 138
calculer, une variance de population
219 2012-05-10
Index calculs
personnalisés 11 standard 11 calculs personnalisés 11
calculs personnalisés, créer à l'aide de
caractères afficher depuis des valeurs ASCII
cellules
inclure du texte dans 13 inclure les fonctions dans 13
chaînes
chaînes de caractères appliquer des règles d'encodage
faire correspondre à un modèle 83
joindre/concaténer 18, 77, 173
mettre en majuscules la première
mettre en majuscules les premières
mettre en majuscules toutes les
remplir avec d'autres chaînes 81,
renvoyer les caractères les plus à
renvoyer les caractères les plus à
supprimer les espaces à droite 88
supprimer les espaces à gauche
supprimer les espaces à la fin
classement et fonctions d'agrégat cumulatives
Col, opérateur 62, 65, 66, 68, 69, 181
colonnes
comparer les valeurs à l'aide de
comparer les valeurs à l'aide de
RelativeValue 208, 210, 212, 214,
comparer les valeurs, à l'aide de
compter, lignes dans les tableaux 164
concaténer des chaînes de caractères
concaténer, chaînes de caractères 18,
condition Si...Alors...Sinon 161
conditionnels, opérateurs 19, 173
contextes de calcul
et indicateurs intelligents 46
modifier à l'aide d'une syntaxe
convertir à partir d'euros 128
D
DansListe, opérateur 19, 174, 176
DataProviderKeyDate, fonction 103
DataProviderKeyDateCaption, fonction
DataProviderType, fonction 105
dates
calculer les dates relatives 97
impact de l'ordre de tri 208, 212,
devises convertir entre devises
devises européennes
diagrammes
dimensions
ajouter au contexte de calcul 32,
et message d'erreur
et message d'erreur
inclure plusieurs dimensions dans
spécifier dans le contexte de calcul
supprimer du contexte de calcul
document, afficher les paramètres
document, paramètres régionaux
DocumentPartiallyRefreshed, fonction
documents
afficher l'heure du dernier
afficher la date de création 113
afficher la date du dernier
enregistrement 114 afficher le nom de 114 afficher le propriétaire de 114
visualiser les requêtes dans 117
données
220 2012-05-10
Index données de référence
E
Editeur de formule afficher la syntaxe de la fonction
Eléments de même niveau, fonction
entrée, contexte
erreurs
espaces à droite supprimer des chaînes de
espaces à gauche supprimer des chaînes de
étendue, syntaxe
opérateur Dans 29, 184 opérateur PourTout 29, 184
PourChaque (opérateur) 29, 184
EuroConvertFrom, fonction 128, 194
EuroConvertTo, fonction 130, 194
EuroFromRoundError, fonction 131,
euros
EuroToRoundError , fonction 194
EuroToRoundError, fonction 133
Exploration, opérateur 165, 177
F
Fact, fonction 135 factoriel 135
filtres
afficher les filtres d'exploration 177 afficher tout 177
et indicateurs intelligents 48
filtres (suite) filtrer des indicateurs intelligents
filtres d'exploration 177 afficher 177
et indicateurs intelligents 48
ignorer 177 filtres de rapport 118, 177 ignorer 177
filtres sur les dimensions impact sur les indicateurs
fonction, syntaxe
fonctions
combiner avec du texte dans les
DataProviderKeyDateCaption 103
fonctions (suite)
DocumentPartiallyRefreshed 115
faire référence à des ensembles
faire référence à des membres
fonction DocumentCreationDate
fonction DocumentCreationTime
fonction LastExecutionTime 107
GetDominantPreferredViewingLocale
221 2012-05-10
Index fonctions (suite)
Previous 166, 180, 183, 202, 207
fonctions (suite)
Sum 14, 32, 33, 34, 35, 37, 38, 72,
ValeurRelative 170, 199, 207, 210,
fonctions caractère
fonctions d'agrégat
fonctions d'agrégat cumulatives
et message d'erreur
fonctions de date et d'heure
fonctions diverses
fonctions document
I fonctions du fournisseur de données
fonctions logiques
fonctions numériques
formules créer des calculs personnalisés à
et indicateurs intelligents 45
indicateurs intelligents dans 46
messages d'erreur générés par
simplifier avec des variables 12, 17
utilisation des opérateurs dans 18,
formules, messages d'erreur 199
afficher le nom de l'univers 111
afficher le nombre de lignes dans
visualiser le code SQL généré par
G
GetContentLocale, fonction 158
GetDominantPreferredViewingLocale,
GetPreferredViewingLocale, fonction
guide des fonctions, formules et calculs, utilisation
H heure, valeurs
identifier les nombres impairs 119, 126 identifier les nombres pairs 119, 126
identifier, valeurs booléennes 122
222 2012-05-10
Index
identifier, valeurs d'heure 125
identifier, valeurs nulles 122
indicateur, valeurs
indicateurs et contextes de calcul par défaut
indicateurs intelligents définis 41
renvoyer les valeurs précédentes
170 renvoyer les valeurs suivantes 170
indicateurs intelligents
et message d'erreur
et message d'erreur
et message d'erreur
indicateurs intelligents, filtrer 47
individuelles, cellules et message d'erreur
Interpolation, fonction 136, 180, 181
interpoler des valeurs d'indicateur 136,
181 interpoler, valeurs d'indicateur 181
invites
IsPromptAnswered, fonction 105
J
joindre des chaînes de caractères 18,
K
L
LastExecutionDate, fonction 106
LastExecutionDuration, fonction 107
LastExecutionTime, fonction 107
Ligne, opérateur 62, 65, 66, 68, 69,
lignes afficher le nombre de lignes dans
afficher le numéro de ligne 172
compter les valeurs distinctes 177 compter toutes les valeurs 177
logarithmes 137, 138 logarithmes en base 10 138 logarithmes en base n 138
M
mathématiques, opérateurs 18, 173
utiliser avec les opérateurs de
maximum, valeurs
calculer un maximum cumulatif 65
Median, fonction 57 médiane 57
membres faire référence dans les fonctions
membres, ensemble faire référence dans les fonctions
messages d'erreur
minimum, valeurs
calculer un minimum cumulatif 66
MonthNumberOfYear, fonction 95
mots clés
mots clés de la syntaxe étendue
rendre les rapports génériques
moyenne calculer une moyenne cumulative
N
223 2012-05-10
Index
nombre, calculer la valeur absolue 127
nombres
arrondir les nombres par défaut
déterminer si impair ou pair 119,
transformer des chaînes de
caractères en 145 tronquer 145 tronquer des nombres 145
nombres impairs
nombres pairs
nulles, valeurs
NumberOfDataProviders, fonction 108
et message d'erreur #RECURSIF
numéros de page
afficher dans les rapports 166
O objets
visualiser des filtres sur 118
opérateurs
Col 62, 64, 65, 66, 68, 69, 181
opérateurs (suite)
Ligne 62, 64, 65, 66, 68, 69, 181
NonNul 166, 180 opérateur Index 180
opérateurs spécifiques à la fonction
spécifiques à la fonction 20, 176
ordre de tri
et dimensions de découpage 208,
PasSurRupture, opérateur 136, 181
personnalisés, calculs
utiliser des formules pour créer 12
PointAPoint, opérateur 136, 181
pourcentage, calcul standard 11
PourTout, opérateur 32, 38, 187
Preferred Viewing Locale
Previous, fonction 166, 180, 183
et message d'erreur
produit, afficher les paramètres
produit, paramètres régionaux
produits
calculer un produit cumulatif 68
propriétés de requête
Nombre max. de lignes extraites
Q
P
pages afficher le nombre de pages dans
paramètres régionaux afficher les paramètres régionaux
afficher les paramètres régionaux de visualisation préférés
afficher les paramètres régionaux
paramètres régionaux de visualisation
préférés dominants, afficher 159
paramètres régionaux de visualisation
paramètres régionaux de visualisation préférés, dominants
R
rapports afficher le nombre de pages dans
afficher les noms des objets dans
afficher les numéros de page dans
RefValueUserReponse, fonction 110
RefValueUserResponse, fonction 180
regroupements 41 définition 41
224 2012-05-10
Index regroupements (suite)
et périmètre d'analyse 43 exemple de gestion de 43
RelativeValue, fonction
comparer des valeurs 210, 212,
et dimensions de découpage 210 et les sections 210
ReportFilterSummary, fonction 118
requêtes
RunningAverage, fonction 62, 179
RunningCount, fonction 64, 179
ruptures contextes de calcul par défaut dans
S
sections contextes de calcul par défaut dans
et dimensions de découpage 210 et la fonction ValeurRelative 210
simplifier des formules avec des
sortie, contexte
et actualisation des données 42 et regroupements 41, 42
SQL (suite)
à l'aide de mots clés de syntaxe
à l'aide de mots clés de syntaxe
utiliser avec les opérateurs de
syntaxe avancée, mots clés 33, 189
rendre les rapports génériques
utiliser avec la fonction Average
utiliser avec la fonction Sum 33,
34, 35, 37, 190, 191, 192, 193
syntaxe de la fonction, afficher 14
T tableaux
tableaux croisés contextes de calcul par défaut dans
et la fonction ValeurRelative 215
tableaux horizontaux contextes de calcul par défaut dans
Tan, fonction 144 tangentes 144
tester, valeurs booléennes 161, 163
tris
et dimensions de découpage 208,
U
univers
URL appliquer des règles d'encodage à
UserResponse, fonction 14, 111, 180
V
comparer des valeurs 207, 208,
et dimensions de découpage 208,
et message d'erreur #CALCUL 199
valeurs
comparer à l'aide de Previous 207
comparer à l'aide de RelativeValue
variables
et indicateurs intelligents 45
simplifier les formules avec 12, 17
vertical, tableau contextes de calcul par défaut dans
W
Y
225 2012-05-10
Index
226 2012-05-10
