View
242
Download
7
Category
Preview:
Citation preview
Utilisation de fonctions, formules et calculs dans Web Intelligence■ SAP BusinessObjects Business Intelligence Suite 4.0 Feature Pack 3
2012-05-10
© 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
Copyright
mentionnés dans ce document, ainsi que leurs logos respectifs, sont des marques commerciales oudes marques déposées de SAP AG en Allemagne ainsi que dans d'autres pays. Business Objectset 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, ainsique leurs logos respectifs, sont des marques commerciales ou des marques déposées de BusinessObjects 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 dansce document, ainsi que leurs logos respectifs, sont des marques commerciales ou des marquesdéposées de Sybase, Inc. Sybase est une société du Groupe SAP. Crossgate, m@gic EDDY, B2B360°, B2B 360° Services sont des marques commerciales ou des marques déposées de CrossgateAG en Allemagne ainsi que dans d'autres pays. Crossgate est une société du Groupe SAP. Tous lesautres noms de produits et de services mentionnés sont des marques commerciales ou des marquesdéposées de leurs entreprises respectives. Les données contenues dans ce document sontuniquement 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, sansengagement ni garantie d'aucune sorte. Le Groupe SAP ne pourra en aucun cas être tenu pourresponsable des erreurs ou omissions relatives à ces informations. Les seules garanties fourniespour les produits et les services du Groupe SAP sont celles énoncées expressément à titre degarantie accompagnant, le cas échéant, lesdits produits et services. Aucune des informationscontenues dans ce document ne saurait constituer une garantie supplémentaire.
2012-05-10
Table des matières
Historique des documents : Fonctions, formules et calculs Web Intelligence.......................7Chapitre 1
A propos de ce guide..............................................................................................................9Chapitre 2
Utilisation de calculs standards et personnalisés.................................................................11Chapitre 3
Calculs standard....................................................................................................................113.1Utilisation de formules pour créer des calculs personnalisés..................................................123.2Utilisation de variables pour simplifier des formules................................................................123.2.1Utilisation des fonctions.........................................................................................................133.3Insertion de fonctions dans des cellules.................................................................................133.3.1Syntaxe de la fonction............................................................................................................143.3.2Exemples de fonctions...........................................................................................................143.3.3Opérateurs de fonction et de formule.....................................................................................183.3.4
Notions de contextes de calcul.............................................................................................21Chapitre 4
Définition des contextes de calcul..........................................................................................214.1Contexte d'entrée..................................................................................................................214.1.1Contexte de sortie.................................................................................................................224.1.2Contextes de calcul par défaut...............................................................................................244.2Contextes par défaut dans un tableau vertical........................................................................254.2.1Contextes par défaut dans un tableau horizontal....................................................................264.2.2Contextes par défaut dans un tableau croisé..........................................................................264.2.3Contextes par défaut dans une section..................................................................................274.2.4Contextes par défaut dans une rupture..................................................................................284.2.5Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée..........................294.3Opérateurs de syntaxe avancée.............................................................................................294.3.1Mots clés de la syntaxe avancée............................................................................................334.3.2
Calcul de valeurs à l'aide d'indicateurs intelligents..............................................................41Chapitre 5
Indicateurs intelligents définis.................................................................................................415.1Regroupements et indicateurs intelligents..............................................................................415.2
2012-05-103
Gestion des regroupements...................................................................................................425.2.1Indicateurs intelligents et périmètre d'analyse.........................................................................435.3Indicateurs intelligents et SQL................................................................................................435.4Regroupements et opérateur UNION.....................................................................................435.4.1Indicateurs intelligents et formules.........................................................................................455.5Indicateurs intelligents et dimensions contenant des formules................................................455.5.1Indicateurs intelligents dans les formules................................................................................465.5.2Indicateurs intelligents et filtres..............................................................................................465.6Indicateurs intelligents et filtres sur les dimensions................................................................465.6.1Filtrage des indicateurs intelligents.........................................................................................475.6.2Indicateurs intelligents et filtres d'exploration.........................................................................485.6.3Indicateurs intelligents et filtres OR imbriqués........................................................................495.6.4
Fonctions, opérateurs et mots clés.......................................................................................51Chapitre 6
Fonctions...............................................................................................................................516.1Fonction du groupe Aggregate...............................................................................................516.1.1Fonctions du groupe Character..............................................................................................756.1.2Fonctions du groupe Date and Time.......................................................................................906.1.3Fonctions du groupe Data Provider......................................................................................1016.1.4Fonctions du groupe Document...........................................................................................1126.1.5Fonctions du groupe Logical.................................................................................................1196.1.6Fonctions du groupe Numeric..............................................................................................1266.1.7Fonctions d'ensemble..........................................................................................................1466.1.8Fonctions diverses...............................................................................................................1556.1.9Opérateurs de fonction et de formule...................................................................................1736.2Opérateurs mathématiques..................................................................................................1736.2.1Opérateurs conditionnels.....................................................................................................1736.2.2Opérateurs logiques.............................................................................................................1746.2.3Opérateurs spécifiques à la fonction....................................................................................1766.2.4Opérateurs de syntaxe avancée...........................................................................................1846.2.5Opérateurs définis................................................................................................................1886.2.6Mots clés de la syntaxe avancée..........................................................................................1896.3Mot clé Bloc........................................................................................................................1896.3.1Mot clé Corps......................................................................................................................1906.3.2Mot clé Saut........................................................................................................................1916.3.3Mot clé Rapport...................................................................................................................1926.3.4Mot clé Section....................................................................................................................1936.3.5Arrondir et tronquer des nombres........................................................................................1946.4Référence à des membres et des ensembles de membres des hiérarchies..........................1956.5
2012-05-104
Table des matières
Dépannage des formules....................................................................................................199Chapitre 7
Messages d'erreur de formule et d'information....................................................................1997.1#CALCUL............................................................................................................................1997.1.1#CONTEXTE........................................................................................................................1997.1.2#SYNCDONNEES...............................................................................................................2007.1.3#DIV/0.................................................................................................................................2007.1.4#ERREUR............................................................................................................................2007.1.5#EXTERNE...........................................................................................................................2017.1.6#INCOMPATIBLE................................................................................................................2017.1.7#MELANGER.......................................................................................................................2017.1.8#VALEURMULTI..................................................................................................................2017.1.9#DEBORDEMENT...............................................................................................................2027.1.10#RESULTATPARTIEL...........................................................................................................2027.1.11#CLASSEMENT...................................................................................................................2027.1.12#RECURSIF.........................................................................................................................2037.1.13#ACTUALISER.....................................................................................................................2037.1.14#FORMULERAPPT..............................................................................................................2037.1.15#SECURITE.........................................................................................................................2047.1.16#SYNTAXE..........................................................................................................................2047.1.17#TOREFRESH......................................................................................................................2047.1.18#INDISPONIBLE..................................................................................................................2047.1.19
Comparaison de valeurs à l'aide de fonctions....................................................................207Chapitre 8
Comparaison de valeurs à l'aide de la fonction Previous.......................................................2078.1Comparaison de valeurs à l'aide de la fonction ValeurRelative..............................................2078.2Dimensions de découpage et fonction ValeurRelative..........................................................2088.2.1Dimensions de découpage et sections.................................................................................2108.2.2Ordre des dimensions de découpage...................................................................................2128.2.3Dimensions de découpage et tris.........................................................................................2148.2.4Utilisation de ValeurRelative dans les tableaux croisés.........................................................2158.2.5
Informations supplémentaires.............................................................................................217Annexe A
Index 219
2012-05-105
Table des matières
2012-05-106
Table des matières
Historique des documents : Fonctions, formules etcalculs Web Intelligence
La table suivante fournit un récapitulatif des principales modifications effectuées dans le document :
DescriptionDateVersion
Initialement renommé Interactive AnalysisPremière version de ce document
30 nove-mbre 2011
SAP BusinessObjects InteractiveAnalysis 4.0
Support Package 125 fé-vrier 2011
SAP BusinessObjects InteractiveAnalysis 4.0 Service Pack 1
Support Package 2 Renommé ensuite WebIntelligence
15 juin 2011BusinessObjects Web Intelligence 4.0Service Pack 2
Feature Pack 320 fé-vrier 2012
BusinessObjects Web Intelligence 4.0Feature Pack 3
2012-05-107
Historique des documents : Fonctions, formules et calculs Web Intelligence
2012-05-108
Historique des documents : Fonctions, formules et calculs Web Intelligence
A propos de ce guide
Le guide Utilisation de fonctions, de formules et de calculs dans Web Intelligence fournit des informationsdétaillées sur les fonctionnalités de calcul avancées disponibles lorsque vous effectuez une analysede données. Il sert aussi de référence pour la syntaxe des fonctions et des opérateurs disponibles.
2012-05-109
A propos de ce guide
2012-05-1010
A propos de ce guide
Utilisation de calculs standards et personnalisés
Vous pouvez vous servir des fonctions de calcul standard pour effectuer des calculs rapides sur lesdonnées. Si les calculs standard ne suffisent pas et ne répondent pas à vos besoins, vous pouvez créerdes 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 lesdonnées. Les calculs standard suivants sont disponibles :
DescriptionCalcul
Calcule la somme des données sélectionnées.Somme
Compte toutes les lignes d'un objet de type indi-cateur ou compte les différentes lignes d'un objetde type dimension ou information.
Nombre
Calcule la moyenne des données.Moyenne
Affiche la valeur minimale des données sélectio-nnées.Minimum
Affiche la valeur maximale des données sélectio-nnées.Maximum
Afficher les données sélectionnées sous formede pourcentage du total. Les résultats du pource-ntage sont affichés dans une colonne ou une lignesupplémentaire du tableau.
Remarque :Les pourcentages sont calculés pour l'indicateursélectionné relativement aux résultats totaux pourcet indicateur sur le tableau ou la rupture. Pourcalculer le pourcentage d'un indicateur relativeme-nt à un autre indicateur, vous devez créer uncalcul personnalisé.
Pourcentage
2012-05-1011
Utilisation de calculs standards et personnalisés
DescriptionCalcul
Applique la fonction d'agrégation par défaut à unindicateur standard, ou la fonction d'agrégationde base de données à un indicateur intelligent.
Par défaut
Lorsque vous appliquez des calculs standard à des colonnes de tableau, leurs résultats apparaissentdans 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 debase et des calculs standard.
L'ajout d'un calcul personnalisé se fait en écrivant une formule. Une formule peut se composer devariables 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 etd'opérateurs. Les formules bénéficient d'un contexte de calcul que vous pouvez spécifier de façonexplicite 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 quevous voulez ajouter le revenu par vente. Le calcul [Revenu des ventes]/[Quantité vendue]génère cette valeur en divisant le revenu par le nombre d'articles vendus pour obtenir le revenupar 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 desvariables, 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êmefaçon que vous utilisez d'autres objets de rapport. Les variables apparaissent dans l'Editeur de formulesous le dossier Variables.
2012-05-1012
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 Formulecomme 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 desventes]/[Nombre de ventes]. Néanmoins, les calculs peuvent également inclure des fonctionsen 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 indicateursdes ventes.
Rubriques associées• Opérateurs de fonction et de formule• Fonctions
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é deguillemets, au contraire des formules qui apparaissent sans guillemets. Par exemple, la formuleAverage([Revenu]) apparaît dans une cellule sous la forme =Average([Revenu]). Le texte "Revenumoyen ?" 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 soientpas placés directement côte à côte dans la cellule.
2012-05-1013
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 abesoin et les types de données de ces valeurs. Vous devez également connaître le type de donnéesque génère la fonction.
Par exemple, la fonction Sum utilise un objet numérique comme entrée (par exemple, un indicateurprésentant un revenu des ventes) et génère des données numériques (la somme de toutes les valeursde 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 ensortie.
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'objetEtat figure également dans le rapport bien qu'il ne soit pas affiché. Lorsque l'utilisateur exécute lerapport, une invite s'affiche, lui proposant de choisir un Etat. Vous voulez que l'Etat choisi s'affichedans le titre du rapport. Si le fournisseur de données s'appelle "eFashion" et que le texte de l'inviteest "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 dufournisseur de données :
2012-05-1014
Utilisation de calculs standards et personnalisés
Exemple : Calcul d'un pourcentage à l'aide de la fonction Pourcentage
La fonction Pourcentage permet de calculer des pourcentages : Cette fonction calcule le pourcentaged'un nombre par rapport à son contexte environnant. Par exemple, le tableau suivant présente lesrevenus par année et par trimestre. La colonne de pourcentage contient la formule Pourcentage([Revenu des ventes]).
2012-05-1015
Utilisation de calculs standards et personnalisés
Dans ce cas, la fonction calcule chaque revenu en tant que pourcentage du revenu total. Le contexteenvironnant est le revenu total ; il s'agit du seul chiffre de revenu qui est intéressant, en dehors de laré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 devientle revenu total de la section.
Si la cellule Pourcentage est placée à l'extérieur du tableau, mais toujours au sein de la section, lecontexte environnant devient le revenu total. Dans ce cas, la fonction Pourcentage calcule le revenutotal pour la section en tant que pourcentage du revenu global total.
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 Sumplutôt que la fonction Percentage. Si vous divisez un chiffre faisant partie d'un ensemble de chiffrespar 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 pourcentagedu revenu total.
Dans le tableau suivant, la colonne Pourcentage du total contient la formule[Sales revenue]/(Sum([Sales revenue] In Report))
2012-05-1016
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 à lafonction 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
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 cesvaleurs 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 formulecomplexe 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 voulezinclure la variance. Sans l'utilisation de variables pour la simplifier, cette formule complexe se présentecomme suit :Sum((([Quantity sold] - Average([Quantity sold] ForEach [Quarter]) In Report)*([Quantity sold] - Average([Quantity sold] ForEach [Quarter]) In Report)) In [Quarter])/(Count ([Quantity sold] ForEach [Quarter]) - 1)
Création de la formule de variancePlusieurs étapes sont nécessaires pour créer une formule de variance. Vous encapsulez chacune deces étapes dans une variable. Les variables que vous créez sont les suivantes :• Moyenne du nombre d'articles vendus
2012-05-1017
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 :
FormuleVariable
Average([Quantité vendue] Dans ([Trimestre]))Dans RapportMoyenne des ventes
Count([Quantité vendue] Dans ([Trimestre])) DansRapportNombre d'observations
Power(([Quantité vendue] - [Moyenne ventes]);2)Différence élevée au carré
Sum([Différence élevée au carré] Dans ([Trime-stre]))/([Nombre d'observations] - 1)Variance
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 ensuiteexaminer les formules des variables référencées dans la formule de niveau élevé pour comprendreses parties constitutives.
Par exemple, la formule fait référence à la variable Différence élevée au carré, qui fait elle-mêmeréférence à la variable Moyenne vendue. En examinant les formules de Différence élevée au carré etde Moyenne vendue, vous pouvez explorer en avant la formule afin de comprendre en détail ce qu'elleeffectue.
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 desopé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étiquesde base. Les opérateurs d'addition (+), de soustraction (-), de multiplication (*) et de division (/) permettent
2012-05-1018
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énationde 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
Les opérateurs conditionnels déterminent le type de comparaison à effectuer entre des valeurs.
DescriptionOpérateur
Egal à=
Supérieur à>
Inférieur à<
Supérieur ou égal à>=
Inférieur ou égal à<=
Différent de<>
Vous utilisez les opérateurs conditionnels avec la fonction Si, comme dans :If [Revenue]>10000 Then "High" Else "Low"
qui renvoie "Elevé" pour toutes les lignes où le revenu est supérieur ou égal à 10 000 et "Bas" pourtoutes 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ésdans des expressions booléennes qui renvoient True ou False.
3.3.4.4 Opérateurs contextuels
2012-05-1019
Utilisation de calculs standards et personnalisés
Les opérateurs contextuels font partie de la syntaxe de calcul avancée. La syntaxe avancée permetde 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, lafonction Previous peut avoir pour argument l'opérateur Lui-même.
Toutes les fonctions entourent les arguments avec ) et (. Les fonctions qui acceptent plusieursparamètres utilisent ; pour les séparer.
2012-05-1020
Utilisation de calculs standards et personnalisés
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 pourcalculer 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 durevenu 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. Lerevenu et le nombre de ventes sont des exemples d'indicateurs. Par exemple, nous pouvons parlerdu nombre de ventes réalisées dans un magasin particulier.
Les indicateurs peuvent également être générés par des combinaisons de données de type dimension.Par exemple, nous pouvons parler du revenu généré par un magasin particulier en 2005.
Le contexte de calcul d'un indicateur comprend deux composants :• la dimension ou la liste de dimensions qui détermine la valeur de l'indicateur,• la partie des données de type dimension qui détermine la valeur de l'indicateur.
Le contexte de calcul comprend deux composants :• Contexte d'entrée• Contexte de sortie
Rubriques associées• Contexte d'entrée• Contexte de sortie
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.
2012-05-1021
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 quirenvoie la valeur en sortie. La liste de dimensions doit également se trouver entre parenthèses (mêmesi elle ne contient qu'une seule dimension) et les dimensions doivent être séparées par despoints-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 colonnesClient et Revenu, les contextes d'entrée sont les suivants :
Contexte d'entréePartie de rapport
AnnéeEn-tête de section et pieds de page de bloc
Année, ClientLignes du bloc
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 lerevenu 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 commesuit :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 depage 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 del'année, et le revenu minimal calculé par année :
2012-05-1022
Notions de contextes de calcul
Comment présenter le revenu annuel minimal dans un bloc sans rupture ? Pour ce faire, vous pouvezspé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 vousspécifiez ce contexte. Dans ce cas, le contexte de sortie calcule le revenu minimal par an.
Si vous rajoutez une colonne contenant cette formule dans le bloc, le résultat est le suivant :
Vous pouvez constater que la colonne Minimum par année contient le revenu minimal qui figure dansles 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 pardéfaut (Année, Trimestre) pour le bloc. En d'autres termes, le contexte de sortie détermine le revenu
2012-05-1023
Notions de contextes de calcul
par année et par trimestre à calculer. De forme complète, avec les formules d'entrée et de sortiespé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'indiquerle 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'oubliezpas que le contexte par défaut d'un bloc inclut les dimensions du bloc. Le revenu minimal annuel partrimestre est identique au revenu annuel par trimestre parce qu'il n'existe qu'un seul revenu parcombinaison 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 chiffresrenvoyés par un indicateur dépendent des dimensions auxquelles cet indicateur est associé. Cettecombinaison 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, vouspouvez déterminer l'ensemble de dimensions utilisé pour générer un indicateur. Il s'agit précisémentde 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 rapportprésente le revenu généré par les clients et il est divisé en sections par année.
Total : 8 0002005
RevenuClient
1 000Harris
3 000Dupont
4 000Walsh
8000Total :
Total du rapport : 8 000
2012-05-1024
Notions de contextes de calcul
Le tableau suivant présente le contexte de calcul des indicateurs dans ce rapport :
ContexteValeurIndicateur
Total de tous les revenus durapport20 000Total du rapport
Année8000Total de l'en-tête de section
Année;Client1000, 3000, 4000Total du client
Année8000Total du pied de page de bloc
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, desdonnées s'étendant de haut en bas dans le tableau, et des pieds de page dans la partie inférieure dutableau. Les contextes par défaut dans un tableau vertical sont les suivants :
Le contexte de sortie est...Le contexte d'entrée est...Lorsque le calcul se trouve da-ns...
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs utilisés pour générer lecorps du bloc.
En-tête
Le même que le contexte d'en-trée.
Les dimensions et les indica-teurs utilisés pour générer laligne en cours.
Corps du bloc
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs utilisés pour générer lecorps du bloc.
Pied de page
2012-05-1025
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 lagauche, les données s'échelonnent de gauche à droite et les pieds de page figurent sur la droite. Lescontextes 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 auxintersections des dimensions. Les contextes par défaut dans un tableau croisé sont les suivants :
Le contexte de sortie est…Le contexte d'entrée est…Le calcul se trouve dans...
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs utilisés pour générer lecorps du bloc.
En-tête
Le même que le contexte d'en-trée.
Les dimensions et les indica-teurs utilisés pour générer lecorps du bloc.
Corps du bloc
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs utilisés pour générer lecorps du bloc.
Pied de page
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs utilisés pour générer lacolonne courante.
Pied de page VBody
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs utilisés pour générer laligne courante.
Pied de page HBody
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Identique au pied de page.Pied de page VFooter
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Identique au pied de page.Pied de page HFooter
2012-05-1026
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 dansune section sont les suivants :
Le contexte de sortie est…Le contexte d'entrée est…Le calcul se trouve dans...
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Les dimensions et les indica-teurs du rapport, filtrés pour limi-ter les données à celles de lasection.
Corps
Exemple : Contextes par défaut dans une section
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
2012-05-1027
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 dansune rupture sont les suivants :
Le contexte de sortie est…Le contexte d'entrée est…Le calcul se trouve dans...
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Instance en cours de la rupture.En-tête
Toutes les données sont agré-gées, puis la fonction de calculrenvoie une valeur unique.
Instance en cours de la rupture.Pied de page
Exemple : Contextes par défaut dans une rupture
Le rapport suivant présente les contextes par défaut dans une rupture :
2012-05-1028
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 à unindicateur pour spécifier son contexte de calcul. Le contexte d'un indicateur ou d'une formule estconstitué 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. Letableau suivant répertorie les opérateurs contextuels :
DescriptionOpérateur
Spécifie une liste explicite de dimensions à utiliserdans le contexteDans
Ajoute des dimensions au contexte par défautPourChaque
Supprime des dimensions du contexte par défautPourTout
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte par défaut contient denombreuses dimensions. Il est souvent plus facile d'effectuer un ajout ou un retrait du contexte avecles opérateurs PourTout et PourChaque que de spécifier explicitement la liste avec Dans.
2012-05-1029
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. Votrefournisseur de données contient aussi l'objet Trimestre, mais vous n'incluez pas cette dimension dansle bloc. Vous choisissez plutôt d'inclure une autre colonne qui affiche le revenu maximal par trimestrede chaque année. Votre rapport se présente comme suit :
Revenu trimestriel max.Revenu des ventesAnnée
2 660 699,50 €8 096 123,60 €2001
4 186 120,00 €13 232 246,00 €2002
4 006 717,50 €15 059 142,80 €2003
Vous pouvez voir d'où proviennent les valeurs de la colonne Revenu trimestriel maximum en examinantce bloc avec un bloc incluant la dimension Trimestre :
2012-05-1030
Notions de contextes de calcul
Revenu des ventesTrimestreAnnée
2 660 699,50 €T12001
2 279 003,00 €T22001
1 367 841,00 €T32001
1 788 580,00 €T42001
2 660 699,50 €Max. :
Revenu des ventesTrimestreAnnée
3 326 172,00 €T1
2 840 651,00 €T2
2 879 303,00 €T3
4 186 120,00 €T4
4 186 120,00 €Max. :
Revenu des ventesTrimestreAnnée
3 742 989,00 €T1
4 006 717,50 €T2
3 953 395,00 €T3
3 356 041,00 €T4
4 006 717,50 €Max. :
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 maximumpré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 defaçon explicite le contexte de sortie dans cette formule.
2012-05-1031
Notions de contextes de calcul
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 ladimension Trimestre, mais ne l'inclut pas dans le bloc :
Revenu trimestriel max.Revenu des ventesAnnée
2 660 699,508 096 123,602001
4 186 120,0013 232 246,002002
4 006 717,5015 059 142,802003
Il est possible de créer une formule pour la colonne Revenu trimestriel maximum n'incluant pasl'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 laformule 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 servantde l'opérateur PourChaque, vous ajoutez la dimension Trimestre au contexte, en donnant le contexted'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 vousvoulez ajouter une colonne qui présente le revenu total de chaque année, comme indiqué dans lebloc suivant :
2012-05-1032
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 ducontexte 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 supprimerTrimestre 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 defaire 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érencesfigées dans le code à des dimensions, elles restent valables même en cas d'ajout ou de suppressionde 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 sonemplacement dans un rapport :
2012-05-1033
Notions de contextes de calcul
Fait référence à…Placé dans…
Toutes les données du rapportUn bloc
Toutes les données du rapportUne rupture de bloc (en-tête ou pied)
Toutes les données du rapportUne section (en-tête, pied ou à l'extérieur d'unbloc)
Toutes les données du rapportA l'extérieur des blocs ou sections
Exemple : Mot clé Rapport
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. Le rapportcontient 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 desortie 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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données de la sectionUn bloc
Toutes les données de la sectionUne rupture de bloc (en-tête ou pied)
2012-05-1034
Notions de contextes de calcul
Fait référence à…Placé dans…
Toutes les données de la sectionUne section (en-tête, pied ou à l'extérieur d'unbloc)
Non applicableA l'extérieur des blocs ou sections
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes.
Le rapport contient une section basée sur Année. La colonne Total section contient la formule :
Sum ([Sales Revenue]) In Section
Les chiffres de la colonne Total section représentent le revenu total pour 2001, car la rupture desection se produit au niveau de l'objet Année. Sans le mot clé Section, cette colonne dupliquerait leschiffres 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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données dans la partie du bloc délimitépar un sautUn bloc
Toutes les données dans la partie du bloc délimitépar un sautUn saut de bloc (en-tête ou pied)
Non applicableUne section (en-tête, pied ou à l'extérieur d'unbloc)
Non applicableA l'extérieur des blocs ou sections
2012-05-1035
Notions de contextes de calcul
Exemple : Mot clé Saut
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes :
Total SautRevenu des ventesTrimestreAnnée
8 096 124 €2 660 700 €T12001
8 096 124 €2 279 003 €T2
8 096 124 €1 367 841 €T3
8 096 124 €1 788 580 €T4
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, carle 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 dansun rapport : le mot-clé Bloc rassemble souvent les mêmes données que le mot-clé Section. La différenceentre les deux réside dans le fait que Bloc tient compte des filtres placés sur un bloc alors que Sectionles ignore.
Fait référence à…Placé dans…
Toutes les données du bloc, sans tenir comptedes ruptures, en respectant les filtresUn bloc
Toutes les données du bloc, sans tenir comptedes ruptures, en respectant les filtresUne rupture de bloc (en-tête ou pied)
Non applicableUne section (en-tête, pied ou à l'extérieur d'unbloc)
Non applicableA l'extérieur des blocs ou sections
Exemple : Mot clé Bloc
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes. Le rapportcontient une section basée sur Année. Le bloc est filtré de façon à exclure les troisième et quatrièmetrimestres.
2012-05-1036
Notions de contextes de calcul
La colonne Moyenne annuelle contient la formule
Average([Sales revenue] In Section)
et la colonne Moyenne du premier semestre contient la formuleAverage ([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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données du blocUn bloc
Toutes les données du blocUne rupture de bloc (en-tête ou pied)
Toutes les données de la sectionUne section (en-tête, pied ou à l'extérieur d'unbloc)
Toutes les données du rapportA l'extérieur des blocs ou sections
2012-05-1037
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 unerupture sur Année. Le rapport contient une section basée sur Année et une rupture au niveau deTrimestre.
CorpsRevenu des ventesTrimestreAnnée
2 660 699,52 660 700T12001
2 279 0032 279 003T2
1 367 840,71 367 841T3
1 788 580,41 788 580T4
8 096 123,62001
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 lacolonne 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 pourle 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 lesmodifications. 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 inattenduesen 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 desventes. Vous voulez afficher les revenus par année et par trimestre, ainsi que le pourcentage durevenu total dans le rapport représenté par chaque revenu individuel, comme indiqué :
2012-05-1038
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'écrirela 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 calculerun total général, car le rapport ne contient aucune autre dimension. La formule divise ensuite chaquerevenu 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 ? Laversion 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 :
2012-05-1039
Notions de contextes de calcul
Pour quelle raison ? Le problème vient de :
Sum ([Sales Revenue] ForAll ([Year];[Quarter))
Lorsque Année et Trimestre étaient les seules dimensions du rapport, la formule revenait à calculer"un total général de tous les revenus". Une fois que vous ajoutez la dimension Mois, cette expressionsupprime 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 lignesoù le Mois est 1, cette expression signifie à présent "le total des revenus de tous les mois 1". Danstoutes 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-1040
Notions de contextes de calcul
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 classiquesqui, eux, sont calculés à partir des valeurs détaillées renvoyées par la base de données. Les donnéesrenvoyées par des indicateurs intelligents sont agrégées d'une manière qui n'est pas, à l'origine, priseen charge par le composant Web Intelligence de la plateforme SAP BusinessObjects de BusinessIntelligence.
Les requêtes contenant des indicateurs intelligents calculent les indicateurs dans tous les contextesde calcul requis du rapport. Ces contextes peuvent changer lorsque le rapport est modifié. Enconséquence, la requête est modifiée à chaque actualisation des données résultant de la modificationdes 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 lesmodifications apportées.
Les indicateurs intelligents se comportent différemment des indicateurs classiques, qui prennent encharge 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éezune requête contenant les dimensions [Pays] et [Région], et l'indicateur [Chiffre d'affaires] (qui calculela somme des chiffres d'affaires), l'affichage initial affiche Pays, Région et Chiffre d'affaires dans unbloc. 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 lesrégions du pays. Dans le cas d'un indicateur intelligent, dans cette situation, il est nécessaire d'actualiserles 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 SQLgénéré qui renvoie les données d'un indicateur intelligent inclut les regroupements de toutes lesagrégations de cet indicateur comprises dans le rapport.
2012-05-1041
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]. Cesobjets 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 clauseUNION dans le SQL généré.
Les regroupements sont mis à jour en fonction des contextes de calcul requis par le rapport, lesquelspeuvent 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 auniveau 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'indicateurintelligent [Chiffre d'affaires], le regroupement (Pays, Région, Ville) s'affiche dans le SQL généré. Leregroupement le plus détaillé apparaît toujours dans le SQL. D'autres regroupements sont ajoutés etsupprimé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 renvoyerles valeurs du chiffre d'affaires. Ce regroupement n'est pas encore disponible dans le SQL de la requêteet, par conséquent, #TOREFRESH apparaît dans les cellules [Chiffre d'affaires]. A l'actualisation desdonné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 plusné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émentaux 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.
2012-05-1042
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 objetsdu résultat, mais pas les objets du périmètre. La requête ne génère pas tous les regroupements possiblesré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) etaffiche [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 expliciteavec 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'effetREGROUPEMENTS.
Exemple : Regroupements extraits avec l'opérateur UNION
Cet exemple décrit une requête contenant les dimensions [Pays], [Région], [Ville] et l'indicateurintelligent [Revenu].
Remarque :Pour plus de simplicité, l'indicateur intelligent calcule une somme. En pratique, cette agrégation nenécessite pas d'indicateurs intelligents car les sommes sont, à l'origine, prises en charge dans WebIntelligence.
Lorsque la requête est exécutée pour la première fois, le regroupement est (Pays, Région, Ville). Larequête SQL complète renvoie ce regroupement et l'opérateur UNION n'est absolument pas nécessairedans le SQL.
2012-05-1043
Calcul de valeurs à l'aide d'indicateurs intelligents
Si vous supprimez la dimension [Ville] du tableau, le regroupement (Pays, Région) est nécessairepour afficher le chiffre d'affaires (qui apparaît initialement en tant qu'erreur #TOREFRESH). Aprèsl'actualisation des données, le SQL se présente comme suit :
SELECTSELECT0 AS GID,country.country_name,region.region_name,NULL,sum(city.revenue)
FROMcountry,region,city
WHERE( country.country_id=region.country_id )AND ( region.region_id=city.region_id )
GROUP BYcountry.country_name,region.region_name
UNIONSELECT1 AS GID,country.country_name,region.region_name,city.city_name,sum(city.revenue)
FROMcountry,region,city
WHERE( country.country_id=region.country_id )AND ( region.region_id=city.region_id )
GROUP BYcountry.country_name,region.region_name,city.city_name
Chaque regroupement est représenté par une instruction SELECT et a son propre ID (dans la colonneGID). Les regroupements qui ne contiennent pas l'ensemble de dimensions intégral incluent descolonnes vides (SELECT '') car chaque instruction SELECT d'une requête incluant l'opérateur UNIONdoit 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 :SELECT0 AS GID,country.country_name,region.region_name,NULL,sum(city.revenue)
FROMcountry,region,city
WHERE( country.country_id=region.country_id )AND ( region.region_id=city.region_id )
GROUP BYcountry.country_name,region.region_name
UNIONSELECT1 AS GID,country.country_name,NULL,NULL,sum(city.revenue)
FROM
2012-05-1044
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 BYcountry.country_name
UNIONSELECT2 AS GID,country.country_name,region.region_name,city.city_name,sum(city.revenue)
FROMcountry,region,city
WHERE( country.country_id=region.country_id )AND ( region.region_id=city.region_id )
GROUP BYcountry.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 indicateurintelligent et que cette formule détermine le regroupement requis par l'indicateur, les valeurs del'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 :
RevenuSemestre
#INDISPONIBLEH1
#INDISPONIBLEH2
2012-05-1045
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êmelorsque 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 :
RevenuRégionPays
10 000NordEtats-Unis
15 000SudEtats-Unis
14 000EstEtats-Unis
12 000OuestEtats-Unis
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égionsdans le calcul, requiert le regroupement (Pays). L'actualisation des données ajoute le regroupement(Pays) à la requête et affiche les valeurs de l'indicateur.
Rubriques associées• Opérateur contextuel PourTout
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 indicateurintelligent 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.
2012-05-1046
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 indicateurintelligent ne peut être agrégé après l'application d'un filtre de niveau de rapport. Il est possible decalculer l'indicateur en ajoutant un filtre de requête au SQL généré. Par contre, cette solution risqued'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 à, Dansliste, Inférieur à. Vous pouvez appliquer des filtres à valeur unique tels que Egal à sans pour autantgénérer l'erreur #INDISPONIBLE.
• Une solution de contournement existe dans les cas qui ne nécessitent pas d'agrégation : Définissezla formule sous forme de variable dont la qualification désigne un indicateur, puis veillez à ce quela dimension utilisée soit incluse dans le bloc avec la variable (vous pouvez masquer cette colonnepour 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 limiteles valeurs de Lieu de séjour à "Côte d'azur" ou "Plage des Bahamas", #INDISPONIBLE apparaîtdans les cellules Chiffre d'affaires.
Chiffre d'affairesPays
#INDISPONIBLEFrance
#INDISPONIBLEEtats-Unis
#INDISPONIBLESomme :
Si vous limitez Lieu de séjour à "Plage des Bahamas", les valeurs s'affichent.
Chiffre d'affairesPays
971 444Etats-Unis
971 444Somme :
5.6.2 Filtrage des indicateurs intelligents
Si vous appliquez un filtre sur un indicateur intelligent dans un contexte où l'indicateur intelligent estagrégé à différents niveaux d'informations, il renvoie l'erreur #INDISPONIBLE lorsqu'il est agrégé à unniveau d'information inférieur.
2012-05-1047
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ù Chiffred'affaires est l'indicateur intelligent.
Chiffre d'affairesLieu de séjourPays
835 420Côte d'AzurFrance
971 444Bahamas BeachUS
1 479 660Hawaiian ClubUS
3 286 524Somme :
Si vous appliquez un filtre Chiffre d'affaires > 900 000 au bloc, le total affiche#INDISPONIBLE.
Chiffre d'affairesLieu de séjourPays
971 444Bahamas BeachEtats-Unis
1 479 660Hawaiian ClubUS
#INDISPONIBLESomme :
#INDISPONIBLE s'affiche car le chiffre d'affaires du bloc est agrégé par le regroupement (Pays, Lieude séjour) mais le chiffre d'affaires du pied de page, également affecté par le filtre, est agrégé à unniveau 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 estappliqué à une dimension qui affecte le calcul de l'indicateur. Les dimensions filtrées par des filtresd'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é pourn'afficher que les régions contenues dans le pays exploré. Il n'est pas nécessaire d'ajouter un filtreau niveau de la requête pour filtrer les régions en fonction du pays auquel elles appartiennent.
2012-05-1048
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 unbloc génèrent l'erreur #INDISPONIBLE pour un indicateur intelligent du bloc.
Exemple :
• Le filtre [Pays] = "Etats-Unis" OR [Pays] = "France" renvoie #INDISPONIBLE pourun 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 unindicateur intelligent qui utilise les dimensions [Pays] ou [Année] si ni [Pays] ni [Année] n'apparaîtdans le bloc.
2012-05-1049
Calcul de valeurs à l'aide d'indicateurs intelligents
2012-05-1050
Calcul de valeurs à l'aide d'indicateurs intelligents
Fonctions, opérateurs et mots clés
6.1 Fonctions
Les fonctions se divisent en plusieurs catégories qui sont les suivantes :
DescriptionCatégorie
Données agrégées (par exemple, en effectuantle total ou la moyenne d'un ensemble de valeurs)Aggregate
Manipule des chaînes de caractèresCaractère
Renvoie des données de date et heureDate et heure
Renvoie des données relatives à un documentDocument
Renvoie des données sur le fournisseur de don-nées d'un documentFournisseur de données
Renvoie VRAI ou FAUXLogique
Renvoie des données numériquesNumérique
Fonctions ne correspondant à aucune des caté-gories précédentesDivers
Renvoie des ensembles de membres de hiérar-chiesEnsemble
6.1.1 Fonction du groupe Aggregate
2012-05-1051
Fonctions, opérateurs et mots clés
6.1.1.1 Aggregate
DescriptionRenvoie l'agrégation par défaut d'un indicateur pour un ensemble de membres donné
Groupe de fonctionsAggregate
Syntaxenum Aggregate(indicateur[;ensemble_de_membres]
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonEnsemble de me-mbres
Ensemble de membres utilisé pour calculerl'agrégation
ensemble_de_me-mbres
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é.
ExemplesSi l'agrégation par défaut de l'indicateur [Chiffre d'affaires] est Sum et que [Californie] désigne unmembre de la hiérarchie [Géographie] (Pays > Etat > Ville), Aggregate([Chiffre d'affaires];Descendants([Géographie]&[EU].[Californie];1)) renvoie le chiffre d'affaires total de toutesles villes de Californie.
Rubriques associées• Référence à des membres et des ensembles de membres des hiérarchies
2012-05-1052
Fonctions, opérateurs et mots clés
6.1.1.2 Average
DescriptionRenvoie la valeur moyenne d'un indicateur
Groupe de fonctionsAggregate
Syntaxenum Average(indicateur[;ensemble_de_membres][;InclureVide])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonEnsemble demembres
Un ensemble de membresense-mble_de_me-mbres
Non
(les lignes vides sont exclues par dé-faut)
Mot cléInclut les lignes vides dansle calcul
InclureVide
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é.
ExemplesSi l'indicateur [Chiffre d'affaires] comporte les valeurs 41 569, 30 500, 40 000 et 50 138, Average([Chiffre d'affaires]) renvoie 40 552.
Si [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , Average([Chiffre d'affaires];[Géographie]&[EU].[Californie].enfants) renvoie lechiffre d'affaires moyen de toutes les villes de Californie.
2012-05-1053
Fonctions, opérateurs et mots clés
Rubriques associées• Référence à des membres et des ensembles de membres des hiérarchies• Opérateur InclureVide
6.1.1.3 Count
DescriptionRenvoie le nombre de valeurs d'un ensemble de valeurs
Groupe de fonctionsAggregate
Syntaxeentier Count(données_agrégées[;ensemble_de_membres][;InclureVide][;Distinct|Tous])
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension, indicateur,hiérarchie, ensemble demembres
Tout indicateur, dimension, hiérarchie, niveau ouensemble de membres
don-nées_agré-gées
NonEnsemble de membresEnsemble de membres utilisé pour calculer lenombre
ense-mble_de_me-mbres
NonMot cléInclut des valeurs vides dans le calculInclureVide
NonMot cléInclut les valeurs distinctes uniquement (par dé-faut pour les dimensions) ou toutes les valeurs(par défaut pour les indicateurs) dans le calcul
Distin-ct|Tout
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 {}.
2012-05-1054
Fonctions, opérateurs et mots clés
• Tous les ensembles de membres doivent provenir de la hiérarchie actuelle. Si une autre hiérarchieest utilisée, l'erreur #MULTIVALUE se produit.
• Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel dela hiérarchie est utilisé.
ExemplesCount("Test") renvoie 1
Count([Ville];Distinct) renvoie 5 s'il existe 5 villes différentes dans une liste de villes, mêmesi 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 sicertaines sont des doublons.
Count ([Ville];InclureVide) renvoie 6 s'il existe 5 villes et une ligne vide dans une liste devilles.
Count([Produit];{Géographie]&[Etat) renvoie le nombre total de membres au niveau [Etat]de la hiérarchie [Géographie].
Rubriques associées• Opérateur InclureVide• Opérateurs Distinct/Tout
6.1.1.4 Premier
DescriptionRenvoie la première valeur d'un ensemble de données
Groupe de fonctionsAggregate
Syntaxetype_entrée First(dimension|indicateur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension ou indica-teur
Toute dimension ou tout indica-teur
dimension|indicateur
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-1055
Fonctions, opérateurs et mots clés
ExemplesLorsque 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.5 Dernier
DescriptionRenvoie la dernière valeur d'une dimension ou d'un indicateur
Groupe de fonctionsAggregate
Syntaxetype_entrée Dernier(dimension|indicateur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension ou indica-teur
Toute dimension ou tout indica-teur
dimension|indicateur
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.
ExemplesLorsque 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
DescriptionRenvoie la plus grande valeur d'un ensemble de valeurs
Groupe de fonctionsAggregate
Syntaxetype_de_saisie Max(données_agrégées[;ensemble_de_membres])
2012-05-1056
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension, indicateur, hiérar-chie, niveau ou ensemble demembres
Tout indicateur, dimension, hiérarchie,niveau ou ensemble de membres
don-nées_agré-gées
NonEnsemble de membresUn ensemble de membresense-mble_de_me-mbres
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é.
ExemplesSi les valeurs de l'indicateur [Chiffre d'affaires] sont 3 000, 60 034 et 901 234, Max([Chiffre d'affaires]) 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([Chiffred'affaires];[Géographie].[Etats-Unis].Enfants) renvoie le chiffre d'affaires le plus élevépour un Etat américain.
6.1.1.7 Median
DescriptionRenvoie la médiane (valeur centrale) d'un indicateur
Groupe de fonctionsAggregate
Syntaxenumérique Median(indicateur)
2012-05-1057
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
RemarquesSi l'ensemble de nombres comporte un nombre de valeurs pair, la fonction Median prend la moyennedes deux valeurs centrales.
ExemplesMedian([Chiffre d'affaires]) renvoie 971 444 si [Chiffre d'affaires] possède les valeurs835 420, 971 444 et 1 479 660.
6.1.1.8 Min
DescriptionRenvoie la plus petite valeur d'un ensemble de valeurs
Groupe de fonctionsAggregate
Syntaxetout_type Min(données_agrégées[;ensemble_de_membres])
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension, indicateur, hiérar-chie, niveau ou ensemble demembres
Tout indicateur, dimension, hiérarchie,niveau ou ensemble de membres
don-nées_agré-gées
NonEnsemble de membresUn ensemble de membresense-mble_de_me-mbres
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-1058
Fonctions, opérateurs et mots clés
• Si une hiérarchie est spécifiée uniquement dans un ensemble de membres, le membre actuel dela hiérarchie est utilisé.
ExemplesSi l'indicateur Chiffre d'affaires comporte les valeurs 3 000, 60 034 et 901 234, Min([Chiffred'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 leplus 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
DescriptionRenvoie la valeur d'un ensemble de données qui apparaît le plus souvent
Groupe de fonctionsAggregate
Syntaxeinput_type Mode(dimension|measure)
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurToute dimension ou indica-teur
dimension|indicateur
Remarques• Mode renvoie la valeur Nul si aucune des valeurs de l'ensemble de données n'apparaît plus souvent
que les autres.
ExemplesMode([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.
2012-05-1059
Fonctions, opérateurs et mots clés
6.1.1.10 Pourcentage
DescriptionExprime une valeur d'indicateur en tant que pourcentage de son contexte
Groupe de fonctionsAggregate
Syntaxenum Percentage(indicateur[;Rupture][;Ligne|Col])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonMot cléPrend en compte les ruptures detableau
Rupture
NonMot cléDéfinit le sens du calculLigne|Col
ExemplesDans le tableau suivant, la colonne Pourcentage contient la formule Percentage ([Revenu desventes]).
PourcentageChiffre d'affairesAnnée
101 0002001
505 0002002
404 0002003
10010 000Somme :
Par défaut, le contexte d'intégration est le total de l'indicateur dans le tableau. Vous pouvez faire ensorte que la fonction prenne en compte une rupture dans le tableau en utilisant l'argument facultatifRupture. 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([Chiffred'affaires];Rupture)
PourcentageRevenu des ventesTrimestreAnnée
101 000T12001
2012-05-1060
Fonctions, opérateurs et mots clés
202 000T2
505 000T3
202 000T4
10010 000Somme :2001
PourcentageRevenu des ventesTrimestreAnnée
202 000T12002
202 000T2
505 000T3
101 000T4
10010 000Somme :2002
Vous pouvez utiliser la fonction Percentage sur plusieurs colonnes ou lignes ; l'argument facultatifLigne|Col vous permet de le préciser explicitement. Par exemple, dans le tableau croisé suivant, lacolonne % contient la formule Percentage ([Revenu des ventes];Ligne).
%T4%T3%T2%T1
202 000505000202 000101 0002001
101 000505000202 000202 0002002
6.1.1.11 Percentile
DescriptionRenvoie le nième centile d'un indicateur
Groupe de fonctionsNumérique
Syntaxenumérique Percentile(indicateur;centile)
2012-05-1061
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
OuiNombreUn pourcentage exprimé sous formedécimale
centile
RemarquesLe nième centile est un nombre supérieur ou égal à n % des nombres d'un ensemble. Vous exprimezn % sous la forme 0.n.
ExemplesSi [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
DescriptionMultiplie les valeurs d'un indicateur
Groupe de fonctionsAggregate
Syntaxenumérique Product(indicateur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
ExemplesProduct([Indicateur]) renvoie 30 si [Indicateur] a les valeurs 2, 3, 5.
6.1.1.13 RunningAverage
DescriptionRenvoie la moyenne cumulative d'un indicateur
2012-05-1062
Fonctions, opérateurs et mots clés
Groupe de fonctionsAggregate
Syntaxenum RunningAverage(indicateur[;Ligne|Col][;InclureVide][;(réinit_dims)])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonMot cléDéfinit le sens du calculLigne|Col
NonMot cléInclut des valeurs vides dans le calculInclureVide
NonListe DimensionRéinitialise le calcul selon les dimensionsspécifiées
dim_redéfinies
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.
ExemplesRunningAverage([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Moyenne cumulativeChiffre d'affairesLieu de séjourPays
835 4201 479 660Hawaiian ClubUS
1 225 552971 444Bahamas BeachUS
1 095 508835 420Côte d'AzurFrance
RunningAverage([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableausuivant :
Moyenne cumulativeChiffre d'affairesLieu de séjourPays
835 4201 479 660Hawaiian ClubUS
2012-05-1063
Fonctions, opérateurs et mots clés
1 225 552971 444Bahamas BeachUS
835 420835 420Côte d'AzurFrance
Rubriques associées• Opérateur InclureVide• Opérateurs Ligne/Col
6.1.1.14 RunningCount
DescriptionRenvoie le total cumulatif d'un ensemble de nombres
Groupe de fonctionsAggregate
Syntaxenum RunningCount(dimension|indicateur[;Ligne|Col][;InclureVide][;(réinit_dims)])
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension ou indi-cateur
Toute dimension ou tout indicateurdimension|indica-teur
NonMot cléDéfinit le sens du calculLigne|Col
NonMot cléInclut des valeurs vides dans le calculInclureVide
NonListe DimensionRéinitialise le calcul selon les dimensionsspécifiées
dim_redéfinies
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.
2012-05-1064
Fonctions, opérateurs et mots clés
• RunningCount ne réinitialise pas automatiquement le total après un saut de bloc ou une nouvellesection.
ExemplesRunningCount([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Nombre cumulatifChiffre d'affairesLieu de séjourPays
11 479 660Hawaiian ClubUS
2971 444Bahamas BeachUS
3835 420Côte d'AzurFrance
RunningCount([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Nombre cumulatifChiffre d'affairesLieu de séjourPays
11 479 660Hawaiian ClubUS
2971 444Bahamas BeachUS
1835 420Côte d'AzurFrance
Rubriques associées• Opérateur InclureVide• Opérateurs Ligne/Col• Opérateur InclureVide• Opérateur InclureVide
6.1.1.15 RunningMax
DescriptionRenvoie le maximum cumulatif d'une dimension ou d'un indicateur
Groupe de fonctionsAggregate
Syntaxeinput_type RunningMax(dimension|measure[;Row|Col][;(reset_dims)])
2012-05-1065
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension ou indi-cateur
Toute dimension ou tout indicateurdimension|indica-teur
NonMot cléDéfinit le sens du calculLigne|Col
NonListe DimensionRéinitialise le calcul selon les dimensionsspécifiées
dim_redéfinies
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.
ExemplesRunningMax([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Maximum cumulatifChiffre d'affairesLieu de séjourPays
835 420835 420Côte d'AzurFrance
971 444971 444Bahamas BeachUS
1 479 6601 479 660Hawaiian ClubUS
Rubriques associées• Opérateur InclureVide• Opérateurs Ligne/Col
6.1.1.16 RunningMin
DescriptionRenvoie le minimum cumulatif d'une dimension ou d'un indicateur
2012-05-1066
Fonctions, opérateurs et mots clés
Groupe de fonctionsAggregate
Syntaxetype_entrée RunningMin(dimension|indicateur;[Ligne|Col];[(réinit_dimensions)])
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension ou indi-cateur
Toute dimension ou indicateurdimension|détail|in-dicateur
NonMot cléDéfinit le sens du calculLigne|Col
NonListe DimensionRéinitialise le calcul selon les dimensionsspécifiées
dim_redéfinies
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.
ExemplesRunningMin([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Minimum cumulatifChiffre d'affairesLieu de séjourPays
835 420835 420Côte d'AzurFrance
835 420971 444Bahamas BeachUS
835 4201 479 660Hawaiian ClubUS
Rubriques associées• Opérateur InclureVide• Opérateurs Ligne/Col
2012-05-1067
Fonctions, opérateurs et mots clés
6.1.1.17 RunningProduct
DescriptionRenvoie le produit cumulatif d'un indicateur
Groupe de fonctionsAggregate
Syntaxenum RunningProduct(indicateur[;Ligne|Col][;(réinit_dims)])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonMot cléDéfinit le sens du calculLigne|Col
NonListe DimensionRéinitialise le calcul selon les dimensionsspécifiées
dim_redéfinies
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.
ExemplesRunningProduct([Nombre d'invités]) renvoie ces résultats dans le tableau suivant :
Produit cumulatifNombre d'invitésVillePays d'origine
66KobeJapon
244OsakaJapon
5 784241ChicagoUS
2012-05-1068
Fonctions, opérateurs et mots clés
RunningProduct([Nombre d'invités]);([Pays d'origine]) renvoie ces résultats dans letableau suivant :
Produit cumulatifNombre d'invitésVillePays d'origine
66KobeJapon
244OsakaJapon
5 784241ChicagoUS
Rubriques associées• Opérateur InclureVide• Opérateurs Ligne/Col
6.1.1.18 RunningSum
DescriptionRenvoie la somme cumulative d'un indicateur
Groupe de fonctionsAggregate
Syntaxenum RunningSum(indicateur[;Ligne|Col][;(réinit_dims)])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonMot cléDéfinit le sens du calculLigne|Col
NonListe DimensionRéinitialise le calcul selon les dimensionsspécifiées
dim_redéfinies
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-1069
Fonctions, opérateurs et mots clés
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par despoints-virgules.
• RunningSum ne réinitialise pas automatiquement la somme après un saut de bloc ou une nouvellesection.
ExempleRunningSum([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Somme cumulativeChiffre d'affairesLieu de séjourPays
835 420835 420Côte d'AzurFrance
1 806 864971 444Bahamas BeachUS
3 286 5241 479 660Hawaiian ClubUS
RunningSum([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Somme cumulativeChiffre d'affairesLieu de séjourPays
835 420835 420Côte d'AzurFrance
971 444971 444Bahamas BeachUS
2 451 1041 479 660Hawaiian ClubUS
Rubriques associées• Opérateur InclureVide• Opérateurs Ligne/Col
6.1.1.19 ValeurServeur
DescriptionRenvoie la valeur de la base de données d'un indicateur
Groupe de fonctionsAggregate
Syntaxenum ValeurServeur([indicateur])
2012-05-1070
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
Remarques• ValeurServeur ignore l'ensemble des filtres appliqués aux dimensions ou hiérarchies utilisées
pour calculer l'indicateur
ExempleValeurServeur([Montant des ventes sur Internet] renvoie la valeur de la base de donnéesde l'indicateur [Montant des ventes sur Internet]
6.1.1.20 Ecartype
DescriptionRenvoie l'écart type d'un indicateur
Groupe de fonctionsAggregate
Syntaxenumérique EcartType(indicateur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
RemarquesL'écart type est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculéecomme 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.
ExemplesSi indicateur possède l'ensemble de valeurs (2, 4, 6, 8), EcartType([indicateur]) renvoie2,58.
2012-05-1071
Fonctions, opérateurs et mots clés
Rubriques associées• Var
6.1.1.21 EcartTypeP
DescriptionRenvoie l'écart type de population d'un indicateur
Groupe de fonctionsAggregate
Syntaxenumérique EcartTypeP(indicateur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
RemarquesL'écart type de population est un indicateur de variation statistique dans un ensemble de nombres. Elleest 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.
ExemplesSi indicateur possède l'ensemble de valeurs (2, 4, 6, 8), EcartTypeP([indicateur]) renvoie2,24.
6.1.1.22 Sum
2012-05-1072
Fonctions, opérateurs et mots clés
DescriptionRenvoie la somme d'un indicateur
Groupe de fonctionsAggregate
Syntaxenum Sum(indicateur[;ensemble_de_membres])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
NonEnsemble de membresUn ensemble de me-mbres
ensemble_de_membres
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é.
ExemplesSi l'indicateur Chiffre d'affaires comporte les valeurs 2 000, 3 000, 4 000 et 1 000, Sum([Chiffred'affaires]) renvoie 10 000.
Si [Californie] désigne un membre de la hiérarchie [Géographie] (Pays > Etat > Ville), , Sum([Chiffred'affaires];Descendants([Géographie]&[EU].[Californie];1)) renvoie le chiffre d'affairestotal de toutes les villes de Californie.
6.1.1.23 Var
DescriptionRenvoie la variance d'un indicateur
Groupe de fonctionsAggregate
2012-05-1073
Fonctions, opérateurs et mots clés
Syntaxenumérique Var(indicateur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
RemarquesLa variance est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculéecomme 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.
ExemplesSi indicateur possède l'ensemble de valeurs (2, 4, 6, 8), Var([indicateur]) renvoie 6,67.
Rubriques associées• Ecartype
6.1.1.24 VarP
DescriptionRenvoie la variance de population d'un indicateur
Groupe de fonctionsAggregate
Syntaxenumérique VarP(indicateur)
2012-05-1074
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
RemarquesLa variance de population est un indicateur de variation statistique dans un ensemble de nombres. Elleest 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.
ExemplesSi indicateur possède l'ensemble de valeurs (2, 4, 6, 8), VarP([indicateur]) renvoie 5.
Rubriques associées• EcartTypeP
6.1.2 Fonctions du groupe Character
6.1.2.1 Asc
DescriptionRenvoie la valeur ASCII d'un caractère
Groupe de fonctionsCaractère
Syntaxeentier Asc(chaîne)
2012-05-1075
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneN'importe quelle chaînechaîne
RemarquesSi chaîne contient plusieurs caractères, la fonction renvoie la valeur ASCII du premier caractère dansla chaîne.
ExemplesAsc("A") renvoie 65.
Asc("ab") renvoie 97.
Asc([Pays]) renvoie 85 lorsque la valeur de [Pays] est "US".
6.1.2.2 Char
DescriptionRenvoie le caractère associé à un code ASCII
Groupe de fonctionsCaractère
Syntaxechaîne Char(code_ascii)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreUn code ASCIIcode_ascii
RemarquesSi nombre est un décimal, la fonction ignore la partie décimale.
Exemples
Char(123) renvoie "{".
2012-05-1076
Fonctions, opérateurs et mots clés
6.1.2.3 Concaténation
DescriptionConcatène (joint) deux chaînes de caractères.
Groupe de fonctionsCaractère
Syntaxechaîne Concatenation(première_chaîne;seconde_chaîne)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa première chaînepremière_chaîne
OuiChaîneLa seconde chaînedeuxième_chaîne
RemarquesVous 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 à lasyntaxe Count<Représentant>,<Trimestre>,<Lieu de séjour> autorisée par DesktopIntelligence.
ExemplesConcatenation("Premier ";"Second") renvoie "Premier Second"
Concatenation("Premier ";Concaténation("Second ";"Troisième")) renvoie "PremierSecond Troisième".
6.1.2.4 Fill
DescriptionConstruit une chaîne en répétant une chaîne n fois
2012-05-1077
Fonctions, opérateurs et mots clés
Groupe de fonctionsCaractère
Syntaxechaîne Fill(répétition_chaîne;nombre_répétitions)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à répéterchaîne_à_répéter
OuiNombreLe nombre de répétitionsnombre_de_répétitions
ExemplesFill("New York";2) renvoie "New York New York".
6.1.2.5 FormatDate
DescriptionFormate une date selon le format spécifié
Groupe de fonctionsCaractère
Syntaxechaîne FormatDate(date;chaîne_format)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date à laquelle appliquer le format dedate
date
OuiChaîneLe format à appliquerchaîne_format
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.
ExemplesFormatDate(DateActuelle();"dd/MM/yyyy") renvoie "15/12/2005" si la date actuelle est le15 décembre 2005.
2012-05-1078
Fonctions, opérateurs et mots clés
6.1.2.6 FormatNumber
DescriptionFormate un nombre selon un format spécifié
Groupe de fonctionsCaractère
Syntaxechaîne FormatNumber(nombre;chaîne_format)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe nombre à formaternombre
OuiChaîneLe format à appliquerchaîne_format
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.
ExemplesFormatNumber[Revenu des ventes];"# ###,00") renvoie 835 420,00 si [Revenu des ventes]est d'une valeur de 835 420.
6.1.2.7 HTMLEncode
DescriptionApplique des règles d'encodage HTML à une chaîne
Groupe de fonctionsCaractère
Syntaxechaîne HTMLEncode(html)
2012-05-1079
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneUne chaîne HTMLhtml
ExemplesHTMLEncode("http://www.sap.com") renvoie "http%3A%2F%2Fwww%2Esap%2Ecom".
6.1.2.8 Capitale
DescriptionMet en majuscule la première lettre d'une chaîne de caractères
Groupe de fonctionsCaractère
Syntaxechaîne InitCap(chaîne)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à mettre en majus-cules
chaîne
ExemplesInitCap("ces vérités sont évidentes") renvoie "Ces vérités sont évidentes".
6.1.2.9 Gauche
DescriptionRetourne les caractères les plus à gauche dans une chaîne
Groupe de fonctionsCaractère
Syntaxechaîne Left(chaîne;nombre_car)
2012-05-1080
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneLa chaîne entrée.chaîne
OuinombreLe nombre de caractères à retourner àpartir de la gauche
nombre_car
ExemplesLeft([Pays];2) retourne "Fr" si [Pays] est "France".
6.1.2.10 LeftPad
DescriptionRemplit une chaîne à gauche avec une autre chaîne
Groupe de fonctionsCaractère
Syntaxechaîne LeftPad(chaîne_complétée,longueur,chaîne_gauche)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne d'originechaîne_complétée
OuiNombrela longueur de la chaîne de sortielongueur
OuiChaîneLa chaîne à ajouter à gauche de lachaîne_complétée
chaîne_gauche
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 remplirla longueur.
ExemplesLeftPad("York";8;"New ") renvoie "New York"
2012-05-1081
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
DescriptionSupprime les espaces à gauche d'une chaîne de caractères
Groupe de fonctionsCaractère
Syntaxechaîne LeftTrim(chaîne_à_traiter)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à traiter.chaîne_raccourcie
ExemplesLeftTrim([Pays]) renvoie "France" si [Pays] est " France".
6.1.2.12 Longueur
DescriptionRenvoie le nombre de caractères d'une chaîne.
Groupe de fonctionsCaractère
Syntaxeentier Length(chaîne)
2012-05-1082
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne entrée.chaîne
ExemplesLength([Nom]) renvoie 6 si [Nom] est "Martin".
6.1.2.13 Minuscule
DescriptionConvertit une chaîne en minuscules
Groupe de fonctionsCaractère
Syntaxechaîne Lower(chaîne)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à convertir en minus-cules
chaîne
ExemplesLower("New York") renvoie "new york".
6.1.2.14 Comparaison
Descriptiondétermine si une chaîne correspond à un modèle.
Groupe de fonctionsCaractère
Syntaxebooléen Match(chaîne_test;modèle)
2012-05-1083
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneLa chaîne à comparer au modèlede texte
chaîne_test
Ouichaîne du modèle detexte
Lamodèle
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).
ExemplesMatch([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
DescriptionRenvoie la position de départ d'une chaîne de caractères dans une chaîne
Groupe de fonctionsCaractère
Syntaxeentier Pos(chaîne_test;modèle)
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneLa chaîne à vérifier dans le modèlede texte
chaîne_test
Ouichaîne du modèlede texte
Lamodèle
Remarques• Si le modèle apparaît plusieurs fois, Pos renvoie la position de la première occurrence.
2012-05-1084
Fonctions, opérateurs et mots clés
ExemplesPos("New York";"Ne") renvoie 1.
Pos("New York, New York";"Ne") renvoie 1.
Pos("New York"; "York") renvoie 5.
6.1.2.16 Remplacer
Descriptionremplace une partie d'une chaîne par une autre chaîne.
Groupe de fonctionsCaractère
Syntaxechaîne Remplacer(remplacer_dans;chaîne_remplacée;chaîne_de_remplacement)
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneLa chaîne dans laquelle le texte estremplacé
remplacer_dans
OuichaîneLe texte à remplacerchaîne_remplacée
OuichaîneLe texte qui remplace chaîne_remplacée
chaîne_de_rempla-cement
ExemplesRemplacer("New YORK";"ORK";"ork") renvoie "New York"
6.1.2.17 Droite
DescriptionRenvoie les caractères les plus à droite dans une chaîne
Groupe de fonctionsCaractère
2012-05-1085
Fonctions, opérateurs et mots clés
Syntaxechaîne Right(chaîne;nombre_de_caractères)
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneN'importe quelle chaînechaîne
OuinombreLe nombre de caractères à renvoyer àpartir de la droite
nombre_de_carac-tères
ExemplesRight([Pays];2) renvoie "ce" si [Pays] est "France".
6.1.2.18 RightPad
DescriptionRemplit une chaîne à droite avec une autre chaîne
Groupe de fonctionsCaractère
Syntaxechaîne RightPad(chaîne_complétée;longueur;chaîne_droite)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne d'originechaîne_complétée
OuiNombrela longueur de la chaîne de sortielongueur
OuiChaîneLa chaîne à ajouter à droite de lachaîne_complétée
chaîne_droite
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 remplirla longueur.
2012-05-1086
Fonctions, opérateurs et mots clés
ExemplesRightPad("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
DescriptionSupprime les espaces de fin de chaîne
Groupe de fonctionsCaractère
Syntaxechaîne RightTrim(chaîne_raccourcie)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à traiter.chaîne_raccourcie
ExemplesRightTrim([Pays]) renvoie "France" si [Pays] est "France ".
6.1.2.20 Substr
DescriptionRenvoie une partie d'une chaîne
Groupe de fonctionsCaractère
Syntaxechaîne Substr(chaîne;début;longueur)
2012-05-1087
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneN'importe quelle chaînechaîne
OuiNombreLa position de départ de la chaîneextraite
début
OuiNombreLa longueur de la chaîne extraitelongueur
ExemplesSubstr("Grande Bretagne";1;6) renvoie "Grande".
Substr("Grande Bretagne";8;8) renvoie "Bretagne".
6.1.2.21 SupprEspace
DescriptionSupprime les espaces de début et de fin d'une chaîne
Groupe de fonctionsCaractère
Syntaxechaîne SupprEspace(chaîne_raccourcie)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à traiter.chaîne
ExemplesTrim(" Grande Bretagne ") renvoie "Grande Bretagne".
6.1.2.22 Majuscule
DescriptionConvertit une chaîne en majuscules
2012-05-1088
Fonctions, opérateurs et mots clés
Groupe de fonctionsCaractère
Syntaxechaîne Majuscule(chaîne)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne à convertirchaîne
ExemplesMajuscule("New York") renvoie "NEW YORK".
6.1.2.23 UrlEncode
DescriptionApplique des règles d'encodage URL à une chaîne
Groupe de fonctionsCaractère
Syntaxechaîne UrlEncode(html)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneL'URL à encoderhtml
ExemplesUrlEncode("http://www.sap.com") renvoie "http%3A%2F%2Fwww%2Esap%2Ecom".
6.1.2.24 WordCap
DescriptionMet en majuscule la première lettre de chaque mot d'une chaîne
2012-05-1089
Fonctions, opérateurs et mots clés
Groupe de fonctionsCaractère
Syntaxechaîne WordCap(chaîne)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneLa chaîne qui va être mise en ma-juscules
chaîne
ExemplesWordCap("Chiffre d'affaires de mars") renvoie "Chiffre D'affaires De Mars".
6.1.3 Fonctions du groupe Date and Time
6.1.3.1 CurrentDate
DescriptionRenvoie la date actuelle au format conforme aux paramètres régionaux
Groupe de fonctionsDate et heure
Syntaxedate CurrentDate()
ExemplesCurrentDate() renvoie 10 septembre 2002 si la date est le 10 septembre 2002.
6.1.3.2 CurrentTime
DescriptionRenvoie l'heure actuelle au format conforme aux paramètres régionaux
2012-05-1090
Fonctions, opérateurs et mots clés
Groupe de fonctionsDate et heure
Syntaxeheure CurrentTime()
ExemplesCurrentTime renvoie 11:15 si l'heure actuelle est 11 h 15.
6.1.3.3 DayName
DescriptionRenvoie le nom du jour correspondant à une date
Groupe de fonctionsDate et heure
Syntaxechaîne DayName(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
ExemplesDayName([Date de réservation]) renvoie "samedi' si [Date de réservation] est 15 décembre2001 (ce qui correspond à un samedi).
RemarqueLa date saisie doit être une variable. Vous ne pouvez pas spécifier directement la date, comme dansDayName("07/15/2001").
6.1.3.4 DayNumberOfMonth
DescriptionRenvoie le numéro du jour dans un mois
2012-05-1091
Fonctions, opérateurs et mots clés
Groupe de fonctionsDate et heure
Syntaxeentier DayNumberOfMonth(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
ExemplesDayNumberOfMonth([Date de réservation]) renvoie 15 si [Date de réservation] est "15 décembre2001".
6.1.3.5 DayNumberOfWeek
DescriptionRenvoie le numéro du jour d'une semaine
Groupe de fonctionsDate et heure
Syntaxeentier DayNumberOfWeek(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
RemarquesLe lundi est considéré comme premier jour de la semaine avec cette fonction.
ExemplesDayNumberOfWeek([Date de réservation]) renvoie 1 si la date figurant dans [Date deréservation] est le 2 mai 2005 (ce qui correspond à un lundi).
6.1.3.6 DayNumberOfYear
2012-05-1092
Fonctions, opérateurs et mots clés
DescriptionRenvoie le numéro du jour dans une année
Groupe de fonctionsDate et heure
Syntaxeentier DayNumberOfYear(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
ExemplesDayNumberOfYear([Date de réservation]) renvoie 349 si [Date de réservation] est "15 décembre2001".
6.1.3.7 DaysBetween
Descriptionrenvoie le nombre de jours compris entre deux dates.
Groupe de fonctionsDate et heure
Syntaxeentier DaysBetween(première_date;dernière_date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa première datepremière_date
OuiDateLa dernière datedernière_date
ExemplesDaysBetween([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.
2012-05-1093
Fonctions, opérateurs et mots clés
6.1.3.8 LastDayOfMonth
DescriptionRenvoie la date du dernier jour d'un mois
Groupe de fonctionsDate et heure
Syntaxedate LastDayOfMonth(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateN'importe quelle date dumois
date
ExemplesLastDayOfMonth([Date de la vente]) renvoie 31 décembre 2005 si [Date de la vente] correspondau 11 décembre 2005.
6.1.3.9 LastDayOfWeek
DescriptionRenvoie la date du dernier jour d'une semaine
Groupe de fonctionsDate et heure
Syntaxedate LastDayOfWeek(date)
2012-05-1094
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateN'importe quelle date de la se-maine
date
RemarquesLe lundi est considéré comme premier jour de la semaine avec cette fonction.
ExemplesLastDayOfWeek([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
DescriptionRenvoie le nom du mois correspondant à une date
Groupe de fonctionsDate et heure
Syntaxechaîne Month(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
ExemplesMonth([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
DescriptionRenvoie le numéro du mois correspondant à une date
2012-05-1095
Fonctions, opérateurs et mots clés
Groupe de fonctionsDate et heure
Syntaxeentier MonthNumberOfYear(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateN'importe quelle date de l'an-née
date
ExempleMonthNumberOfYear([Date de réservation]) renvoie 12 si la date figurant dans [Date deréservation] correspond au 15 décembre 2005.
6.1.3.12 MonthsBetween
DescriptionRenvoie le nombre de mois entre deux dates.
Groupe de fonctionsDate et heure
Syntaxeentier MonthsBetween(première_date;dernière_date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa première datepremière_date
OuiDateLa dernière datedernière_date
ExemplesMonthsBetween([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
2012-05-1096
Fonctions, opérateurs et mots clés
DescriptionRenvoie le numéro du trimestre correspondant à une date
Groupe de fonctionsDate et heure
Syntaxeentier Quarter(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateN'importe quelle date du trime-stre
date
ExemplesQuarter([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
DescriptionRenvoie une date relative à une autre date
Groupe de fonctionsDate et heure
Syntaxedate DateRelative(date_début;nombre_de_jours)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date de débutdate_début
OuiNombreLe nombre de jours à partir de la datede début
nombre_de_jours
RemarquesLe paramètre nombre_de_jours peut être négatif pour renvoyer une date antérieure à date_début.
2012-05-1097
Fonctions, opérateurs et mots clés
ExemplesDateRelative([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
DescriptionLa dimension temporelle TimeDim permet de construire un axe de temps à partir d'un objet d'universde type Date. TimeDim renvoie les données correspondant aux dates spécifiées en tant que premierparamètre pour les périodes indiquées comme second paramètre. Si certaines périodes ne comprennentaucune donnée, le premier jour de chaque période vide est renvoyé. On dispose ainsi d'un axe completpour 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 fonctionsDate et heure
SyntaxeTimeDim([Type de date]; Type de période)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateL'objet de date pour le rapport, InvoiceDate par exemple.Type de date
FacultatifPrédéfiniLa période pour les résultats, à partir des valeurs suiva-ntes :• 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 dedonnées disponible à partir des objets de rapport. Il nepeut s'agir d'une variable.
Type de pé-riode
Utilisez la fonction ci-dessus conjointement avec les fonctions suivantes :
2012-05-1098
Fonctions, opérateurs et mots clés
• DayName• DayNumberOfMonth• DayNumberOfWeek• DayNumberOfYear• Month• MonthNumberOfYear• Quarter• Year• FormatDate
ExempleLe premier tableau contient les données qui ne concernent que certaines dates. Les exemples derequête suivants montrent comment sont interprétés les résultats.
Chiffre d'affairesDate de la facture
31 6071/3/00
31 2441/8/00
38 1547/3/00
La formule DayName(TimeDim([Date de la facture] ; QuarterPeriod) renvoie les valeursjournalières du tableau ci-dessus.
Chiffre d'affairesDate de la facture
31 6071/3/00
31 2441/8/00
4/1/00
38 1547/3/00
Vous devez mettre en forme les résultats de la fonction TimeDim avec la fonction Quarter pour renvoyerles résultats par trimestre (T1, T2, etc.) afin d'obtenir le tableau de résultats suivant :
2012-05-1099
Fonctions, opérateurs et mots clés
Chiffre d'affairesDate de la facture
62 851T1
T2
38 154T3
6.1.3.16 EnDate
Descriptionrenvoie une chaîne de caractères spécifiant la date indiquée dans le format défini.
Groupe de fonctionsDate et heure
Syntaxedate EnDate(chaîne_date;format)
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneDate à formaterchaîne_date
OuichaîneLe format de dateformat
ExemplesEnDate("15/12/2002";"dd/MM/yyyy") renvoie 15 décembre 2002.
6.1.3.17 Week
DescriptionRenvoie le numéro de la semaine de l'année
Groupe de fonctionsDate et heure
Syntaxeentier Week(date)
2012-05-10100
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
ExemplesWeek([Date de réservation]) renvoie 1 si la date figurant dans [Date de réservation] est le 4janvier 2004 (ce qui correspond à la première semaine de l'année 2004).
6.1.3.18 Year
DescriptionRenvoie l'année correspondant à une date
Groupe de fonctionsDate et heure
Syntaxeentier Year(date)
Entrée
ObligatoireTypeDescriptionParamètre
OuiDateLa date saisiedate
ExemplesYear([Date de réservation]) renvoie 2005 si la date figurant dans [Date de réservation] est le15 décembre 2005.
6.1.4 Fonctions du groupe Data Provider
6.1.4.1 Connexion
2012-05-10101
Fonctions, opérateurs et mots clés
DescriptionRenvoie les paramètres de la connexion à la base de données utilisée par un fournisseur de données.
Groupe de fonctionsFournisseur de données
Syntaxechaîne Connection(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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
DescriptionRenvoie le nom d'un fournisseur de données contenant un objet de rapport
Groupe de fonctionsFournisseur de données
Syntaxechaîne DataProvider(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportUn objet de rapportobj
ExemplesDataProvider([Revenu total]) renvoie "Ventes" si l'indicateur [Revenu total] se trouve dans unfournisseur de données appelé "Ventes".
2012-05-10102
Fonctions, opérateurs et mots clés
6.1.4.3 DataProviderKeyDate
DescriptionRenvoie la date clé d'un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxedate DataProviderKeyDate(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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.
ExemplesDataProviderKeyDate([Ventes]) renvoie le 3 août 2007 si la date clé du fournisseur de donnéesVentes est le 3 août 2007.
6.1.4.4 DataProviderKeyDateCaption
DescriptionRenvoie la légende de la date clé d'un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxechaîne DataProviderKeyDateCaption(dp)
2012-05-10103
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
RemarquesVous devez mettre le nom du fournisseur de données entre crochets.
ExemplesDataProviderKeyDateCaption([Ventes]) renvoie la "Date actuelle du calendrier" si la légendede date clé du fournisseur de données Ventes est "Date actuelle du calendrier".
6.1.4.5 DataProviderSQL
DescriptionRenvoie le SQL généré par un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxechaîne DataProviderSQL(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
RemarquesVous devez mettre le nom du fournisseur de données entre crochets.
ExemplesDataProviderSQL([Requête 1]) renvoie SELECT pays.nom_pays FROM pays si le SQL dufournisseur de données est SELECT pays.nom_pays FROM pays.
6.1.4.6 DataProviderType
2012-05-10104
Fonctions, opérateurs et mots clés
DescriptionRenvoie le type d'un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxechaîne DataProviderType(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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.
ExemplesDataProviderType([Ventes]) renvoie "Univers" si le fournisseur de données "Ventes" est basésur un univers.
6.1.4.7 IsPromptAnswered
DescriptionDétermine si une réponse a été donnée à l'invite
Groupe de fonctionsFournisseur de données
Syntaxebool IsPromptAnswered([fd;]chaîne_invite)
2012-05-10105
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
NonFournisseur de don-nées
Le fournisseur de données contenantl'invite
dp
OuiChaîneTexte de l'invitechaîne_invite
RemarquesVous devez mettre le nom du fournisseur de données entre crochets.
ExemplesIsPromptAnswered("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éponsea é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
DescriptionRenvoie la date de la dernière actualisation d'un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxedate LastExecutionDate(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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.
2012-05-10106
Fonctions, opérateurs et mots clés
ExemplesLastExecutionDate([Requête ventes]) renvoie "4/3/2002" si le fournisseur de données Requêteventes a été actualisé pour la dernière fois le 4 mars 2002.
Rubriques associées• DataProvider
6.1.4.9 LastExecutionDuration
DescriptionRenvoie la durée, exprimée en secondes, de la dernière actualisation d'un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxenumérique LastExecutionDuration(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
RemarquesVous devez mettre le nom du fournisseur de données entre crochets.
ExemplesLastExecutionDuration ([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
DescriptionRenvoie l'heure de la dernière actualisation d'un fournisseur de données
Groupe de fonctionsFournisseur de données
2012-05-10107
Fonctions, opérateurs et mots clés
Syntaxeheure LastExecutionTime(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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.
ExemplesLastExecutionTime([Requête ventes]) renvoie "2:48:00 PM" si le fournisseur de donnéesRequête ventes a été actualisé pour la dernière fois à 14 h 48.
Rubriques associées• DataProvider
6.1.4.11 NumberOfDataProviders
DescriptionRenvoie le nombre de fournisseurs de données dans un rapport
Groupe de fonctionsFournisseur de données
Syntaxeentier NumberOfDataProviders()
ExemplesNumberOfDataProviders() renvoie 2 si le rapport comporte deux fournisseurs de données.
6.1.4.12 NumberOfRows
2012-05-10108
Fonctions, opérateurs et mots clés
DescriptionRenvoie le nombre de lignes dans un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxeentier NumberOfRows(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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.
ExemplesNumberOfRows([Requête 1]) renvoie 10 si le fournisseur de données "Requête 1" comporte10 lignes.
Rubriques associées• DataProvider
6.1.4.13 RefValueDate
DescriptionRenvoie la date des données de référence utilisées dans le cadre du suivi des données
Groupe de fonctionsFournisseur de données
Syntaxedate RefValueDate()
ExemplesRefValueDate() renvoie 15 décembre 2008 si la date de référence correspond au 15 décembre 2008.
2012-05-10109
Fonctions, opérateurs et mots clés
6.1.4.14 RefValueUserReponse
DescriptionRenvoie la réponse à une invite lorsque les données de référence étaient les données actuelles
Groupe de fonctionsFournisseur de données
Syntaxechaîne RefValueUserReponse([fd;]chaîne_invite[;Index])
Entrée
ObligatoireTypeDescriptionParamètre
NonFournisseurde données
Le fournisseur de donnéesdp
OuiChaîneTexte de l'invitechaîne_invite
NonMot cléIndique à la fonction de renvoyer les clés primaires debase de données des valeurs d'invite
Index
Remarques• Cette fonction renvoie une chaîne vide si le suivi des données n'est pas activé.• Vous devez mettre le nom du fournisseur de données entre crochets.• Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir une référence à un fournisseur
de données.• Si vous avez sélectionné plusieurs valeurs en réponse à une invite, la fonction renvoie une chaîne
constituée d'une liste de valeurs (ou de clés primaires si l'opérateur Index est spécifié) séparéespar des points-virgules.
ExemplesRefValueUserReponse( "Quelle ville ?" ) renvoie "Madrid" si vous avez saisi "Madrid" dansl'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 avezsaisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes" lorsque lesdonnées de référence étaient les données actuelles.
6.1.4.15 NomDeUnivers
2012-05-10110
Fonctions, opérateurs et mots clés
DescriptionRenvoie le nom de l'univers sur lequel repose un fournisseur de données
Groupe de fonctionsFournisseur de données
Syntaxechaîne NomDeUnivers(dp)
Entrée
ObligatoireTypeDescriptionParamètre
OuiFournisseur de donnéesLe fournisseur de don-nées
dp
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.
ExemplesNomDeUnivers([Requête 1]) renvoie "eMode" si le fournisseur de données [Requête 1] est basésur l'univers eMode.
Rubriques associées• DataProvider
6.1.4.16 UserResponse
DescriptionRenvoie la réponse à une invite
Groupe de fonctionsFournisseur de données
Syntaxechaîne UserResponse([fd;]chaîne_invite[;Index])
2012-05-10111
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
NonFournisseurde données
Le fournisseur de donnéesdp
OuiChaîneTexte de l'invitechaîne_invite
NonMot cléIndique à la fonction de renvoyer les clés primaires debase de données des valeurs d'invite
Index
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éespar des points-virgules.
ExemplesUserResponse( "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 avezsaisi "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
DescriptionRenvoie l'identification InfoView de l'auteur du document
Groupe de fonctionsDocument
2012-05-10112
Fonctions, opérateurs et mots clés
Syntaxechaîne DocumentAuthor()
ExemplesDocumentAuthor() renvoie "gkn" si le nom de connexion de l'auteur du document est "gkn".
6.1.5.2 DocumentCreationDate
DescriptionRenvoie la date à laquelle un document a été créé
Groupe de fonctionsDocument
Syntaxedate DocumentCreationDate()
ExemplesDocumentCreationDate renvoie 15 décembre 2008 si le document a été créé le 15 décembre 2008.
6.1.5.3 DocumentCreationTime
DescriptionRenvoie l'heure à laquelle un document a été créé
Groupe de fonctionsDocument
Syntaxeheure DocumentCreationTime()
ExemplesDocumentCreationTime() renvoie 11:15 si le document a été créé à 11 h 15.
6.1.5.4 DocumentDate
2012-05-10113
Fonctions, opérateurs et mots clés
DescriptionRenvoie la date à laquelle un document a été enregistré pour la dernière fois
Groupe de fonctionsDocument
Syntaxedate DocumentDate()
ExemplesDocumentDate () renvoie 8 août 2005 si le document a été enregistré pour la dernière fois le 8août 2005.
6.1.5.5 DocumentName
Descriptionrenvoie le nom du document.
Groupe de fonctionsDocument
Syntaxechaîne DocumentName()
ExemplesDocumentName() renvoie "Rapport des ventes" si le document se nomme "Rapport des ventes".
6.1.5.6 DocumentOwner
DescriptionRenvoie le nom d'utilisateur/les informations de connexion à InfoView du propriétaire du document (ladernière personne à avoir enregistré le document). (Pour renvoyer l'auteur/le créateur initial du document,utilisez la fonction AuteurDocument.)
Groupe de fonctionsDocument
Syntaxechaîne DocumentOwner()
2012-05-10114
Fonctions, opérateurs et mots clés
ExemplesDocumentOwner() renvoie "gkn" si la dernière personne à avoir enregistré le document contient unnom d'utilisateur ou une connexion "gkn".
6.1.5.7 DocumentPartiallyRefreshed
DescriptionDétermine si un document est partiellement actualisé
Groupe de fonctionsDocument
Syntaxebooléen DocumentPartiallyRefreshed()
RemarquesDocumentPartiallyRefreshed renvoie une valeur booléenne que vous pouvez utiliser dans lafonction Si.
ExemplesDocumentPartiallyRefreshed() renvoie True si le document est partiellement actualisé.
6.1.5.8 DocumentTime
DescriptionRenvoie l'heure à laquelle un document a été enregistré pour la dernière fois
Groupe de fonctionsDocument
Syntaxeheure DocumentTime()
RemarquesLe format de l'heure renvoyée varie en fonction du format de cellule.
ExempleDocumentTime() renvoie 15:45 si le document a été enregistré pour la dernière fois à 15h:45.
2012-05-10115
Fonctions, opérateurs et mots clés
6.1.5.9 DrillFilters
DescriptionRenvoie les filtres d'exploration appliqués à un document ou à un objet en mode Exploration
Groupe de fonctionsDocument
Syntaxechaîne DrillFilters(obj|séparateur)
Entrée
ObligatoireTypeDescriptionParamètre
Soit obj, soit séparateur requis
Objet rapportUn objet de rapportobj
Soit obj, soit séparateur requis
ChaîneLe séparateur du filtre d'explo-ration
séparateur
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.
ExemplesDrillFilters() 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 limitantl'objet [Trimestre] à "T3".
6.1.5.10 PromptSummary
2012-05-10116
Fonctions, opérateurs et mots clés
DescriptionRenvoie le texte de l'invite et la réponse utilisateur de toutes les invites d'un document
Groupe de fonctionsDocument
Syntaxestring PromptSummary()
ExemplesExemples d'entrées de la fonction PromptSummary :
Enter Quantity Sold: 5000Enter value(s) for State (optional): California, Texas, UtahEnter Customer (optional):
6.1.5.11 QuerySummary
DescriptionRenvoie des informations sur les requêtes d'un document
Groupe de fonctionsDocument
Syntaxechaîne QuerySummary([dp])
Entrée
ObligatoireTypeDescriptionParamètre
NonFournisseur de donnéesUn fournisseur de don-nées
dp
Remarques• Vous devez mettre le nom du fournisseur de données entre crochets.
ExemplesQuerySummary() 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 lefournisseur de données [Requête 1].
2012-05-10117
Fonctions, opérateurs et mots clés
Exemple de sortie :Query 1:
Universe: eFashionLast execution time: 1sNB of rows: 34500Result objects: State, Year, Sales RevenueScope of analysis: State, City, Year, Quarter, MonthFilters:(State inlist{"US";"France";}And (Sales Revenue Greater Than 1000000Or Sales Revenue Less Than 10000))
Query 2:Source file: D:\Data\datacar.xlsResult objects: State, Year, Sales Revenue
6.1.5.12 ReportFilter
DescriptionRenvoie les filtres de rapport appliqués à un objet ou un rapport
Groupe de fonctionsDocument
Syntaxechaîne ReportFilter(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportUn objet de rapportobj
ExemplesReportFilter([Pays]) renvoie "US" si un filtre de rapport limite l'objet Pays à "US".
6.1.5.13 ReportFilterSummary
DescriptionRenvoie un résumé des filtres de rapport d'un document ou d'un rapport
Groupe de fonctionsDocument
2012-05-10118
Fonctions, opérateurs et mots clés
Syntaxestring ReportFilterSummary(report_name)
Entrée
ObligatoireTypeDescriptionParamètre
NonChaîneLe nom du rapportnom_rapport
RemarquesSi nom_rapport est omis, ReportFilterSummary renvoie un résumé de tous les filtres de rapportdu document.
ExemplesReportFilterSummary() 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 1000000Or (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
DescriptionDétermine si un nombre est pair
Groupe de fonctionsLogique
Syntaxebooléen Even(nombre)
2012-05-10119
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
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.
ExemplesEven(4) renvoie True.
Even(3) renvoie False.
Even(23,2) renvoie False.
Even(-4) renvoie True.
Even(-2,2) renvoie False.
6.1.6.2 IsDate
DescriptionDétermine si une valeur est une date
Groupe de fonctionsLogique
Syntaxebooléen IsDate(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
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.
ExemplesIsDate([Date de réservation]) renvoie True si la variable [Date de réservation] est une date.
2012-05-10120
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• Si...Alors...Sinon
6.1.6.3 IsError
DescriptionDétermine si un objet renvoie une erreur
Groupe de fonctionsLogique
Syntaxebooléen IsError(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
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.
ExemplesIsError([Chiffre d'affaires]) renvoie la valeur False si la variable [Chiffre d'affaires] nerenvoie 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• Si...Alors...Sinon
2012-05-10121
Fonctions, opérateurs et mots clés
6.1.6.4 IsLogical
DescriptionDétermine si une valeur est booléenne
Groupe de fonctionsLogique
Syntaxebooléen IsLogical(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
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.
ExemplesEstLogique(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• Si...Alors...Sinon
6.1.6.5 IsNull
DescriptionDétermine si une valeur est nulle
Groupe de fonctionsLogique
2012-05-10122
Fonctions, opérateurs et mots clés
Syntaxebooléen IsNull(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
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.
ExemplesIsNull([Chiffre d'affaires]) renvoie la valeur False si la variable [Chiffre d'affaires] n'est pasnulle.
IsNull([Nombre moyen d'invités]) renvoie la valeur True si la variable [Nombre moyen d'invités]est nulle.
Rubriques associées• Si...Alors...Sinon
6.1.6.6 IsNumber
DescriptionDétermine si une valeur est un nombre
Groupe de fonctionsLogique
Syntaxebooléen IsNumber(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
Remarques• IsNumber renvoie une valeur booléenne que vous pouvez utiliser dans la fonction If.
2012-05-10123
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.
ExemplesIsNumber([Chiffre d'affaires]) renvoie la valeur True si la variable [Chiffre d'affaires] est unnombre.
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 "Pasun nombre" si la variable [Nom du client] n'est pas un nombre.
Rubriques associées• Si...Alors...Sinon
6.1.6.7 IsString
DescriptionDétermine si une valeur est une chaîne
Groupe de fonctionsLogique
Syntaxebooléen IsString(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
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.
ExemplesIsString([Chiffre d'affaires]) renvoie la valeur False si la variable [Chiffre d'affaires] n'estpas 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" sila variable [Nom client] est une chaîne.
2012-05-10124
Fonctions, opérateurs et mots clés
Rubriques associées• Si...Alors...Sinon
6.1.6.8 IsTime
DescriptionDétermine si une variable est une variable d'heure
Groupe de fonctionsLogique
Syntaxebooléen IsTime(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
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.
ExemplesIsTime([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 moyend'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• Si...Alors...Sinon
6.1.6.9 Odd
2012-05-10125
Fonctions, opérateurs et mots clés
DescriptionDétermine si un nombre est impair
Groupe de fonctionsLogique
Syntaxebool Odd(nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
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.
ExemplesOdd(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• Si...Alors...Sinon
6.1.7 Fonctions du groupe Numeric
6.1.7.1 Abs
2012-05-10126
Fonctions, opérateurs et mots clés
DescriptionRenvoie la valeur absolue d'un nombre
Groupe de fonctionsNumérique
Syntaxenumérique Abs(nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
ExemplesAbs(25) renvoie 25.
Abs(-11) renvoie 11.
6.1.7.2 Ceil
DescriptionRenvoie un nombre arrondi à l'entier supérieur
Groupe de fonctionsNumérique
Syntaxenumérique Ceil( nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
ExemplesCeil(2,4) renvoie 3.
Ceil(3,1) renvoie 4.
Ceil(-3,1) renvoie -3.
2012-05-10127
Fonctions, opérateurs et mots clés
6.1.7.3 Cos
DescriptionRenvoie le cosinus d'un angle
Groupe de fonctionsNumérique
Syntaxenumérique Cos(angle)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreUn angle en radiansangle
ExempleCos(180) renvoie -0,6.
6.1.7.4 EuroConvertFrom
DescriptionConvertit un montant en euros dans une autre devise
Groupe de fonctionsNumérique
Syntaxenumérique EuroConvertFrom(montant_euro;code_dev;niveau_arrondi)
2012-05-10128
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe montant en eurosmontant_non_eu-ro
OuiChaîneLe code ISO de la devise ciblecode_dev
OuiNombreLe nombre de décimales selon lequel le résul-tat doit être arrondi
niveau_arrondi
RemarquesLe code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeursont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonctionrenvoie #ERROR. Les devises sont les suivantes :
Franc belgeBEF
Mark allemandDEM
Drachme grecqueGRD
Peseta espagnoleESP
Franc françaisFRF
Punt irlandaisIEP
Lire italienneITL
Franc luxembourgeoisLUF
Guilder néerlandaiseNLG
Schilling autrichienATS
Escudo portugaisPTS
Mark finnoisFIM
ExemplesEuroConvertFrom(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-10129
Fonctions, opérateurs et mots clés
6.1.7.5 EuroConvertTo
DescriptionConvertit un montant en euros
Groupe de fonctionsNumérique
Syntaxenumérique EuroConvertTo(montant_non_euro;code_dev;niveau_arrondi)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe montant dans la devise qui n'est pas en eurosmonta-nt_non_euro
OuiChaîneLe code ISO de la devise qui n'est pas en euroscode_dev
OuiNombreLe nombre de décimales selon lequel le résultatdoit être arrondi
niveau_arrondi
ExempleEuroConvertTo(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.
RemarqueLe code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeursont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonctionrenvoie #ERROR. Les devises sont les suivantes :
Franc belgeBEF
Mark allemandDEM
Drachme grecqueGRD
Peseta espagnoleESP
Franc françaisFRF
2012-05-10130
Fonctions, opérateurs et mots clés
Punt irlandaisIEP
Lire italienneITL
Franc luxembourgeoisLUF
Guilder néerlandaiseNLG
Schilling autrichienATS
Escudo portugaisPTS
Mark finnoisFIM
Rubriques associées• Arrondir et tronquer des nombres
6.1.7.6 EuroFromRoundError
DescriptionRenvoie l'erreur d'arrondi d'une conversion de l'euro
Groupe de fonctionsNumérique
Syntaxenumérique EuroFromRoundError (montant_euro;code_dev;niveau_arrondi)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe montant en eurosmonta-nt_non_euro
OuiChaîneLe code ISO de la devise ciblecode_dev
OuiNombreLe nombre de décimales selon lequel le résultatdoit être arrondi
niveau_arrondi
RésultatL'erreur d'arrondi du calcul
2012-05-10131
Fonctions, opérateurs et mots clés
ExemplesEuroFromRoundError(1000;"FRF";2) renvoie 0. (Il n'y a pas de différence entre la conversionnon arrondie et la conversion arrondie à 2 positions décimales.)
EuroFromRoundError(1000;"FRF";1) renvoie 0,03. (La conversion non arrondie est 6559,57. Laconversion 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 conversionnon 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.)
RemarqueLe code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeursont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonctionrenvoie #ERROR. Les devises sont les suivantes :
Franc belgeBEF
Mark allemandDEM
Drachme grecqueGRD
Peseta espagnoleESP
Franc françaisFRF
Punt irlandaisIEP
Lire italienneITL
Franc luxembourgeoisLUF
Guilder néerlandaiseNLG
Schilling autrichienATS
Escudo portugaisPTS
Mark finnoisFIM
Rubriques associées• Arrondir et tronquer des nombres
6.1.7.7 EuroToRoundError
2012-05-10132
Fonctions, opérateurs et mots clés
DescriptionRenvoie l'erreur d'arrondi d'une conversion en euros
Groupe de fonctionsNumérique
Syntaxenumérique EuroToRoundError(montant_non_euro;code_dev;niveau_arrondi)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe montant dans la devise qui n'est pas en eurosmonta-nt_non_euro
OuiChaîneLe code ISO de la devise qui n'est pas en euroscode_dev
OuiNombreLe nombre de décimales selon lequel le résultatdoit être arrondi
niveau_arrondi
ExemplesEuroToRoundError(6559;"FRF";2) renvoie 0. (Il n'y a pas de différence entre la conversion nonarrondie et la conversion arrondie à 2 positions décimales.)
EuroToRoundError(6559;"FRF";1) renvoie -0,01. (La conversion non arrondie est 999,91. Laconversion 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 nonarrondie et la conversion arrondie à 2 positions décimales.)
EuroToRoundError(1955;"DEM";1) renvoie 0,02. (La conversion non arrondie est 999,58. Laconversion arrondie à 1 position décimale est 999,60. L'erreur d'arrondi est de -0,02.)
RemarqueLe code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeursont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Si ce n'est pas le cas, la fonctionrenvoie #ERROR. Les devises sont les suivantes :
Franc belgeBEF
Mark allemandDEM
Drachme grecqueGRD
Peseta espagnoleESP
Franc françaisFRF
Punt irlandaisIEP
2012-05-10133
Fonctions, opérateurs et mots clés
Lire italienneITL
Franc luxembourgeoisLUF
Guilder néerlandaiseNLG
Schilling autrichienATS
Escudo portugaisPTS
Mark finnoisFIM
Rubriques associées• Arrondir et tronquer des nombres
6.1.7.8 Exp
DescriptionRenvoie une valeur exponentielle (e élevée à une puissance)
Groupe de fonctionsNumérique
Syntaxenumérique Exp(puissance)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLa puissancepuissance
RemarquesUne valeur exponentielle est la constante e (2,718...) élevée à une puissance.
ExemplesExp(2.2) renvoie 9,03.
6.1.7.9 Fact
2012-05-10134
Fonctions, opérateurs et mots clés
DescriptionRenvoie le factoriel d'un nombre
Groupe de fonctionsNumérique
Syntaxeentier Fact(nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
RemarquesLe factoriel de nombre est le produit de tous les nombres entiers compris entre 1 et nombre.
ExemplesFact(4) renvoie 24.
Fact(5,9) renvoie 120.
6.1.7.10 Floor
DescriptionRenvoie un nombre arrondi à l'entier inférieur le plus proche
Groupe de fonctionsNumérique
Syntaxeentier Floor(nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
ExempleFloor(24,4) renvoie 24.
2012-05-10135
Fonctions, opérateurs et mots clés
6.1.7.11 Interpolation
DescriptionCalcule les valeurs d'indicateur manquantes par interpolation
Groupe de fonctionsNumérique
Syntaxenum Interpolation(measure[;PointToPoint|Linear][;NotOnBreak|(reset_dims)][;Row|Col])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
Non
(PointAPoint est utilisépar défaut)
Mot cléLa méthode d'interpolation :• PointAPoint : interpolation de point à
point• Linéaire : régression linéaire avec inter-
polation des moindres carrés.
PointAPoi-nt|Linéaire
NonMot clé| listedes dimen-sions
• PasSurSaut : empêche la fonction de réini-tialiser le calcul au niveau des sauts de se-ction et de bloc
• réinit_dims : liste des dimensions utili-sées pour réinitialiser l'interpolation.
PasSurSaut|réinit_dims
(Ligne, par défaut)Mot cléDéfinit le sens du calculLigne|Col
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 traceune 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 encalculant une équation de droite de type f(x) = ax + b qui passe, le plus précisément possible, partoutes les valeurs disponibles de l'indicateur.
• L'interpolation de point à point calcule les valeurs manquantes en calculant une équation de droitede 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-10136
Fonctions, opérateurs et mots clés
• Si la liste de valeurs ne comporte qu'une seule valeur, Interpolation l'utilise pour fournir toutesles valeurs manquantes.
• Les filtres appliqués à un indicateur interpolé peuvent modifier les valeurs renvoyées par Interpolation en fonction des valeurs concernées par les filtres.
ExemplesInterpolation([Valeur]) fournit les valeurs manquantes suivantes en utilisant la méthoded'interpolation de point à point par défaut :
Interpolation([Valeur])ValeurJour
1212Lundi
1414Mardi
15Mercredi
1616Jeudi
17Vendredi
18Samedi
1919Dimanche
Rubriques associées• Opérateur Linéaire• Opérateur PointAPoint
6.1.7.12 Ln
Descriptionrenvoie le logarithme naturel d'un nombre.
Groupe de fonctionsNumérique
Syntaxenumérique Ln(nombre)
2012-05-10137
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
ExemplesLn(10) renvoie 2.
6.1.7.13 Journal
DescriptionRenvoie le logarithme d'un nombre d'une base spécifiée
Groupe de fonctionsNumérique
Syntaxenumérique Log(nombre;base)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
OuiNombreLa base du logarithmebase
ExemplesLog(125;5) renvoie 3.
6.1.7.14 Log10
DescriptionRenvoie le logarithme de base 10 d'un nombre
Groupe de fonctionsNumérique
Syntaxenumérique Log10(nombre)
2012-05-10138
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
ExemplesLog10(100) renvoie 2.
6.1.7.15 Mod
DescriptionRenvoie le reste d'une division de deux nombres
Groupe de fonctionsNumérique
Syntaxenumérique Mod(dividende;diviseur)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe dividendedividende
OuiNombreLe diviseur.diviseur
ExemplesMod(10;4) renvoie 2.
Mod (10.2;4.2) renvoie 1.8.
6.1.7.16 Puissance
DescriptionRenvoie un nombre élevé à une puissance
Groupe de fonctionsNumérique
2012-05-10139
Fonctions, opérateurs et mots clés
Syntaxenumérique Power(nombre;puissance)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe nombre à élever à une puis-sance
nombre
OuiNombreLa puissancepuissance
ExemplePower(10;2) renvoie 100.
6.1.7.17 Rank
DescriptionClasse un indicateur selon des dimensions
Groupe de fonctionsNumérique
Syntaxeentier Rank(indicateur;[dims_classement][;Premiers|Derniers][;(réinit_dims)])
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurL'indicateur à classerindicateur
NonListe Dimen-sion
Les dimensions utilisées pour classer l'indicateurdim_classe-ment
Non (Premiers est laconfiguration par défaut)
Mot cléDéfinit l'ordre de classement.• Premiers : décroissant• Bas : croissant
Pre-miers/Der-niers
NonListe Dimen-sion
Les dimensions qui réinitialisent le classementdim_redéfi-nies
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-10140
Fonctions, opérateurs et mots clés
• Lorsque vous spécifiez un ensemble de dimensions de classement ou redéfinies, vous devez lesséparer par des points-virgules.
• Par défaut, le classement est réinitialisé sur une section ou une rupture de bloc.
ExemplesDans le tableau suivant, le classement est indiqué par Rank([Chiffre d'affaires]);([Pays])):
ClassementChiffre d'affairesPays
2835 420France
12 451 104US
Dans le tableau suivant, le classement est donné par Rank([Chiffre d'affaires];([Pays]);Derniers). L'argument Derniers signifie que les indicateurs sont classés par ordre décroissant.
ClassementChiffre d'affairesPays
1835 420France
22 451 104US
Dans le tableau suivant, le classement est indiqué par Rank([Chiffre d'affaires];([Pays];[Lieu de séjour])):
ClassementChiffre d'affairesLieu de séjourPays
3835 420Côte d'AzurFrance
2971 444Bahamas BeachUS
11 479 660Hawaiian ClubUS
Dans le tableau suivant, le classement est indiqué par Rank([Chiffre d'affaires];([Pays];[Année]);([Pays])). Le rang est réinitialisé dans la dimension Pays.
ClassementChiffre d'affairesAnnéePays
1295 940FY1998France
2280 3101999France
3259 1702000France
3767 614FY1998US
2826 9301999US
2012-05-10141
Fonctions, opérateurs et mots clés
1856 5602000US
Rubriques associées• Opérateurs Derniers/Premiers
6.1.7.18 Round
DescriptionArrondit un nombre
Groupe de fonctionsNumérique
Syntaxenumérique Round (nombre;niveau_arrondi)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe nombre à arrondirnombre
OuiNombreNombre de décimales selon lequel le no-mbre est arrondi
niveau_arrondi
ExemplesRound(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
2012-05-10142
Fonctions, opérateurs et mots clés
6.1.7.19 Signe
DescriptionRenvoie le signe d'un nombre
Groupe de fonctionsNumérique
Syntaxeentier Signe(nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
RemarquesSigne renvoie -1 si nombre est négatif, 0 si nombre est zéro et 1 si nombre est positif.
ExemplesSigne(3) renvoie 1.
Signe(-27,5) renvoie -1.
6.1.7.20 Sin
DescriptionRetourne le sinus d'un angle
Groupe de fonctionsNumérique
Syntaxenumérique Sin(angle)
2012-05-10143
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreUn angle en radiansangle
ExempleSin(234542) renvoie -0,116992.
6.1.7.21 RacineCarrée
DescriptionCalcule la racine carrée d'un nombre.
Groupe de fonctionsNumérique
Syntaxenumérique RacineCarrée(nombre)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreN'importe quel nombrenombre
ExempleRacine(25) renvoie 5.
6.1.7.22 Tan
DescriptionRenvoie la tangente d'un angle
Groupe de fonctionsNumérique
Syntaxenumérique Tan(angle)
2012-05-10144
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreUn angle en radiansangle
ExemplesTan(90) renvoie -2.
6.1.7.23 EnNombre
Descriptionrenvoie une chaîne sous la forme de nombre.
Groupe de fonctionsNumérique
Syntaxenumérique EnNombre(chaîne)
Entrée
ObligatoireTypeDescriptionParamètre
OuiChaîneUn nombre sous forme de chaîne decaractères
chaîne
RemarquesSi chaîne ne correspond pas à un nombre, la fonction EnNombre renvoie #ERREUR.
ExemplesEnNombre("45") renvoie 45.
6.1.7.24 Truncate
DescriptionTronque un nombre
Groupe de fonctionsNumérique
2012-05-10145
Fonctions, opérateurs et mots clés
Syntaxenumérique Truncate(nombre;niveau_troncature)
Entrée
ObligatoireTypeDescriptionParamètre
OuiNombreLe nombre à arrondirnombre
OuiNombreNombre de décimales selon lequel le no-mbre est tronqué
niveau_troncature
RemarquesExempleTruncate(3,423;2) renvoie 3,42.
Rubriques associées• Arrondir et tronquer des nombres
6.1.8 Fonctions d'ensemble
6.1.8.1 Children
DescriptionRenvoie les membres enfant d'un membre
Groupe de fonctionsEnsemble
Syntaxemember_set member.Children
2012-05-10146
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
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 vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
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 lemembre actuel de la hiérarchie [Géographie].
Rubriques associées• Aggregate• Average• Count• Max• Min• Sum
6.1.8.2 Depth
DescriptionRenvoie la profondeur d'un membre dans la hiérarchie
Groupe de fonctionsEnsemble
Syntaxeent membre.Profondeur
2012-05-10147
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
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 vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
Exemples[Géographie].[Etats-Unis].[Californie].[Los Angeles].Profondeur renvoie 2.
6.1.8.3 Descendants
DescriptionRenvoie les membres descendants d'un membre
Groupe de fonctionsEnsemble
Syntaxemember_set Descendants(member[;level|distance][;desc_flag])
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
Non (le niveau de membre estle niveau par défaut)
niveauNiveau des descendantsniveau
Non (le niveau de membre estle niveau par défaut)
intDistance entre le niveau du descen-dant et le niveau actuel
distance
Non (la valeur par défaut estSelf)
mot cléDétermine quels membres descenda-nts sont renvoyés
indicateur_de-sc
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-10148
Fonctions, opérateurs et mots clés
• Le membre est indiqué explicitement ou il s'agit du membre actuel d'une hiérarchie. Si vous indiquezle membre explicitement, vous devez préciser le chemin d'accès complet dans la hiérarchie. Si vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
• 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 :
Renvoie les descendants qui se trouvent au niveau indiqué par le paramètreniveau|distance, y compris le membre actuel s'il se trouve à ce niveau.
Self
Renvoie le membre actuel et tous les descendants qui se trouvent au-dessusdu niveau indiqué par le paramètreniveau|distance.
Before
Renvoie les descendants qui se trouvent au-dessous du niveau indiqué par leparamètre niveau|distance.
After
Renvoie le membre actuel et tous les descendants qui se trouvent au niveauindiqué par le paramètreniveau|distance ou au-dessus.
Self_Before
Renvoie le membre actuel et tous les descendants qui se trouvent au niveauindiqué par le paramètreniveau|distance ou au-dessous.
Self_After
Renvoie le membre actuel et tous les descendants, sauf ceux qui se trouventau niveau indiqué par le paramètreniveau|distance.
Before_After
Renvoie le membre actuel et tous les descendants.Self_Before_After
Renvoie tous les membres qui se trouvent entre le membre actuel et le niveauindiqué par le paramètreniveau|distance et qui n'ont pas de membres en-fant.
Leaves
• La distance doit être positive.
ExemplesTous les exemples reposent sur les données suivantes :
Etats-Unis
NevadaCalifornie
Carson CityRenoLas VegasSanFrancis-coSan DiegoLos An-
geles
Descendants([Géographie].[Etats-Unis].[Californie];[Géographie].[Ville])renvoie [San Francisco], [San Diego], [Los Angeles].
2012-05-10149
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], [SanDiego], [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], [SanFrancisco], [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 [SanFrancisco], [San Diego], [Los Angeles], [Las Vegas], [Reno], [Carson City].
Rubriques associées• Aggregate• Average• Count• Max• Min• Sum
6.1.8.4 IsLeaf
DescriptionDétermine si un membre est un membre feuille.
Groupe de fonctionsDivers
Syntaxebool membre.EstFeuille
2012-05-10150
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
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 vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
Exemples[Géographie].[Etats-Unis].[Californie].IsLeaf renvoie False si [Californie] a les membresenfant [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é
DescriptionRenvoie la clé d'un membre.
Syntaxechaîne membre.Key
Groupe de fonctionsEnsemble
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
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 vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
2012-05-10151
Fonctions, opérateurs et mots clés
Exemple[Géographie].[Etats-Unis].Key renvoie "XYZ" si la clé du membre [Etats-Unis] est "XYZ".
6.1.8.6 Lag
DescriptionRenvoie un membre qui se trouve au même niveau que le membre actuel et à une distance donnéeavant ce dernier.
Syntaxemembre membre.Lag(distance)
Groupe de fonctionsEnsemble
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
OuiintDistance entre le membre en question et lemembre actuel
distance
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 distance spécifiée après membre.
• Le membre est indiqué explicitement ou il s'agit du membre actuel d'une hiérarchie. Si vous indiquezle membre explicitement, vous devez préciser le chemin d'accès complet dans la hiérarchie. Si vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
• Décalage se sert de l'ordre des membres dans la hiérarchie et dans la requête pour renvoyer lemembre correspondant.
Exemples[Géographie].[Etats-Unis].[Californie].[San Francisco].Décalage(1) renvoie [SanDiego] si [San Diego] est le membre juste avant [San Francisco] au niveau Ville.
Rubriques associées• Aggregate
2012-05-10152
Fonctions, opérateurs et mots clés
• Average• Count• Max• Min• Sum
6.1.8.7 Parent
DescriptionRenvoie le membre parent d'un membre
Groupe de fonctionsEnsemble
Syntaxemember member.Parent
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
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 vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
Exemples[Géographie].[Etats-Unis].[Californie].[Los Angeles].Parent renvoie [Californie].
Rubriques associées• Aggregate• Average• Count• Max• Min• Sum
2012-05-10153
Fonctions, opérateurs et mots clés
6.1.8.8 Eléments de même niveau
DescriptionRenvoie le membre et les membres de même niveau que celui-ci.
Groupe de fonctionsEnsemble
Syntaxemember_set member.Siblings
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
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 desmembres pour l'agrégation.
• Le membre est indiqué explicitement ou il s'agit du membre actuel d'une hiérarchie. Si vous indiquezle membre explicitement, vous devez préciser le chemin d'accès complet dans la hiérarchie. Si vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
• 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• Aggregate• Average• Count• Max• Min• Sum
2012-05-10154
Fonctions, opérateurs et mots clés
6.1.9 Fonctions diverses
6.1.9.1 Ancestor
DescriptionRenvoie un membre ascendant d'un membre
Groupe de fonctionsDivers
Syntaxemember Ancestor(member;level|distance)
Entrée
ObligatoireTypeDescriptionParamètre
OuimembreTout membremembre
Le niveau ou la distance est requis
niveauLe niveau de l'ascendantniveau
Le niveau ou la distance est requis
intLa distance du niveau de l'ascendant parrapport au niveau actuel
distance
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 vousindiquez une hiérarchie qui n'entre pas dans le contexte de la formule, la formule renvoie une valeurvide.
• La distance doit être positive.
ExemplesTous les exemples sont basés sur la hiérarchie [Géographie] (Pays > Etat > Ville). Le tableau suivantmontre un sous-ensemble des données de la hiérarchie.
Etats-Unis
NevadaCalifornie
2012-05-10155
Fonctions, opérateurs et mots clés
Carson CityRenoLas VegasSanFrancis-coSan DiegoLos An-
geles
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• Aggregate• Average• Count• Max• Min• Sum
6.1.9.2 BlockName
DescriptionRenvoie le nom du bloc
Groupe de fonctionsDivers
Syntaxechaîne BlockName()
ExemplesSi BlockName est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
6.1.9.3 Numéro de colonne
DescriptionRenvoie le numéro de la colonne
2012-05-10156
Fonctions, opérateurs et mots clés
Groupe de fonctionsDivers
Syntaxeentier ColumnNumber()
ExemplesColumnNumber() renvoie 2 si la formule est placée dans la deuxième colonne d'un tableau.
6.1.9.4 CurrentUser
DescriptionRenvoie le nom d'utilisateur de l'utilisateur actuel pour accéder à la zone de lancement BI
Groupe de fonctionsDivers
Syntaxechaîne CurrentUser()
ExemplesCurrentUser() renvoie "gkn" si son nom d'utilisateur est "gkn".
6.1.9.5 ForceMerge
DescriptionInclut des dimensions synchronisées dans les calculs d'indicateurs lorsque les dimensions n'apparaissentpas dans le contexte du calcul.
Groupe de fonctionsDivers
Syntaxenum ForceMerge(measure)
2012-05-10157
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateurTout indicateurindicateur
RésultatRé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.
ExemplesForceMerge([Chiffre d'affaires]) renvoie la valeur de [Chiffre d'affaires] en tenant comptedes dimensions synchronisées qui n'apparaissent pas dans le même bloc que l'indicateur [Chiffred'affaires].
6.1.9.6 GetContentLocale
DescriptionRenvoie les paramètres régionaux des données contenues dans le document (les paramètres régionauxdu document)
Groupe de fonctionsDivers
Syntaxechaîne GetContentLocale()
RemarquesLes paramètres régionaux du document sont utilisés pour mettre en forme les données dans undocument.
ExemplesGetContentLocale() renvoie "fr_FR" si les paramètres régionaux du document sont "Français(France)".
2012-05-10158
Fonctions, opérateurs et mots clés
6.1.9.7 GetDominantPreferredViewingLocale
DescriptionRenvoie les paramètres régionaux dans le groupe paramètres régionaux de visualisation préférés del'utilisateur
Groupe de fonctionsDivers
Syntaxestring 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, AnglaisUS ("en_US") constitue le paramètre régional prévalent dans le groupe des paramètres régionauxanglais. 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 visualisationpréférés dominants.
ExemplesGetDominantPreferredViewingLocale renvoie "en_US" lorsque le paramètre régional devisualisation préféré est "Anglais (Nouvelle-Zélande)".
Rubriques associées• GetPreferredViewingLocale
6.1.9.8 GetLocale
DescriptionRenvoie les paramètres régionaux de l'utilisateur utilisés pour mettre en forme l'interface utilisateur (lesparamètres régionaux du produit)
Groupe de fonctionsDivers
Syntaxechaîne GetLocale()
2012-05-10159
Fonctions, opérateurs et mots clés
RemarquesLes 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).
ExemplesGetLocale() renvoie "en_US" si le paramètre régional du produit est "Anglais (US)".
6.1.9.9 GetLocalized
DescriptionRenvoie une chaîne localisée conformément aux paramètres régionaux de visualisation préférés del'utilisateur
Syntaxestring GetLocalized(string[;comment])
Entrée
ObligatoireTypeDescriptionParamètre
OuichaîneLa chaîne à traduirechaîne
NonchaîneUn commentaire pour aider les traduc-teurs
comment (commen-taire)
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îtavec la chaîne dans l'outil Gestionnaire de traduction que les traducteurs utilisent pour traduire lesrapports.
• Chaque paire chaîne + commentaire génère une chaîne distincte à traduire dans l'outilGestionnaire de traduction. En conséquence, GetLocalized("Product Total";"Max 20characters") et GetLocalized("Product Total";"Use no more than 20 characters") peuvent renvoyer des traductions différentes.
ExemplesGetLocalized("Total for all products") renvoie la traduction de "Total for all products" sile paramètre régional de visualisation préféré est "fr_FR".
GetLocalized("Total for all products";"Try not to use more than 20 characters") renvoie la traduction allemande de "Total for all products" si le paramètre régional devisualisation préféré est "de_DE". La fonction prévient également le traducteur s'il ne doit pas utiliserplus de 20 caractères, si possible, pour la traduction de la chaîne.
2012-05-10160
Fonctions, opérateurs et mots clés
Rubriques associées• GetPreferredViewingLocale
6.1.9.10 GetPreferredViewingLocale
DescriptionRenvoie 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 fonctionsDivers
Syntaxechaîne GetPreferredViewingLocale()
ExemplesGetPreferredViewingLocale renvoie "en_US" si les Paramètres régionaux de visualisation préféréssont "English (US)".
Rubriques associées• GetLocalized• GetDominantPreferredViewingLocale
6.1.9.11 Si...Alors...Sinon
DescriptionRenvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctionsDivers
SyntaxeIf bool_value Then true_value [Else false_value]
2012-05-10161
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiBooléenUne valeur booléennevaleur_bool
OuiN'importe lequelLa valeur à renvoyer si valeur_boolest vraie
valeur_true
Oui si Sinon est in-clus
N'importe lequelLa valeur à renvoyer si valeur_boolest fausse
valeur_false
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 Elsefalse_value…]
• La syntaxe d'origine de la fonctionIf, If(valeur_bool; valeur_true; valeur_false) estégalement prise en charge.
ExemplesIf [Chiffre d'affaires]>1 000 000 Alors "CA élevé" renvoie "CA élevé" pour toutesles 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 duchiffre 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 toutesles 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'affaires]> 800 000 Alors "CA moyen" Sinon "CA faible" renvoie "CA élevé" pour toutesles lignes dont le revenu dépasse 1 000 000, "CA moyen" pour toutes les lignes dont le chiffre d'affairesest compris entre 800 000 et 1 000 000 et "CA faible" pour toutes les autres lignes.
Rubriques associées• Si• Et (opérateur)• Opérateur Entre• DansListe (opérateur)• Ou (opérateur)• Pas (not x)
2012-05-10162
Fonctions, opérateurs et mots clés
6.1.9.12 Si
DescriptionRenvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctionsDivers
SyntaxeIf(bool_value;true_value;false_value)
Entrée
ObligatoireTypeDescriptionParamètre
OuiBooléenUne valeur booléennevaleur_bool
OuiN'importe lequelLa valeur à renvoyer si valeur_boolest vraie
valeur_true
OuiN'importe lequelLa valeur à renvoyer si valeur_boolest fausse
valeur_false
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.
ExemplesSi([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 toutesles 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 chiffred'affaires pour les autres lignes.
Rubriques associées• Si...Alors...Sinon
2012-05-10163
Fonctions, opérateurs et mots clés
6.1.9.13 LineNumber
DescriptionRenvoie le numéro de ligne dans un tableau
Groupe de fonctionsDivers
Syntaxeentier LineNumber()
RemarquesLa numérotation des lignes d'un tableau commence par l'en-tête, qui est la ligne 1.
ExemplesLineNumber() renvoie 2 lorsque la fonction apparaît au niveau de la deuxième ligne d'un tableau.
6.1.9.14 NameOf
DescriptionRenvoie le nom d'un objet
Groupe de fonctionsDivers
Syntaxechaîne NameOf(obj)
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
RemarquesLa fonction NameOf apparaît dans les en-têtes de colonne et de ligne des rapports ;.
ExemplesNameOf([Date de réservation]) renvoie "Date de réservation".
2012-05-10164
Fonctions, opérateurs et mots clés
6.1.9.15 NoFilter
DescriptionIgnore les filtres lors du calcul d'une valeur
Groupe de fonctionsDivers
Syntaxetype_saisie AucunFiltre(obj[;Tous|Explorer])
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
NonMot clé• Aucun mot clé spécifié : ignorer les filtres de rapportet de bloc
• Tout : ignorer tous les filtres• Exploration : ignorer les filtres de rapport et d'explo-
ration
Tout|Explora-tion
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(objet;Exploration) est appliqué.
ExemplesLorsque NoFilter(Somme([Chiffre d'affaires])) est placé dans un pied de bloc, le chiffred'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 tousles 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'affairesde tous les pays, même si un filtre d'exploration filtre la dimension [Pays].
2012-05-10165
Fonctions, opérateurs et mots clés
6.1.9.16 NumberOfPages
DescriptionRenvoie le nombre de pages dans un rapport
Groupe de fonctionsDivers
Syntaxeentier NumberOfPages()
ExemplesNumberOfPages() renvoie 2 si le rapport contient deux pages.
6.1.9.17 Page
DescriptionRenvoie le numéro de la page actuelle dans un rapport
Groupe de fonctionsDivers
Syntaxeentier Page()
ExemplePage()renvoie 2 s'il apparaît dans la deuxième page du rapport;
6.1.9.18 Previous
DescriptionRenvoie une valeur précédente d'un objet
Groupe de fonctionsDivers
2012-05-10166
Fonctions, opérateurs et mots clés
Syntaxetype_entrée Rank(dimension|indicateur|Auto[;(réinit_dims)][;décalage][;NonNul])
Entrée
ObligatoireTypeDescriptionParamètre
OuiDimension, indi-cateur ou motclé
La dimension ou l'indicateur dont la valeur précédenteest renvoyée par la fonction, ou le mot clé Auto
dimen-sion|indica-teur|Auto
NonListe DimensionLa liste des dimensions utilisées pour réinitialiser lecalcul
dimensio-ns_redéfi-nies
Non (la valeurpar défaut est 1)
EntierIndique la valeur de dimension ou d'indicateurprésentant un décalage de lignes avant la ligne ac-tuelle
offset
NonMot cléDemande à la fonction de renvoyer la première valeurnon nulle à partir du décalage
NonNul
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.
ExemplesPrevious([Pays)];1) renvoie les valeurs suivantes dans le tableau qui suit :
2012-05-10167
Fonctions, opérateurs et mots clés
PrécédentChiffre d'affairesPays
5 000 000US
Etats-Unis2 000 000Royaume-Uni
Royaume-Uni2 100 000France
Previous([Chiffre d'affaires)]) renvoie les valeurs suivantes dans le tableau qui suit :
PrécédentChiffre d'affairesPays
5 000 000US
5 000 0002 000 000Royaume-Uni
2 000 0002 100 000France
Previous([Chiffre d'affaires];([Pays]) renvoie les valeurs suivantes dans le tableau quisuit :
PrécédentChiffre d'affairesRégionPays
5 000 000NordEtats-Unis
5 000 0007 000 000Sud
3 000 000NordRoyaume-Uni
3 000 0004 000 000Sud
Previous([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau croisé qui suit :
Précédent2005Précédent2004
5 000 0006 000 0005 000 000US
2 000 0002 500 0002 000 000Royaume-Uni
3 000 0002 000 0003 000 000France
Previous([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau qui suit avecune rupture sur [Pays] :
PrécédentChiffre d'affairesRégionPays
5 000 000NordEtats-Unis
2012-05-10168
Fonctions, opérateurs et mots clés
5 000 0007 000 000Sud
12 000 000Etats-Unis
PrécédentChiffre d'affairesRégionPays
7 000 0003 000 000NordRoyaume-Uni
3 000 0004 000 000Sud
12 000 0007 000 000Royaume-Uni
Previous([Chiffre d'affaires]);2;NonNul) renvoie les valeurs suivantes dans le tableauqui suit :
PrécédentChiffre d'affairesTrimestreAnnée
500T12008
T22008
500400T32008
500700T42008
400300T12008
700T22008
300T32008
300200T42008
2*Previous(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Rubriques associées• Comparaison de valeurs à l'aide de la fonction Previous• Opérateur Auto
6.1.9.19 RefValue
2012-05-10169
Fonctions, opérateurs et mots clés
DescriptionRenvoie la valeur de référence d'un objet rapport lorsque le suivi de données est activé
Groupe de fonctionsDivers
Syntaxetype_entrée RefValue(obj)
ExemplesRefValue([Région ayant les meilleurs résultats]) renvoie "Sud-ouest" si la valeur dela 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
DescriptionRenvoie les valeurs antérieures ou suivantes d'un objet
Groupe de fonctionsDivers
Syntaxeinput_type RelativeValue(measure|detail;slicing_dims;offset)
Entrée
ObligatoireTypeDescriptionParamètre
OuiIndicateur oudétail
Tout indicateur ou détail d'une dimension dans le blocindicateur|dé-tail
OuiListe Dimen-sion
Les dimensions qui donnent le contexte du calculdim_décou-page
OuiEntierIndique la valeur de l'indicateur ou du détail qui estde offset lignes supprimées de la ligne actuelle
offset
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.
2012-05-10170
Fonctions, opérateurs et mots clés
Deux facteurs définissent l'ordre de tri : les tris appliqués aux dimensions de découpage et l'ordredans 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 dedécoupage.
• Toutes les dimensions de découpage doivent être présentes dans le bloc ou dans l'en-tête de sectiondu bloc dans lequel se trouve la fonction. Si une dimension de découpage est suppriméeulté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, leré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.
ExemplesLa colonne ValeurRelative du tableau ci-dessous contient le formule suivante :RelativeValue([Revenue];([Year]);-1)
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
1 000DurandT12007
2 000DupontT22007
1 500MartinT32007
3 000HarrisT42007
1 0004 000DurandT12008
2 0003 400DupontT22008
1 5002 000MartinT32008
3 0001 700HarrisT42008
Rubriques associées• #CALCUL• Comparaison de valeurs à l'aide de la fonction ValeurRelative
6.1.9.21 ReportName
DescriptionRenvoie le nom d'un rapport
2012-05-10171
Fonctions, opérateurs et mots clés
Groupe de fonctionsDivers
SyntaxeChaîne NomRapport()
ExemplesSi NomRapport() est placé dans un rapport appelé "Rapport des ventes", alors "Rapport des ventes"est renvoyé.
6.1.9.22 RowIndex
DescriptionRenvoie le numéro d'une ligne
Groupe de fonctionsDivers
Syntaxeentier 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.
ExemplesRowIndex renvoie 0 lorsqu'elle apparaît sur la première ligne d'un tableau.
6.1.9.23 UniqueNameOf
DescriptionRenvoie le nom unique d'un objet
Groupe de fonctionsDivers
Syntaxechaîne NomUniqueDe(obj)
2012-05-10172
Fonctions, opérateurs et mots clés
Entrée
ObligatoireTypeDescriptionParamètre
OuiObjet rapportTout objet rapportobj
ExemplesNomUniqueDe([Date de réservation]) renvoie "Date de réservation".
6.2 Opérateurs de fonction et de formule
Les opérateurs lient les différents composants dans une formule. Les formules peuvent contenir desopé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étiquesde base. Les opérateurs d'addition (+), de soustraction (-), de multiplication (*) et de division (/) permettentd'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énationde 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.
DescriptionOpérateur
Egal à=
Supérieur à>
Inférieur à<
2012-05-10173
Fonctions, opérateurs et mots clés
DescriptionOpérateur
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" pourtoutes 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ésdans des expressions booléennes qui renvoient True ou False.
6.2.3.1 Et (opérateur)
DescriptionL'opérateur Et relie des valeurs booléennes. Si toutes les valeurs booléennes reliées par Et renvoientTrue, la combinaison de toutes les valeurs renvoie également True.
Syntaxevaleur_bool Et valeur_bool [Et valeur_bool...]
ExemplesSi [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)
2012-05-10174
Fonctions, opérateurs et mots clés
DescriptionL'opérateur Ou relie les valeurs booléennes. Si une valeur booléenne reliée par Ou renvoie True, lacombinaison de toutes les valeurs renvoie également True.
Syntaxevaleur_bool Ou valeur_bool [Ou valeur_bool...]
ExemplesSi [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)
DescriptionL'opérateur Non renvoie l'inverse d'une valeur booléenne.
Syntaxebooléen Non(valeur_bool)
ExemplesSi Non([Pays] = "Etats-Unis") Alors "Pas Etats-Unis" renvoie "Pas Etats-Unis" si[Pays] a une valeur autre que "Etats-Unis".
6.2.3.4 Opérateur Entre
DescriptionL'opérateur Entre détermine si une variable est comprise entre deux valeurs.
Syntaxeboolé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.
ExemplesIf [Chiffre d'affaires] Entre(800000;900000) Alors "Revenu moyen" renvoie "Revenumoyen" si [Chiffres d'affaires] est compris entre 800 000 et 900 000.
2012-05-10175
Fonctions, opérateurs et mots clés
[Chiffre d'affaires] Entre (10000;20000) renvoie True si le chiffre d'affaires est comprisentre 10 000 et 20 000.
Si ([Chiffre d'affaires] Entre (200000;500000);"Revenu moyen";"Revenubas/élevé") renvoie "Revenu moyen" si [Chiffre d'affaires] est égal à 300 000.
Rubriques associées• Si...Alors...Sinon• Opérateur Où
6.2.3.5 DansListe (opérateur)
DescriptionL'opérateur DansListe détermine si une valeur fait partie d'une liste de valeurs.
Syntaxebooléen valeur_test DansListe(liste_valeurs)
RemarquesC'est la combinaison de valeur_test et de DansListe qui renvoie une valeur booléenne, et nonDansListe seul.
ExemplesSi Non ([Pays] DansListe("Angleterre";"Ecosse";"Pays de Galles")) Alors "PasGrande Bretagne" Sinon "Grande Bretagne" renvoie "Pas Grande Bretagne" si [Pays] n'estpas égal à "Angleterre", "Ecosse" ou "Pays de Galles", et renvoie "Grande Bretagne" dans le cascontraire.
Si [Lieu de séjour] DansListe("Bahamas Beach";"Hawaiian Club") Alors "Lieude séjour Etats-Unis" renvoie "Lieu de séjour Etats-Unis" si [Lieu de séjour] est égal à "BahamasBeach" ou "Hawaiian Club".
Rubriques associées• Si...Alors...Sinon• Opérateur Où
6.2.4 Opérateurs spécifiques à la fonction
2012-05-10176
Fonctions, opérateurs et mots clés
Certaines fonctions peuvent se servir d'opérateurs particuliers comme arguments. Par exemple, lafonction Previous peut avoir pour argument l'opérateur Lui-même.
Toutes les fonctions entourent les arguments avec ) et (. Les fonctions qui acceptent plusieursparamè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 à comptertoutes les valeurs, y compris les doublons.
Rubriques associées• Count• Opérateurs Distinct/Tout• NoFilter• Opérateurs Tout/Exploration
6.2.4.2 Opérateurs Tout/Exploration
DescriptionLes 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
DescriptionLes opérateurs Derniers/Premiers indiquent à la fonctionRank de classer par ordre croissant oudécroissant.• Premiers : établit un classement par ordre décroissant• Derniers : établit un classement par ordre croissant
2012-05-10177
Fonctions, opérateurs et mots clés
ExemplesRank([Chiffres d'affaires];([Pays]);Premiers classe les pays par ordre décroissant dechiffre d'affaires.
Rubriques associées• Rank
6.2.4.4 Opérateur Rupture
DescriptionL'opérateur Rupture invite la fonction Percentage à prendre en compte les ruptures de tableau.
ExemplesLa 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) :
PourcentageChiffre d'affairesTrimestreAnnée
10 %10 000T12005
20 %20 000T22005
30 %30 000T12006
40 %40 000T22006
La formule Pourcentage([Chiffre d'affaires];Rupture) donne le résultat indiqué dans letableau suivant (les pourcentages sont calculés sur le chiffre d'affaires total de chaque partie du bloc) :
PourcentageChiffre d'affairesTrimestreAnnée
33,3 %10 000T12005
66,6 %20 000T22005
42,9%30 000T12006
57,1%40 000T22006
2012-05-10178
Fonctions, opérateurs et mots clés
Rubriques associées• Pourcentage
6.2.4.5 Opérateurs Distinct/Tout
Les opérateurs Distinct/Tout indiquent à la fonction Count de compter les valeurs distinctesuniquement ou toutes les valeurs.
ExemplesCount([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• Count
6.2.4.6 Opérateur InclureVide
DescriptionL'opérateur InclureVide invite certaines fonctions d'agrégat à inclure des valeurs vides dans lescalculs.
ExemplesAverage([Chiffre d'affaires];InclureVide) renvoie 3 si [Chiffre d'affaires] a les valeurs(5;3;<vide>;4).
Rubriques associées• Average• Count• RunningAverage• RunningCount
2012-05-10179
Fonctions, opérateurs et mots clés
6.2.4.7 Opérateur Index
DescriptionL'opérateur Index indique aux fonctions UserResponse et RefValueUserResponse de renvoyerla clé primaire de la base de données de la réponse d'invite.
Rubriques associées• UserResponse• RefValueUserReponse
6.2.4.8 Opérateur Linéaire
DescriptionL'opérateur Linéaire stipule que la fonction Interpolation doit utiliser la régression linéaire avecl'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 encalculant une équation de droite de type f(x) = ax + b qui passe, le plus précisément possible, par toutesles valeurs disponibles de l'indicateur.
Rubriques associées• Interpolation
6.2.4.9 Opérateur NonNul
DescriptionL'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, enremontant à partir des lignes offset de la cellule située avant la ligne actuelle.
Rubriques associées• Previous
2012-05-10180
Fonctions, opérateurs et mots clés
6.2.4.10 Opérateur PasSurSaut
DescriptionL'opérateur PasSurRupture invite la fonction Interpolation à ignorer les ruptures de section etde bloc.
Rubriques associées• Interpolation
6.2.4.11 Opérateur PointAPoint
DescriptionL'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 detype f(x) = ax + b qui passe par les deux valeurs adjacentes à la valeur manquante.
Rubriques associées• Interpolation
6.2.4.12 Opérateurs Ligne/Col
DescriptionVous pouvez utiliser les opérateurs Ligne/Col pour définir le sens du calcul des fonctions suivantes :Percentage, RunningAverage, RunningCount, RunningMax, RunningMin, RunningProduct,RunningSum.
RemarquesL'opérateur Ligne calcule chaque valeur de la ligne sous la forme d'un pourcentage de la valeur totalede toutes les lignes du contexte d'incorporation. L'opérateur Col calcule chaque valeur de la colonnesous la forme d'un pourcentage de la valeur totale de toutes les colonnes du contexte d'incorporation.
2012-05-10181
Fonctions, opérateurs et mots clés
Dans un tableau croisé, par défaut, la valeur de chaque cellule est calculée sous la forme d'unpourcentage de la valeur totale du tableau croisé. L'opérateur Ligne calcule les valeurs des lignessous la forme de pourcentages de la valeur totale de la ligne. L'opérateur Col calcule les valeurs descolonnes sous la forme de pourcentages de la valeur totale de la colonne.
ExemplesDans un tableau croisé, Pourcentage([Indicateur]) donne le résultat suivant :
PourcentageIndicateurPourcentageIndicateur
50 %50010 %100
20 %20020 %200
Pourcentage([Indicateur];Ligne) donne le résultat suivant :
PourcentageIndicateurPourcentageIndicateur
83,3 %50016,7 %100
50 %20050 %200
Pourcentage([Indicateur];Col) donne le résultat suivant :
PourcentageIndicateurPourcentageIndicateur
83,3 %50033,3 %100
16,7 %20066,6 %200
L'opérateur Ligne calcule l'agrégat cumulatif par ligne. L'opérateur Col calcule l'agrégat cumulatif parcolonne.
Dans un tableau croisé, RunningSum([indicateur]) ou RunningSum([indicateur];Ligne)donne le résultat suivant :
RunningSumIndicateurRunningSumIndicateur
300200100100
950250700400
Dans un tableau croisé, RunningSum([Indicateur];Col) donne le résultat suivant :
RunningSumIndicateurRunningSumIndicateur
2012-05-10182
Fonctions, opérateurs et mots clés
700200100100
950250500400
Rubriques associées• Pourcentage• RunningAverage• RunningCount• RunningMax• RunningMin• RunningProduct• RunningSum
6.2.4.13 Opérateur Auto
DescriptionFait référence à la fonction Previous pour la cellule précédente si celle-ci ne contient pas d'objet derapport.
Exemples5 + 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• Previous
6.2.4.14 Opérateur Où
DescriptionL'opérateur Où limite les données utilisées pour calculer un indicateur.
ExemplesLa formule Average ([Chiffre d'affaires]) Où ([Pays] = "USA") calcule les ventesmoyennes où le pays est "USA".
2012-05-10183
Fonctions, opérateurs et mots clés
La formule Average ([Chiffre d'affaires]) Où ([Pays] = "USA" Ou [Pays] = "France") 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ù [Chiffred'affaires > 500 000]. Lorsque la variable [Chiffre d'affaires élevé] est placée dans un bloc, ellerenvoie le chiffre d'affaires lorsque sa valeur est supérieure à 500 000 ou bien aucune valeur. Lorsquela 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• Et (opérateur)• Opérateur Entre• DansListe (opérateur)• Ou (opérateur)• Pas (not x)
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. Letableau suivant répertorie les opérateurs contextuels :
DescriptionOpérateur
Spécifie une liste explicite de dimensions à utiliserdans le contexteDans
Ajoute des dimensions au contexte par défautPourChaque
Supprime des dimensions du contexte par défautPourTout
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte par défaut contient denombreuses dimensions. Il est souvent plus facile d'effectuer un ajout ou un retrait du contexte avecles 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.
2012-05-10184
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. Votrefournisseur de données contient aussi l'objet Trimestre, mais vous n'incluez pas cette dimension dansle bloc. Vous choisissez plutôt d'inclure une autre colonne qui affiche le revenu maximal par trimestrede chaque année. Votre rapport se présente comme suit :
Revenu trimestriel max.Revenu des ventesAnnée
2 660 699,50 €8 096 123,60 €2001
4 186 120,00 €13 232 246,00 €2002
4 006 717,50 €15 059 142,80 €2003
Vous pouvez voir d'où proviennent les valeurs de la colonne Revenu trimestriel maximum en examinantce bloc avec un bloc incluant la dimension Trimestre :
2012-05-10185
Fonctions, opérateurs et mots clés
Revenu des ventesTrimestreAnnée
2 660 699,50 €T12001
2 279 003,00 €T22001
1 367 841,00 €T32001
1 788 580,00 €T42001
2 660 699,50 €Max. :
Revenu des ventesTrimestreAnnée
3 326 172,00 €T1
2 840 651,00 €T2
2 879 303,00 €T3
4 186 120,00 €T4
4 186 120,00 €Max. :
Revenu des ventesTrimestreAnnée
3 742 989,00 €T1
4 006 717,50 €T2
3 953 395,00 €T3
3 356 041,00 €T4
4 006 717,50 €Max. :
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 maximumpré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 defaçon explicite le contexte de sortie dans cette formule.
2012-05-10186
Fonctions, opérateurs et mots clés
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 ladimension Trimestre, mais ne l'inclut pas dans le bloc :
Revenu trimestriel max.Revenu des ventesAnnée
2 660 699,508 096 123,602001
4 186 120,0013 232 246,002002
4 006 717,5015 059 142,802003
Il est possible de créer une formule pour la colonne Revenu trimestriel maximum n'incluant pasl'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 laformule 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 servantde l'opérateur PourChaque, vous ajoutez la dimension Trimestre au contexte, en donnant le contexted'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 vousvoulez ajouter une colonne qui présente le revenu total de chaque année, comme indiqué dans lebloc suivant :
2012-05-10187
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 ducontexte 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 supprimerTrimestre 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
DescriptionL'opérateur de plage (:) renvoie un ensemble de membres qui comprend deux membres d'un mêmeniveau et tous ceux qui se trouvent entre les deux.
Syntaxepremier_membre:dernier_membre
2012-05-10188
Fonctions, opérateurs et mots clés
Exemples[Géographie]&[EU].[Californie].[Los Angeles]:[Géographie]&[EU].[Californie].[San Francisco] renvoie [Los Angeles], [San Diego], [San Francisco] si les membres dece niveau viennent dans l'ordre ... [Los Angeles], [San Diego], [San Francisco]...
Sum([Chiffre d'affaires];{[Géographie]&[EU].[Californie].[Los Angeles]:[Géographie]&[EU].[Californie].[San Francisco]}) renvoie le chiffre d'affaires total pour LosAngeles, 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 defaire 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érencesfigées dans le code à des dimensions, elles restent valables même en cas d'ajout ou de suppressionde 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 dansun rapport : le mot-clé Bloc rassemble souvent les mêmes données que le mot-clé Section. La différenceentre les deux réside dans le fait que Bloc tient compte des filtres placés sur un bloc alors que Sectionles ignore.
Fait référence à…Placé dans…
Toutes les données du bloc, sans tenir comptedes ruptures, en respectant les filtresUn bloc
Toutes les données du bloc, sans tenir comptedes ruptures, en respectant les filtresUne rupture de bloc (en-tête ou pied)
Non applicableUne section (en-tête, pied ou à l'extérieur d'unbloc)
Non applicableA l'extérieur des blocs ou sections
2012-05-10189
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 rapportcontient une section basée sur Année. Le bloc est filtré de façon à exclure les troisième et quatrièmetrimestres.
La colonne Moyenne annuelle contient la formule
Average([Sales revenue] In Section)
et la colonne Moyenne du premier semestre contient la formuleAverage ([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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données du blocUn bloc
Toutes les données du blocUne rupture de bloc (en-tête ou pied)
2012-05-10190
Fonctions, opérateurs et mots clés
Fait référence à…Placé dans…
Toutes les données de la sectionUne section (en-tête, pied ou à l'extérieur d'unbloc)
Toutes les données du rapportA l'extérieur des blocs ou sections
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes, avec unerupture sur Année. Le rapport contient une section basée sur Année et une rupture au niveau deTrimestre.
CorpsRevenu des ventesTrimestreAnnée
2 660 699,52 660 700T12001
2 279 0032 279 003T2
1 367 840,71 367 841T3
1 788 580,41 788 580T4
8 096 123,62001
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 lacolonne 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 pourle 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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données dans la partie du bloc délimitépar un sautUn bloc
Toutes les données dans la partie du bloc délimitépar un sautUn saut de bloc (en-tête ou pied)
2012-05-10191
Fonctions, opérateurs et mots clés
Fait référence à…Placé dans…
Non applicableUne section (en-tête, pied ou à l'extérieur d'unbloc)
Non applicableA l'extérieur des blocs ou sections
Exemple : Mot clé Saut
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes :
Total SautRevenu des ventesTrimestreAnnée
8 096 124 €2 660 700 €T12001
8 096 124 €2 279 003 €T2
8 096 124 €1 367 841 €T3
8 096 124 €1 788 580 €T4
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, carle 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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données du rapportUn bloc
Toutes les données du rapportUne rupture de bloc (en-tête ou pied)
Toutes les données du rapportUne section (en-tête, pied ou à l'extérieur d'unbloc)
Toutes les données du rapportA l'extérieur des blocs ou sections
2012-05-10192
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 rapportcontient 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 desortie 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 sonemplacement dans un rapport :
Fait référence à…Placé dans…
Toutes les données de la sectionUn bloc
Toutes les données de la sectionUne rupture de bloc (en-tête ou pied)
Toutes les données de la sectionUne section (en-tête, pied ou à l'extérieur d'unbloc)
Non applicableA l'extérieur des blocs ou sections
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et Revenu des ventes.
2012-05-10193
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 desection se produit au niveau de l'objet Année. Sans le mot clé Section, cette colonne dupliquerait leschiffres 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 fonctionarrondit ou tronque la valeur qu'elle renvoie. Ce paramètre accepte un nombre entier supérieur, égalou inférieur à 0. Le tableau ci-dessous explique comment les nombres sont arrondis ou tronqués dansles différents cas :
2012-05-10194
Fonctions, opérateurs et mots clés
DescriptionParamètre
La fonction arrondit/tronque à <paramètre> décimales.
Exemples :
Round(3.13;1) renvoie 3,1
Round(3.157;2) renvoie 3,16
> 0
La fonction arrondit/tronque à l'entier le plus proche.
Exemples :
Truncate(3.7;0) renvoie 3
Truncate(4.164;0) renvoie 4
0
La fonction arrondit/tronque à la dizaine (paramètre = -1), à la centaine (paramètre= -2), au millier (paramètre = -3), etc., le plus proche.
Exemples :
Round(123.76;-1) renvoie 120
Round(459.9;-2) renvoie 500
Truncate(1600;-3) renvoie 1000
< 0
Remarque :Les nombres sont représentés de manière interne comme doubles et sont précis à seize chiffres près.
Rubriques associées• Round• Truncate• EuroConvertTo• EuroConvertFrom• EuroFromRoundError• EuroToRoundError
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 lasyntaxe [hiérarchie]&chemin.fonction. Les parties chemin et fonction sont facultatives.
2012-05-10195
Fonctions, opérateurs et mots clés
Dans chemin, faites référence à chaque membre entre crochets en séparant chacun par un point. Lesnoms 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 unehiérarchie. Dans les fonctions qui acceptent les ensembles de membres, placez {} autour de l'ensemblede membres.
Vous faites référence aux plages des membres utilisant un deux-points (:) entre le membre de débutet le membre de fin, et comportant le chemin d'accès complet spécifié pour chaque membre. Une plageinclut tous les membres du même niveau que celui des membres choisis.
Voici un exemple de syntaxe : [Hiérarchie des ventes]&[Type_Client].[ENTERPRISE];[Grande].[Nancy Davolio] : [Hiérarchie des ventes]&[Type_Client].[ENTERPRISE];[Grande].[Andrew Smith].
Exemple : Référence à des membres et des ensembles de membres
Vous disposez de la hiérarchie suivante :
Montant commandeHiérarchie Ventes
277 290 434Client_Type
180 063 361ENTERPRISE
113 905 997Grande
44 855 689Nancy Davolio
44 050 308Janet Leverling
30 000 000Andrew Smith
91 157 363GENERAL
• [Hiérarchie Ventes]&[Client_Type].[ENTREPRISE];[Grande].Enfants fait référenceaux membres [Nancy Davolio], [Janet Leverling] et [Andrew Smith].
• Sum([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].enfants}) renvoie 113 905 997 (la somme de l'indicateur des trois membres enfant).
• [Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Janet Leverling]fait référence au membre [Janet Leverling].
• Sum([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Janet Leverling];[Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Nancy Davolio]}) renvoie 88 905 997 (la somme de l'indicateur des deux membres).
• [Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Nancy Davolio]:[Hiérarchie des ventes]&[Type_Client].[ENTERPRISE].[Grande].[AndrewSmith] fait référence aux membres [Nancy Davolio], [Janet Leverling] et [Andrew Smith].
• Sum([Montant commande];{Hiérarchie Ventes]&[Client_Type].[ENTERPRISE].[Grande].[Nancy Davolio]:[Hiérarchie des ventes]&[Type_Client].[ENTER
2012-05-10196
Fonctions, opérateurs et mots clés
PRISE].[Grande].[Andrew Smith]}) renvoie 113 905 997 (la somme de l'indicateur pourles trois membres de la plage).
• [Hiérarchie Ventes].enfants fait référence à tous les membres de la hiérarchie [HiérarchieVentes].
• Sum([Montant commande];{Hiérarchie Ventes].enfants}) renvoie 277 290,434.
2012-05-10197
Fonctions, opérateurs et mots clés
2012-05-10198
Fonctions, opérateurs et mots clés
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 oud'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'aidede 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 ValeurRelative 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 unrapport.
Le message #CALCUL est lié à une mauvaise utilisation des opérateurs de contexte dans une formule.
Rubriques associées• ValeurRelative
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 apparaissentdans 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 sontincompatibles ; dans le cas de l'erreur #SYNCDONNEES, le contexte est inexistant car les dimensionsproviennent de plusieurs fournisseurs de données non synchronisés.
2012-05-10199
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, lemessage d'erreur #CONTEXTE apparaît parce qu'il n'est pas possible de regrouper le revenu paranné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éesdifférent dans un bloc qui contient des dimensions provenant d'un autre fournisseur de données, lesdeux fournisseurs de données n'étant pas synchronisés via une dimension fusionnée. #SYNCDONNEESapparaî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 comportantles objets (Année, Revenu) et (Trimestre), un bloc contenant Année, Trimestre et Revenu affichel'erreur #SYNCDONNEES dans les colonnes Années et Trimestre, car les deux fournisseurs dedonné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 estmathé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 lerevenu 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 ; lacolonne Revenu par article renvoie #DIV/0 pour ce trimestre, parce que la formule essaie d'effectuerune division par zéro, c'est-à-dire de diviser par zéro le nombre d'articles vendus.
7.1.5 #ERREUR
2012-05-10200
Dépannage des formules
#ERREUR est le message d'erreur par défaut qui couvre toutes les erreurs non couvertes par les autresmessages d'erreur.
7.1.6 #EXTERNE
#EXTERNE apparaît lorsqu'une formule fait référence à une fonction externe non disponible dans WebIntelligence.
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 sontincompatibles.
7.1.8 #MELANGER
#MELANGER apparaît lorsqu'un indicateur agrégé possède différentes unités. Par exemple, une celluleaffiche #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 valeursdans 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 ajoutezune 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".
2012-05-10201
Dépannage des formules
Une cellule ne peut pas afficher simultanément le revenu pour les Etats-Unis et la France. Placée endehors 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éedans une section car il n'existe qu'une valeur de Pays par section. Sinon, en dehors d'une section, laformule renvoie systématiquement l'erreur #VALEURMULTI.
7.1.10 #DEBORDEMENT
#DEPASSEMENT apparaît lorsqu'un calcul renvoie une valeur trop importante pour que le logicielpuisse 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 lerafraî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 nombrede 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 enfonction d'un objet qui dépend de l'ordre des valeurs. (Les objets qui utilisent la fonction Previous outoute fonction d'agrégation en cours d'exécution dépendent de l'ordre des valeurs). L'établissant d'unclassement engendre un nouveau calcul des valeurs de ces objets, ce qui modifie le classement etprovoque ainsi une dépendance circulaire. Une telle dépendance peut survenir lorsque vous utilisezla boîte de dialogue Classement pour générer un classement ou lorsque vous utilisez la fonction Rank.
2012-05-10202
Dépannage des formules
Exemple : Etablissement d'un classement de la moyenne cumulative ou des valeursprécédentes
Si vous essayez de classer un bloc dans une colonne qui contient la fonction Previous ou toutefonction 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épendancecirculaire.
Exemple : Utilisation de la fonction NumberOfPages()
Si vous placez la fonction NumberOfPages dans une cellule dont les propriétés Ajuster la hauteurautomatiquement ou Ajuster la largeur automatiquement sont définies, la cellule renvoie #RECURSIFcar le fait de placer cette formule dans une cellule ajustée automatiquement crée une dépendancecirculaire. La fonction a besoin de la taille exacte du rapport pour renvoyer une valeur mais la taillede 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ésd'une requête et ajoutés à nouveau. Les objets sont supprimés d'une requête lorsque la propriété derequête Activer la suppression des requêtes est activée et qu'ils ne contribuent à aucun rapportbasé 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.
2012-05-10203
Dépannage des formules
7.1.16 #SECURITE
L'erreur #SECURITE se produit lorsque vous essayez d'utiliser une fonction pour laquelle vous nedisposez 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 lafonction 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 lerapport.
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 moyenannuel. 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 contientrenvoie l'erreur #SYNTAXE.
7.1.18 #TOREFRESH
L'erreur #TOREFRESH apparaît dans les cellules basées sur des indicateurs intelligents lorsque lavaleur 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
2012-05-10204
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 appliquerde filtre à la requête. D'autres rapports basés sur la même requêtes risquant d'être affectés, aucunfiltre n'est appliqué.
2012-05-10205
Dépannage des formules
2012-05-10206
Dépannage des formules
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éedépend de la présentation du rapport.
Si vous voulez utiliser une fonctionnalité de comparaison plus puissante, utilisez la fonction ValeurRelative. 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• Previous• ValeurRelative• 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 renvoieces 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éespar les dimensions de découpage) pour renvoyer une valeur comparative. Les dimensions de sous-axecorrespondent à 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 lignesoffset de la ligne actuelle, et où les valeurs des dimensions de sous-axe sont identiques à celles dela ligne actuelle.
2012-05-10207
Comparaison de valeurs à l'aide de fonctions
Remarque :Toutes les dimensions de découpage se trouvent obligatoirement dans le contexte de calcul du blocdans lequel se trouve la fonction. Si une dimension de découpage est ensuite supprimée, la fonctionrenvoie 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).
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
1 000DurandT12007
2 000DupontT22007
1 500MartinT32007
3 000HarrisT42007
1 0004 000DurandT12008
2 0003 400DupontT22008
1 5002 000MartinT32008
3 0001 700HarrisT42008
Exprimée sous la forme d'une question sur l'activité, la formule renvoie le chiffre d'affaires généré parle 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 valeurprécédente de la liste de valeurs de l'objet [Année] et où les valeurs de [Trimestre] et de [Vendeur](les dimensions de sous-axe) sont identiques à celles de la ligne active.
Rubriques associées• ValeurRelative
8.2.1 Dimensions de découpage et fonction ValeurRelative
2012-05-10208
Comparaison de valeurs à l'aide de fonctions
La fonction ValeurRelative utilise la liste de valeurs des dimensions de découpage pour trouver laligne comparative. La fonction renvoie la valeur comparative de l'expression spécifiée dans la fonctionqui 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ésultatde 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).
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
1 000DurandT12007
2 000DurandT22007
1 500DurandT32007
3 000*DurandT42007
4 000DupontT12007
3 400DupontT22007
2 000DupontT32007
1 700DupontT42007
3 000*5 000**DurandT12008
5 000**3 000***DurandT22008
3 000***2 700****DurandT32008
2 700****6 800DurandT42008
Exprimée sous la forme d'une question sur l'activité, la formule renvoie le chiffre d'affaires généré parle 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 listede 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'affairescomparatif.
2012-05-10209
Comparaison de valeurs à l'aide de fonctions
TrimestreAnnée
T12007
T22007
T32007
*T42007
**T12008
***T22008
****T32008
T42008
L'ordre de tri des dimensions de découpage détermine le résultat de la fonction. Dans les tableaux,l'ordre de tri est signalé par le signe *.
Rubriques associées• ValeurRelative
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
ValeurRelativeChiffre d'affairesVendeurTrimestre
1 000DurandT1
2 000DurandT2
1 500DurandT3
3 000*DurandT4
2012-05-10210
Comparaison de valeurs à l'aide de fonctions
ValeurRelativeChiffre d'affairesVendeurTrimestre
4 000DupontT1
3 400DupontT2
2 000DupontT3
1 700DupontT4
2008
ValeurRelativeChiffre d'affairesVendeurTrimestre
3 000*5 000**DurandT1
5 000**3 000***DurandT2
3 000***2 700 ****DurandT3
2 700****6 800DurandT4
La fonction se sert de la liste des valeurs des dimensions de découpage pour trouver le chiffre d'affairescomparatif.
TrimestreAnnée
T12007
T22007
T32007
*T42007
**T12008
***T22008
****T32008
T42008
L'ordre de tri des dimensions de découpage détermine le résultat de la fonction. Dans les tableaux,l'ordre de tri est signalé par le signe *.
Rubriques associées• ValeurRelative
2012-05-10211
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ésultatde ValeurRelative, l'ordre dans lequel les dimensions de découpage sont spécifiées a une incidencesur 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)
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
1 000DurandT12007
2 000DurandT22007
1 500DurandT32007
3 000*DurandT42007
4 000DupontT12007
3 400DupontT22007
2 000DupontT32007
1 700DupontT42007
3 000*5 000**DurandT12008
5 000**3 000***DurandT22008
3 000***2 700****DurandT32008
2 700****6 800DurandT42008
Exprimée sous la forme d'une question sur l'activité, la formule renvoie le chiffre d'affaires généré parle même vendeur au trimestre précédent.
L'ordre de tri des dimensions de découpage est le suivant :
TrimestreAnnée
T12007
T22007
T32007
*T42007
2012-05-10212
Comparaison de valeurs à l'aide de fonctions
TrimestreAnnée
**T12008
***T22008
****T32008
T42008
La fonction devient :RelativeValue([Revenue];([Quarter];[Year]);-1)
L'ordre de tri des dimensions de découpage devient :
YearQuarter
*2007T1
**2008T1
***2007T2
****2008T2
*****2007T3
******2008T3
*******2007T4
********2008T4
L'impact de l'ordre de tri sur le résultat de la fonction est le suivant :
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
1 000*DurandT12007
2 000***DurandT22007
1 500*****DurandT32007
3 000*******DurandT42007
4 000DupontT12007
3 400DupontT22007
2 000DupontT32007
1 700DupontT42007
1 000*5 000**DurandT12008
2012-05-10213
Comparaison de valeurs à l'aide de fonctions
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
2 000***3 000****DurandT22008
1 500*****2 700******DurandT32008
3 000*******6 800********DurandT42008
Exprimée sous la forme d'une question sur l'activité, la formule renvoie maintenant le chiffre d'affairesgénéré par le même vendeur au même trimestre de l'année précédente.
La modification de l'ordre de tri de la dimension de découpage modifie la signification de la formule.Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées• ValeurRelative
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ésultatde la fonction, le tri appliqué à toutes les dimensions de découpage a une incidence sur le résultat dela 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 :
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
1 000DurandT12007
2 000DurandT22007
3 000DurandT42007
1 500*DurandT32007
4 000DupontT12007
3 400DupontT22007
1 700DupontT42007
2012-05-10214
Comparaison de valeurs à l'aide de fonctions
ValeurRelativeChiffre d'affairesVendeurTrimestreAnnée
2 000DupontT32007
1 500*5 000**DurandT12008
5 000**3 000***DurandT22008
3 000***6 800****DurandT42008
6 800****2 700DurandT32008
La liste triée des dimensions de découpage est la suivante :
TrimestreAnnée
T12007
T22007
T42007
*T32007
**T12008
***T22008
****T42008
T32008
Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées• ValeurRelative
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 dansles tableaux verticaux. La présentation des données dans un tableau croisé n'a pas d'incidence sur lerésultat de la fonction.
Rubriques associées• ValeurRelative
2012-05-10215
Comparaison de valeurs à l'aide de fonctions
2012-05-10216
Comparaison de valeurs à l'aide de fonctions
Informations supplémentaires
EmplacementRessources d'informations
http://www.sap.comInformations sur le produit SAPBusinessObjects
Naviguez vers http://help.sap.com/businessobjects/ et cliquez sur Tousles produits dans le panneau latéral "Présentation de SAP BusinessOb-jects".
Vous pouvez accéder à la toute dernière documentation relative auxproduits SAP BusinessObjects et à leur déploiement sur le portail SAPHelp Portal. Il est également possible de télécharger des versions PDFou des bibliothèques HTML installables.
Certains guides résident sur SAP Service Marketplace et ne sont, parconséquent, pas disponibles sur le portail SAP Help Portal. Le portaild'aide répertorie ces guides et propose un lien vers SAP Service Market-place. Les clients qui bénéficient d'un contrat de maintenance disposentd'un ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, co-ntactez votre support technique.
SAP Help Portal
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, guidesde migration et de mise à niveau, guides de déploiement, notes de versionet des documents concernant les plates-formes prises en charge. Lesclients qui bénéficient d'un contrat de maintenance disposent d'un IDutilisateur pour accéder à ce site. Pour obtenir un identifiant, contactezvotre support technique. Si vous êtes redirigé vers SAP Service Market-place à partir du site SAP Help Portal, utilisez le menu situé dans le pa-nneau de navigation à gauche pour sélectionner la catégorie contenantla documentation que vous souhaitez consulter.
SAP Service Marketplace
2012-05-10217
Informations supplémentaires
EmplacementRessources d'informations
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 commentairesinteractif.
Docupedia
https://boc.sdn.sap.com/
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibraryRessources à l'attention des déve-loppeurs
https://www.sdn.sap.com/irj/boc/businessobjects-articles
Ces articles étaient précédemment appelées notes techniques.Articles SAP BusinessObjects surSAP Community Network
https://service.sap.com/notes
Ces remarques étaient précédemment appelées des articles de la basede connaissances.
Remarques
https://www.sdn.sap.com/irj/scn/forumsForums sur SAP Community Net-work
http://www.sap.com/services/education
Nous pouvons vous fournir un module de formation qui réponde à vosbesoins et convienne à votre style d'apprentissage préféré, sous formede stage traditionnel ou de séminaires plus ciblés.
Formation
http://service.sap.com/bosap-support
Le site SAP Support Portal présente des informations sur les programmeset services de support technique. Il propose également des liens versde nombreuses informations techniques ainsi que des téléchargements.Les clients qui bénéficient d'un contrat de maintenance disposent d'unID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactezvotre support technique.
Support client en ligne
http://www.sap.com/services/bysubject/businessobjectsconsulting
Les consultants peuvent vous accompagner dans votre démarche, depuisla phase initiale d'analyse jusqu'à la phase finale de livraison de votreprojet de déploiement. Ils peuvent vous faire bénéficier de leur expertiseen matière de bases de données relationnelles et multidimensionnelles,de connectivité, d'outils de conception de base de données et de technologie d'intégration personnalisée.
Conseil
2012-05-10218
Informations supplémentaires
IndexSymboles
#ACTUALISER, message d'erreur 203#CALCUL, message d'erreur 170, 199#CLASSEMENT, message d'erreur
202#CONTEXTE, message d'erreur 199,
200#DEBORDEMENT, message d'erreur
202#DIV/0, message d'erreur 200#ERREUR, message d'erreur 128,
130, 131, 133, 145, 200#EXTERNE, message d'erreur 201#FORMULERAPPT, message d'erreur
203#INCOMPATIBLE, message d'erreur
199, 200, 201#INDISPONIBLE
et indicateurs intelligents 47#INDISPONIBLE, message d'erreur
46, 205et indicateurs intelligents 205
#MELANGER, message d'erreur 201#RECURSIF, message d'erreur 203#RESULTATPARTIEL, message
d'erreur 202et indicateurs intelligents 202
#SECURITE, message d'erreur 204#SYNCDONNEES, message d'erreur
199, 200#SYNTAXE, message d'erreur 204#TOREFRESH, message d'erreur 42,
46, 204et indicateurs intelligents 204
#VALEURMULTI, message d'erreur172
#VALEURMULTIPLE, messaged'erreur 201
A
Abs, fonction 127actualiser les données 42afficher l'auteur de documents 112afficher le propriétaire des documents
114afficher les informations de connexion
de l'auteur d'un document 112afficher les informations de connexion
du propriétaire d'un document 114
afficher les noms des diagrammes 156afficher les numéros de colonne 156afficher, date du dernier
enregistrement d'un document 114afficher, heure du dernier
enregistrement d'un document 115afficher, la date de création des
documents 113afficher, nombre de pages dans un
rapport 166afficher, noms d'univers 111afficher, noms des objets rapport 164afficher, noms des tableaux 156afficher, numéro de ligne 172afficher, numéros de page 166afficher, réponses aux invites 111Aggregate, fonction 52aggregation, fonctions
inclure plusieurs dimensions dans77
analyse, périmètreet indicateurs intelligents 43et regroupements 43
Ancestor, fonction 155appliquer, format aux nombres 79arrondir les nombres 127arrondir les valeurs 194Asc, fonction 75ASCII, valeurs 75
renvoyer des caractères associésà 76
Auto, opérateur 166, 183avancée, syntaxe 20
modifier le contexte de calcul pardéfaut à l'aide de 29
mot clé Bloc 36, 189mot clé Corps 37, 190mot clé Rapport 33, 38, 192mot clé Saut 35, 191mot clé Section 34, 193opérateur Dans 30, 184PourChaque (opérateur) 32, 187PourTout (opérateur) 32, 187
Average, fonction 53, 179à l'aide de mots clés de syntaxe
avancée 36, 189
B
Bloc, mot clé 36, 189BlockName, fonction 156
blocsafficher les noms 156
booléennes, expressionslier à l'opérateur Et 174renvoyer l'opposé de 175
booléennes, valeursidentifier 122tester 161, 163
C
calcul par défaut, contextesdans les ruptures 28dans les sections 27dans les tableaux horizontaux 26dans les tableaux verticaux 25modifier à l'aide d'une syntaxe
étendue 29tableaux croisés 26
calcul standard par défaut 11calculer des erreurs d'arrondi 131, 133calculer le sinus d'un angle 143calculer un centile 61calculer un logarithme en base 10 138calculer un logarithme naturel 137calculer un maximum cumulatif 65calculer un minimum cumulatif 66calculer un mode 59calculer un nombre cumulatif 64calculer un pourcentage 14calculer un produit cumulatif 68calculer une fonction exponentielle 134calculer une médiane 57calculer une moyenne cumulative 62calculer une racine carrée 144calculer une somme cumulative 69calculer, cosinus 128calculer, écart type 71calculer, écart type de population 72calculer, factoriel 135calculer, logarithme en base n 138calculer, moyenne 53calculer, pourcentage 60calculer, produit 62calculer, somme 72calculer, tangente 144calculer, une variance de population
74calculer, valeur maximum 56calculer, valeur minimale 58calculer, variance 73
2012-05-10219
calculspersonnalisés 11standard 11
calculs personnalisés 11calculs personnalisés, créer à l'aide de
formules 12caractères
afficher depuis des valeurs ASCII76
renvoyer les valeurs ASCII 75Ceil, fonction 127cellules
inclure du texte dans 13inclure les fonctions dans 13
centile 61chaînes
identifier 124chaînes de caractères
appliquer des règles d'encodageURL à 89
calculer la longueur de 82convertir en minuscules 83extraire des sections de 87faire correspondre à un modèle 83joindre/concaténer 18, 77, 173mettre en majuscules la première
lettre de 80mettre en majuscules les premières
lettres 89mettre en majuscules toutes les
premières lettres dans 89remplacer les parties de 85remplir avec d'autres chaînes 81,
86renvoyer les caractères les plus à
droite de 85renvoyer les caractères les plus à
gauche de 80répéter 77supprimer les espaces à droite 88supprimer les espaces à gauche
82, 88supprimer les espaces à la fin
d'une chaîne de caractères 87transformer en majuscules 88transformer en nombres 145
Char, fonction 76Children, fonction 146classement
et fonctions d'agrégat cumulatives202
classer les données 140Col, opérateur 62, 65, 66, 68, 69, 181colonnes
afficher les nombres de 156ColumnNumber, fonction 156
comparer les valeurs à l'aide dePrevious 207
comparer les valeurs à l'aide deRelativeValue 208, 210, 212, 214, 215
comparer les valeurs, à l'aide deRelativeValue 207
compter les valeurs 64compter, lignes dans les tableaux 164Concatenation, fonction 77concaténer des chaînes de caractères
77concaténer, chaînes de caractères 18,
173condition Si...Alors...Sinon 161conditionnels, opérateurs 19, 173Connection, fonction 101contexte, opérateurs 20contextes de calcul
contexte d'entrée 21contexte de sortie 21, 22définition 21et indicateurs intelligents 46modifier à l'aide d'une syntaxe
étendue 24par défaut 24
convertir à partir d'euros 128convertir en euros 130Corps, mot clé 37, 190Cos, fonction 128cosinus 128Count, fonction 54, 177, 179CurrentDate, fonction 90CurrentTime, fonction 90CurrentUser, fonction 157
D
Dans, opérateur 30, 184DansListe, opérateur 19, 174, 176DataProvider, fonction 102DataProviderKeyDate, fonction 103DataProviderKeyDateCaption, fonction
103DataProviderSQL, fonction 104DataProviderType, fonction 105dates
calculer les dates relatives 97identifier 120mettre en forme 78, 100
DayName, fonction 91DayNumberOfMonth, fonction 91DayNumberOfWeek, fonction 92DayNumberOfYear, fonction 93DaysBetween, fonction 93
découpage, dimensions 207et les sections 210impact de l'ordre de tri 208, 212,
214ordre 212
Depth, fonction 147Derniers, opérateur 140, 177Descendants, fonction 148devises
convertir entre deviseseuropéennes 128, 130
devises européennesconvertir entre 128, 130
diagrammesafficher les noms 156
dimensionsajouter au contexte de calcul 32,
187dimensions de découpage 207,
208et message d'erreur
#INCOMPATIBLE 201et message d'erreur
#SYNCDONNEES 200et regroupements 45inclure plusieurs dimensions dans
les fonctions d'agrégat 77spécifier dans le contexte de calcul
30, 184supprimer du contexte de calcul
32, 187Distinct, opérateur 179document, afficher les paramètres
régionaux 158document, paramètres régionaux
afficher 158DocumentAuthor, fonction 112DocumentDate, fonction 114DocumentName, fonction 114DocumentOwner, fonction 114DocumentPartiallyRefreshed, fonction
115documents
afficher l'auteur 112afficher l'heure du dernier
enregistrement 115afficher la date de création 113afficher la date du dernier
enregistrement 114afficher le nom de 114afficher le propriétaire de 114visualiser les requêtes dans 117
DocumentTime, fonction 115données
actualiser 42
2012-05-10220
Index
données de référencerenvoyer la date de 109
DrillFilters, fonction 116
E
écart type 71écart type, population 72Editeur de formule
afficher la syntaxe de la fonctiondans 14
Eléments de même niveau, fonction154
Entre, opérateur 19, 174, 175entrée, contexte
définition 21erreurs
identifier 121erreurs d'arrondi 131, 133espaces à droite
supprimer des chaînes decaractères 87, 88
espaces à gauchesupprimer des chaînes de
caractères 82, 88Et, opérateur 19, 174étendue, syntaxe
opérateur Dans 29, 184opérateur PourTout 29, 184PourChaque (opérateur) 29, 184PourTout (opérateur) 29, 184
EuroConvertFrom, fonction 128, 194EuroConvertTo, fonction 130, 194EuroFromRoundError, fonction 131,
194euros
convertir à partir de 128convertir en 130
EuroToRoundError , fonction 194EuroToRoundError, fonction 133Even, fonction 119Exp, fonction 134Exploration, opérateur 165, 177exponentielle, fonction 134
F
Fact, fonction 135factoriel 135Fill, fonction 77filtres
afficher les filtres d'exploration 177afficher tout 177bloc 118et indicateurs intelligents 48explorer 177
filtres (suite)filtrer des indicateurs intelligents
47filtres d'exploration 48rapport 118, 177section 118sur les dimensions 46
filtres d'exploration 177afficher 177et indicateurs intelligents 48ignorer 177
filtres de rapport 118, 177ignorer 177visualiser un résumé 118
filtres sur les dimensionsimpact sur les indicateurs
intelligents de 46First, fonction 55Floor, fonction 135fonction, syntaxe
exemple 14fonctions
Abs 127Aggregate 52Ancestor 155Asc 75Average 36, 53, 179, 189BlockName 156catégories 51Ceil 127Char 76Children 146ColumnNumber 156combiner avec du texte dans les
cellules 13Comparer 83Concatenation 77Connection 101Cos 128Count 54, 177, 179CurrentDate 90CurrentTime 90CurrentUser 157DataProvider 102DataProviderKeyDate 103DataProviderKeyDateCaption 103DataProviderSQL 104DataProviderType 105DateRelative 97DayName 91DayNumberOfMonth 91DayNumberOfWeek 92DayNumberOfYear 93DaysBetween 93définition 13Depth 147
fonctions (suite)Descendants 148DocumentAuthor 112DocumentCreationDate 113DocumentCreationTime 113DocumentDate 114DocumentName 114DocumentOwner 114DocumentPartiallyRefreshed 115DocumentTime 115DrillFilters 116EcartTypeP 72éléments de même niveau 154EnDate 100EnNombre 145EuroConvertFrom 128, 194EuroConvertTo 130, 194EuroFromRoundError 131, 194EuroToRoundError 133, 194Even 119exemples 14Exp 134Fact 135faire référence à des ensembles
de membres dans 195faire référence à des membres
dans 195First 55Floor 135fonction DocumentCreationDate
113fonction DocumentCreationTime
113fonction Interpolation 181fonction LastExecutionTime 107fonction Percentage 181fonction RunningAverage 181fonction RunningCount 181fonction RunningMax 181fonction RunningMin 66, 181fonction RunningProduct 181fonction RunningSum 181ForceMerge 157FormatDate 78FormatNumber 79GetContentLocale 158GetDominantPreferredViewingLocale
159GetLocale 159GetLocalized 160GetPreferredViewingLocale 161HTMLEncode 79If 19, 163, 173InitCap 80insérer dans des cellules 13Interpolation 136, 180, 181
2012-05-10221
Index
fonctions (suite)IsDate 120IsError 121IsLeaf 150IsLogical 122IsNull 122IsNumber 123IsPromptAnswered 105IsString 124IsTime 125Key 151Lag 152Last 56LastDayOfMonth 94LastDayOfWeek 94LastExecutionDate 106LastExecutionDuration 107Left 80LeftPad 81LeftTrim 82LineNumber 164Ln 137Log 138Log10 138Longueur 82Majuscule 88Max 32, 56, 187médiane 57Min 58Minuscule 83Mod 139Mode 59Month 95MonthNumberOfYear 95MonthsBetween 96NameOf 164NoFilter 165, 177NomDeUnivers 111NomUniqueDe 172NumberOfDataProviders 108NumberOfPages 166, 203NumberOfRows 108Odd 126Page 166Parent 153Percentage 14, 60, 178, 181Percentile 61Pos 84Power 139Previous 166, 180, 183, 202, 207Product 62PromptSummary 117Quarter 97QuerySummary 117Racine 144Rank 140, 177
fonctions (suite)RefValue 169RefValueDate 109RefValueUserResponse 110, 180Remplacer 85Répéter 77ReportFilter 118ReportFilterSummary 118ReportName 171Right 85RightPad 86RightTrim 87Round 142, 194RowIndex 172RunningAverage 62, 179, 181RunningCount 64, 179, 181RunningMax 65, 181RunningMin 66, 181RunningProduct 68, 181RunningSum 69, 181Sign 143Sin 143StdDev 71Substr 87Sum 14, 32, 33, 34, 35, 37, 38, 72,
187, 190, 191, 192, 193Sum, fonction 72SupprEspace 88syntaxe de la fonction 14Tan 144Truncate 145, 194URLEncode 89UserResponse 14, 111, 180ValeurRelative 170, 199, 207, 210,
212, 214, 215ValeurServeur 70Var 73VarP 74Week 100WordCap 89Year 101
fonctions caractèredescription 51
fonctions d'agrégatdescription 51
fonctions d'agrégat cumulativeset classement 202et message d'erreur
#CLASSEMENT 202fonctions de date et d'heure
description 51fonctions diverses
description 51fonctions document
description 51
fonctions du fournisseur de donnéesdescription 51
fonctions logiquesdescription 51
fonctions numériquesdescription 51
ForceMerge, fonction 157FormatDate, fonction 78FormatNumber, fonction 79formules
créer des calculs personnalisés àl'aide de 12
et indicateurs intelligents 45indicateurs intelligents dans 46messages d'erreur générés par
199simplifier avec des variables 12, 17utilisation des opérateurs dans 18,
173formules, messages d'erreur 199fournisseurs de données 108
afficher le nom de l'univers 111afficher le nombre de lignes dans
108visualiser le code SQL généré par
104
G
GetContentLocale, fonction 158GetDominantPreferredViewingLocale,
Fonction 159GetLocale, fonction 159GetLocalized, fonction 160GetPreferredViewingLocale, fonction
161guide des fonctions, formules et
calculs, utilisationà propos de 9
H
heure, valeursidentifier 125
HTMLEncode, fonction 79
I
identifier les nombres impairs 119, 126identifier les nombres pairs 119, 126identifier, chaînes 124identifier, dates 120identifier, erreurs 121identifier, nombres 123identifier, valeurs booléennes 122
2012-05-10222
Index
identifier, valeurs d'heure 125identifier, valeurs nulles 122If, fonction 19, 163, 173Impair, fonction 126InclureVide, opérateur 179Index, opérateur 111indicateur, valeurs
interpoler 136, 181indicateurs
et contextes de calcul par défaut24
indicateurs intelligents définis 41renvoyer les valeurs précédentes
170renvoyer les valeurs suivantes 170
indicateurs intelligentsdéfinition 41et calculs standards 11et filtres d'exploration 48et formules 45, 46et l'erreur #INDISPONIBLE 47et message d'erreur
#INDISPONIBLE 205et message d'erreur
#RESULTATPARTIEL 202et message d'erreur
#TOREFRESH 204et opérateurs de contexte 46et périmètre d'analyse 43et regroupements 41et variables 45filtrer 47impact des filtres sur 46impossibilité de calculer 205
indicateurs intelligents, filtrer 47individuelles, cellules
et message d'erreur#VALEURMULTI 201
InitCap, fonction 80Interpolation, fonction 136, 180, 181interpoler des valeurs d'indicateur 136,
181interpoler, valeurs d'indicateur 181invites
afficher les réponses 14, 111afficher les réponses de 110
IsDate, fonction 120IsError, fonction 121IsLeaf, fonction 150IsLogical, fonction 122IsNull, fonction 122IsNumber, fonction 123IsPromptAnswered, fonction 105IsString, fonction 124IsTime, fonction 125
J
joindre des chaînes de caractères 18, 77, 173
K
Key, fonction 151
L
Lag, fonction 152Last, fonction 56LastDayOfMonth, fonction 94LastDayOfWeek, fonction 94LastExecutionDate, fonction 106LastExecutionDuration, fonction 107LastExecutionTime, fonction 107Left, fonction 80LeftPad, fonction 81LeftTrim, fonction 82Length, fonction 82Ligne, opérateur 62, 65, 66, 68, 69,
181lignes
afficher le nombre de lignes dansle fournisseur de données 108
afficher le numéro de ligne 172compter dans les tableaux 164compter les valeurs distinctes 177compter toutes les valeurs 177
Linéaire, opérateur 136, 180LineNumber, fonction 164Ln, fonction 137Log, fonction 138Log10, fonction 138logarithme naturel 137logarithmes 137, 138logarithmes en base 10 138logarithmes en base n 138Lower, fonction 83
M
Match, fonction 83mathématiques, opérateurs 18, 173Max, fonction 56
utiliser avec les opérateurs decontexte 32, 187
maximum, calcul standard 11maximum, valeurs
calculer un maximum cumulatif 65Median, fonction 57médiane 57
membresfaire référence dans les fonctions
195membres, ensemble
faire référence dans les fonctions195
messages d'erreur#ACTUALISER 203#CALCUL 170, 199#CLASSEMENT 202#CONTEXTE 199, 200#DEBORDEMENT 202#DIV/0 200#ERREUR 128, 130, 131, 133,
145, 200#EXTERNE 201#FORMULERAPPT 203#INCOMPATIBLE 199, 200, 201#INDISPONIBLE 46, 205#MELANGER 201#RECURSIF 203#RESULTATPARTIEL 202#SECURITE 204#SYNCDONNEES 199, 200#SYNTAXE 204#TOREFRESH 42, 46, 204#VALEURMULTI 172, 201
Min, fonction 58minimum, calcul standard 11minimum, valeurs
calculer un minimum cumulatif 66Mod, fonction 139mode 59Mode, fonction 59Month, fonction 95MonthNumberOfYear, fonction 95MonthsBetween, fonction 96mots clés
Bloc 36, 189Corps 37, 190mots clés de la syntaxe étendue
33, 189rapport 33, 38, 192rendre les rapports génériques
avec 38Saut 35, 191Section 34, 193
moyennecalculer une moyenne cumulative
62moyenne, calcul standard 11multiplier des nombres 62, 68
N
NameOf, fonction 164
2012-05-10223
Index
NoFilter, fonction 165, 177nombre cumulatif 64nombre, calcul standard 11nombre, calculer la valeur absolue 127nombres
arrondir 127, 142arrondir à inférieur 135arrondir les nombres 142arrondir les nombres par défaut
135calculer un modulo 139déterminer si impair ou pair 119,
126diviser 139élever à une puissance 139identifier 123mettre en forme 79modulo 139multiplier 62, 68transformer des chaînes de
caractères en 145tronquer 145tronquer des nombres 145
nombres impairsidentifier 119, 126
nombres pairsidentifier 119, 126
Non, opérateur 19, 174, 175NonNul, opérateur 166, 180nulles, valeurs
identifier 122NumberOfDataProviders, fonction 108NumberOfPages, fonction 166
et message d'erreur #RECURSIF203
NumberOfRows, fonction 108numéros de page
afficher dans les rapports 166
O
objetsafficher le nom de 172visualiser des filtres sur 118
opérateursAuto 166, 183Bas 140Col 62, 64, 65, 66, 68, 69, 181conditionnels 19, 173contexte 20Dans 30, 184DansListe 19, 174, 176définir 188définition 18, 173Derniers 177Distinct 179
opérateurs (suite)Entre 19, 174, 175Et 19, 174Exploration 165, 177InclureVide 64, 179Index 111, 180Ligne 62, 64, 65, 66, 68, 69, 181Linéaire 136, 180logiques 19, 174mathématiques 18, 173Non 19, 174, 175NonNul 166, 180opérateur Index 180opérateurs spécifiques à la fonction
20, 176Ou 19, 174Où 183PasSurSaut 136, 181plage 188PointAPoint 136, 181PourChaque 32, 187PourTout 32, 38, 187Premiers 140, 177Rupture 178spécifiques à la fonction 20, 176Tout 165, 177, 179
opérateurs définis 188opérateurs logiques 19, 174ordre de tri
et dimensions de découpage 208, 212, 214
Ou, opérateur 19, 174Où, opérateur 183
P
Page, fonction 166pages
afficher le nombre de pages dansles rapports 166
paramètres régionauxafficher les paramètres régionaux
de document 158afficher les paramètres régionaux
de visualisation préférésdominants 159
afficher les paramètres régionauxdu produit 159
paramètres régionaux de visualisationpréférés dominants, afficher 159
paramètres régionaux de visualisationpréférés, afficher 161
paramètres régionaux de visualisationpréférés, dominantsafficher 159
Parent, fonction 153
PasSurRupture, opérateur 136, 181Percentage, fonction 14, 60Percentile, fonction 61personnalisés, calculs
utiliser des formules pour créer 12plage, opérateur 188PointAPoint, opérateur 136, 181Pos, fonction 84pourcentage, calcul standard 11PourChaque, opérateur 32, 187PourTout, opérateur 32, 38, 187Power, fonction 139Preferred Viewing Locale
afficher 161Premiers, opérateur 140, 177Previous, fonction 166, 180, 183
comparer des valeurs 207et message d'erreur
#CLASSEMENT 202Product, fonction 62produit, afficher les paramètres
régionaux 159produit, paramètres régionaux
afficher 159produits
calculer un produit cumulatif 68PromptSummary, fonction 117propriétés de requête
Nombre max. de lignes extraites202
Q
Quarter, fonction 97QuerySummary, fonction 117
R
racine carrée 144Rank, fonction 140, 177Rapport, mot clé 33, 38, 192rapports
afficher le nombre de pages dans166
afficher les noms des objets dans164
afficher les numéros de page dans166
visualiser les noms de 171RefValue, fonction 169RefValueDate, fonction 109RefValueUserReponse, fonction 110RefValueUserResponse, fonction 180regroupements 41
définition 41et opérateur UNION 43
2012-05-10224
Index
regroupements (suite)et périmètre d'analyse 43exemple de gestion de 43gestion de 42
RelativeDate, fonction 97RelativeValue, fonction
comparer des valeurs 210, 212, 214
et dimensions de découpage 210et les sections 210
Remplace, fonction 85ReportFilter, fonction 118ReportFilterSummary, fonction 118ReportName, fonction 171requêtes
visualiser un résumé 117Right, fonction 85RightPad, fonction 86RightTrim, fonction 87Round, fonction 142, 194RowIndex, fonction 172RunningAverage, fonction 62, 179RunningCount, fonction 64, 179RunningMax, fonction 65RunningProduct, fonction 68RunningSum, fonction 69Rupture, opérateur 178ruptures
contextes de calcul par défaut dans28
S
Saut, mot clé 35, 191Section, mot clé 34, 193sections
contextes de calcul par défaut dans27
et dimensions de découpage 210et la fonction ValeurRelative 210
Sign, fonction 143simplifier des formules avec des
variables 12, 17Sin, fonction 143sinus 143somme, calcul standard 11sortie, contexte
définition 22SQL 104
et actualisation des données 42et regroupements 41, 42
SQL (suite)opérateur GROUPING SETS 43UNION, opérateur 41, 43
Sqrt, fonction 144standard, calculs 11StdDev, fonction 71StdDevP, fonction 72Substr, fonction 87Sum, fonction 14
à l'aide de mots clés de syntaxeavancée 34, 35, 37, 38, 190, 191, 193
à l'aide de mots clés de syntaxeétendue 33, 192
utiliser avec les opérateurs decontexte 32, 187
syntaxe avancée, mots clés 33, 189rendre les rapports génériques
avec 38utiliser avec la fonction Average
36, 189utiliser avec la fonction Sum 33,
34, 35, 37, 190, 191, 192, 193syntaxe de la fonction, afficher 14
T
tableauxafficher les noms 156compter les lignes dans 164horizontaux 26verticaux 25
tableaux croiséscontextes de calcul par défaut dans
26et la fonction ValeurRelative 215
tableaux horizontauxcontextes de calcul par défaut dans
26Tan, fonction 144tangentes 144tester, valeurs booléennes 161, 163ToDate, fonction 100ToNumber, fonction 145Tout, opérateur 165, 177, 179Trim, fonction 88tris
et dimensions de découpage 208, 212, 214
tronquer les valeurs 194Truncate, fonction 145, 194
U
UNION, opérateur 43UniqueNameOf, fonction 172univers
afficher les noms 111UniverseName, fonction 111Upper, fonction 88URL
appliquer des règles d'encodage à89
URLEncode, fonction 89UserResponse, fonction 14, 111, 180
V
ValeurRelative, fonction 170comparer des valeurs 207, 208,
215et dimensions de découpage 208,
214et message d'erreur #CALCUL 199et tableaux croisés 215
valeursarrondir 194comparer à l'aide de Previous 207comparer à l'aide de RelativeValue
207, 208, 210, 212, 214, 215compter 54, 64précision de 194tronquer 194
ValeurServeur, fonction 70Var, fonction 73variables
et indicateurs intelligents 45simplifier les formules avec 12, 17
variance 73variance, population 74VarP, fonction 74vertical, tableau
contextes de calcul par défaut dans25
W
Week, fonction 100WordCap, fonction 89
Y
Year, fonction 101
2012-05-10225
Index
2012-05-10226
Index
Recommended