SAP XI 3.1 Mode d'emploi
Vous trouverez ci-dessous de brèves informations pour XI 3.1 Web Intelligence. Ce guide vous aide à maîtriser les fonctions, les formules et les calculs disponibles dans Web Intelligence pour personnaliser vos rapports et analyses de données. Apprenez à créer des formules complexes, à manipuler les contextes de calcul et à résoudre les erreurs de formule.
Utilisation de fonctions, formules et calculs dans Web Intelligence
Web Intelligence XI 3.1
Copyright © 2008 Business Objects, an SAP company. Tous droits réservés. Business Objects est propriétaire des brevets américains suivants, qui peuvent porter sur des produits proposés et concédés sous licence par Business Objects : 5 295 243 ; 5 339 390 ;
5 555 403 ; 5 590 250 ; 5 619 632 ; 5 632 009 ; 5 857 205 ; 5 880 742 ; 5 883 635 ;
6 085 202 ; 6 108 698 ; 6 247 008 ; 6 289 352 ; 6 300 957 ; 6 377 259 ; 6 490 593 ;
6 578 027 ; 6 581 068 ; 6 628 312 ; 6 654 761 ; 6 768 986 ; 6 772 409 ; 6 831 668 ;
6 882 998 ; 6 892 189 ; 6 901 555 ; 7 089 238 ; 7 107 266 ; 7 139 766 ; 7 178 099 ;
7 181 435 ; 7 181 440 ; 7 194 465 ; 7 222 130 ; 7 299 419 ; 7 320 122 et 7 356 779.
Business Objects et ses logos, BusinessObjects, Business Objects Crystal Vision,
Business Process On Demand, BusinessQuery, Cartesis, Crystal Analysis, Crystal
Applications, Crystal Decisions, Crystal Enterprise, Crystal Insider, Crystal Reports,
Crystal Vision, Desktop Intelligence, Inxight et ses logos, LinguistX, Star Tree,
Table Lens, ThingFinder, Timewall, Let There Be Light, Metify, NSite, Rapid Marts,
RapidMarts, le design de Spectrum, Web Intelligence, Workmail et Xcelsius sont des marques ou des marques déposées de Business Objects ou de ses sociétés affiliées aux Etats-Unis et dans d'autres pays. SAP est une marque déposée ou non de SAP AG en Allemagne et dans d'autres pays. Tous les autres noms mentionnés peuvent être des marques de leurs propriétaires respectifs.
Tiers contributeurs
Les produits Business Objects de cette version peuvent contenir des redistributions de logiciels sous licence de tiers contributeurs. Certains de ces composants peuvent
également être disponibles sous d'autres licences. La liste non exhaustive des tiers contributeurs mentionnés ainsi que les mentions obligatoires associées sont disponibles à l'adresse suivante : http://www.businessobjects.com/thirdparty.
2008-09-11
Table des matières
Chapitre 1 A propos de ce guide 7
Chapitre 2 Utilisation de calculs standard et personnalisés 9
Utilisation de calculs standard et personnalisés dans les rapports...........10
Utilisation de formules pour créer des calculs personnalisés..............11
Utilisation des fonctions........................................................................13
Chapitre 3 Notions de contextes de calcul 23
Définition des contextes de calcul.............................................................24
Contexte d'entrée.................................................................................25
Contexte de sortie................................................................................26
Contextes de calcul par défaut..................................................................28
Contextes par défaut dans un tableau vertical.....................................29
Contextes par défaut dans un tableau horizontal.................................30
Contextes par défaut dans un tableau croisé.......................................31
Contextes par défaut dans une section................................................32
Contextes par défaut dans une rupture................................................33
Opérateurs contextuels de syntaxe avancée.......................................35
Mots clés de la syntaxe avancée Web Intelligence..............................39
Chapitre 4 Fonctions, opérateurs et mots clés de Web Intelligence 49
Fonctions Web Intelligence........................................................................50
Fonction Agrégat..................................................................................50
Utilisation de fonctions, formules et calculs dans Web Intelligence 3
Table des matières
Fonctions du groupe Caractère............................................................78
Fonctions Date et heure.......................................................................97
Fonctions du groupe Fournisseur de données...................................111
Fonctions Document..........................................................................125
Fonctions du groupe Logique.............................................................137
Fonctions du groupe Numérique........................................................147
Fonctions diverses.............................................................................172
Opérateurs de fonction et de formule Web Intelligence..........................191
Opérateurs mathématiques................................................................192
Opérateurs conditionnels...................................................................192
Opérateurs logiques...........................................................................193
Opérateurs spécifiques à la fonction..................................................196
Opérateurs contextuels de syntaxe avancée.....................................206
Mots clés de la syntaxe avancée Web Intelligence.................................210
Mot clé Rupture..................................................................................213
Mot clé Rapport..................................................................................214
Chapitre 5 Dépannage des formules Web Intelligence 217
Messages d'erreur de formule et d'information.......................................218
#CONTEXTE......................................................................................218
#SYNCDONNEES..............................................................................219
#INCOMPATIBLE...............................................................................220
#VALEURMULTI.................................................................................220
#DEBORDEMENT.............................................................................221
#RESULTATPARTIEL.........................................................................221
#CLASSEMENT.................................................................................221
4 Utilisation de fonctions, formules et calculs dans Web Intelligence
Table des matières
#RECURSIF.......................................................................................222
#SECURITE.......................................................................................222
#SYNTAXE.........................................................................................223
#TOREFRESH...................................................................................223
#INDISPONIBLE................................................................................223
#ERREUR..........................................................................................224
Chapitre 6 Calcul de valeurs à l'aide d'indicateurs intelligents 225
Regroupements et indicateurs intelligents...............................................226
Gestion des regroupements par Web Intelligence.............................227
Indicateurs intelligents et périmètre d'analyse.........................................228
Indicateurs intelligents et SQL.................................................................228
Regroupements et opérateur UNION.................................................228
Indicateurs intelligents et formules..........................................................231
Indicateurs intelligents et dimensions contenant des formules..........231
Indicateurs intelligents dans les formules..........................................232
Indicateurs intelligents et filtres sur les dimensions...........................233
Indicateurs intelligents et filtres d'exploration.....................................233
Chapitre 7 Comparaison de valeurs à l'aide des fonctions de Web Intelligence235
Comparaison de valeurs à l'aide de la fonction Précédent.....................236
Comparaison de valeurs à l'aide de la fonction ValeurRelative...............236
Dimensions de découpage et fonction ValeurRelative.......................238
Dimensions de découpage et sections..............................................240
Ordre des dimensions de découpage................................................242
Dimensions de découpage et tris.......................................................245
Utilisation de ValeurRelative dans les tableaux croisés.....................247
Utilisation de fonctions, formules et calculs dans Web Intelligence 5
Table des matières
6 Utilisation de fonctions, formules et calculs dans Web Intelligence
A propos de ce guide
1
1
A propos de ce guide
Le guide Utilisation de fonctions, formules et calculs dans Web Intelligence propose des informations détaillées sur les fonctions de calcul avancées de
Web Intelligence. Il s'agit également d'un guide de référence syntaxique pour les fonctions et opérateurs Web Intelligence.
Les informations sont génériques et ne font pas référence à l'interface
Web Intelligence. Pour en savoir plus sur l'utilisation des fonctions liées aux calculs dans les documents Web Intelligence (ajout d'une variable ou d'une formule à un rapport, par exemple), voir Analyse en direct avec
Web Intelligence, Création de rapports à l'aide de l'Editeur de rapport Java et Guide de l'utilisateur de Web Intelligence Rich Client.
8 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
Utilisation de calculs standard et personnalisés dans les rapports
Vous pouvez vous servir des fonctions de calcul standard pour opérer des calculs rapides sur les données des rapports Web Intelligence. Si les calculs standard ne répondent pas suffisamment à vos besoins, vous pouvez utiliser le langage des formules Web Intelligence pour créer des calculs personnalisés.
Calculs standard
Vous pouvez vous servir des fonctions de calcul standard pour opérer des calculs rapides sur les données des rapports Web Intelligence. Les calculs standard suivants sont disponibles :
Calcul
Somme
Nombre
Moyenne
Minimum
Maximum
Description
Calcule la somme des données sélectionnées.
Compte toutes les lignes d'un objet de type indicateur ou compte les différentes lignes d'un objet de type dimension ou information.
Calcule la moyenne des données.
Affiche la valeur minimale des données sélectionnées.
Affiche la valeur maximale des données sélectionnées.
10 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
Utilisation de calculs standard et personnalisés dans les rapports
2
Calcul
Pourcentage
Par défaut
Description
Afficher les données sélectionnées sous forme de pourcentage du total.
Les résultats du pourcentage sont affichés dans une colonne ou une ligne supplémentaire du tableau.
Remarque :
Les pourcentages sont calculés pour l'indicateur sélectionné relativement aux résultats totaux pour cet indicateur sur le tableau ou la rupture. Pour calculer le pourcentage d'un indicateur relativement à un autre indicateur, vous devez créer un calcul personnalisé.
Applique la fonction d'agrégat par défaut à un indicateur standard, ou la fonction d'agrégat de base de données
à un indicateur intelligent.
Lorsque vous appliquez un calcul standard à une colonne de tableau, le résultat du calcul apparaît dans un pied de page dans la colonne. Web
Intelligence ajoute un pied de page pour le résultat de chaque calcul si vous appliquez plusieurs calculs à la même colonne.
Utilisation de formules pour créer des calculs personnalisés
Les calculs personnalisés permettent d'ajouter des calculs supplémentaires
à votre rapport en plus des objets de base et des calculs standard fournis par Web Intelligence.
Pour ajouter un calcul personnalisé, il suffit d'écrire une formule que
Web Intelligence évalue lorsque vous exécutez le rapport. Une formule peut se composer de variables de rapport de base, de fonctions, d'opérateurs et de contextes de calcul.
Utilisation de fonctions, formules et calculs dans Web Intelligence 11
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
Un calcul personnalisé est une formule qui peut être composée d'objets de rapport, de fonctions et d'opérateurs. Les formules bénéficient d'un contexte de calcul que vous pouvez spécifier de façon explicite si vous le souhaitez.
Exemple : Affichage de la moyenne de revenus par vente
Imaginons qu'un de vos rapports contient les objets Revenu des ventes et
Quantité vendue et que vous voulez ajouter le revenu par vente. Le calcul
[Revenu des ventes]/[Quantité vendue] génère cette valeur en divisant le revenu par le nombre d'articles vendus pour obtenir le revenu par article.
Rubriques associées
•
Définition des contextes de calcul
page 24
Utilisation de variables pour simplifier des formules
Si une formule est complexe, vous pouvez utiliser des variables pour la simplifier. En utilisant des variables, vous décomposez une formule complexe en parties faciles à gérer et améliorez sa lisibilité, tout en réduisant le risque d'erreur de génération de formule.
Vous pouvez utiliser dans une formule des variables créées antérieurement, exactement de la même façon que vous utilisez d'autres objets de rapport.
Les variables apparaissent dans l'Editeur de formule sous le dossier
"Variables".
Vous pouvez saisir ce nom de variable dans une formule ou le faire glisser dans la barre d'outils Formule comme pour tout autre objet de rapport.
Exemple : Création d'une formule pour renvoyer une variance statistique
La variance est un terme statistique. La variance d'un ensemble de valeurs mesure l'étendue de ces valeurs par rapport à leur moyenne.
Web Intelligence dispose de la fonction Var() qui calcule la variance en une
étape, mais le calcul manuel de la variance fournit un bon exemple de la façon de simplifier une formule complexe à l'aide 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é,
12 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
Utilisation de calculs standard et personnalisés dans les rapports
2
• additionner toutes ces différences élevées au carré,
• diviser ce total par le nombre de valeurs – 1.
Vous disposez d'un rapport présentant les nombres d'articles vendus par trimestre et vous voulez inclure la variance. Sans variables pour la simplifier, la formule se présente comme 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)
Il est clair que cette formule n'est pas très pratique à manier. En ayant recours à des variables, vous pouvez la simplifier ainsi :
Sum ([Difference Squared])/[Number of Observations] - 1) qui est beaucoup plus facile à comprendre. La version simplifiée de la formule donne une vue de niveau élevé de l'action de la formule, au lieu de vous plonger dans des détails confus. Vous pouvez ensuite examiner les formules des variables référencées dans la formule de niveau élevé pour comprendre ses parties constitutives.
Par exemple, la formule fait référence à la variable Différence élevée au carré, qui fait elle-même référence à la variable Moyenne vendue. En examinant les formules de Différence élevée au carré et de Moyenne vendue, vous pouvez effectuer une exploration avant de la formule afin de comprendre en détails ce qu'elle effectue.
Utilisation des fonctions
Un calcul personnalisé ne contient parfois que des objets de rapport, par exemple
[Revenu des ventes]/[Nombre de ventes]
. Néanmoins, les calculs peuvent également inclure des fonctions en plus des objets de rapport.
Une fonction reçoit zéro ou plusieurs valeurs comme entrée et renvoie une sortie basée sur ces valeurs. Par exemple, la fonction
Somme calcule le total de toutes les valeurs d'un indicateur et renvoie le résultat. La formule
Somme([Revenu des ventes]) génère le total des revenus des ventes.
Dans ce cas, l'entrée de la fonction est l'indicateur Revenu des ventes et la sortie est le total de tous les indicateurs des ventes.
Utilisation de fonctions, formules et calculs dans Web Intelligence 13
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
Rubriques associées
•
Opérateurs de fonction et de formule Web Intelligence
page 191
•
page 50
Insertion de fonctions dans des cellules
Le texte des cellules de rapport commence toujours par "=". Le texte littéral apparaît entouré de guillemets, au contraire des formules qui apparaissent sans guillemets. Par exemple, la formule Moyenne([Revenu]) apparaît dans une cellule sous la forme
=Moyenne([Revenu])
. Le texte "Revenu moyen" apparaît sous la forme
="Revenu moyen"
.
Vous pouvez utiliser seulement du texte dans une cellule, ou bien mélanger des formules et du texte à l'aide de l'opérateur "+". Si vous voulez qu'une cellule affiche le revenu moyen précédé du texte "Revenu moyen", le texte de cette cellule doit se présenter comme suit :
="Revenu moyen :" +
Moyenne([Revenu])
.
Notez la présence d'un espace à la fin de la chaîne de texte pour que le texte et la valeur ne soient pas placés directement côte à côte dans la cellule.
Prototypes de fonction
Pour utiliser une fonction, vous devez connaître son nom, le nombre de valeurs en entrée dont elle a besoin et les types de données de ces valeurs.
Vous devez également connaître le type de données que génère la fonction.
Par exemple, la fonction Somme utilise un objet numérique comme entrée
(par exemple, un indicateur présentant un revenu des ventes) et génère des données numériques (la somme de toutes les valeurs de l'objet indicateur).
Cette description des entrées et sorties d'une fonction est désignée sous le terme prototype. Voici le prototype de la fonction Abs : number Abs (number input_number)
Ce prototype indique que la fonction Abs prend un seul nombre
( nombre_en_entrée
) en entrée et renvoie un nombre en sortie.
L'Editeur de formule affiche le prototype de la fonction lorsque vous sélectionnez cette dernière.
14 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
Utilisation de calculs standard et personnalisés dans les rapports
2
Exemples de fonctions
Exemple : Affichage d'une invite de saisie avec la fonction
RéponseUtilisateur
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes. L'objet Etat figure également dans le rapport bien qu'il ne soit pas affiché. Lorsque l'utilisateur exécute le rapport, une invite s'affiche, lui proposant de choisir un Etat. Vous voulez que l'Etat choisi s'affiche dans le titre du rapport. Si votre fournisseur de données s'appelle
"eMode" et que le texte de l'invite est "Sélectionnez un Etat", la formule du titre est la suivante :
"Quarterly Revenues for " + UserResponse( "eFashion";"Choose a State")
Le rapport est le suivant :
Utilisation de fonctions, formules et calculs dans Web Intelligence 15
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
Exemple : Calcul d'un pourcentage à l'aide de la fonction Pourcentage
Web Intelligence comporte la fonction Pourcentage pour le calcul des pourcentages. Cette fonction calcule le pourcentage d'un nombre par rapport
à son contexte environnant. Par exemple, le tableau suivant présente les revenus par année et par trimestre. La colonne de pourcentage contient la formule
Pourcentage ([Revenu des ventes])
.
Dans ce cas, la fonction calcule chaque revenu en tant que pourcentage du revenu total. Le contexte environnant est le revenu total ; il s'agit du seul chiffre de revenu qui est intéressant, en dehors de la répartition en année et en trimestre dans le tableau.
Si le rapport est divisé en sections par année, le contexte environnant à l'extérieur du tableau devient le revenu total de la section.
16 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
Utilisation de calculs standard et personnalisés dans les rapports
2
Si la cellule Pourcentage est placée à l'extérieur du tableau, mais toujours au sein de la section, le contexte environnant devient le revenu total. Dans ce cas, la fonction Pourcentage calcule le revenu total pour la section en tant que pourcentage du revenu global total.
Exemple : Calcul d'un pourcentage à l'aide de la fonction Somme
Vous pouvez contrôler davantage le contexte de calcul d'un pourcentage en utilisant la fonction Somme plutôt que la fonction Pourcentage. Si vous divisez un chiffre faisant partie d'un ensemble de chiffres par le total de ces chiffres, vous obtenez son pourcentage par rapport au total ; par exemple,
Utilisation de fonctions, formules et calculs dans Web Intelligence 17
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
la formule [Revenu des ventes]/Somme([Revenu des ventes]) donne le revenu des ventes en tant que pourcentage du revenu total.
Dans le tableau suivant, la colonne Pourcentage du total contient la formule
[Sales revenue]/(Sum([Sales revenue] In Report)) et la colonne Pourcentage de Année contient la formule
[Sales revenue]/(Sum([Sales revenue] In Section))
Ces formules utilisent les mots clés de syntaxe avancée Rapport et Section pour demander à la fonction Somme de calculer respectivement le revenu total global et le revenu annuel.
Rubriques associées
•
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
page 34
Simplification d'une formule de variance avec des variables
La variance est un terme statistique. La variance d'un ensemble de valeurs mesure l'étendue de ces valeurs par rapport à leur moyenne. Web Intelligence dispose de la fonction Var() qui calcule la variance en une étape, mais le calcul manuel de la variance fournit un bon exemple de la façon de simplifier une formule complexe à l'aide 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.
18 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
Utilisation de calculs standard et personnalisés dans les rapports
2
Vous disposez d'un rapport présentant les nombres d'articles vendus par trimestre et vous voulez inclure la variance. Sans variables pour la simplifier, la formule se présente comme suit :
Sum((([Quantity sold] - Average([Quantity sold] ForEach [Quar ter]) In Report)*([Quantity sold] - Average([Quantity sold]
ForEach [Quarter]) In Report)) In [Quarter])/(Count ([Quantity sold] ForEach [Quarter]) - 1)
Il est clair que cette formule n'est pas très pratique à manier.
Création de la formule de variance
Plusieurs étapes sont nécessaires pour créer une formule de variance. Vous encapsulez chacune de ces étapes dans une variable. Les variables que vous créez sont les suivantes :
• Moyenne du nombre d'articles vendus
• Nombre d'observations (soit le nombre de valeurs distinctes du nombre d'articles vendus)
• Différence entre une observation et la moyenne (valeur élevée au carré)
• Somme de ces différences divisée par le nombre d'observations - 1
Les formules de variable sont les suivantes :
Variable Formule
Moyenne des ventes
Nombre d'observations
Différence élevée au carré
Variance
Moyenne([Quantité vendue] Dans
([Trimestre])) Dans Rapport
Nombre([Quantité vendue] Dans
([Trimestre])) Dans Rapport
Puissance(([Quantité vendue] -
[Moyenne ventes]);2)
Somme([Différence élevée au carré]
Dans ([Trimestre]))/([Nombre d'observations] - 1)
Utilisation de fonctions, formules et calculs dans Web Intelligence 19
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
La formule s'affiche désormais sous la forme suivante :
Sum ([Difference Squared])/[Number of Observations] - 1) qui est beaucoup plus facile à comprendre. La version simplifiée de la formule donne une vue de niveau élevé de l'action de la formule, au lieu de vous plonger dans des détails confus. Vous pouvez ensuite examiner les formules des variables référencées dans la formule de niveau élevé pour comprendre ses parties constitutives.
Par exemple, la formule fait référence à la variable Différence élevée au carré, qui fait elle-même référence à la variable Moyenne vendue. En examinant les formules de Différence élevée au carré et de Moyenne vendue, vous pouvez effectuer une exploration avant de la formule afin de comprendre en détails ce qu'elle effectue.
Opérateurs de fonction et de formule Web Intelligence
Les opérateurs lient les différents composants dans une formule. Les formules peuvent contenir des opérateurs mathématiques, conditionnels, logiques, spécifiques à une fonction ou de syntaxe avancée.
Opérateurs mathématiques
Les opérateurs mathématiques paraissent familiers car ils correspondent aux opérations arithmétiques de base. Les opérateurs d'addition (+), de soustraction (-), de multiplication (*) et de division (/) permettent d'effectuer des opérations mathématiques dans une formule. La formule
[Chiffre d'affaires] - [Coût des ventes] contient un opérateur mathématique, la soustraction en l'occurrence.
Remarque :
Lorsqu'il est utilisé avec des chaînes de caractères, l'opérateur "+" devient un opérateur de concaténation de chaînes. Autrement dit, il permet de joindre des chaînes de caractères. Par exemple, la formule "Jean" + " Durand" renvoie "Jean Durand".
Opérateurs conditionnels
Les opérateurs conditionnels déterminent le type de comparaison à effectuer entre des valeurs.
20 Utilisation de fonctions, formules et calculs dans Web Intelligence
Utilisation de calculs standard et personnalisés
Utilisation de calculs standard et personnalisés dans les rapports
2
Opérateur
=
>
<
>=
<=
<>
Description
Egal à
Supérieur à
Inférieur à
Supérieur ou égal à
Inférieur ou égal à
Différent de
Vous utilisez les opérateurs conditionnels avec la fonction Si, comme dans :
If [Revenue]>10000 Then "High" Else "Low" qui renvoie "Elevé" pour toutes les lignes où le revenu est supérieur ou égal
à 10 000 et "Bas" pour toutes les autres lignes.
Opérateurs logiques
Les opérateurs logiques Web Intelligence sont
Et
,
Ou
,
Pas
,
Entre et
Dans
Liste
. Les opérateurs logiques sont utilisés dans des expressions booléennes qui renvoient
Vrai ou
Faux
.
Opérateurs contextuels
Les opérateurs contextuels font partie de la syntaxe de calcul avancée. La syntaxe avancée permet de définir quelles dimensions un indicateur ou une formule prend en compte dans un calcul.
Opérateurs spécifiques à la fonction
Certaines fonctions Web Intelligence peuvent avoir des opérateurs spécifiques comme arguments. Par exemple, la fonction
Précédent peut avoir pour argument l'opérateur
Auto
.
Toutes les fonctions entourent les arguments avec
) et
(
. Les fonctions qui acceptent plusieurs paramètres utilisent
; pour les séparer.
Utilisation de fonctions, formules et calculs dans Web Intelligence 21
Utilisation de calculs standard et personnalisés
2
Utilisation de calculs standard et personnalisés dans les rapports
22 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
3
Notions de contextes de calcul
3
Définition des contextes de calcul
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. Dans Web Intelligence, cela signifie que la valeur donnée par un indicateur est déterminée par les dimensions utilisées pour calculer cet indicateur.
Un rapport contient deux types d'objet :
• Les dimensions représentent les données professionnelles qui génèrent les chiffres. Les points de vente, les années ou les régions sont des exemples de données de type dimension. Par exemple, un point de vente, une année ou une région peuvent générer un revenu et nous pouvons parler du revenu par point de vente, du revenu par année ou du revenu par région.
• Les indicateurs sont les données numériques générées par les données de type dimension. Le revenu et le nombre de ventes sont des exemples d'indicateurs. Par exemple, nous pouvons parler du nombre de ventes réalisées dans un magasin particulier.
Les indicateurs peuvent également être générés par des combinaisons de données de type dimension. Par exemple, nous pouvons parler du revenu généré par un magasin particulier en 2005.
Le contexte de calcul d'un indicateur comprend deux composants :
• la dimension ou la liste de dimensions qui détermine la valeur de l'indicateur,
• la partie des données de type dimension qui détermine la valeur de l'indicateur.
Le contexte de calcul comprend deux composants :
• Contexte d'entrée
• Contexte de sortie
Rubriques associées
•
page 25
•
page 26
24 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Définition des contextes de calcul
3
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.
La liste de dimensions d'un contexte d'entrée apparaît à l'intérieur des parenthèses de la fonction qui renvoie la valeur en sortie. La liste de dimensions doit également se trouver entre parenthèses (même si elle ne contient qu'une seule dimension) et les dimensions doivent être séparées par des points-virgules.
Exemple : Spécification d'un contexte d'entrée
Dans un rapport comprenant plusieurs sections Année et un bloc par section incluant les colonnes Client et Revenu, les contextes d'entrée sont les suivants :
Partie de rapport Contexte d'entrée
En-tête de section et pieds de page de bloc
Année
Lignes du bloc Année, Client
En d'autres termes, les en-têtes de section et les pieds de page de bloc montrent le revenu agrégé par année, et chaque ligne du bloc présente le revenu agrégé par année et par client (c'est-à-dire le revenu généré par ce client au cours de l'année en question).
Lorsqu'ils sont explicitement définis dans une formule, ces contextes d'entrée se présentent comme suit :
Sum ([Revenue] In ([Year]))
Sum ([Revenue] In ([Year];[Customer]))
Autrement dit, les dimensions du contexte d'entrée apparaissent entre les parenthèses de la fonction (en l'occurrence, Somme) pour laquelle ce contexte est défini.
Utilisation de fonctions, formules et calculs dans Web Intelligence 25
Notions de contextes de calcul
3
Définition des contextes de calcul
Contexte de sortie
Le contexte de sortie entraîne la génération d'une valeur par la formule s'il est placé dans le pied de page d'un bloc contenant une rupture.
Exemple : Spécification d'un contexte de sortie
Le rapport suivant présente le revenu par année et par trimestre, avec une rupture au niveau de l'année, et le revenu minimal calculé par année :
Comment présenter le revenu annuel minimal dans un bloc sans rupture ?
Pour ce faire, vous pouvez spécifier le contexte de sortie dans une formule.
Dans ce cas, la formule se présente comme suit :
Min ([Revenue]) In ([Year])
Autrement dit, le contexte de sortie apparaît après les parenthèses de la fonction pour laquelle vous spécifiez ce contexte. Dans ce cas, le contexte de sortie indique à Web Intelligence de calculer le revenu minimal par an.
26 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Définition des contextes de calcul
3
Si vous rajoutez une colonne contenant cette formule dans le bloc, le résultat est le suivant :
Vous pouvez constater que la colonne Minimum par année contient le revenu minimal qui figure dans les pieds de rupture du rapport précédent.
Notez que, dans cet exemple, le contexte d'entrée n'est pas spécifié, car il s'agit du contexte par défaut (Année, Trimestre) pour le bloc. En d'autres termes, le contexte de sortie indique à Web Intelligence quel revenu par année et par trimestre il faut calculer. De forme complète, avec les formules d'entrée et de sortie spécifiées de façon explicite, la formule se présente comme suit :
Min ([Sales Revenue] In([Year];[Quarter])) In ([Year])
En d'autres termes, cette formule indique à Web Intelligence "de calculer les revenus annuels par trimestre, puis d'indiquer les revenus les plus bas générés chaque année".
Que se passe-t-il si vous ne spécifiez pas le contexte de sortie dans la colonne Minimum par année ? Dans ce cas, les chiffres sont identiques à ceux de la colonne Revenu des ventes. Pourquoi ? N'oubliez pas que le contexte par défaut d'un bloc inclut les dimensions du bloc. Le revenu minimal annuel par trimestre est identique au revenu annuel par trimestre parce qu'il n'existe qu'un seul revenu par combinaison année/trimestre.
Utilisation de fonctions, formules et calculs dans Web Intelligence 27
Notions de contextes de calcul
3
Contextes de calcul par défaut
Contextes de calcul par défaut
Suivant l'emplacement d'un indicateur ou d'une formule, Web Intelligence affecte un contexte de calcul par défaut à l'indicateur.
Les indicateurs sont sémantiquement dynamiques. Cela signifie que les chiffres renvoyés par un indicateur dépendent des dimensions auxquelles cet indicateur est associé. Cette combinaison de dimensions représente le contexte de calcul.
Web Intelligence associe un contexte par défaut à un indicateur en fonction de l'emplacement de ce dernier. Vous pouvez modifier ce contexte par défaut
à l'aide de la syntaxe étendue. En d'autres termes, vous pouvez déterminer l'ensemble de dimensions utilisé pour générer un indicateur. Il s'agit précisément de l'action évoquée par la notion de définition du contexte de calcul.
Exemple : Contextes par défaut dans un rapport
Cet exemple décrit le contexte de calcul par défaut des indicateurs d'un rapport simple. Le rapport présente le revenu généré par les clients et il est divisé en sections par année.
2005 Total : 8000
Client
Harris
Dupont
Walsh
Total :
Total du rapport : 8000
Revenu
1 000
3000
4 000
8000
28 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Contextes de calcul par défaut
3
Le tableau suivant présente le contexte de calcul des indicateurs dans ce rapport :
Indicateur Valeur
Total du rapport 20 000
Contexte
Total de tous les revenus du rapport
Total de l'en-tête de section
8000
Total du client 1000, 3000, 4000
Total du pied de page de bloc
8000
Année
Année;Client
Année
Rubriques associées
•
Définition des contextes de calcul
page 24
•
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
page 34
Contextes par défaut dans un tableau vertical
Un tableau vertical est un tableau de rapport standard avec des en-têtes dans la partie supérieure, des données s'étendant de haut en bas dans le tableau, et des pieds de page dans la partie inférieure du tableau. Les contextes par défaut dans un tableau vertical sont les suivants :
Lorsque le calcul se trouve dans...
Le contexte d'entrée est...
Le contexte de sortie est...
En-tête
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Utilisation de fonctions, formules et calculs dans Web Intelligence 29
Notions de contextes de calcul
3
Contextes de calcul par défaut
Lorsque le calcul se trouve dans...
Le contexte d'entrée est...
Le contexte de sortie est...
Corps du bloc
Pied de page
Les dimensions et les indicateurs utilisés pour générer la ligne en cours.
Le même que le contexte d'entrée.
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Exemple : Contextes par défaut dans un tableau vertical
Le tableau suivant présente les contextes par défaut dans un tableau vertical :
Contextes par défaut dans un tableau horizontal
Un tableau horizontal ressemble à un tableau vertical couché sur un côté.
Les en-têtes figurent sur la gauche, les données s'échelonnent de gauche
30 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Contextes de calcul par défaut
3
à droite et les pieds de page figurent sur la droite. Les contextes par défaut pour un tableau horizontal sont identiques à ceux d'un tableau vertical.
Contextes par défaut dans un tableau croisé
Un tableau croisé affiche les données dans une matrice avec des indicateurs apparaissant aux intersections des dimensions. Les contextes par défaut dans un tableau croisé sont les suivants :
Le calcul se trouve dans...
En-tête
Corps du bloc
Pied de page
Pied de page VBody
Pied de page HBody
Pied de page VFooter
Le contexte d'entrée est…
Le contexte de sortie est…
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Le même que le contexte d'entrée.
Les dimensions et les indicateurs utilisés pour générer le corps du bloc.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Les dimensions et les indicateurs utilisés pour générer la colonne courante.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Les dimensions et les indicateurs utilisés pour générer la ligne courante.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Identique au pied de page.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Utilisation de fonctions, formules et calculs dans Web Intelligence 31
Notions de contextes de calcul
3
Contextes de calcul par défaut
Le calcul se trouve dans...
Pied de page HFooter
Le contexte d'entrée est…
Identique au pied de page.
Le contexte de sortie est…
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Exemple : Contextes par défaut dans un tableau croisé
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
Contextes par défaut dans une section
Une section se compose d'un en-tête, d'un corps et d'un pied de page. Les contextes par défaut dans une section sont les suivants :
Le calcul se trouve dans...
Corps
Le contexte d'entrée est…
Le contexte de sortie est…
Les dimensions et les indicateurs du rapport, filtrés pour limiter les données à celles de la section.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Exemple : Contextes par défaut dans une section
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
32 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Contextes de calcul par défaut
3
Contextes par défaut dans une rupture
Une rupture se compose d'un en-tête, d'un corps et d'un pied de page. Les contextes par défaut dans une rupture sont les suivants :
Le calcul se trouve dans...
En-tête
Le contexte d'entrée est…
Le contexte de sortie est…
Instance en cours de la rupture.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Utilisation de fonctions, formules et calculs dans Web Intelligence 33
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Le calcul se trouve dans...
Pied de page
Le contexte d'entrée est…
Le contexte de sortie est…
Instance en cours de la rupture.
Toutes les données sont agrégées, puis la fonction de calcul renvoie une valeur unique.
Exemple : Contextes par défaut dans une rupture
Le rapport suivant présente les contextes par défaut dans une rupture :
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
La syntaxe avancée fait appel à des opérateurs contextuels que vous ajoutez
à une formule ou à un indicateur pour spécifier son contexte de calcul. Le contexte d'un indicateur ou d'une formule est constitué d'un contexte d'entrée et d'un contexte de sortie.
34 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3
Opérateurs contextuels de syntaxe avancée
Vous spécifiez explicitement les contextes d'entrée et de sortie avec les opérateurs contextuels. Le tableau suivant répertorie les opérateurs contextuels :
Opérateur
Dans
PourChaque
PourTout
Description
Spécifie une liste explicite de dimensions à utiliser dans le contexte
Ajoute des dimensions au contexte par défaut
Supprime des dimensions du contexte par défaut
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte par défaut contient de nombreuses dimensions. Il est souvent plus facile d'effectuer un "ajout" ou un "retrait" du contexte avec les opérateurs PourTout et PourChaque que de spécifier explicitement la liste avec Dans.
Opérateur contextuel Dans
L'opérateur contextuel Dans spécifie les dimensions de façon explicite dans un contexte.
Exemple : Utilisation de l'opérateur Dans pour spécifier les dimensions dans un contexte
Dans cet exemple, vous avez un rapport présentant les valeurs Année et
Revenu des ventes. Votre fournisseur de données contient aussi l'objet
Trimestre, mais vous n'incluez pas cette dimension dans le bloc. Vous choisissez plutôt d'inclure une autre colonne qui affiche le revenu maximal par trimestre de chaque année. Votre rapport se présente comme suit :
Utilisation de fonctions, formules et calculs dans Web Intelligence 35
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Vous pouvez voir d'où proviennent les valeurs de la colonne Revenu trimestriel maximum en examinant ce bloc avec un bloc incluant la dimension Trimestre :
La colonne Revenu trimestriel maximum présente le revenu trimestriel le plus élevé de chaque année. Par exemple, T4 présentant le revenu le plus
élevé pour 2002, la colonne Revenu trimestriel maximum présente le revenu de T4 sur la ligne affichant les valeurs de 2002.
Avec l'opérateur Dans, la formule pour Revenu trimestriel maximum est
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
36 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3
Cette formule indique à Web Intelligence de calculer le revenu des ventes maximal pour chaque combinaison (Année,Trimestre), puis d'indiquer ce chiffre par année.
Remarque :
Comme le contexte de sortie par défaut du bloc est Année, vous n'avez pas besoin de spécifier de façon explicite le contexte de sortie dans cette formule.
Opérateur contextuel PourChaque
L'opérateur PourChaque ajoute des dimensions à un contexte.
Exemple : Utilisation de l'opérateur PourChaque pour ajouter des dimensions à un contexte
Le tableau suivant présente le revenu maximal de chaque trimestre dans un rapport qui contient la dimension Trimestre, mais ne l'inclut pas dans le bloc :
Année
2001
2002
2003
Revenu des ventes
8 096 123,60
13 232 246,00
15 059 142,80
Revenu trimestriel max.
2 660 699,50
4 186 120,00
4 006 717,50
Il est possible de créer une formule pour la colonne Revenu trimestriel maximum n'incluant pas l'opérateur PourChaque :
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Si vous optez pour l'opérateur contextuel PourChaque, vous pouvez obtenir le même résultat avec la formule suivante :
Max ([Sales Revenue] ForEach ([Quarter])) In ([Year])
Pourquoi ? Parce que la dimension Année est le contexte d'entrée par défaut du bloc. En vous servant de l'opérateur PourChaque, vous ajoutez la dimension Trimestre au contexte, en donnant le contexte d'entrée
([Année];[Trimestre]).
Utilisation de fonctions, formules et calculs dans Web Intelligence 37
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Opérateur contextuel PourTout
L'opérateur contextuel PourTout supprime les dimensions d'un contexte.
Exemple : Utilisation de l'opérateur PourTout pour supprimer les dimensions d'un contexte
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes, et vous voulez ajouter une colonne qui présente le revenu total de chaque année, comme indiqué dans le bloc suivant :
Pour que le total de chiffre d'affaires par année soit effectué, le contexte d'entrée doit être (Année) ; par défaut, il s'agit de (Année; Trimestre). Par conséquent, vous pouvez supprimer Trimestre du contexte d'entrée en spécifiant PourTout ([Trimestre]) dans la formule, comme suit :
Sum([Sales Revenue] ForAll ([Quarter]))
Sachez que l'opérateur Dans vous permet d'aboutir au même résultat ; dans ce cas, la formule est :
Sum([Sales Revenue] In ([Year]))
Cette version de la formule spécifie de façon explicite Année comme contexte, au lieu de supprimer Trimestre pour conserver Année.
38 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3
Mots clés de la syntaxe avancée Web Intelligence
Les mots clés de la syntaxe avancée constituent une sorte de "notation abrégée" qui vous permet de faire référence à des dimensions en syntaxe avancée sans spécifier de façon explicite ces dimensions. Cette opération garantit des rapports toujours optimaux ; si les formules ne contiennent pas de références figées dans le code à des dimensions, elles restent valables même en cas d'ajout ou de suppression de dimensions dans le rapport.
Il existe cinq mots clés de syntaxe avancée : Rapport, Section, Rupture,
Bloc et Corps.
Mot clé Rapport
Le tableau ci-après décrit les données auxquelles fait référence le mot clé
Rapport, selon son emplacement dans un rapport :
Placé dans…
Un bloc
Fait référence à…
Toutes les données du rapport
Une rupture de bloc (en-tête ou pied) Toutes les données du rapport
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Toutes les données du rapport
Toutes les données du rapport
Exemple : Mot clé Rapport
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes. Le rapport contient une colonne, Rapport total, qui affiche le total de tous les revenus du rapport.
Utilisation de fonctions, formules et calculs dans Web Intelligence 39
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
La formule pour la colonne Rapport total est Somme([Chiffre d'affaires])
Dans Rapport. Sans le mot clé Rapport, cette colonne dupliquerait les chiffres de la colonne Revenu des ventes, car le contexte de sortie par défaut serait utilisé ([Année];[Trimestre]).
Mot clé Section
Le tableau ci-après décrit les données auxquelles fait référence le mot clé
Section, selon son emplacement dans un rapport :
Placé dans…
Un bloc
Fait référence à…
Toutes les données de la section
Une rupture de bloc (en-tête ou pied) Toutes les données de la section
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Toutes les données de la section
Non applicable
40 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes.
Le rapport contient une section basée sur Année. La colonne Total section contient la formule :
Sum ([Sales Revenue]) In Section
Les chiffres de la colonne Total section représentent le revenu total pour
2001, car la rupture de section se produit au niveau de l'objet Année. Sans le mot clé Section, cette colonne dupliquerait les chiffres de la colonne
Revenu des ventes car le contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
Mot clé Rupture
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Rupture, selon son emplacement dans un rapport :
Placé dans…
Un bloc
Fait référence à…
Toutes les données dans la partie du bloc délimité par une rupture
Une rupture de bloc (en-tête ou pied)
Toutes les données dans la partie du bloc délimité par une rupture
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Non applicable
Non applicable
Utilisation de fonctions, formules et calculs dans Web Intelligence 41
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Exemple : Mot clé Rupture
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes.
Le rapport comporte une rupture au niveau de Année. La colonne Total rupture contient la formule :
Sum ([Sales Revenue]) In Break
Sans le mot clé Rupture, cette colonne dupliquerait les chiffres de la colonne
Revenu des ventes, car le contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
Mot clé Bloc
Le tableau suivant décrit les dimensions auxquelles fait référence le mot clé
Bloc, selon son emplacement dans un rapport. Le mot clé Bloc recouvre souvent les mêmes données que le mot clé Section. La différence entre les deux réside dans le fait que Bloc tient compte des filtres placés sur un bloc alors que Section les ignore.
Placé dans… Fait référence à…
Un bloc
Toutes les données du bloc, sans tenir compte des ruptures, en respectant les filtres
Une rupture de bloc (en-tête ou pied)
Toutes les données du bloc, sans tenir compte des ruptures, en respectant les filtres
Une section (en-tête, pied ou à l'extérieur d'un bloc)
Non applicable
42 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3
Placé dans…
A l'extérieur des blocs ou sections
Fait référence à…
Non applicable
Exemple : Mot clé Bloc
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes. Le rapport contient une section basée sur Année. Le bloc est filtré de façon à exclure les troisième et quatrième trimestres.
La colonne Moyenne annuelle contient la formule
Average([Sales revenue] In Section) et la colonne Moyenne du premier semestre contient la formule
Average ([Sales revenue]) In Block
Vous pouvez voir comment le mot clé Bloc prend en compte le filtre sur le bloc.
Utilisation de fonctions, formules et calculs dans Web Intelligence 43
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Mot clé Corps
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Corps, selon son emplacement dans un rapport :
Placé dans… Fait référence à…
Un bloc Toutes les données du bloc
Une rupture de bloc (en-tête ou pied) Toutes les données du bloc
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Toutes les données de la section
Toutes les données du rapport
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes, avec une rupture sur Année. Le rapport contient une section basée sur Année et une rupture au niveau de Trimestre.
Année Trimestre Corps
2001
2001
T1
T2
T3
T4
Revenu des ventes
2 660 700
2 279 003
1 367 841
1 788 580
8 096 123,6
2 660 699,5
2 279 003
1 367 840,7
1 788 580,4
La colonne Corps contient la formule
Sum ([Sales Revenue]) In Body
Les totaux de la colonne Corps sont égaux à ceux de la colonne Revenu des ventes, car le mot clé Corps fait référence aux données du bloc. Si vous deviez supprimer l'objet Mois, les chiffres de la colonne Bloc
44 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3 changeraient pour correspondre aux chiffres modifiés de la colonne Revenu des ventes. Si vous deviez placer la formule dans le pied du rapport, elle renverrait le revenu total pour le bloc.
Utilisation de mots clés pour rendre des rapports génériques
Les mots clés de syntaxe avancée permettent de protéger durablement votre rapport contre les modifications. Si vous faites référence aux données de façon explicite (en spécifiant des dimensions à l'aide de Dans, PourTout et
PourChaque), vos rapports risquent de renvoyer des données inattendues en cas d'ajout ou de suppression de dimensions. L'exemple suivant illustre ce cas de figure.
Exemple : Utilisation du mot clé Rapport pour afficher des pourcentages
Dans cet exemple, vous disposez d'un bloc contenant les objets Année,
Trimestre et Revenu des ventes. Vous voulez afficher les revenus par année et par trimestre, ainsi que le pourcentage du revenu total dans le rapport représenté par chaque revenu individuel, comme indiqué :
La formule pour la colonne Pourcentage du total est la suivante :
([Sales revenue]/(Sum([Sales revenue]) In Report)) * 100
Utilisation de fonctions, formules et calculs dans Web Intelligence 45
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Dans un bloc, le mot clé Rapport inclut toutes les données du rapport, donc il serait possible d'écrire la formule suivante :
([Sales revenue]/Sum([Sales revenue] ForAll ([Year];[Quar ter]))) * 100
Cette formule indique à Web Intelligence de supprimer Année et Trimestre du contexte de sortie, autrement dit, de calculer un total général, car le rapport ne contient pas d'autres dimensions. La formule divise ensuite chaque revenu par le total général pour obtenir un pourcentage du total.
Même si vous pouvez utiliser PourTout dans ce cas, il est nettement préférable d'utiliser le mot clé Rapport. Pourquoi ? Que se passe-t-il si la dimension Mois est rajoutée par la suite au rapport ? La version de la formule qui utilise le mot clé Rapport calcule toujours chaque pourcentage correctement, mais la version qui spécifie de façon explicite les dimensions
Année et Trimestre est désormais fausse :
46 Utilisation de fonctions, formules et calculs dans Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
3
Pour quelle raison ? Le problème vient de :
Sum ([Sales Revenue] ForAll ([Year];[Quarter))
Utilisation de fonctions, formules et calculs dans Web Intelligence 47
Notions de contextes de calcul
3
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Lorsque Année et Trimestre étaient les seules dimensions du rapport, la formule revenait à calculer "un total général de tous les revenus". Une fois que vous ajoutez la dimension Mois, cette expression supprime Année et
Trimestre du contexte de sortie par défaut mais laisse Mois.
La formule contient désormais une "rupture" au niveau du mois. Autrement dit, sur chacune des lignes où le Mois est 1, cette expression signifie à présent "le total des revenus de tous les mois 1". Sur chaque ligne 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.
48 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de
Web Intelligence
4
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Fonctions Web Intelligence
Web Intelligence répartit les fonctions dans les catégories suivantes :
Catégorie
Agrégat
Caractère
Date et heure
Document
Fournisseur de données
Logique
Numérique
Divers
Description
Données agrégées (par exemple, en effectuant le total ou la moyenne d'un ensemble de valeurs)
Manipule des chaînes de caractères
Renvoie des données de date et heure
Renvoie des données relatives à un document
Renvoie des données sur le fournisseur de données d'un document
Renvoie VRAI ou FAUX
Renvoie des données numériques
Fonctions ne correspondant à aucune des catégories précédentes
Fonction Agrégat
Moyenne
Description
renvoie la moyenne d'un ensemble de valeurs numériques.
50 Utilisation de fonctions, formules et calculs dans Web Intelligence
Nombre
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Agrégat
Syntaxe
numérique Moyenne([indicateur]; [INCLUREVIDE])
Entrée
[indicateur] Tout indicateur
Sortie
La moyenne de l'ensemble de valeurs numériques
Exemple
Si l'indicateur Chiffre d'affaires comporte les valeurs 41 569, 30 500, 40 000 et 50 138,
Moyenne([Chiffre d'affaires]) renvoie 40 552
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancés avec la fonction Moyenne.
• Vous pouvez spécifier InclureVide en tant que deuxième argument de la fonction. Lorsque vous spécifiez cet argument, la fonction prend en considération des lignes vides (nulles) pour le calcul.
Rubriques associées
•
page 199
Description
compte le nombre d'occurrences d'un élément.
Groupe de fonctions
Agrégat
Utilisation de fonctions, formules et calculs dans Web Intelligence 51
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
entier Nombre([objet]; [INCLUREVIDE];[DISTINCT|TOUT];)
Entrée
[objet] N'importe quel objet du rapport
Sortie
nombre d'occurrences de l'élément Selon l'argument DISTINCT/TOUT, ce nombre correspond au nombre d'occurrences distinctes (en ignorant les doublons) ou au nombre total d'occurrences (y compris les doublons).
Exemples
Nombre("Test") renvoie 1
Nombre([Ville]; DISTINCT) renvoie 5 s'il existe 5 villes différentes dans une liste de villes, même si la liste contient plus de 5 lignes en raison des doublons.
Nombre([Ville]; TOUT) renvoie 10 s'il existe 10 villes différentes dans une liste de villes, même si certaines sont des doublons.
Nombre ([Ville]; INCLUREVIDE) renvoie 6 s'il existe 5 villes et une ligne vide dans une liste de villes.
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancés avec la fonction Nombre().
• Vous pouvez spécifier InclureVide en tant que deuxième argument de la fonction. Lorsque vous spécifiez cet argument, la fonction prend en considération des lignes vides (nulles) pour le calcul.
• Le paramètre DISTINCT/TOUT est facultatif. Si vous ne spécifiez pas ce paramètre, les valeurs par défaut sont DISTINCT pour toutes les dimensions et TOUT pour tous les indicateurs.
Rubriques associées
•
page 199
•
page 198
52 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Premier
Description
Renvoie la première valeur d'un ensemble de valeurs
Groupe de fonctions
Agrégat
Syntaxe
type_sortie_expression Premier (expression)
Entrée
expression Toute expression
Sortie
La première valeur de l'ensemble
Exemple
Lorsque
Premier([Chiffre d'affaires]) est placé dans un pied de tableau, la première valeur de [Chiffre d'affaires] est renvoyée dans le tableau.
Remarques
• Lorsque
Premier est placé dans un pied de rupture, la première valeur de la rupture est renvoyée.
• Lorsque
Premier est placé dans un pied de section, la première valeur de la section est renvoyée.
Utilisation de fonctions, formules et calculs dans Web Intelligence 53
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Dernier
Description
Renvoie la dernière valeur d'un ensemble de valeurs
Groupe de fonctions
Agrégat
Syntaxe
type_sortie_expression Dernier (expression)
Entrée
expression Toute expression
Sortie
La dernière valeur de l'ensemble
Exemple
Lorsque
Premier([Chiffre d'affaires]) est placé dans un pied de tableau, la première valeur de [Chiffre d'affaires] est renvoyée dans le tableau.
Remarques
• Lorsque
Dernier est placé dans un pied de rupture, la dernière valeur de la rupture est renvoyée.
• Lorsque
Dernier est placé dans un pied de section, la dernière valeur de la section est renvoyée.
Max
Description
renvoie la valeur maximum d'un ensemble de valeurs.
54 Utilisation de fonctions, formules et calculs dans Web Intelligence
Médiane
Groupe de fonctions
Agrégat
Syntaxe
tout_type Max([objet])
Entrée
[objet]
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
N'importe quel objet du rapport
Sortie
valeur la plus élevée de l'ensemble de valeurs
Exemple
Si l'indicateur Chiffre d'affaires comporte les valeurs 3 000, 60 034 et 901 234,
Max([Chiffre d'affaires]) renvoie 901 234.
Si la dimension Ville a les valeurs "Aberdeen" et "Londres", Max([Ville]) renvoie "Londres".
Remarque
Vous pouvez utiliser les opérateurs contextuels de syntaxe avancés avec la fonction Max.
Description
Renvoie la médiane d'un ensemble de nombres. La médiane est le nombre situé au milieu d'un ensemble.
Groupe de fonctions
Agrégat
Utilisation de fonctions, formules et calculs dans Web Intelligence 55
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
numérique Médiane([indicateur])
Entrée
indicateur Tout indicateur
Sortie
La médiane de l'ensemble de nombres
Exemple
Médiane([Chiffre d'affaires]) renvoie 971 444 si [Chiffre d'affaires] possède les valeurs 835 420, 971 444 et 1 479 660
Remarques
Si l'ensemble de nombres comporte un nombre de valeurs pair, la fonction
Médiane() prend la moyenne des deux valeurs centrales.
Min
Description
renvoie la valeur minimum d'un ensemble de valeurs.
Groupe de fonctions
Agrégat
Syntaxe
tout_type Min([objet])
Entrée
[objet] N'importe quel objet du rapport
56 Utilisation de fonctions, formules et calculs dans Web Intelligence
Mode
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
valeur la plus petite dans l'ensemble de valeurs
Exemple
Si l'indicateur Chiffre d'affaires comporte les valeurs 3 000, 60 034 et 901 234,
Min([Chiffre d'affaires]) renvoie 3 000
Si la dimension Ville a les valeurs "Aberdeen" et "Londres", Min([Ville]) renvoie "Aberdeen"
Remarque
Vous pouvez utiliser les opérateurs contextuels de syntaxe avancés avec la fonction Min().
Description
Renvoie la valeur d'un ensemble qui apparaît le plus souvent
Groupe de fonctions
Agrégat
Syntaxe
type_sortie_expression Mode(expression)
Entrée
expression Toute expression
Exemples
Mode([Chiffre 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.
Utilisation de fonctions, formules et calculs dans Web Intelligence 57
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Remarques
•
Mode renvoie la valeur Nul si aucune des valeurs de l'ensemble n'apparaît plus souvent que les autres.
Pourcentage
Description
renvoie le rapport d'une valeur numérique à une autre valeur numérique.
Groupe de fonctions
Agrégat
Syntaxe
numérique Pourcentage([indicateur];[RUPTURE];[LIGNE|COL])
Entrée
[indicateur]
RUPTURE
LIGNE|COL
Tout indicateur du rapport
Prendre en compte la rupture de tableau (facultatif)
Le sens du calcul (facultatif)
Sortie
Rapport de la valeur d'indicateur dans le contexte du calcul en cours à la valeur d'indicateur du contexte d'intégration par défaut.
Exemple
Dans le tableau suivant, la colonne Pourcentage contient la formule
Pourcentage ([Revenu des ventes]).
Année Chiffre d'affaires Pourcentage
58 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
2001
2002
2003
Somme :
1 000
5 000
4 000
10 000
10
50
40
100
Par défaut, le contexte d'intégration est le total de l'indicateur dans le tableau.
Vous pouvez faire en sorte que la fonction prenne en compte une rupture dans le tableau en utilisant l'argument facultatif BREAK. Dans ce cas, le contexte d'intégration par défaut devient la section de tableau.
Dans le tableau suivant, la colonne Pourcentage contient la formule
Pourcentage([Chiffre d'affaires]; RUPTURE)
Année Trimestre Pourcentage
2001
2001
T1
T2
T3
T4
Somme :
Revenu des ventes
1 000
2 000
5 000
2 000
10 000
10
20
50
20
100
Année
2002
Trimestre
T1
T2
T3
T4
Revenu des ventes
2 000
2 000
5 000
1 000
Pourcentage
20
20
50
10
Utilisation de fonctions, formules et calculs dans Web Intelligence 59
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
2002 Somme :
10 000 100
Vous pouvez utiliser la fonction Pourcentage sur plusieurs colonnes ou lignes ; l'argument facultatif LIGNE/COL vous permet de le préciser explicitement. Par exemple, dans le tableau croisé suivant, la colonne
Pourcentage contient la formule Pourcentage([Chiffre d'affaires];LIGNE).
2001
2002
T1 Pour cen tage
1 000 10
2 000 20
T2 Pour cen tage
2 000 20
2 000 20
T3 Pour cen tage
5 000 50
5 000 50
T4 Pour cen tage
2 000 20
1 000 10
Centile
Description
Renvoie le centile d'un ensemble de nombres
Groupe de fonctions
Numérique
Syntaxe
numérique centile([indicateur]; numérique centile)
Entrée
[indicateur] centile
Tout indicateur
Un pourcentage exprimé sous forme décimale
60 Utilisation de fonctions, formules et calculs dans Web Intelligence
Produit
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
La valeur de centile
Exemple
Si [indicateur] possède l'ensemble de nombres (10;20;30;40;50),
Cen tile([indicateur];0.3) renvoie 22, qui est supérieur ou égal à 30 % des nombres de l'ensemble.
Remarques
• Le nième centile est un nombre supérieur ou égal à n % des nombres d'un ensemble. Vous exprimez n % sous la forme 0.n.
Description
Renvoie le produit d'un ensemble de valeurs numériques
Groupe de fonctions
Agrégat
Syntaxe
numérique Produit([indicateur])
Entrée
[indicateur] Tout indicateur
Sortie
Le produit de l'ensemble de valeurs numériques
Exemple
Produit([Indicateur]) renvoie 30 si [Indicateur] a les valeurs 2, 3, 5
Utilisation de fonctions, formules et calculs dans Web Intelligence 61
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
MoyenneCumulative
Description
Renvoie la moyenne cumulative d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique MoyenneCumulative([indicateur];[Ligne|Col];[In clureVide];[(dimensions_redéfinies)])
Entrée
[indicateur]
Ligne|Col
InclureVide dimensions_redéfinies
Tout indicateur
Le sens du calcul (facultatif)
Inclure des valeurs vides dans le calcul
(facultatif)
La liste des dimensions utilisées pour réinitialiser la moyenne cumulative
(facultatif)
Sortie
La moyenne cumulative de l'ensemble de nombres
Exemples
MoyenneCumulative([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays Lieu de séjour
Chiffre d'affaires Moyenne cumulative
62 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
US
Etats-Unis
France
Hawaiian Club 1 479 660
Bahamas Beach 971 444
Côte d'Azur 835 420
835 420
1 225 552
1 095 508
MoyenneCumulative([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Pays
US
Etats-Unis
France
Lieu de séjour
Hawaiian Club
Bahamas Beach
Côte d'Azur
Chiffre d'affaires Moyenne cumulative
1 479 660
971 444
835 420
835 420
1 225 552
835 420
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction MoyenneCumulative().
• Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et
Col.
• Si vous appliquez un tri sur l'indicateur référencé par la fonction
MoyenneCumulative(), Web Intelligence applique le tri au premier indicateur, puis calcule la moyenne cumulative.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
• MoyenneCumulative() ne réinitialise pas automatiquement la moyenne après une rupture de bloc.
Rubriques associées
•
page 199
•
page 201
Utilisation de fonctions, formules et calculs dans Web Intelligence 63
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
NombreCumulatif
Description
Renvoie le total cumulatif d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique NombreCumulatif(indicateur;[Ligne|Col];[In clureVide];[(dimensions_redéfinies)])
Entrée
indicateur
Ligne|Col
InclureVide dimensions_redéfinies
Tout indicateur
Le sens du calcul (facultatif)
Inclure des valeurs vides dans le calcul
(facultatif)
La liste des dimensions utilisées pour réinitialiser le total cumulatif (facultatif)
Sortie
Le total cumulatif de l'ensemble de nombres
Exemples
NombreCumulatif(Chiffre d'affaires) renvoie ces résultats dans le tableau suivant :
64 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Pays
Etats-Unis
US
France
Lieu de séjour
Hawaiian Club
Bahamas Beach
Côte d'Azur
Chiffre d'affaires Nombre cumulatif
1 479 660
971 444
835 420
1
2
3
NombreCumulatif(Chiffre d'affaires;(Pays)) renvoie ces résultats dans le tableau suivant :
Pays
Etats-Unis
US
France
Lieu de séjour
Hawaiian Club
Bahamas Beach
Côte d'Azur
Chiffre d'affaires Nombre cumulatif
1 479 660 1
971 444
835 420
2
1
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction
NombreCumulatif()
.
• Vous pouvez définir le sens du calcul à l'aide des opérateurs LIGNE et
COL.
• Si vous appliquez un tri à l'indicateur référencé par la fonction
Nom breCumulatif()
, Web Intelligence applique le tri au premier indicateur, puis calcule le total cumulatif.
• 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.
•
NombreCumulatif() ne réinitialise pas automatiquement le total après une rupture de bloc ou une nouvelle section.
Rubriques associées
•
page 199
•
page 201
•
page 199
•
page 199
Utilisation de fonctions, formules et calculs dans Web Intelligence 65
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
MaxCumulatif
Description
Renvoie le maximum cumulatif d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
tout_type MaxCumulatif([objet];[Ligne|Col];[(dimensions_redéfin ies)])
Entrée
[indicateur]
Ligne|Col dimensions_redéfinies
Tout objet
Le sens du calcul (facultatif)
La liste des dimensions utilisées pour réinitialiser le maximum cumulatif
(facultatif)
Sortie
Le maximum cumulatif de l'objet rapport
Exemples
MinCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
France
Etats-Unis
Lieu de séjour
Côte d'Azur
Chiffre d'affaires
835 420
Bahamas Beach 971 444
Minimum cumulatif
835 420
971 444
66 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
1 479 660 Hawaiian Club 1 479 660 Etats-Unis
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction MaxCumulatif().
• Vous pouvez définir le sens du calcul à l'aide des opérateurs LIGNE et
COL.
• Si vous appliquez un tri à l'indicateur référencé par la fonction
MaxCumulatif(), Web Intelligence applique le tri au premier indicateur, puis calcule le maximum cumulatif.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
• MaxCumulatif() ne réinitialise pas automatiquement le maximum après une rupture de bloc ou une nouvelle section.
Rubriques associées
•
page 199
•
page 201
MinCumulatif
Description
Renvoie le minimum cumulatif d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
tout_type MinCumulatif([objet];[Ligne|Col];[(dimensions_redéfin ies)])
Utilisation de fonctions, formules et calculs dans Web Intelligence 67
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Entrée
[objet]
Ligne|Col dimensions_redéfinies
Tout objet
Le sens du calcul (facultatif)
La liste des dimensions utilisées pour réinitialiser le minimum cumulatif
(facultatif)
Sortie
Le minimum cumulatif de l'ensemble de nombres
Exemples
MinCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
France
Etats-Unis
US
Lieu de séjour
Côte d'Azur
Chiffre d'affaires
835 420
Bahamas Beach 971 444
Hawaiian Club 1 479 660
Minimum cumulatif
835 420
835 420
835 420
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction MinCumulatif().
• Vous pouvez définir le sens du calcul à l'aide des opérateurs LIGNE et
COL.
• Si vous appliquez un tri à l'indicateur référencé par la fonction
MinCumulatif(), Web Intelligence applique le tri au premier indicateur, puis calcule le minimum cumulatif.
• 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.
68 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• MinCumulatif() ne réinitialise pas automatiquement le minimum après une rupture de bloc ou une nouvelle section.
Rubriques associées
•
page 199
•
page 201
ProduitCumulatif
Description
Renvoie le produit cumulatif d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique ProduitCumulatif([indicateur];[Ligne|Col];[(dimen sions_redéfinies)])
Entrée
[indicateur]
Ligne|Col dimensions_redéfinies
Tout indicateur
Le sens du calcul (facultatif)
La liste des dimensions utilisées pour réinitialiser le produit cumulatif (facultatif)
Sortie
Le produit cumulatif de l'ensemble de nombres
Exemples
ProduitCumulatif([Nombre d'invités]) renvoie ces résultats dans le tableau suivant :
Utilisation de fonctions, formules et calculs dans Web Intelligence 69
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Pays d'origine
Japon
Japon
US
Ville
Kobe
Osaka
Chicago
6
4
Nombre d'invités Produit cumulatif
241
6
24
5 784
ProduitCumulatif([Nombre d'invités]);([Pays d'origine]) renvoie ces résultats dans le tableau suivant :
Pays d'origine
Japon
Japon
US
Ville
Kobe
Osaka
Chicago
Nombre d'invités Produit cumulatif
6 6
4
241
24
5 784
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction ProduitCumulatif().
• Vous pouvez définir le sens du calcul à l'aide des opérateurs LIGNE et
COL.
• Si vous appliquez un tri à l'indicateur référencé par la fonction
ProduitCumulatif(), Web Intelligence applique le tri au premier indicateur, puis calcule le maximum cumulatif.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
• ProduitCumulatif() ne réinitialise pas automatiquement le produit après une rupture de bloc ou une nouvelle section.
Rubriques associées
•
page 199
•
page 201
70 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
SommeCumulative
Description
Renvoie le total cumulé d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique SommeCumulative([indicateur];[Ligne|Col];[(dimen sions_redéfinies)])
Entrée
[indicateur]
Ligne|Col dimensions_redéfinies
Tout indicateur
Le sens du calcul (facultatif)
La liste des dimensions utilisées pour réinitialiser le total cumulé (facultatif)
Sortie
Le total cumulé de l'ensemble de nombres
Exemple
SommeCumulative([Chiffre d'affaires]) renvoie ces résultats dans le tableau suivant :
Pays
France
Etats-Unis
Lieu de séjour
Côte d'Azur
Chiffre d'affaires
835 420
Bahamas Beach 971 444
Total cumulé
835 420
1 806 864
Utilisation de fonctions, formules et calculs dans Web Intelligence 71
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
US Hawaiian Club 1 479 660 3 286 524
SommeCumulative([Chiffre d'affaires]);([Pays]) renvoie ces résultats dans le tableau suivant :
Pays
France
Etats-Unis
Etats-Unis
Lieu de séjour
Côte d'Azur
Bahamas Beach
Chiffre d'affaires
Total cumulé
835 420
971 444
835 420
971 444
Hawaiian Club 1 479 660 2 451 104
Remarques
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction SommeCumulative().
• Vous pouvez définir le sens du calcul à l'aide des opérateurs LIGNE et
COL.
• Si vous appliquez un tri à l'indicateur référencé par la fonction
SommeCumulative(), Web Intelligence applique le tri au premier indicateur, puis calcule le total cumulé.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
• SommeCumulative() ne réinitialise pas automatiquement la somme après une rupture de bloc ou une nouvelle section.
Rubriques associées
•
page 199
•
page 201
72 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
EcartType
Description
Renvoie l'écart type d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique EcartType(indicateur)
Entrée
indicateur
Tout indicateur ou dimension numérique
Sortie
L'écart type de l'ensemble de nombres
Exemple
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8)
EcartType
(in
dicateur
) renvoie 2,58
Remarques
• L'écart type est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculée comme suit :
• • calcul de la moyenne d'un ensemble de nombres ;
• soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré ;
• addition de toutes ces différences élevées au carré ;
• division de cette somme par le nombre de nombres de
l'ensemble
- 1) ;
• calcul de la racine carrée du résultat.
Utilisation de fonctions, formules et calculs dans Web Intelligence 73
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
• L'écart type est la racine carrée de la variance.
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction
EcartType()
.
Rubriques associées
•
page 76
EcartTypeP
Description
Renvoie l'écart type de population d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique EcartTypeP([indicateur])
Entrée
[indicateur] Tout indicateur
Sortie
L'écart type de population de l'ensemble de nombres
Exemple
Si [indicateur] possède l'ensemble de valeurs (2, 4, 6, 8),
EcartTypeP([Chiffre d'affaires]) renvoie 2,24
Remarques
• L'écart type de population est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculée comme suit :
• • calcul de la moyenne d'un ensemble de nombres ;
74 Utilisation de fonctions, formules et calculs dans Web Intelligence
Somme
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• 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 les opérateurs contextuels de syntaxe avancée avec la fonction EcartTypeP().
Description
Renvoie le total d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique Somme([indicateur])
Entrée
[indicateur] Tout indicateur
Sortie
La somme de l'ensemble de nombres
Exemple
Si l'indicateur Chiffre d'affaires comporte les valeurs 2 000, 3 000, 4 000 et
1 000, Somme([Chiffre d'affaires]) renvoie 10 000
Remarque
Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction Somme().
Utilisation de fonctions, formules et calculs dans Web Intelligence 75
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Var
Description
Renvoie la variation d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique Var(indicateur)
Entrée
indicateur
Tout indicateur
Sortie
La variation de l'ensemble de nombres
Exemple
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8),
Var
(in
dicateur
) renvoie 6,67
Remarques
• La variation est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculée comme suit :
• • calcul de la moyenne d'un ensemble de nombres ;
• soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré ;
• addition de toutes ces différences élevées au carré ;
• division de cette somme par le nombre de nombres de
l'ensemble
- 1)
• La variation est le carré de l'
écart type()
.
76 Utilisation de fonctions, formules et calculs dans Web Intelligence
VarP
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction
Var()
.
Rubriques associées
•
page 73
Description
Renvoie la variation de population d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
numérique
VarP(indicateur)
Entrée
indicateur
Tout indicateur
Sortie
La variation de population de l'ensemble de nombres
Exemple
Si
indicateur
possède l'ensemble de valeurs (2, 4, 6, 8)
VarP
(in
dicateur
) renvoie 5
Remarques
• La variation de population est un indicateur de variation statistique dans un ensemble de nombres. Elle est calculée comme suit :
• • calcul de la moyenne d'un ensemble de nombres ;
• soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré ;
Utilisation de fonctions, formules et calculs dans Web Intelligence 77
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
• addition de toutes ces différences élevées au carré ;
• division de cette somme par le (nombre de nombres de
l'ensemble
).
• La variation de population est le carré de l'écart type de population.
• Vous pouvez utiliser les opérateurs contextuels de syntaxe avancée avec la fonction
VarP()
.
Rubriques associées
•
page 74
Fonctions du groupe Caractère
Asc
Description
Renvoie la valeur ASCII d'un caractère
Groupe de fonctions
Caractère
Syntaxe
entier Asc(chaîne chaîne_entrée)
Entrée
chaîne_en_entrée Un seul caractère
Remarques
Si chaîne_entrée contient plusieurs caractères, la fonction renvoie la valeur
ASCII du premier caractère dans la chaîne.
78 Utilisation de fonctions, formules et calculs dans Web Intelligence
Car
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
La valeur ASCII du caractère
Exemple
Asc("A") renvoie 65
Asc("ab") renvoie 97
Asc([Pays]) renvoie 85 lorsque la dimension Pays est "US"
Description
Renvoie le caractère associé à une valeur ASCII
Groupe de fonctions
Caractère
Syntaxe
chaîne Car(entier valeur_ascii)
Entrée
valeur_ascii Une valeur ASCII
Sortie
Le caractère associé à la valeur ASCII
Exemple
Car(123) renvoie "{"
Utilisation de fonctions, formules et calculs dans Web Intelligence 79
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Concaténation
Description
Concatène (joint) deux chaînes de caractères.
Groupe de fonctions
Caractère
Syntaxe
chaîne Concaténation(chaîne première_chaîne; chaîne deuxième_chaîne)
Entrée
première_chaîne deuxième_chaîne
La première chaîne
La seconde chaîne
Sortie
La chaîne concaténée
Exemple
Concaténation("Premier ";"Second") renvoie "Premier Second"
Remarque
Vous pouvez également utiliser l'opérateur "+" pour concaténer des chaînes.
Par exemple,
"Premier " + "Second" renvoie "Premier Second".
80 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Remplissage
Description
Construit une chaîne de caractères consistant en une chaîne répétée un certain nombre de fois
Groupe de fonctions
Caractère
Syntaxe
chaîne Répéter(chaîne répétition_chaîne; entier nombre_répétitions)
Entrée
chaîne_à_répéter nombre_de_répétitions
La chaîne à répéter
Le nombre de fois que la chaîne doit
être répétée
Sortie
La chaîne répétée
Exemple
Répéter("New York";2) renvoie "New York New York"
FormatDeDate
Description
formate une date selon le format spécifié.
Utilisation de fonctions, formules et calculs dans Web Intelligence 81
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatDeDate(date date_à_formater; chaîne format_date)
Entrée
date_à_formater format_de_date
N'importe quelle date
Le format à appliquer à la date
Sortie
La date (sous forme de chaîne) mise en forme selon le format spécifié dans
format_date
Exemple
FormatDeDate(DateActuelle();"dd/MM/yyyy") renvoie "15/12/2005" si la date actuelle est le 15 décembre 2005
Remarque
• Le format du résultat dépend du format de date appliqué à la cellule.
• Vous ne pouvez pas appliquer les chaînes de mise en forme des couleurs
(par exemple [Rouge], [Bleu] etc.) à la fonction FormatDeDate.
FormatDeNombre
Description
renvoie un nombre se présentant sous le format spécifié.
Groupe de fonctions
Caractère
82 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Syntaxe
chaîne FormatDeNombre(numérique numérique_au_format; chaîne format_numérique)
Entrée
nombre_à_formater format_nombre
N'importe quel nombre
Le format à appliquer au nombre
Sortie
Nombre se présentant sous le format de la chaîne de format
Exemple
FormatDeNombre[Revenu des ventes];"# ###,00") renvoie "835 420,00" si [Revenu des ventes] est d'une valeur de 835 420.
Remarques
• Le format du résultat dépend du format de nombre appliqué à la cellule.
• Vous ne pouvez pas appliquer les chaînes de mise en forme des couleurs
(par exemple [Rouge], [Bleu] etc.) à la fonction FormatDeNombre.
HTMLEncode
Description
Applique des règles d'encodage HTML à une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne HTMLEncode (chaîne html)
Utilisation de fonctions, formules et calculs dans Web Intelligence 83
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Entrée
html Une chaîne html
Sortie
La chaîne encodée
Exemple
HTMLEncode("http://www.businessobjects.com") renvoie
"http%3A%2F%2Fwww%2Ebusinessobjects%2Ecom "
Capitale
Description
Met en majuscule la première lettre d'une chaîne de caractères.
Groupe de fonctions
Caractère
Syntaxe
chaîne Capitale(chaîne chaîne_en_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Sortie
La chaîne de caractères avec la première lettre en majuscule
Exemple
Capitale("ces vérités sont évidentes") renvoie "Ces vérités sont
évidentes".
84 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Gauche
Description
Renvoie une chaîne constituée des n premiers caractères les plus à gauche de la chaîne en entrée
Groupe de fonctions
Caractère
Syntaxe
chaîne Gauche (chaîne chaîne_entrée; entier nombre_de_carac tères)
Entrée
chaîne_en_entrée nombre_de_caractères
La chaîne entrée.
Le nombre de caractères à prendre à gauche
Sortie
Chaîne constituée des n premiers caractères les plus à gauche de la chaîne en entrée, n correspondant au nombre_de_caractères
Exemple
Gauche([Pays];2) renvoie "France" si [Pays] est "France"
RemplissageGauche
Description
Remplit une chaîne à gauche avec une autre chaîne
Utilisation de fonctions, formules et calculs dans Web Intelligence 85
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Caractère
Syntaxe
chaîne RemplissageGauche(chaîne nouvelle_chaîne; entier lon gueur_sortie; chaîne chaîne_orig)
Entrée
nouvelle_chaîne longueur_sortie chaîne_orig
La chaîne à ajouter à gauche de la chaîne d'origine la longueur de la chaîne de sortie
La chaîne d'origine
Sortie
Une chaîne constituée de deux chaînes concaténées
Exemples
RemplissageGauche("York";8;"New ") renvoie "New York"
Remarques
• Si longueur_sortie est inférieure aux longueurs de nouvelle_chaîne et
chaîne_orig, nouvelle_chaîne est tronquée
• Si longueur_sortie est supérieure aux longueurs de nouvelle_chaîne et chaîne_orig, nouvelle_chaîne est répétée jusqu'à ce que la longueur soit atteinte
SupprEspGauche
Description
Supprime les espaces à gauche d'une chaîne de caractères
86 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspGauche (chaîne chaîne_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Longueur
Sortie
La chaîne en entrée sans les espaces du côté gauche
Exemple
SupprEspGauche([Pays]) renvoie "France" si [Pays] est " France"
Description
Renvoie la longueur d'une chaîne de caractères
Groupe de fonctions
Caractère
Syntaxe
entier Longueur(chaîne chaîne_en_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Utilisation de fonctions, formules et calculs dans Web Intelligence 87
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Minuscule
Sortie
longueur de la chaîne
Exemple
Longueur([Nom]) renvoie 5 si [Nom] est "Martin".
Description
Convertit une chaîne en minuscules
Groupe de fonctions
Caractère
Syntaxe
chaîne Minuscule(chaîne chaîne_en_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Sortie
La chaîne entrée en minuscules
Exemple
Minuscule("New York") renvoie "new york"
Correspondance
Description
détermine si une chaîne correspond à un modèle.
88 Utilisation de fonctions, formules et calculs dans Web Intelligence
Pos
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Caractère
Syntaxe
booléen Comparer(chaîne chaîne_en_entrée; chaîne modèle)
Entrée
chaîne_en_entrée modèle
La chaîne entrée.
Le modèle de comparaison
Sortie
Vrai si la chaîne correspond au modèle ; Faux dans le cas contraire.
Exemples
Comparer([Pays];"F*") renvoie Vrai si [Pays] est "France".
Comparer([Pays];"?S?") renvoie Vrai si [Pays] est "USA".
Comparer("New York";"P*") renvoie la valeur Faux
Remarque
• 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).
Description
Renvoie la position de départ d'une chaîne de caractères dans une chaîne
Groupe de fonctions
Caractère
Utilisation de fonctions, formules et calculs dans Web Intelligence 89
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
entier Pos(chaîne chaîne_en_entrée; chaîne modèle)
Entrée
chaîne_en_entrée modèle
La chaîne entrée.
Le modèle à rechercher
Sortie
La position de départ de la chaîne de caractères dans la chaîne
Exemples
Pos("New York";"Ne") renvoie 1
Pos("New York, New York";"Ne") renvoie 1
Pos("New York"; "York") renvoie 5
Remarque
• Si le modèle apparaît plusieurs fois, Comparer() renvoie la position de la première occurrence
Replace
Description
remplace une partie d'une chaîne par une autre chaîne.
Groupe de fonctions
Caractère
Syntaxe
chaîne Remplacer (chaîne chaîne_en_entrée; chaîne chaîne_à_remplacer; chaîne chaîne_de_remplacement)
90 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Entrée
chaîne_en_entrée chaîne_à_remplacer chaîne_de_remplacement
La chaîne entrée.
La chaîne à remplacer au sein de
chaîne_en_entrée
La chaîne devant remplacer
chaîne_à_remplacer.
Sortie
chaîne avec une partie remplacée
Exemple
Remplacer("New YORK";"ORK";"ork") renvoie "New York"
Droit
Description
Renvoie une chaîne constituée des n premiers caractères les plus à droite de la chaîne en entrée
Groupe de fonctions
Caractère
Syntaxe
chaîne Droite (chaîne chaîne_entrée; entier nombre_de_carac tères)
Entrée
chaîne_en_entrée La chaîne entrée.
Utilisation de fonctions, formules et calculs dans Web Intelligence 91
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
nombre_de_caractères Le nombre de caractères à renvoyer
à partir de la droite de la chaîne en entrée
Sortie
Chaîne constituée des n premiers caractères les plus à droite de la chaîne en entrée, n correspondant au nombre_de_caractères
Exemple
Droite([Pays];2) renvoie "ce" si [Pays] est "France"
RemplissageDroite
Description
Remplit une chaîne à droite avec une autre chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne RemplissageDroite(chaîne nouvelle_chaîne; entier lon gueur_sortie; chaîne chaîne_orig)
Entrée
nouvelle_chaîne longueur_sortie chaîne_orig
La chaîne à ajouter à droite de la chaîne d'origine la longueur de la chaîne de sortie
La chaîne d'origine
92 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
Une chaîne constituée de deux chaînes concaténées
Exemples
RemplissageDroite("New ";8;"York") renvoie "New York"
RemplissageDroite("New "; 6;"York") renvoie "New Yo"
RemplissageDroite("New "; 12;"York") renvoie "New YorkYork"
Remarques
• Si longueur_sortie est inférieure aux longueurs de nouvelle_chaîne et
chaîne_orig, nouvelle_chaîne est tronquée
• Si longueur_sortie est supérieure aux longueurs de nouvelle_chaîne et chaîne_orig, nouvelle_chaîne est répétée jusqu'à ce que la longueur soit atteinte
SupprEspDroite
Description
Supprime les espaces de fin (à droite) d'une chaîne.
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspDroite(chaîne chaîne_en_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Sortie
La chaîne entrée sans les espaces de fin de chaîne
Utilisation de fonctions, formules et calculs dans Web Intelligence 93
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemple
SupprEspDroite([Pays]) renvoie "France" si [Pays] est "France "
SousChaîne
Description
extrait une chaîne à partir d'une chaîne de caractères.
Groupe de fonctions
Caractère
Syntaxe
chaîne SousChaîne(chaîne chaîne_entrée; entier début; entier longueur)
Entrée
chaîne_en_entrée début longueur
La chaîne entrée.
La position du premier caractère de la chaîne extraite dans chaîne_en_entrée
La longueur de la chaîne extraite
Sortie
chaîne extraite
Exemples
SousChaîne("Grande Bretagne";1;6) renvoie "Grande".
SousChaîne("Grande Bretagne";8;8) renvoie "Bretagne".
94 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
SupprEspace
Description
Supprime les espaces de début et de fin d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspace(chaîne chaîne_en_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Majuscule
Sortie
chaîne sans espace de début et de fin
Exemple
SupprEspace(" Grande Bretagne ") renvoie "Grande Bretagne".
Description
Convertit une chaîne en majuscules
Groupe de fonctions
Caractère
Syntaxe
chaîne Majuscule(chaîne chaîne_en_entrée)
Utilisation de fonctions, formules et calculs dans Web Intelligence 95
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Entrée
chaîne_en_entrée La chaîne entrée.
UrlEncode
Sortie
La chaîne entrée en majuscules
Exemple
Majuscule("New York") renvoie "NEW YORK"
Description
Applique des règles d'encodage URL à une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne UrlEncode (chaîne html)
Entrée
html Une chaîne html
Sortie
La chaîne encodée
Exemple
UrlEncode("http://www.businessobjects.com") renvoie
"http%3A%2F%2Fwww%2Ebusinessobjects%2Ecom"
96 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
CapitaleMot
Description
Met en majuscule la première lettre de chaque mot d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne CapitaleMot(chaîne chaîne_en_entrée)
Entrée
chaîne_en_entrée La chaîne entrée.
Sortie
La chaîne entrée avec la première lettre de chaque mot en capitale
Exemple
CapitaleMot ("Chiffre d'affaires de mars") renvoie "Chiffre D'affaires
De Mars"
Fonctions Date et heure
DateActuelle
Description
Renvoie la date actuelle au format conforme aux paramètres régionaux
Utilisation de fonctions, formules et calculs dans Web Intelligence 97
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Date et heure
Syntaxe
date DateCourante()
Entrée
Rien
Sortie
Date actuelle
Exemple
DateActuelle() renvoie 10 septembre 2002 si la date est le
10 septembre 2002
HeureActuelle
Description
Renvoie l'heure actuelle au format conforme aux paramètres régionaux
Groupe de fonctions
Date et heure
Syntaxe
heure HeureCourante()
Sortie
heure courante
98 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
NomDuJour
Description
renvoie le nom du jour dans une date.
Groupe de fonctions
Date et heure
Syntaxe
chaîne NomDuJour(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
Sortie
nom du jour dans la date
Exemple
NomDuJour([Date de réservation]) renvoie "samedi" si la date figurant dans [Date de réservation] est le 15 décembre 2001 (ce qui correspond à un samedi)
Remarque
La date saisie doit être une variable. Vous ne pouvez pas spécifier directement la date, comme dans NomDuJour("07/15/2001")
NuméroDuJourDuMois
Description
renvoie, à partir d'une date, le numéro du jour dans le mois.
Utilisation de fonctions, formules et calculs dans Web Intelligence 99
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDuMois(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
Sortie
numéro du jour dans le mois
Exemple
NuméroDuJourDuMois([Date de réservation]) renvoie 15 si la date figurant dans [Date de réservation] est le 15 décembre 2001
NuméroDuJourDeLaSemaine
Description
Renvoie, à partir d'une date, le numéro du jour dans la semaine
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDeLaSemaine(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
100 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
numéro du jour dans la semaine
Exemple
NuméroDuJourDeLaSemaine([Date de réservation]) renvoie 1 si la date figurant dans [Date de réservation] est le 2 mai 2005 (ce qui correspond à un lundi).
Remarque
Web Intelligence considère le lundi comme le premier jour de la semaine.
NuméroDuJourDeAnnée
Description
renvoie, à partir d'une date, le numéro du jour dans l'année.
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDeAnnée(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
Sortie
numéro du jour dans l'année
Exemple
NuméroDuJourDeAnnée([Date de réservation]) renvoie 349 si la date figurant dans [Date de réservation] est le 15 décembre 2001
Utilisation de fonctions, formules et calculs dans Web Intelligence 101
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
JoursEntre
Description
renvoie le nombre de jours compris entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier JoursEntre(date première_date; date dernière_date)
Entrée
première_date dernière_date
La première date de la fourchette
La dernière date de la fourchette
Sortie
nombre de jours entre les deux dates
Exemple
JoursEntre([Date de la vente]; [Date de facture]) renvoie 2 si
[Date de la vente] correspond au 15 décembre 2001 et [Date de facture] au
17 décembre 2001
DernierJourDuMois
Description
Renvoie la date du dernier jour du mois pour une date donnée
102 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Date et heure
Syntaxe
date DernierJourDuMois(date date_en_entrée)
Entrée
date_en_entrée N'importe quelle date
Sortie
La date du dernier jour du mois dans la date en entrée
Exemple
DernierJourDuMois([Date de la vente]) renvoie 31 décembre 2005 si
[Date de la vente] correspond au 11 décembre 2005
DernierJourDeLaSemaine
Description
Renvoie la date du dernier jour de la semaine pour une date donnée
Groupe de fonctions
Date et heure
Syntaxe
date DernierJourDeLaSemaine(date date_en_entrée)
Entrée
date_en_entrée N'importe quelle date
Utilisation de fonctions, formules et calculs dans Web Intelligence 103
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Sortie
La date du dernier jour de la semaine dans la date en entrée
Exemple
DernierJourDeLaSemaine([Date de la vente]) renvoie 15 mai 2005 (un dimanche) si [Date de la vente] correspond au 11 mai 2005.
Remarque
Web Intelligence considère le lundi comme le premier jour de la semaine.
Mois
Description
renvoie, à partir d'une date, le nom du mois.
Groupe de fonctions
Date et heure
Syntaxe
chaîne Mois(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
Sortie
nom du mois dans la date
Exemple
Mois([Date de réservation]) renvoie "Décembre" si la date figurant dans
[Date de réservation] correspond au 15 décembre 2005
104 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
NuméroDuMoisDeAnnée
Description
renvoie, à partir d'une date, le numéro du mois.
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuMoisDeAnnée(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
MoisEntre
Sortie
numéro du mois dans la date
Exemple
NuméroDuMoisDeAnnée([Date de réservation]) renvoie 12 si la date figurant dans [Date de réservation] correspond au 15 décembre 2005
Description
Description
Renvoie le nombre de mois entre deux dates.
Groupe de fonctions
Date et heure
Utilisation de fonctions, formules et calculs dans Web Intelligence 105
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
entier MoisEntre(date première_date; date dernière_date)
Entrée
première_date dernière_date
La première date de la fourchette
La dernière date de la fourchette
Trimestre
Sortie
nombre de mois entre les deux dates
Exemple
MoisEntre([Date de la vente]; [Date de facture]) renvoie 1 si [Date de la vente] correspond au 30 décembre 2005 et [Date de facture] au 2 janvier 2006
Description
renvoie, à partir d'une date, le numéro du trimestre.
Groupe de fonctions
Date et heure
Syntaxe
entier Trimestre(date date_entrée)
Entrée
date_en_entrée N'importe quelle date
106 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
numéro correspondant au trimestre dans la date
Exemple
Trimestre([Date de réservation]) renvoie 4 si la date figurant dans
[Date de réservation] correspond au 15 décembre 2005
DateRelative
Description
renvoie une date égale à la date en entrée plus un certain nombre nombre de jours.
Groupe de fonctions
Date et heure
Syntaxe
date DateRelative(date date_entrée; entier nombre_de_jours)
Entrée
première_date dernière_date
La première date de la fourchette
La dernière date de la fourchette
Sortie
date représentée par date_en_entrée + nombre_de_jours
Exemple
DateRelative([Date de réservation];2) renvoie 17 décembre 2005 si
[Date de réservation] correspond au 15 décembre 2005
Utilisation de fonctions, formules et calculs dans Web Intelligence 107
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
EnDate
Description
renvoie une chaîne de caractères spécifiant la date indiquée dans le format défini.
Groupe de fonctions
Date et heure
Syntaxe
date DateEn(chaîne chaîne_en_entrée; chaîne format)
Entrée
chaîne_en_entrée format
La chaîne entrée.
Le format de la date saisie
Sortie
Date mise en forme selon le format spécifié dans format
.
Exemple
EnDate("15/12/2002";"dd/MM/yyyy") renvoie 15 décembre 2002.
EnNombre
Description
renvoie une chaîne sous la forme de nombre.
Groupe de fonctions
Numérique
108 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Syntaxe
numérique EnNombre(chaîne chaîne_numérique)
Entrée
nombre_chaîne La chaîne à convertir en nombre
Semaine
Sortie
chaîne convertie en nombre
Exemple
EnNombre("45") renvoie 45
Remarque
Si chaîne_numérique ne correspond pas à un nombre, la fonction
EnNombre() renvoie #ERREUR
Description
Renvoie, à partir d'une date, le numéro de la semaine dans l'année
Groupe de fonctions
Date et heure
Syntaxe
entier Semaine (date date_entrée)
Entrée
date_en_entrée N'importe quelle date
Utilisation de fonctions, formules et calculs dans Web Intelligence 109
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Sortie
numéro correspondant à la semaine dans la date
Exemple
Semaine([Date de réservation]) renvoie 1 si la date figurant dans [Date de réservation] est le 4 janvier 2004 (ce qui correspond à la première semaine de l'année 2004).
Année
Description
renvoie, à partir d'une date, le nombre correspondant à l'année.
Groupe de fonctions
Date et heure
Syntaxe
entier Année (date date_entrée)
Entrée
date_en_entrée N'importe quelle date
Sortie
nombre qui correspond à l'année dans la date
Exemple
Année([Date de réservation]) renvoie 2005 si la date figurant dans [Date de réservation] est le 15 décembre 2005
110 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Fonctions du groupe Fournisseur de données
Connexion
Description
Renvoie les paramètres de la connexion à la base de données utilisée par un fournisseur de données.
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne Connexion(objet fournisseur_données)
Entrée
fournisseur_de_données Le fournisseur de données
Sortie
La liste des paramètres
Exemples
Connexion([RequêteVentes]) peut renvoyer
"BO_DRV_CONNECT_MODE=0;BO_DSN=eMode;ODBC_USER=;ODBC_PAS
SWORD=;"
(La valeur renvoyée varie en fonction de la connexion à la base de données.)
Remarque
Vous devez mettre le nom du fournisseur de données entre crochets
Utilisation de fonctions, formules et calculs dans Web Intelligence 111
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
FournisseurDeDonnées
Description
Renvoie le nom d'un fournisseur de données contenant une variable.
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne FournisseurDeDonnées (variable [toute_variable])
Entrée
toute_variable N'importe quelle variable dans un fournisseur de données
Sortie
Le nom du fournisseur de données
Exemple
FournisseurDeDonnées([Revenu total]) renvoie "Ventes" si [Revenu total] se trouve dans un fournisseur de données appelé "Ventes".
DateCléFournisseurDonnées
Description
Renvoie la date clé d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
112 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Syntaxe
date DateCléFournisseurDonnées(objet fournisseur_de_données)
Entrée
fournisseur_de_données Un fournisseur de données
Sortie
La date clé du fournisseur de données
Exemple
DateCléFournisseurDonnées([Ventes]) renvoie le 3 août 2007 si la date clé du fournisseur de données Ventes est le 3 août 2007
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
LégendeDateCléFournisseurDonnées
Description
Renvoie la légende de la date clé du fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne LégendeDateCléFournisseurDonnées(objet fournisseur_de_don nées)
Utilisation de fonctions, formules et calculs dans Web Intelligence 113
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Entrée
fournisseur_de_données Un fournisseur de données
Sortie
La légende de la date clé
Exemple
LégendeDateCléFournisseurDonnées([Ventes]) renvoie la "Date actuelle du calendrier" si la légende de date clé du fournisseur de données Ventes est "Date actuelle du calendrier"
Remarque
Vous devez mettre le nom du fournisseur de données entre crochets
SQLDuFournisseur
Description
Renvoie le SQL généré par un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne FournisseurDuSQL (objet fournisseur_données)
Entrée
fournisseur_de_données Un fournisseur de données
Sortie
Le SQL généré par le fournisseur de données
114 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple
SQLDuFournisseur([Requête 1]) renvoie "SELECT pays.nom_pays
FROM pays" si le SQL du fournisseur de données est "SELECT
pays.nom_pays FROM pays"
Remarque
Vous devez mettre le nom du fournisseur de données entre crochets
TypeDuFournisseur
Description
Renvoie le type d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne TypeDuFournisseur (objet fournisseur_de_données)
Entrée
fournisseur_de_données Un fournisseur de données
Sortie
"Univers" si le fournisseur de données est un univers ; "Données personnelles" si le fournisseur de données est un fournisseur de données personnelles
Exemple
TypeDuFournisseur([Ventes]) renvoie "Univers" si le fournisseur de données Ventes est basé sur un univers
Utilisation de fonctions, formules et calculs dans Web Intelligence 115
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Remarque
Vous devez mettre le nom du fournisseur de données entre crochets
DateDeLaDernièreExécution
Description
Renvoie la date de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateDeLaDernièreExécution(objet fournisseur_de_données)
Entrée
fournisseur_de_données
Un fournisseur de données (facultatif)
Sortie
La date de la dernière actualisation du fournisseur de données
Exemple
DateDeLaDernièreExécution(Requête ventes) renvoie "4/3/2002" si le fournisseur de données Requête ventes a été actualisé pour la dernière fois le 4 mars 2002
Remarques
• Si votre rapport ne comporte qu'un fournisseur de données, vous pouvez omettre le paramètre fournisseur_de_données
• 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.
116 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Rubriques associées
•
page 112
DuréeDernièreExécution
Description
Renvoie le temps, en secondes, mis par le fournisseur de données pour renvoyer ses données lors de la dernière exécution
Groupe de fonctions
Fournisseur de données
Syntaxe
numérique DuréeDernièreExécution(objet fournisseur_de_données)
Entrée
fournisseur_de_données Un fournisseur de données
Sortie
Le temps, en secondes, mis par le fournisseur de données pour renvoyer ses données lors de la dernière exécution
Exemple
DuréeDernièreExécution([Ventes]) renvoie 3 s'il a fallu 3 secondes au fournisseur de données Ventes pour renvoyer ses données lors de la dernière exécution
Remarque
Vous devez mettre le nom du fournisseur de données entre crochets
Utilisation de fonctions, formules et calculs dans Web Intelligence 117
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
HeureDeLaDernièreExécution
Description
Renvoie l'heure de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date HeureDeLaDernièreExécution(objet fournisseur_de_données)
Entrée
fournisseur_de_données
Un fournisseur de données (facultatif)
Sortie
L'heure de la dernière actualisation du fournisseur de données
Exemple
HeureDeLaDernièreExécution(Requête ventes) renvoie "2:48:00 PM" si le fournisseur de données Requête ventes a été actualisé pour la dernière fois à 14 h 48.
Remarques
• Si votre rapport ne comporte qu'un fournisseur de données, vous pouvez omettre le paramètre fournisseur_de_données
• Vous pouvez utiliser la fonction
FournisseurDeDonnées() pour fournir une référence à un fournisseur de données.
• Vous devez mettre le nom du fournisseur de données entre crochets
Rubriques associées
•
page 112
118 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
NombreDeFournisseurs
Description
Renvoie le nombre de fournisseurs de données dans un rapport
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NombreDeFournisseurs()
Sortie
Le nombre de fournisseurs de données dans le rapport
Exemple
NombreDeFournisseurs() renvoie 2 si le rapport comporte deux fournisseurs de données
NombreDeLignes
Description
Renvoie le nombre de lignes dans un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NombreDeLignes(objet fournisseur_de_données)
Utilisation de fonctions, formules et calculs dans Web Intelligence 119
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Entrée
fournisseur_de_données
Un fournisseur de données
Sortie
Le nombre de lignes dans le fournisseur de données
Exemple
NombreDeLignes(Requête 1) renvoie 10 si le fournisseur de données
Requête 1
comporte 10 lignes
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.
Rubriques associées
•
page 112
DateDeLaValeurDeRéférence
Description
Renvoie la date des données de référence utilisées dans le cadre du suivi des données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateDeLaValeurDeRéférence()
Entrée
Aucune
120 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
Date des données de référence
RéponseUtilisateurValeurRéf
Description
Renvoie les données saisies en réponse à une invite, lorsque les données de référence étaient les données actuelles
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateurValeurRéf(objet fournisseur_de_données; chaîne texte_invite;Index)
Entrée
fournisseur_de_données texte_invite
Index
Fournisseur de données (facultatif)
Texte qui s'affiche dans l'invite
Indique à la fonction de renvoyer les clés primaires de base de données des valeurs d'invite plutôt que les valeurs proprement dites.
Sortie
Données saisies dans l'invite
Exemple
RéponseUtilisateurValeurRéf("Quelle ville ?" ) renvoie "Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" lorsque les données de référence étaient les données actuelles.
Utilisation de fonctions, formules et calculs dans Web Intelligence 121
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
RéponseUtilisateurValeurRéf([Requête ventes];"Quelle ville ?") renvoie "Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes" lorsque les données de référence
étaient les données actuelles.
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 sélectionnez plusieurs valeurs en réponse à une invite, la fonction renvoie une chaîne constituée d'une liste de valeurs (ou de clés primaires si l'opérateur Index est spécifié) séparées par des points-virgules.
NomDeUnivers
Description
Renvoie le nom de l'univers sur lequel est basé le fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne NomDeUnivers(objet fournisseur_de_données)
Entrée
fournisseur_de_données
Le fournisseur de données
Sortie
Le nom de l'univers
122 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple
NomDeUnivers(Requête 1) renvoie "eMode" si le fournisseur de données est basé sur l'univers eMode
Remarques
• Web Intelligence met automatiquement à jour le nom du fournisseur de données dans la formule. Si, dans l'exemple, le fournisseur de données est renommé Q1, la formule devient
NomDeUnivers
(Q1)
• 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.
Rubriques associées
•
page 112
RéponseUtilisateur
Description
Renvoie les données saisies en réponse à une invite.
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateur(objet fournisseur_de_don
nées; chaînetexte_invite; Index)
Entrée
fournisseur_de_données texte_invite
Fournisseur de données (facultatif)
Texte qui s'affiche dans l'invite
Utilisation de fonctions, formules et calculs dans Web Intelligence 123
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Index Indique à la fonction de renvoyer les clés primaires de base de données des valeurs d'invite plutôt que les valeurs proprement dites.
Sortie
Données saisies dans l'invite
Exemple
RéponseUtilisateur( "Quelle ville ?" ) renvoie "Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?".
RéponseUtilisateur ([Requête ventes];"Quelle ville ?") renvoie
"Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes".
RéponseUtilisateur([Requête ventes];"Quelle ville ?";Index) renvoie 23 si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes" et que la clé primaire de base de données de Madrid est 23.
Remarques
• Vous devez mettre le nom du fournisseur de données entre crochets.
• Vous pouvez utiliser la fonction
FournisseurDeDonnées() pour fournir une référence à un fournisseur de données.
• Si vous sélectionnez plusieurs valeurs en réponse à une invite, la fonction renvoie une chaîne constituée d'une liste de valeurs (ou de clés primaires si l'opérateur Index est spécifié) séparées par des points-virgules.
124 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Fonctions Document
AuteurDuDocument
Description
renvoie l'identification InfoView de la personne qui a créé le document.
Groupe de fonctions
Document
Syntaxe
chaîne AuteurDuDocument()
Entrée
Aucune
Sortie
identification InfoView de l'auteur du document
Exemple
AuteurDuDocument() renvoie "gkn" si le nom de connexion de l'auteur du document est "gkn".
DateDeCréationDuDocument
Description
Renvoie la date à laquelle un document a été créé.
Groupe de fonctions
Document
Utilisation de fonctions, formules et calculs dans Web Intelligence 125
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
date DateDeCréationDuDocument()
Entrée
Aucune
Sortie
La date à laquelle le document a été créé.
HeureDeCréationDuDocument
Description
Renvoie l'heure à laquelle un document a été créé.
Groupe de fonctions
Document
Syntaxe
heure HeureDeCréationDuDocument()
Entrée
Aucune
Sortie
L'heure à laquelle le document a été créé.
DateDuDocument
Description
Renvoie la date à laquelle un document a été enregistré pour la dernière fois.
126 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Document
Syntaxe
date DateDuDocument()
Entrée
Aucune
Sortie
date à laquelle le document a été enregistré pour la dernière fois
Exemple
DateDuDocument() renvoie 8 août 2005 si le document a été enregistré pour la dernière fois le 8 août 2005
NomDuDocument
Description
renvoie le nom du document.
Groupe de fonctions
Document
Syntaxe
chaîne NomDuDocument()
Entrée
Aucune
Sortie
Nom du document
Utilisation de fonctions, formules et calculs dans Web Intelligence 127
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemple
NomDuDocument() renvoie "Rapport des ventes" si le document se nomme
"Rapport des ventes"
DocumentPartiellementActualisé
Description
détermine si un document est partiellement ou totalement actualisé.
Groupe de fonctions
Document
Syntaxe
booléen DocumentPartiellementActualisé()
Entrée
Aucune
Sortie
True si le document est partiellement actualisé ; False si le document est entièrement actualisé
Exemple
DocumentPartiellementActualisé() renvoie la valeur Vrai si Web
Intelligence est encore en train d'extraire des données de document
Remarque
DocumentPartiellementActualisé() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
page 176. Si vous placez
Est
Chaîne() directement dans une colonne, Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
128 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
HeureDuDocument
Description
renvoie l'heure à laquelle un document a été enregistré pour la dernière fois.
Groupe de fonctions
Document
Syntaxe
heure HeureDuDocument()
Entrée
Aucune
Sortie
heure à laquelle le document a été enregistré pour la dernière fois
Exemple
HeureDuDocument() renvoie 15:45 si le document a été enregistré pour la dernière fois à 15 h 45
Remarque
Le format de l'heure renvoyée varie en fonction du format de cellule
FiltresExploration
Description
Renvoie les filtres d'exploration appliqués à un document ou à un objet en mode Exploration
Utilisation de fonctions, formules et calculs dans Web Intelligence 129
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Document
Syntaxe
chaîne FiltresExploration([objet]; [séparateur de chaîne])
Entrée
[objet] séparateur
Tout objet
Le séparateur du filtre d'exploration
(facultatif)
Sortie
Les filtres d'exploration appliqués à la variable ou à l'objet
Exemples
FiltresExploration() renvoie "US" si le document possède un filtre d'exploration limitant l'objet [Pays] à "US"
FiltresExploration() renvoie "US - 1999" si le document possède un filtre limitant les objets [Pays] à "US" et [Année] à 1999
FiltresExploration("/") renvoie "US / 1999" si le document possède un filtre limitant les objets [Pays] à "US" et [Année] à 1999
FiltresExploration ([Trimestre]) renvoie "T3" si le document possède un filtre d'exploration limitant l'objet [Trimestre] à "T3"
Remarques
• Vous pouvez insérer la fonction FiltresExploration() directement sans saisir manuellement la formule en insérant une cellule de filtres d'exploration.
• Si vous ne spécifiez aucun objet, la fonction renvoie tous les filtres d'exploration appliqués au document.
130 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
DateDeLaDernièreImpression
Description
Renvoie la date à laquelle le document a été imprimé pour la dernière fois
Groupe de fonctions
Document
Syntaxe
date DateDeLaDernièreImpression()
Entrée
Aucune
Sortie
La date de la dernière impression du document (ou rien si le document n'a jamais été imprimé)
Exemples
DateDeLaDernièreImpression () renvoie 12 décembre 2005 si le document a été imprimé pour la dernière fois le 12 décembre 2005
RésuméInvite
Description
Renvoie le texte de l'invite et la réponse donnée par l'utilisateur, pour toutes les invites d'un document
Groupe de fonctions
Document
Utilisation de fonctions, formules et calculs dans Web Intelligence 131
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
chaîne RésuméInvite()
Entrée
Aucune
Sortie
Texte de l'invite et réponse donnée par l'utilisateur, pour toutes les invites du document
Exemple
Exemple de sortie
RésuméInvite
:
Enter Quantity Sold: 5000
Enter value(s) for State (optional): California, Texas, Utah
Enter Customer (optional):
RésuméRequête
Description
Renvoie des informations sur les requêtes d'un document
Groupe de fonctions
Document
Syntaxe
chaîne RésuméRequête(objet fournisseur_de_données)
Entrée
fournisseur_de_données Un fournisseur de données (facultatif)
[aucun]
132 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
Informations sur les requêtes
Exemple
Exemple de sortie
RésuméRequête([Requête 1])
:
Query 1:
Universe: eFashion
Last execution time: 1s
NB of rows: 34500
Result objects: State, Year, Sales Revenue
Scope of analysis: State, City, Year, Quarter, Month
Filters:
(State inlist{"US";"France";}
And (Sales Revenue Greater Than 1000000
Or Sales Revenue Less Than 10000))
Query 2:
Source file: D:\Data\datacar.xls
Result objects: State, Year, Sales Revenue
Remarques
• Vous devez mettre le nom du fournisseur de données entre crochets
FiltreRapport
Description
Renvoie les filtres de rapport appliqués à un objet ou un rapport
Groupe de fonctions
Document
Syntaxe
chaîne FiltreRapport([objet]|)
Entrée
[objet] Tout objet rapport
Utilisation de fonctions, formules et calculs dans Web Intelligence 133
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Sortie
Les filtres de rapport appliqués à l'objet ou au rapport
Exemples
FiltreRapport([Pays]) renvoie "US" si un filtre limite l'objet Pays à "US"
RésuméFiltreRapport
Description
Renvoie des informations sur les filtres de rapport d'un document
Groupe de fonctions
Document
Syntaxe
chaîne RésuméFiltreRapport([chaîne nom_rapport])
Entrée
nom_rapport Le nom du rapport (facultatif)
Sortie
Informations sur les filtres de rapport
Exemple
RésuméFiltreRapport() renvoie des informations sur tous les filtres de rapport d'un document.
RésuméFiltreRapport("Ventes du dernier trimestre") renvoie des informations sur les filtres du rapport "Ventes du dernier trimestre".
134 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple de sortie :
Filters on Report1:
(Sales Revenue Greater Than 1000000
Or (Sales Revenue Less Than 3000))
Filters on Section on City:
(City InList{"Los Angeles";"San Diego";})
Ranking Filter:
(Top 10 & Bottom 10 [Customer] Based on [Sales Revenue] (Count))
NomRapport
Description
Renvoie le nom d'un rapport
Groupe de fonctions
Document
Syntaxe
Chaîne NomRapport()
Entrée
Aucune
Sortie
Le nom du rapport où la fonction est placée
Exemple
Si
NomRapport() est placé dans un rapport appelé "Rapport des ventes", alors "Rapport des ventes" est renvoyé.
RéponseUtilisateur
Description
Renvoie les données saisies en réponse à une invite.
Utilisation de fonctions, formules et calculs dans Web Intelligence 135
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateur(objet fournisseur_de_don
nées; chaînetexte_invite; Index)
Entrée
fournisseur_de_données texte_invite
Index
Fournisseur de données (facultatif)
Texte qui s'affiche dans l'invite
Indique à la fonction de renvoyer les clés primaires de base de données des valeurs d'invite plutôt que les valeurs proprement dites.
Sortie
Données saisies dans l'invite
Exemple
RéponseUtilisateur( "Quelle ville ?" ) renvoie "Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?".
RéponseUtilisateur ([Requête ventes];"Quelle ville ?") renvoie
"Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes".
RéponseUtilisateur([Requête ventes];"Quelle ville ?";Index) renvoie 23 si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" du fournisseur de données "Requête ventes" et que la clé primaire de base de données de Madrid est 23.
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.
136 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• Si vous sélectionnez plusieurs valeurs en réponse à une invite, la fonction renvoie une chaîne constituée d'une liste de valeurs (ou de clés primaires si l'opérateur Index est spécifié) séparées par des points-virgules.
Fonctions du groupe Logique
Pair
Description
Détermine si un nombre est pair
Groupe de fonctions
Logique
Syntaxe
booléen Pair(numérique numérique_entré)
Entrée
numérique_entré N'importe quel nombre
Sortie
True si le nombre est pair, False dans le cas contraire
Exemples
Pair(4) renvoie True.
Pair(23.2) renvoie la valeur Faux.
Pair(24.2) renvoie la valeur Vrai.
Utilisation de fonctions, formules et calculs dans Web Intelligence 137
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Remarques
Pair() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si. Si vous placez la fonction directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
EstDate
Description
détermine si une variable est de type date.
Groupe de fonctions
Logique
Syntaxe
booléen EstDate (objet)
Entrée
objet
Tout objet
Sortie
True si l'objet est de type date, False dans le cas contraire
Exemples
EstDate(Date de réservation) renvoie Vrai si la variable Date de
réservation
est de type date.
Si( EstDate(Date de réservation;"Date";"Pas une date") renvoie
"Date" si la variable Date de réservation est de type date.
Remarque
EstDate( renvoie une valeur booléenne que vous pouvez utiliser dans la fonction Si. Si vous placez
EstDate() directement dans une colonne,
138 Utilisation de fonctions, formules et calculs dans Web Intelligence
EstErreur
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
Description
Détermine si une variable renvoie une erreur
Groupe de fonctions
Logique
Syntaxe
booléen
EstErreur (objet)
Entrée
objet
Tout objet
Sortie
True si l'objet renvoie une erreur, False dans le cas contraire
Exemples
EstErreur(Chiffre d'affaires) renvoie la valeur Faux si la variable
Chiffre d'affaires
ne renvoie pas d'erreur
EstErreur(Nombre moyen de clients) renvoie la valeur Vrai si la variable
Nombre moyen de clients
renvoie une erreur de division par zéro
(#DIV/0).
Si ( EstErreur(Chiffre d'affaires);"Erreur";"Aucune erreur" renvoie "Erreur" si la variable Chiffre d'affaires renvoie une erreur
Utilisation de fonctions, formules et calculs dans Web Intelligence 139
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Remarque
EstErreur() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
EstErreur() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
EstLogique
Description
Détermine si un objet est de type booléen
Groupe de fonctions
Logique
Syntaxe
booléen
EstLogique (objet)
Entrée
objet
Tout objet
Sortie
True si l'objet est de type booléen, False dans le cas contraire
Exemples
EstLogique(EstChaîne) renvoie la valeur Vrai si la variable EstChaîne possède la formule EstChaîne(Pays)
Si ( EstLogique(EstChaîne;"Logique";"Pas logique") renvoie "Logique" si la variable EstChaîne possède la formule
EstChaîne
(Pays)
140 Utilisation de fonctions, formules et calculs dans Web Intelligence
EstNul
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Remarque
EstLogique() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
EstLogique() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
Description
Détermine si une variable est nulle
Groupe de fonctions
Logique
Syntaxe
booléen EstNul(objet)
Entrée
objet
Tout objet
Sortie
True si la variable est nulle, False dans le cas contraire
Exemples
EstNul
(Chiffre d'affaires) renvoie la valeur Faux si la variable
Chiffre d'affaires
n'est pas nulle.
EstNul
(Nombre moyen d'invités) renvoie la valeur Vrai si la variable
Nombre moyen d'invités
est nulle.
Utilisation de fonctions, formules et calculs dans Web Intelligence 141
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Si
(
EstNul
(Chiffre d'affaires)"Nul";"Pas nul") renvoie "Nul" si la variable Chiffre d'affaires est nulle.
Remarque
EstNul() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
EstNul() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
EstNombre
Description
Détermine si une variable est un nombre
Groupe de fonctions
Logique
Syntaxe
booléen EstNombre(objet)
Entrée
objet
Tout objet
Sortie
True si l'objet est un nombre, False dans le cas contraire
Exemples
EstNombre(Chiffre d'affaires) renvoie la valeur Vrai si la variable
Chiffre d'affaires
est un nombre.
142 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
EstNombre(Nom du client ) renvoie la valeur Faux si la variable Nom du
client
n'est pas un nombre.
Si (EstNombre ( Chiffre d'affaires);"Nombre";"Pas un nombre") renvoie "Nombre" si la variable Chiffre d'affaires est numérique.
Remarque
EstNombre() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
EstNombre() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
RéponseInvite
Description
Indique si une réponse a été donnée à l'invite
Groupe de fonctions
Booléen
Syntaxe
booléen RéponseInvite (objet fournisseur_de_données; chaîne invite)
Entrée
fournisseur_de_don nées invite
Le fournisseur de données (facultatif)
Texte associé à l'invite
Utilisation de fonctions, formules et calculs dans Web Intelligence 143
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
EstChaîne
Sortie
Vrai si une réponse a été donnée à l'invite, faux dans le cas contraire
Exemple
RéponseInvite ([Ventes];"Choisir une ville") renvoie la valeur Vrai si une réponse a été donnée à l'invite identifiée par le texte "Choisir une ville" dans le fournisseur de données [Ventes].
Remarque
Vous devez mettre le nom du fournisseur de données entre crochets
Description
détermine si une variable est une chaîne.
Groupe de fonctions
Logique
Syntaxe
booléen EstChaîne(objet)
Entrée
objet
Tout objet
Sortie
True si l'objet est une chaîne, False dans le cas contraire
Exemples
EstChaîne(Chiffre d'affaires) renvoie la valeur Faux si la variable
Chiffre d'affaires
n'est pas une chaîne.
144 Utilisation de fonctions, formules et calculs dans Web Intelligence
EstHeure
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
EstChaîne(Nom du client ) renvoie la valeur Vrai si la variable Nom du
client
est une chaîne.
Si(EstChaînePays);"Chaîne";"Pas une chaîne") renvoie "Chaîne" si la variable Pays est une chaîne.
Remarque
EstChaîne() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
EstChaîne() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
Description
Détermine si une variable est une variable d'heure
Groupe de fonctions
Logique
Syntaxe
booléen EstHeure(objet)
Entrée
objet
Tout objet
Sortie
True si la variable est une variable d'heure, False dans le cas contraire
Utilisation de fonctions, formules et calculs dans Web Intelligence 145
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemples
EstHeure(Heure de réservation) renvoie Vrai si la variable Heure de
réservation
est une variable d'heure.
EstHeure(Nombre moyen d'invités) renvoie Faux si la variable Nombre
moyen d'invités
n'est pas une variable d'heure.
Si(EstHeure(Heure de réservation);"heure";"Pas heure") renvoie
"Heure" si la variable Heure de réservation est une variable d'heure.
Remarque
EstHeure() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
EstHeure() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Rubriques associées
•
page 176
Impair
Description
Détermine si un nombre est impair
Groupe de fonctions
Logique
Syntaxe
booléen Impair(numérique numérique_entré)
Entrée
numérique_entré
N'importe quel nombre
146 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
True si le nombre est impair, False dans le cas contraire
Exemple
Impair(5) renvoie la valeur Vrai.
Impair(23,2) renvoie la valeur Vrai.
Impair(24,2) renvoie la valeur Faux.
Si(Impair(Chiffre d'affaires);'Impair';'Pair') renvoie Impair si
Chiffre d'affaires
possède une valeur impaire.
Remarques
•
Impair() renvoie une valeur booléenne que vous pouvez utiliser dans la fonction
Si()
. Si vous placez
Impair() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier. Vous pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
•
Impair() ignore les fractions des nombres décimaux
Rubriques associées
•
page 176
Fonctions du groupe Numérique
Abs
Description
Renvoie la valeur absolue d'un nombre (la valeur du nombre sans le signe)
Groupe de fonctions
Numérique
Syntaxe
numérique Abs (numérique numérique_entré)
Utilisation de fonctions, formules et calculs dans Web Intelligence 147
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Entrée
numérique_entré Un ensemble de valeurs numériques
(par exemple un indicateur)
Sortie
Valeur absolue du nombre
Exemples
Abs(25) renvoie 25
Abs(-11) renvoie 11
Plafond
Description
renvoie un nombre arrondi au nombre entier supérieur le plus proche.
Groupe de fonctions
Numérique
Syntaxe
numérique Plafond(numérique nombre_en_entrée)
Entrée
numérique_entré Toute variable numérique
Sortie
nombre arrondi au nombre entier supérieur le plus proche
148 Utilisation de fonctions, formules et calculs dans Web Intelligence
Cos
Exemples
Plafond(2,4) renvoie 3
Plafond(3.1) renvoie 4
Plafond(-3.1) renvoie -3
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Description
Renvoie le cosinus d'un nombre, où le nombre est un angle exprimé en radians.
Groupe de fonctions
Numérique
Syntaxe
numérique Cos(numérique angle)
Entrée
angle Un angle en radians
Sortie
Le cosinus de l'angle
Exemples
Cos(180) renvoie -0,6
Utilisation de fonctions, formules et calculs dans Web Intelligence 149
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
ConvertirDepuisEuro
Description
Convertit un montant en euros dans une autre devise
Groupe de fonctions
Numérique
Syntaxe
numérique ConvertirDepuisEuro(numérique montant; chaîne code; entier nombre_décimales)
Entrée
montant code nombre_de_décimales
Le montant en euros
Le code ISO de la devise cible
Le nombre de décimales dans le montant converti
Sortie
Le montant dans la devise cible
Exemple
ConvertirDepuisEuro(1000;"FRF";2) renvoie 6559,57
ConvertirDepuisEuro(1000;"FRF";1) renvoie 6559,60
ConvertirDepuisEuro(1000.04 ;"DEM";2) renvoie 1955,91
ConvertirDepuisEuro(1000.04 ;"DEM";1) renvoie 1955,90
150 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
FRF
IEP
ITL
LUF
BEF
DEM
GRD
ESP
NLG
ATS
PTS
FIM
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Ces devises sont :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
ConvertirEnEuro
Description
Convertit un montant exprimé dans une autre devise en euros
Groupe de fonctions
Numérique
Utilisation de fonctions, formules et calculs dans Web Intelligence 151
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
numérique ConvertirDepuisEuro(numérique montant; chaîne code; entier nombre_décimales)
Entrée
montant code nombre_de_décimales
Le montant dans la devise d'origine
Le code ISO de la devise d'origine
Le nombre de décimales dans le montant converti
Sortie
Le montant en euros
Exemple
ConvertirEnEuro(6559;"FRF";2) renvoie 99,91
ConvertirEnEuro(6559;"FRF";1) renvoie 99,90
ConvertirEnEuro(1955;"DEM";2) renvoie 999,58
ConvertirEnEuro(1955;"DEM";1) renvoie 999,60
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Ces devises sont :
BEF
DEM
GRD
ESP
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
152 Utilisation de fonctions, formules et calculs dans Web Intelligence
FRF
IEP
ITL
LUF
NLG
ATS
PTS
FIM
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Franc français
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
ErreurEuroParArrondi
Description
Renvoie l'erreur d'arrondi dans un calcul de conversion en euro d'un montant exprimé dans une autre devise
Groupe de fonctions
Numérique
Syntaxe
numérique ErreurEuroParArrondi(numérique montant; chaîne code; entier nombre_décimales)
Entrée
montant code
Le montant en euros
Le code ISO de la devise cible
Utilisation de fonctions, formules et calculs dans Web Intelligence 153
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
nombre_de_décimales Le nombre de décimales dans le montant converti
Sortie
L'erreur d'arrondi du calcul
Exemple
ErreurArrondiConvertirDepuisEuro(1000;"FRF";2) renvoie 0
ErreurArrondiConvertirDepuisEuro(1000;"FRF";1) renvoie 0,03
ErreurArrondiConvertirDepuisEuro(1000.04;"DEM";2) renvoie 0
ErreurArrondiConvertirDepuisEuro(1000.04;"DEM";1) renvoie -0,01
BEF
DEM
GRD
ESP
FRF
IEP
ITL
LUF
NLG
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Ces devises sont :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
154 Utilisation de fonctions, formules et calculs dans Web Intelligence
ATS
PTS
FIM
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Schilling autrichien
Escudo portugais
Mark finnois
ErreurEuroVersArrondi
Description
Renvoie l'erreur d'arrondi dans un calcul de conversion d'un montant en euros vers une autre devise
Groupe de fonctions
Numérique
Syntaxe
numérique ErreurEuroVersArrondi(numérique montant; chaîne code; entier nombre_décimales)
Entrée
montant code nombre_de_décimales
Le montant en euros
Le code ISO de la devise cible
Le nombre de décimales dans le montant converti
Sortie
L'erreur d'arrondi du calcul
Exemples
ErreurArrondiConvertirEnEuro(6559;"FRF";2) renvoie 0
Utilisation de fonctions, formules et calculs dans Web Intelligence 155
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
ErreurArrondiConvertirEnEuro(6559;"FRF";1) renvoie -0,01
ErreurArrondiConvertirEnEuro(1955;"DEM";2) renvoie 0
ErreurArrondiConvertirEnEuro(1955;"DEM";1) renvoie 0,02
FRF
IEP
ITL
LUF
BEF
DEM
GRD
ESP
NLG
ATS
PTS
FIM
Remarque
Le code de la devise doit être le code de l'une des 12 devises de l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant leur disparition en janvier 2002. Ces devises sont :
Franc belge
Mark allemand
Drachme grecque
Peseta espagnole
Franc français
Punt irlandais
Lire italienne
Franc luxembourgeois
Guilder néerlandaise
Schilling autrichien
Escudo portugais
Mark finnois
156 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exp
Fact
Description
Renvoie la valeur e (2.718...) élevée à une puissance
Groupe de fonctions
Numérique
Syntaxe
numérique Exp(numérique puissance)
Entrée
puissance La puissance à laquelle vous élevez la variable numérique
Sortie
e (2.718...) élevée à la puissance
Exemple
Exp(2.2) renvoie 9,03
Description
renvoie la factorielle d'un nombre entier.
Groupe de fonctions
Numérique
Utilisation de fonctions, formules et calculs dans Web Intelligence 157
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
entier Fact(entier numérique_entré)
Entrée
numérique_entré Tout nombre entier
Plancher
Sortie
La factorielle du nombre
Exemple
Fact(4) renvoie 24
Description
Renvoie un nombre arrondi à l'entier inférieur le plus proche.
Groupe de fonctions
Numérique
Syntaxe
entier Plafond(numérique numérique_entré)
Entrée
numérique_entré N'importe quel nombre
Sortie
Le nombre arrondi à l'entier inférieur
158 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple
Plancher(24.4) renvoie 24
Interpolation
Description
Calcule les valeurs d'indicateur manquantes par interpolation
Groupe de fonctions
Numérique
Syntaxe
numérique Interpolation(indicateur;[méthode_interpolation];[Pas
SurSaut];[Ligne|Col] )
Entrée
[indicateur] méthode_interpolation
PasSurSaut
Ligne|Col
Tout indicateur
La méthode d'interpolation (facultatif) :
•
PointAPoint
: interpolation de point à point. Méthode d'interpolation par défaut en l'absence d'argument.
•
Linéaire
: régression linéaire avec interpolation des moindres carrés.
Empêche la fonction de réinitialiser le calcul au niveau des sauts de section et de bloc. (Facultatif.)
Le sens du calcul (facultatif)
Utilisation de fonctions, formules et calculs dans Web Intelligence 159
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Sortie
Liste des valeurs renvoyées par l'indicateur avec désignation des valeurs manquantes par interpolation
Exemple
Interpolation([Valeur]) fournit les valeurs manquantes suivantes en utilisant la méthode d'interpolation de point à point par défaut :
Jour Valeur Interpolation([Valeur])
12
14
Lundi
Mardi
Mercredi
Jeudi
Vendredi
Samedi
Dimanche
16
19
17
18
19
12
14
15
16
Remarques
•
Interpolation est très utile pour créer un graphique linéaire pour un indicateur dont certaines valeurs sont manquantes. L'utilisation de cette fonction permet de s'assurer que le diagramme trace une ligne continue
(et non des lignes et des points discontinus).
• L'ordre de tri de l'indicateur a une incidence sur les valeurs renvoyées par
Interpolation
.
• Vous ne pouvez pas appliquer de tri ni de classement à une formule contenant
Interpolation
.
• Si la liste de valeurs ne comporte qu'une seule valeur,
Interpolation l'utilise pour fournir toutes les valeurs manquantes.
160 Utilisation de fonctions, formules et calculs dans Web Intelligence
Ln
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• Les filtres appliqués à un indicateur interpolé peuvent modifier les valeurs renvoyées par
Interpolation en fonction des valeurs concernées par les filtres.
Description
renvoie le logarithme naturel d'un nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique Ln(numérique numérique_entré)
Entrée
numérique_entré N'importe quel nombre
Sortie
logarithme naturel du nombre en entrée
Exemple
Ln(10) renvoie 2
Log
Description
Renvoie le logarithme d'un nombre d'une base spécifiée
Groupe de fonctions
Numérique
Utilisation de fonctions, formules et calculs dans Web Intelligence 161
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
numérique Log(numérique numérique_entré; base numérique)
Entrée
numérique_entré base
N'importe quel nombre
La base.
Sortie
Logarithme du nombre en entrée dans la base spécifiée
Exemple
Log(125;5) renvoie 3
Log10
Description
Renvoie le logarithme de base 10 d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Log10(numérique nombre_en_entrée)
Entrée
numérique_entré Un nombre
Sortie
Le logarithme de base 10 du nombre en entrée
162 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple
Log10(100) renvoie 2
Mod
Description
Renvoie le reste de la division d'un nombre par un autre
Groupe de fonctions
Numérique
Syntaxe
numérique Mod(numérique dividende; numérique diviseur)
Entrée
dividende diviseur
Le dividende
Le diviseur.
Puissance
Sortie
Reste lorsque le dividende est divisé par le diviseur
Exemple
Mod(10;4) renvoie 2
Mod(10.2;4.2) renvoie 1,8
Description
Renvoie un nombre élevé à une puissance
Utilisation de fonctions, formules et calculs dans Web Intelligence 163
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Groupe de fonctions
Numérique
Syntaxe
numérique Puissance(numérique numérique_entré; numérique puis sance)
Entrée
numérique_entré puissance
Le nombre en entrée
La puissance
Sortie
Le nombre élevé à la puissance
Exemple
Puissance(10;2) renvoie 100
Classement
Description
Classe un indicateur selon une dimension ou un ensemble de dimensions
Groupe de fonctions
Numérique
Syntaxe
entier Classement(indicateur; (dimensions); [HAUT|BAS];
[(dimensions_redéfinies)])
164 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Entrée
indicateur dimensions
HAUT|BAS dimensions_redéfinies
Un indicateur
Une dimension ou liste de dimensions
(facultatif)
Ordre de classement (facultatif)
HAUT - décroissant ; BAS - croissant
La liste des dimensions utilisées pour réinitialiser le classement (facultatif)
Sortie
Le classement de l'indicateur en fonction des dimensions de classement
Exemples
Dans le tableau suivant, le rang est indiqué par Classement([Chiffre
d'affaires]);([Pays]))
Pays
France
US
Chiffre d'affaires
835 420
2 451 104
Classement
2
1
Dans le tableau suivant, le rang est indiqué par Classement([Chiffre
d'affaires];([Pays]);BAS) L'argument BAS précise que les indicateurs sont classés dans l'ordre décroissant.
Pays
France
Chiffre d'affaires
835 420
Classement
1
Utilisation de fonctions, formules et calculs dans Web Intelligence 165
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
US 2 451 104 2
Dans le tableau suivant, le classement est indiqué par Classement([Chiffre
d'affaires];([Pays];[Lieu de séjour]))
Pays
France
US
US
Lieu de séjour
Côte d'Azur
Bahamas Beach
Hawaiian Club
Chiffre d'affaires Classement
835 420
971 444
1 479 660
3
2
1
US
US
US
Pays
France
France
France
Dans le tableau suivant, le rang est indiqué par Classement([Chiffre
d'affaires];([Pays];[Année]);([Pays])).
Le rang est réinitialisé dans la dimension Pays.
Année
FY1998
1999
2000
FY1998
1999
2000
Chiffre d'affaires Classement
295 940 1
280 310
259 170
767 614
826 930
856 560
3
2
2
3
1
Remarques
• Si vous ne spécifiez pas de dimension de classement, Web Intelligence utilise le contexte de calcul par défaut pour calculer le 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.
166 Utilisation de fonctions, formules et calculs dans Web Intelligence
Arrondi
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• Lorsque vous spécifiez un ensemble de dimensions de classement ou redéfinies, vous devez les séparer par des points-virgules.
• Par défaut, le classement est réinitialisé sur une section ou une rupture de bloc
Rubriques associées
•
page 197
Description
arrondit un nombre selon le nombre de décimales spécifié.
Groupe de fonctions
Numérique
Syntaxe
numérique Arrondi (numérique nombre_en_entrée; entier nbre_décimales)
Entrée
numérique_entré nbre_décimales
Le nombre à arrondir
Nombre de décimales selon lequel le nombre doit être arrondi
Sortie
nombre arrondi selon le nombre de décimales spécifié
Exemples
Arrondi(9.44;1) renvoie 9,4
Arrondi(9.45;1) renvoie 9,5
Utilisation de fonctions, formules et calculs dans Web Intelligence 167
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Arrondi(9.45;0) renvoie 9
Arrondi(9.45;-1) renvoie 10
Arrondi(4.45;-1) renvoie 0
Remarques
• Si nombre_de_positions_décimales > 0, numérique_entré est arrondi au nombre de décimales nombre_de_positions_décimales
• Si nombre_de_positions_décimales = 0, numérique_entré est arrondi au nombre entier le plus proche
• Si nombre_de_positions_décimales < 0, le séparateur décimal est déplacé de nombre_de_positions_décimales vers la gauche, puis le nombre est arrondi et le séparateur décimal est déplacé de
nombre_de_positions_décimales vers la droite
Signe
Description
Renvoie le signe d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Signe(numérique nombre_en_entrée)
Entrée
numérique_entré Le nombre dont vous voulez déterminer le signe
168 Utilisation de fonctions, formules et calculs dans Web Intelligence
Sin
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Sortie
Le signe du nombre (-1 = négatif; 0 = zéro; 1 = positif)
Exemple
Signe(3) renvoie 1
Signe(-27,5) renvoie -1
Description
Renvoie le sinus d'un angle en radians
Groupe de fonctions
Numérique
Syntaxe
numérique Sin(numérique angle)
Entrée
angle L'angle en radians
Sortie
Le sinus de l'angle
Exemple
Sin(234542) renvoie -0,116992.
Utilisation de fonctions, formules et calculs dans Web Intelligence 169
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
RacineCarrée
Description
Calcule la racine carrée d'un nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique Racine(numérique numérique_entré)
Entrée
numérique_entré Le nombre dont vous recherchez la racine carrée
Sortie
racine carrée du nombre
Exemple
RacineCarrée(25) renvoie 5
Tan
Description
Renvoie la tangente d'un angle
Groupe de fonctions
Numérique
170 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Syntaxe
numérique Tan(numérique angle)
Entrée
angle L'angle
Tronquer
Sortie
La tangente de l'angle
Exemple
Tan(90) renvoie -2
Description
Renvoie un nombre tronqué de n décimales
Groupe de fonctions
Numérique
Syntaxe
numérique Tronquer(numérique numérique_entré; entier nombre_de_positions_décimales)
Entrée
numérique_entré nbre_décimales
Le nombre en entrée
Le nombre de décimales
Sortie
Le nombre en entrée tronqué à nbre_décimales décimales
Utilisation de fonctions, formules et calculs dans Web Intelligence 171
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemple
Tronquer(3.423;2) renvoie 3,42
Fonctions diverses
NomDuBloc
Description
Renvoie le nom d'un bloc
Groupe de fonctions
Divers
Syntaxe
chaîne NomDuBloc()
Entrée
Aucune
Sortie
Le nom du bloc où la fonction est placée.
Exemple
Si
NomDuBloc est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
NuméroDeColonne
Description
Renvoie le numéro de la colonne d'un tableau
172 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeColonne()
Entrée
Aucune
Sortie
Le numéro de la colonne
Exemples
NuméroDeColonne() renvoie 2 si la formule est placée dans la deuxième colonne d'un tableau
UtilisateurCourant
Description
Renvoie l'identification InfoView de l'utilisateur actuel
Groupe de fonctions
Divers
Syntaxe
chaîne UtilisateurCourant()
Entrée
Aucune
Sortie
L'utilisateur courant
Utilisation de fonctions, formules et calculs dans Web Intelligence 173
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemple
UtilisateurActuel() renvoie "gkn" si la connexion InfoView de l'utilisateur actuel est "gkn"
ForcerFusion
Description
Force Web Intelligence à tenir compte des dimensions synchronisées pour les calculs d'indicateur lorsque les dimensions synchronisées n'apparaissent pas dans le contexte du calcul.
Groupe de fonctions
Divers
Syntaxe
numérique ForcerFusion([indicateur])
Entrée
indicateur Tout indicateur
Sortie
Résultat du calcul tenant compte des dimensions synchronisées
Exemple
ForcerFusion([Chiffre d'affaires]) renvoie la valeur de Chiffre d'affaires en tenant compte des dimensions synchronisées qui n'apparaissent pas dans le même bloc que l'indicateur [Chiffre d'affaires].
Remarques
• Appliqué à un indicateur intelligent,
ForcerFusion renvoie
#VALEURMULTI car le groupe nécessaire pour calculer l'indicateur intelligent n'existe pas.
174 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• La fonction
ForcerFusion de Web Intelligence est l'équivalent de la fonction
MultiCube de BusinessObjects/Desktop Intelligence.
ObtenirVariablesRégionalesDeContenu
Description
Renvoie les paramètres régionaux du document
Groupe de fonctions
Divers
Syntaxe
chaîne ObtenirVariablesRégionalesDeContenu()
Entrée
Aucune
Sortie
Les variables régionales de contenu du document
Exemple
ObtenirVariablesRégionalesDeContenu() renvoie "fr_FR" si les variables régionales de contenu correspondent à "Français (France)"
ObtenirVarRég
Description
Renvoie les variables régionales actuelles
Groupe de fonctions
Divers
Utilisation de fonctions, formules et calculs dans Web Intelligence 175
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
chaîne ObtenirVarRég()
Entrée
Aucune
Sortie
Les variables régionales actuelles
Exemple
ObtenirVarRég() renvoie "en_US" si les variables régionales actuelles correspondent à "en_US"
Si
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
Si expression_booléenne Alors expression_vraie {Sinon expres sion_fausse | SinonSi expression_booléenne Alors expres sion_vraie Sinon expression_fausse}
Entrée
expression_booléenne expression_vraie
Une expression qui renvoie vrai ou faux
L'expression dont la valeur est renvoyée si expression_booléenne est vraie
176 Utilisation de fonctions, formules et calculs dans Web Intelligence
expression_fausse
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
L'expression dont la valeur est renvoyée si expression_booléenne est fausse
Sortie
La valeur de expression_vraie ou expression_fausse
Exemples
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" renvoie "CA
élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et aucune valeur pour les autres lignes.
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" Sinon
[Chiffre d'affaires] renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres lignes.
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" Sinon "CA faible" renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et "CA faible" pour toutes les lignes dont le chiffre d'affaires est inférieur à 1 000 000.
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" SinonSi
[Chiffre d'affaires] > 800 000 Alors "CA moyen" Sinon "CA faible" renvoie "CA élevé" pour toutes les lignes dont le revenu dépasse
1 000 000, "CA moyen" pour toutes les lignes dont le chiffre d'affaires est compris entre 800 000 et 1 000 000 et "CA faible" pour toutes les autres lignes.
Remarques
• expression_vraie et expression_fausse peuvent combiner des types de données (voir deuxième exemple ci-dessus) sauf lorsqu'il s'agit de données numériques ou de type date/heure. Si la formule combine des données numériques et de type date/heure, elle renvoie #TYPEDON
NEES.
• Vous pouvez mettre expression_booléenne
, expression_vraie et ex pression_fausse entre parenthèses.
Utilisation de fonctions, formules et calculs dans Web Intelligence 177
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
• Vous pouvez utiliser les opérateurs booléens (ET, Entre, DansListe, OU et PAS) avec la fonction Si.
• Web Intelligence prend toujours en charge la syntaxe d'origine de la fonction Si. Voir le lien ci-dessous pour en savoir plus.
Rubriques associées
•
page 193
•
page 194
•
page 195
•
page 193
•
page 194
NuméroDeLigne
Description
Renvoie le numéro de ligne dans un tableau
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeLigne()
Entrée
Aucune
Sortie
Le numéro de ligne
Exemple
NuméroDeLigne() renvoie 2 lorsque la fonction apparaît au niveau de la deuxième ligne d'un tableau
178 Utilisation de fonctions, formules et calculs dans Web Intelligence
NomDe
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Remarque
La numérotation des lignes d'un tableau commence par l'en-tête, qui est la ligne 1.
Description
Renvoie le nom d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomDe([objet])
Entrée
[objet] Tout objet
Sortie
Le nom de l'objet
Exemple
NomDe([Date de réservation]) renvoie "Date de réservation"
Remarque :
Web Intelligence utilise la fonction NomDe() dans les en-têtes de colonne et de ligne des rapports
Utilisation de fonctions, formules et calculs dans Web Intelligence 179
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
AucunFiltreExploration
Description
Ignore les filtres d'exploration lors d'un calcul.
Groupe de fonctions
Divers
Syntaxe
type_sortie_expression AucunFiltreExploration(expression)
Entrée
expression Toute expression
Sortie
Le résultat de l'expression, sans tenir compte des filtres d'exploration.
AucunFiltre
Description
Indique à Web Intelligence d'ignorer les filtres lors du calcul d'une expression
Groupe de fonctions
Divers
Syntaxe
type_sortie_expression AucunFiltre(expression;[Tout|Ex ploration])
180 Utilisation de fonctions, formules et calculs dans Web Intelligence
Entrée
expression
Tout/Exploration (facultatif)
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Toute expression
• Non spécifié : ignorer les filtres de rapport et de bloc
• Tout : ignorer tous les filtres
• Exploration : ignorer les filtres de rapport et les filtres d'exploration
Sortie
Le résultat de l'expression, sans tenir compte des filtres
Exemples
Lorsque
AucunFiltre(Somme([Chiffre d'affaires])) est placé dans un pied de bloc, le chiffre d'affaires total de toutes les lignes du bloc est renvoyé, même si certaines lignes sont exclues du bloc.
AucunFiltre(Somme([Chiffre d'affaires]);Tout) renvoie la somme du chiffre d'affaires de tous les pays, y compris la France, même si un filtre exclut la France du rapport.
AucunFiltre(Somme([Chiffre d'affaires]);Exploration) renvoie la somme du chiffre d'affaires de tous les pays, même si un filtre d'exploration filtre la dimension [Pays].
Remarques
•
AucunFiltre (expression;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 expressions auxquelles
AucunFiltre(expression;Ex ploration) est appliqué.
Utilisation de fonctions, formules et calculs dans Web Intelligence 181
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
NombreDePages
Description
Renvoie le nombre de pages dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier NombreDePages()
Sortie
Le nombre de pages dans le rapport
Exemple
NombreDePages() renvoie 2 si le rapport contient deux pages.
Page
Description
Renvoie le numéro de la page actuelle dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier Page()
Sortie
Numéro de la page actuelle.
182 Utilisation de fonctions, formules et calculs dans Web Intelligence
Précédent
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple
Page() renvoie 2 s'il apparaît dans la deuxième page du rapport
Description
Renvoie une valeur précédente d'un objet
Groupe de fonctions
Divers
Syntaxe
tout_type Précédent(objet|Auto;{dimensions_redéfinies}; {off set};{NonNul})
Entrée
objet
| Auto dimensions_redéfinies offset
NonNul
Un objet quelconque, ou le mot clé
Auto
La liste des dimensions utilisées pour réinitialiser le calcul (facultatif)
Le nombre de lignes précédant la ligne actuelle (facultatif)
Demande à la fonction de renvoyer la première valeur non nulle à partir de l'offset (facultatif)
Sortie
La valeur des lignes offset de l'objet avant la ligne actuelle
Utilisation de fonctions, formules et calculs dans Web Intelligence 183
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemples
Précédent([Pays)];1) renvoie les valeurs suivantes dans le tableau qui suit :
Précédent Pays
Etats-Unis
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
Etats-Unis
Royaume-Uni
Précédent([Chiffre d'affaires)]) renvoie les valeurs suivantes dans le tableau qui suit :
Précédent Pays
Etats-Unis
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
5 000 000
2 000 000
Précédent([Chiffre d'affaires];([Pays]) renvoie les valeurs suivantes dans le tableau qui suit :
Pays
Etats-Unis
Royaume-Uni
Région
Nord
Sud
Nord
Sud
Chiffre d'affaires Précédent
5 000 000
7 000 000 5 000 000
3 000 000
4 000 000 3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau croisé qui suit :
184 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
France
2004
Etats-Unis 5 000 000
Royaume-Uni 2 000 000
3 000 000
Précédent 2005
6 000 000
2 500 000
2 000 000
Précédent
5 000 000
2 000 000
3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau qui suit avec une rupture sur [Pays] :
Pays
Etats-Unis
Etats-Unis
Région
Nord
Sud
Chiffre d'affaires Précédent
5 000 000
7 000 000
12 000 000
5 000 000
Pays
Royaume-Uni
Région
Nord
Sud
Royaume-Uni
Chiffre d'affaires Précédent
3 000 000 7 000 000
4 000 000
7 000 000
3 000 000
12 000 000
Précédent([Chiffre d'affaires]);2;NonNul) renvoie les valeurs suivantes dans le tableau qui suit :
Année
2008
2008
Trimestre
T1
T2
Chiffre d'affaires Précédent
500
2008 T3 400 500
Utilisation de fonctions, formules et calculs dans Web Intelligence 185
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
2008
2008
2008
2008
2008
T4
T1
T2
T3
T4
700
300
200
500
400
700
300
300
2*Précédent(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Remarques
• La valeur par défaut d' offset est 1.
Précédent([Chiffre d'af faires];1) et
Précédent ([Chiffre d'affaires]) sont identiques du point de vue fonctionnel.
• Lorsque l'argument
NonNul est inclus, Web Intelligence renvoie la première valeur non nulle de l'objet en remontant à partir des lignes offset de la cellule situées avant la ligne actuelle.
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec
Précédent
.
• L'opérateur
Auto permet de faire référence à la valeur précédente d'une cellule lorsque son contenu n'est pas un objet rapport.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
• Web Intelligence applique
Précédent après avoir appliqué tous les filtres de rapport, de section et de bloc.
• Vous ne pouvez pas appliquer de filtre à une formule qui utilise
Précédent
.
• Web Intelligence applique
Précédent() après avoir appliqué tous les tris.
• Vous ne pouvez pas appliquer de tri à une formule qui utilise
Précédent
.
• Si
Précédent est appliqué à un indicateur et que l'indicateur renvoie une valeur non définie,
Précédent renvoie une valeur non définie même si la ligne précédente a renvoyé une valeur.
186 Utilisation de fonctions, formules et calculs dans Web Intelligence
ValeurRéf
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
•
Précédent ignore les ruptures en cas de placement à l'extérieur d'un en-tête ou d'un pied de page de rupture.
•
Précédent renvoie la valeur de l'instance précédente du pied de page en cas de placement dans un pied de page de rupture.
• Web Intelligence réinitialise
Précédent dans chaque section de rapport.
• Lorqu'elle est utilisée dans un tableau croisé, l'option
Précédent ne traite pas la dernière valeur d'une ligne comme la première valeur de la ligne suivante.
Rubriques associées
•
Comparaison de valeurs à l'aide de la fonction Précédent
page 236
•
page 204
Description
Renvoie la valeur de référence d'un objet rapport lorsque le suivi de données est activé
Groupe de fonctions
Divers
Syntaxe
objet_type_données ValeurRéf([objet])
Entrée
Aucune
Sortie
La valeur de l'objet rapport
Utilisation de fonctions, formules et calculs dans Web Intelligence 187
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemples
ValeurRéf([Région ayant les meilleurs résultats]) renvoie
"Sud-ouest" si la valeur de la variable [Région ayant les meilleurs résultats] est "Sud-ouest" dans les données de référence.
ValeurRéf([Chiffre d'affaires]) renvoie 1 000 si la valeur de l'indicateur
[Chiffre d'affaires] est 1 000 dans les données de référence.
ValeurRelative
Description
Renvoie les valeurs précédentes ou suivantes d'une expression calculée à l'aide d'un ensemble de dimensions
Groupe de fonctions
Divers
Syntaxe
expr_type RelativeValue(expr;slicing_dimensions;offset)
Entrée
expr dimensions_découpage offset
Toute expression
Les dimensions qui donnent le contexte du calcul
Le nombre de lignes situées avant ou après la ligne actuelle
Exemple
La colonne ValeurRelative du tableau ci-dessous contient le formule suivante :
RelativeValue([Revenue];([Year]);-1)
188 Utilisation de fonctions, formules et calculs dans Web Intelligence
Année
2007
2007
2007
2007
2008
2008
2008
2008
Trimestre
T1
T2
T3
T4
T1
T2
T3
T4
Vendeur
Durand
Dupont
Martin
Dubois
Durand
Dupont
Martin
Dubois
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Chiffre d'affaires
1 000
2 000
1 500
3 000
4 000
3 400
2 000
1 700
Valeur-
Relative
1 000
2 000
1 500
3 000
Pour en savoir plus sur la fonction
ValeurRelative
, voir le chapitre sur la comparaison de valeurs à l'aide des fonctions Web Intelligence du guide
Utilisation de fonctions, formules et calculs dans Web Intelligence ou suivez le lien au bas de cette rubrique (le cas échéant).
Remarques
• expr doit être un indicateur ou un détail d'une dimension disponible dans le bloc.
• L'ordre de tri de la liste de valeurs des dimensions de découpage permet de déterminer le résultat de la fonction.
Deux facteurs définissent l'ordre de tri : les tris appliqués aux dimensions de découpage et l'ordre dans lequel les dimensions de découpage sont répertoriées dans la fonction.
• Une dimension utilisée comme maître de section peut être spécifiée en tant que dimension de découpage.
• Toutes les dimensions de découpage doivent être présentes dans le bloc ou dans l'en-tête de section du bloc dans lequel se trouve la fonction. Si une dimension de découpage est supprimée ultérieurement du bloc, la fonction renvoie l'erreur #CALCUL.
• Si l'offset dépasse le nombre de lignes de la liste de valeurs de la dimension de découpage, le résultat de la fonction est nul.
•
ValeurRelative ne peut être utilisé de façon récursive.
Utilisation de fonctions, formules et calculs dans Web Intelligence 189
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
• 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.
Rubriques associées
•
page 218
•
Comparaison de valeurs à l'aide de la fonction ValeurRelative
page 236
IndexationDesLignes
Description
Renvoie le numéro d'une ligne
Groupe de fonctions
Divers
Syntaxe
entier IndexationDesLignes()
Entrée
Aucune
Sortie
Le numéro de la ligne
Exemple
IndexationDesLignes() renvoie 0 lorsqu'elle apparaît sur la première ligne d'un tableau
Remarques
• La numérotation des lignes commence à 0
• IndexationDesLignes() renvoie #VALEURMULTI lorsqu'elle est placée dans l'en-tête ou le pied de page d'un tableau
190 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
NomUniqueDe
Description
Renvoie le nom unique d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomUniqueDe([objet])
Entrée
[objet] Tout objet
Sortie
Le nom unique de l'objet
Exemple
NomUniqueDe([Date de réservation]) renvoie "Date de réservation"
Opérateurs de fonction et de formule
Web Intelligence
Les opérateurs lient les différents composants dans une formule. Les formules peuvent contenir des opérateurs mathématiques, conditionnels, logiques, spécifiques à une fonction ou de syntaxe avancée.
Utilisation de fonctions, formules et calculs dans Web Intelligence 191
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Opérateurs mathématiques
Les opérateurs mathématiques paraissent familiers car ils correspondent aux opérations arithmétiques de base. Les opérateurs d'addition (+), de soustraction (-), de multiplication (*) et de division (/) permettent d'effectuer des opérations mathématiques dans une formule. La formule
[Chiffre d'affaires] - [Coût des ventes] contient un opérateur mathématique, la soustraction en l'occurrence.
Remarque :
Lorsqu'il est utilisé avec des chaînes de caractères, l'opérateur "+" devient un opérateur de concaténation de chaînes. Autrement dit, il permet de joindre des chaînes de caractères. Par exemple, la formule "Jean" + " Durand" renvoie "Jean Durand".
Opérateurs conditionnels
Les opérateurs conditionnels déterminent le type de comparaison à effectuer entre des valeurs.
Opérateur
=
>
<
>=
<=
<>
Description
Egal à
Supérieur à
Inférieur à
Supérieur ou égal à
Inférieur ou égal à
Différent de
Vous utilisez les opérateurs conditionnels avec la fonction Si, comme dans :
If [Revenue]>10000 Then "High" Else "Low"
192 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4 qui renvoie "Elevé" pour toutes les lignes où le revenu est supérieur ou égal
à 10 000 et "Bas" pour toutes les autres lignes.
Opérateurs logiques
Les opérateurs logiques Web Intelligence sont
Et
,
Ou
,
Pas
,
Entre et
Dans
Liste
. Les opérateurs logiques sont utilisés dans des expressions booléennes qui renvoient
Vrai ou
Faux
.
Opérateur Et
Description
L'opérateur
Et relie des expressions booléennes. Si toutes les expressions booléennes reliées par
Et renvoient
Vrai
, l'expression donnée par la combinaison de toutes les expressions booléennes renvoie également
Vrai
.
Syntaxe
syntax
Exemple
If [Resort] = "Bahamas Beach" And [Revenue]>100000 Then "High
Bahamas Revenue" renvoie "Chiffre d'affaires Bahamas élevé" si [Lieu de séjour] = "Bahamas
Beach" Et [Chiffre d'affaires]> 100 000.
Opérateur ou
Description
L'opérateur
Ou relie les expressions booléennes. Si une expression booléenne reliée par
Ou renvoie
Vrai
, l'expression donnée par la combinaison de toutes les expressions booléennes renvoie également
Vrai
.
Utilisation de fonctions, formules et calculs dans Web Intelligence 193
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Syntaxe
<expression_booléenne> OU <expression_booléenne> OU <expres sion_booléenne>...
Exemple
If [Resort] = "Bahamas Beach" Or [Resort]="Hawaiian Club" Then
"US" Else "France" renvoie "Etats-Unis" si [Lieu de séjour]="Bahama Beach" ou "Hawaiian Club", sinon "France".
Non (opérateur)
Description
L'opérateur Non renvoie l'inverse d'une expression booléenne.
Syntaxe
NON (<expression_booléenne>)
Exemple
If Not([Country] = "US") Then "Not US" renvoie "Non Etats-Unis" si [Pays] a une valeur autre que "Etats-Unis".
Opérateur Entre
Description
L'opérateur
Entre détermine si une variable est comprise entre deux valeurs.
Syntaxe
booléen Entre([premièrevaleur];[deuxièmevaleur])
Exemple
If [Revenue] Between(800000;900000) Then "Medium Revenue" renvoie "Chiffre d'affaires moyen" si [Lieu de séjour] est compris entre
800 000 et 900 000.
194 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
[Chiffre d'affaires] Entre (10000;20000) renvoie True si le chiffre d'affaires est compris entre 10 000 et 20 000
Si([Chiffre d'affaires] Entre (200000;500000);"Revenu moyen";"Revenu bas/élevé") renvoie "Revenu moyen" si [Chiffre d'affaires] est égal à 300 000
Remarques
• Vous pouvez utiliser l'opérateur Entre avec la fonction
Si et l'opérateur
Où
.
• Etant donné que le paramètre régional de mise en forme du document peut affecter l'ordre de tri des données, la modification du paramètre régional peut influer sur le résultat renvoyé par l'opérateur Entre. (Vous définissez le paramètre régional de mise en forme du document dans l'onglet Préférences de document Web Intelligence dans InfoView.)
Rubriques associées
•
page 176
•
page 204
DansListe (opérateur)
Description
L'opérateur
DansListe détermine si une variable fait partie d'une liste de valeurs.
Syntaxe
booléen DansListe(liste_de_valeurs)
Exemple
If [Resort] InList("Bahamas Beach";"Hawaiian Club") Then "US
Resort" renvoie "Lieu de séjour Etats-Unis" si [Lieu de séjour] est égal à "Bahamas
Beach" ou "Hawaiian Club".
Utilisation de fonctions, formules et calculs dans Web Intelligence 195
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Remarque
• C'est la combinaison d'objet +
DansListe qui renvoie une valeur booléenne, et non
DansListe seul. Par exemple,
Non est utilisé avec
DansListe de la façon suivante :
Non ([objet] DansListe(liste))
.
La syntaxe
[objet] Non DansListe(liste) est incorrecte et renvoie une erreur.
Rubriques associées
•
page 176
•
page 204
Opérateurs spécifiques à la fonction
Certaines fonctions Web Intelligence peuvent avoir des opérateurs spécifiques comme arguments. Par exemple, la fonction
Précédent peut avoir pour argument l'opérateur
Auto
.
Toutes les fonctions entourent les arguments avec
) et
(
. Les fonctions qui acceptent plusieurs paramètres utilisent
; pour les séparer.
Opérateur Tout
Vous pouvez utiliser l'opérateur Tout dans deux contextes :
• Dans le paramètre
Distinct/Tout de la fonction
Nombre
.
• Dans le paramètre
Tout/Exploration de la fonction
AucunFiltre
.
Rubriques associées
•
page 51
•
page 198
•
page 180
•
page 196
Opérateurs Tout/Exploration
Les opérateurs
Tout
/
Exploration détermine quels sont les filtres ignorés par la fonction
AucunFiltre
.
196 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
• Non spécifié :
AucunFiltre ignore les filtres de rapport et de bloc
• Tout :
AucunFiltre ignore tous les filtres
• Exploration :
AucunFiltre ignore les filtres de rapport et les filtres d'exploration
Rubriques associées
•
page 180
Opérateurs Bas/Haut
Les opérateurs
Bas
/
Haut définissent la direction du classement de la fonction
Classement
.
Exemple
Rank([Revenue];([Country]);Top) classe les pays par ordre décroissant de chiffre d'affaires.
Rubriques associées
•
page 164
Opérateur Rupture
Description
Conduit la fonction
Pourcentage()
à prendre en compte les ruptures de tableau
Syntaxe
Pourcentage(indicateur;RUPTURE)
Exemples
La formule
Pourcentage
(Chiffre d'affaires) donne le résultat indiqué dans le tableau suivant (les pourcentages sont calculés sur le chiffre d'affaires total du bloc) :
Année Trimestre Chiffre d'affaires Pourcentage
Utilisation de fonctions, formules et calculs dans Web Intelligence 197
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
2005
2005
2006
2006
T1
T2
T1
T2
10 000
20 000
30 000
40 000
10 %
20 %
30 %
40 %
La formule
Pourcentage
(Chiffre d'affaires;RUPTURE) donne le résultat indiqué dans le tableau suivant (les pourcentages sont calculés sur le chiffre d'affaires total de chaque partie du bloc) :
Année
2005
2005
Trimestre
T1
T2
Chiffre d'affaires Pourcentage
10 000
20 000
33,3 %
66,6 %
2006
2006
T1
T2
30 000
40 000
42,9%
57,1%
Rubriques associées
•
page 58
Opérateurs Distinct/Tout
Les opérateurs
Distinct
/
Tout déterminent si Web Intelligence tient compte des valeurs répétées dans un calcul utilisant la fonction
Nombre
.
198 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
Exemple
Nombre([Chiffre d'affaires]; Distinct) renvoie 3 si [Chiffre d'affaires] a les valeurs (5;5;6;4)
Nombre([Chiffre d'affaires]; Tout) renvoie 4 si [Chiffre d'affaires] a les valeurs (5;5;6;4)
Rubriques associées
•
page 51
Opérateur InclureVide
L'opérateur
InclureVide détermine si Web Intelligence prend en compte les valeurs vides dans certaines fonctions d'agrégation.
Exemple
Moyenne([Chiffre d'affaires]; InclureVide) renvoie 3 si [Chiffre d'affaires] a les valeurs (5;3;<vide>;4)
Rubriques associées
•
page 50
•
page 51
•
page 62
•
page 64
Opérateur Index
L'opérateur
Index invite la fonction
RéponseUtilisateur
à renvoyer les clés primaires de base de données de valeurs d'invite et non les valeurs elles-mêmes.
Rubriques associées
•
page 135
Utilisation de fonctions, formules et calculs dans Web Intelligence 199
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Opérateur Linéaire
Description
L'opérateur
Linéaire stipule que la fonction
Interpolation doit utiliser la régression linéaire avec l'interpolation des moindres carrés pour donner les valeurs d'indicateur manquantes.
La régression linéaire avec interpolation des moindres carrés calcule les valeurs manquantes en calculant une équation de droite de type f(x) = ax + b qui passe, le plus précisément possible, par toutes les valeurs disponibles de l'indicateur.
Rubriques associées
•
page 159
Opérateur NonNul
L'opérateur
NonNul invite la fonction
Précédent
à ignorer les valeurs nulles.
Lorsque
Précédent est utilisé avec
NonNul
, il renvoie la première valeur non nulle de l'objet, en remontant à partir des lignes offset de la cellule située avant la ligne actuelle.
Rubriques associées
•
page 183
Opérateur PasSurSaut
L'opérateur
PasSurSaut invite la fonction
Interpolation
à ignorer les ruptures de section et de bloc.
Rubriques associées
•
page 159
200 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
Opérateur PointAPoint
Description
L'opérateur
PointAPoint stipule que la fonction
Interpolation doit utiliser l'interpolation de point à point pour donner les valeurs d'indicateur manquantes.
L'interpolation de point à point calcule les valeurs manquantes en calculant une équation de droite de type f(x) = ax + b qui passe par les deux valeurs adjacentes à la valeur manquante.
Rubriques associées
•
page 159
Opérateur RégMoindresCarrés
Description
L'opérateur
RégMoindresCarrés stipule que la fonction
Interpolation doit utiliser la régression linéaire avec l'interpolation des moindres carrés pour donner les valeurs d'indicateur manquantes.
La régression linéaire avec interpolation des moindres carrés calcule les valeurs manquantes en calculant une équation de droite de type f(x) = ax + b qui passe, le plus précisément possible, par toutes les valeurs disponibles de l'indicateur.
Rubriques associées
•
page 159
Opérateurs Ligne/Col
Vous pouvez utiliser les opérateurs
Ligne
/
Col pour définir le sens du calcul des fonctions suivantes :
Pourcentage
,
MoyenneCumulative
,
Nom breCumulatif
,
MaxCumulatif
,
MinCumulatif
,
ProduitCumulatif
,
Som meCumulative
.
Utilisation de fonctions, formules et calculs dans Web Intelligence 201
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Opérateurs Ligne et Col et la fonction Pourcentage
Avec l'opérateur
Ligne
, Web Intelligence calcule chaque valeur de la ligne sous la forme d'un pourcentage de la valeur totale de toutes les lignes dans le contexte d'intégration. Avec l'opérateur
Col
, Web Intelligence calcule chaque valeur de la colonne sous la forme d'un pourcentage de la valeur totale de toutes les colonnes dans le contexte d'intégration.
Dans un tableau croisé, Web Intelligence calcule par défaut la valeur de chaque cellule comme un pourcentage de la valeur totale du tableau croisé.
Avec l'opérateur
Ligne
, Web Intelligence calcule les valeurs des lignes sous la forme de pourcentages de la valeur totale de la ligne. Avec l'opérateur
Col
, Web Intelligence calcule les valeurs des colonnes sous la forme de pourcentages de la valeur totale de la colonne.
Dans un tableau croisé,
Pourcentage([Indicateur]) donne le résultat suivant :
Indicateur
100
200
Pourcentage
10 %
20 %
Indicateur
500
200
Pourcentage
50 %
20 %
Pourcentage([Indicateur];Ligne) donne le résultat suivant :
Indicateur
100
200
Pourcentage
16,7 %
50 %
Indicateur
500
200
Pourcentage
83,3 %
50 %
Pourcentage([Indicateur];Col) donne le résultat suivant :
Indicateur
100
Pourcentage
33,3 %
Indicateur
500
Pourcentage
83,3 %
202 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
200 66,6 % 200 16,7 %
Avec l'opérateur LIGNE (ou par défaut), Web Intelligence calcule l'agrégat cumulatif par ligne. Avec l'opérateur COL, Web Intelligence calcule l'agrégat cumulatif par colonne.
Opérateurs Ligne/Col et fonctions d'agrégation cumulative
Dans un tableau croisé,
SommeCumulative([indicateur]) ou
Som meCumulative([indicateur];Ligne) donne le résultat suivant :
Indicateur Indicateur SommeCumulative
100
400
Som meCumulative
100
700
200
250
300
950
Dans un tableau croisé,
SommeCumulative([Indicateur];Col) donne le résultat suivant :
Indicateur Indicateur SommeCumulative
100
400
Som meCumulative
100
500
200
250
700
950
Rubriques associées
•
page 58
•
page 62
•
page 64
•
page 66
•
page 67
•
page 69
Utilisation de fonctions, formules et calculs dans Web Intelligence 203
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
•
page 71
Opérateur Auto
L'opérateur
Auto permet à la fonction
Précédent de faire référence à la valeur de la cellule précédente lorsque le contenu de la cellule n'est pas un objet rapport.
Exemple
5 + Précédent(Auto) renvoie la séquence 5, 10, 15, 20, 25, 30...
1 + 0,5 * Précédent(Auto) renvoie la séquence 1, 1,5, 1,75, 1,88...
Rubriques associées
•
page 183
Opérateur Où
Description
L'opérateur
Où limite les données utilisées pour calculer l'expression d'indicateur.
Syntaxe
[expression] Où [expression_booléenne]
[expression]
[expression_booléenne]
Toute expression
Toute expression booléenne
Exemples
La formule
Moyenne ([Chiffre d'affaires]) Où ([Pays] = "USA") calcule les ventes moyennes où le pays est "USA".
204 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
La formule
Moyenne ([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ù [Chiffre d'affaires > 500 000]
. Lorsque la variable
[Chiffre d'affaires élevé] est placée dans un bloc, elle renvoie le chiffre d'affaires lorsque sa valeur est supérieure à 500 000 ou bien aucune valeur.
Lorsque la variable est placée dans le pied de la colonne [Chiffre d'affaires
élevé], la formule
Moyenne ([Chiffre d'affaires élevé]) renvoie la moyenne des chiffre d'affaires supérieurs à 500 000.
Remarque
Vous pouvez utiliser les opérateurs booléens avec l'opérateur Où.
Rubriques associées
•
page 193
•
page 194
•
page 195
•
page 193
•
page 194
Opérateur LigneEtape
L'opérateur
LigneEtape stipule que la fonction
Interpolation doit utiliser l'interpolation de ligne d'étape pour donner les valeurs d'indicateur manquantes.
L'interpolation de ligne d'étape calcule les valeurs manquantes en utilisant la valeur précédente comme valeur manquante.
Rubriques associées
•
page 159
Utilisation de fonctions, formules et calculs dans Web Intelligence 205
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Opérateurs contextuels de syntaxe avancée
Vous spécifiez explicitement les contextes d'entrée et de sortie avec les opérateurs contextuels. Le tableau suivant répertorie les opérateurs contextuels :
Opérateur
Dans
PourChaque
PourTout
Description
Spécifie une liste explicite de dimensions à utiliser dans le contexte
Ajoute des dimensions au contexte par défaut
Supprime des dimensions du contexte par défaut
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte par défaut contient de nombreuses dimensions. Il est souvent plus facile d'effectuer un "ajout" ou un "retrait" du contexte avec les opérateurs PourTout et PourChaque que de spécifier explicitement la liste avec Dans.
Opérateur contextuel Dans
L'opérateur contextuel Dans spécifie les dimensions de façon explicite dans un contexte.
Exemple : Utilisation de l'opérateur Dans pour spécifier les dimensions dans un contexte
Dans cet exemple, vous avez un rapport présentant les valeurs Année et
Revenu des ventes. Votre fournisseur de données contient aussi l'objet
Trimestre, mais vous n'incluez pas cette dimension dans le bloc. Vous choisissez plutôt d'inclure une autre colonne qui affiche le revenu maximal par trimestre de chaque année. Votre rapport se présente comme suit :
206 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
Vous pouvez voir d'où proviennent les valeurs de la colonne Revenu trimestriel maximum en examinant ce bloc avec un bloc incluant la dimension Trimestre :
La colonne Revenu trimestriel maximum présente le revenu trimestriel le plus élevé de chaque année. Par exemple, T4 présentant le revenu le plus
élevé pour 2002, la colonne Revenu trimestriel maximum présente le revenu de T4 sur la ligne affichant les valeurs de 2002.
Avec l'opérateur Dans, la formule pour Revenu trimestriel maximum est
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Utilisation de fonctions, formules et calculs dans Web Intelligence 207
Fonctions, opérateurs et mots clés de Web Intelligence
4
Opérateurs de fonction et de formule Web Intelligence
Cette formule indique à Web Intelligence de calculer le revenu des ventes maximal pour chaque combinaison (Année,Trimestre), puis d'indiquer ce chiffre par année.
Remarque :
Comme le contexte de sortie par défaut du bloc est Année, vous n'avez pas besoin de spécifier de façon explicite le contexte de sortie dans cette formule.
Opérateur contextuel PourChaque
L'opérateur PourChaque ajoute des dimensions à un contexte.
Exemple : Utilisation de l'opérateur PourChaque pour ajouter des dimensions à un contexte
Le tableau suivant présente le revenu maximal de chaque trimestre dans un rapport qui contient la dimension Trimestre, mais ne l'inclut pas dans le bloc :
Année
2001
2002
2003
Revenu des ventes
8 096 123,60
13 232 246,00
15 059 142,80
Revenu trimestriel max.
2 660 699,50
4 186 120,00
4 006 717,50
Il est possible de créer une formule pour la colonne Revenu trimestriel maximum n'incluant pas l'opérateur PourChaque :
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Si vous optez pour l'opérateur contextuel PourChaque, vous pouvez obtenir le même résultat avec la formule suivante :
Max ([Sales Revenue] ForEach ([Quarter])) In ([Year])
Pourquoi ? Parce que la dimension Année est le contexte d'entrée par défaut du bloc. En vous servant de l'opérateur PourChaque, vous ajoutez la dimension Trimestre au contexte, en donnant le contexte d'entrée
([Année];[Trimestre]).
208 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
4
Opérateur contextuel PourTout
L'opérateur contextuel PourTout supprime les dimensions d'un contexte.
Exemple : Utilisation de l'opérateur PourTout pour supprimer les dimensions d'un contexte
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes, et vous voulez ajouter une colonne qui présente le revenu total de chaque année, comme indiqué dans le bloc suivant :
Pour que le total de chiffre d'affaires par année soit effectué, le contexte d'entrée doit être (Année) ; par défaut, il s'agit de (Année; Trimestre). Par conséquent, vous pouvez supprimer Trimestre du contexte d'entrée en spécifiant PourTout ([Trimestre]) dans la formule, comme suit :
Sum([Sales Revenue] ForAll ([Quarter]))
Sachez que l'opérateur Dans vous permet d'aboutir au même résultat ; dans ce cas, la formule est :
Sum([Sales Revenue] In ([Year]))
Cette version de la formule spécifie de façon explicite Année comme contexte, au lieu de supprimer Trimestre pour conserver Année.
Utilisation de fonctions, formules et calculs dans Web Intelligence 209
Fonctions, opérateurs et mots clés de Web Intelligence
4
Mots clés de la syntaxe avancée Web Intelligence
Mots clés de la syntaxe avancée
Web Intelligence
Les mots clés de la syntaxe avancée constituent une sorte de "notation abrégée" qui vous permet de faire référence à des dimensions en syntaxe avancée sans spécifier de façon explicite ces dimensions. Cette opération garantit des rapports toujours optimaux ; si les formules ne contiennent pas de références figées dans le code à des dimensions, elles restent valables même en cas d'ajout ou de suppression de dimensions dans le rapport.
Il existe cinq mots clés de syntaxe avancée : Rapport, Section, Rupture,
Bloc et Corps.
Mot clé Bloc
Le tableau suivant décrit les dimensions auxquelles fait référence le mot clé
Bloc, selon son emplacement dans un rapport. Le mot clé Bloc recouvre souvent les mêmes données que le mot clé Section. La différence entre les deux réside dans le fait que Bloc tient compte des filtres placés sur un bloc alors que Section les ignore.
Placé dans… Fait référence à…
Un bloc
Toutes les données du bloc, sans tenir compte des ruptures, en respectant les filtres
Une rupture de bloc (en-tête ou pied)
Toutes les données du bloc, sans tenir compte des ruptures, en respectant les filtres
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Non applicable
Non applicable
210 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
4
Exemple : Mot clé Bloc
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes. Le rapport contient une section basée sur Année. Le bloc est filtré de façon à exclure les troisième et quatrième trimestres.
La colonne Moyenne annuelle contient la formule
Average([Sales revenue] In Section) et la colonne Moyenne du premier semestre contient la formule
Average ([Sales revenue]) In Block
Vous pouvez voir comment le mot clé Bloc prend en compte le filtre sur le bloc.
Mot clé Corps
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Corps, selon son emplacement dans un rapport :
Utilisation de fonctions, formules et calculs dans Web Intelligence 211
Fonctions, opérateurs et mots clés de Web Intelligence
4
Mots clés de la syntaxe avancée Web Intelligence
Placé dans…
Un bloc
Fait référence à…
Toutes les données du bloc
Une rupture de bloc (en-tête ou pied) Toutes les données du bloc
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Toutes les données de la section
Toutes les données du rapport
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes, avec une rupture sur Année. Le rapport contient une section basée sur Année et une rupture au niveau de Trimestre.
Année Trimestre Corps
2001
2001
T1
T2
T3
T4
Revenu des ventes
2 660 700
2 279 003
1 367 841
1 788 580
8 096 123,6
2 660 699,5
2 279 003
1 367 840,7
1 788 580,4
La colonne Corps contient la formule
Sum ([Sales Revenue]) In Body
Les totaux de la colonne Corps sont égaux à ceux de la colonne Revenu des ventes, car le mot clé Corps fait référence aux données du bloc. Si vous deviez supprimer l'objet Mois, les chiffres de la colonne Bloc changeraient pour correspondre aux chiffres modifiés de la colonne Revenu des ventes. Si vous deviez placer la formule dans le pied du rapport, elle renverrait le revenu total pour le bloc.
212 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
4
Mot clé Rupture
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot clé Rupture, selon son emplacement dans un rapport :
Placé dans…
Un bloc
Fait référence à…
Toutes les données dans la partie du bloc délimité par une rupture
Une rupture de bloc (en-tête ou pied)
Toutes les données dans la partie du bloc délimité par une rupture
Une section (en-tête, pied ou à l'extérieur d'un bloc)
A l'extérieur des blocs ou sections
Non applicable
Non applicable
Exemple : Mot clé Rupture
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes.
Le rapport comporte une rupture au niveau de Année. La colonne Total rupture contient la formule :
Sum ([Sales Revenue]) In Break
Sans le mot clé Rupture, cette colonne dupliquerait les chiffres de la colonne
Revenu des ventes, car le contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
Utilisation de fonctions, formules et calculs dans Web Intelligence 213
Fonctions, opérateurs et mots clés de Web Intelligence
4
Mots clés de la syntaxe avancée Web Intelligence
Mot clé Rapport
Le tableau ci-après décrit les données auxquelles fait référence le mot clé
Rapport, selon son emplacement dans un rapport :
Placé dans…
Un bloc
Fait référence à…
Toutes les données du rapport
Une rupture de bloc (en-tête ou pied) Toutes les données du rapport
Une section (en-tête, pied ou à l'extérieur d'un bloc)
Toutes les données du rapport
A l'extérieur des blocs ou sections Toutes les données du rapport
Exemple : Mot clé Rapport
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes. Le rapport contient une colonne, Rapport total, qui affiche le total de tous les revenus du rapport.
La formule pour la colonne Rapport total est Somme([Chiffre d'affaires])
Dans Rapport. Sans le mot clé Rapport, cette colonne dupliquerait les
214 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
4 chiffres de la colonne Revenu des ventes, car le contexte de sortie par défaut serait utilisé ([Année];[Trimestre]).
Mot clé Section
Le tableau ci-après décrit les données auxquelles fait référence le mot clé
Section, selon son emplacement dans un rapport :
Placé dans…
Un bloc
Fait référence à…
Toutes les données de la section
Une rupture de bloc (en-tête ou pied) Toutes les données de la section
Une section (en-tête, pied ou à l'extérieur d'un bloc)
Toutes les données de la section
A l'extérieur des blocs ou sections Non applicable
Exemple : Mot clé Section
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes.
Le rapport contient une section basée sur Année. La colonne Total section contient la formule :
Sum ([Sales Revenue]) In Section
Les chiffres de la colonne Total section représentent le revenu total pour
2001, car la rupture de section se produit au niveau de l'objet Année. Sans le mot clé Section, cette colonne dupliquerait les chiffres de la colonne
Utilisation de fonctions, formules et calculs dans Web Intelligence 215
Fonctions, opérateurs et mots clés de Web Intelligence
4
Mots clés de la syntaxe avancée Web Intelligence
Revenu des ventes car le contexte de sortie par défaut ([Année];[Trimestre]) serait utilisé.
216 Utilisation de fonctions, formules et calculs dans Web Intelligence
Dépannage des formules
Web Intelligence
5
Dépannage des formules Web Intelligence
5
Messages d'erreur de formule et d'information
Messages d'erreur de formule et d'information
Lorsqu'une formule Web Intelligence ne peut renvoyer une valeur, elle renvoie un message d'erreur ou d'information commençant par "#". Le message apparaît dans la cellule cible de la formule.
#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.
Le message #CALCUL est lié à une mauvaise utilisation des opérateurs de contexte dans une formule. Pour plus d'informations, voir le guide Utilisation
de fonctions, de formules et de calculs dans Web Intelligence .
Rubriques associées
•
page 188
#CONTEXTE
#CONTEXTE est lié aux messages d'erreur #INCOMPATIBLE et
#SYNCDONNEES, qui se produisent lorsqu'un bloc contient un contexte d'agrégation inexistant. Dans le cas de l'erreur #INCOMPATIBLE, le contexte d'agrégation est inexistant, car les dimensions sont incompatibles ; dans le cas de l'erreur #SYNCDONNEES, le contexte d'agrégation est inexistant, car les dimensions proviennent de plusieurs fournisseurs de données non synchronisés.
Exemple : Contexte d'agrégation non existant dans une requête
Si un bloc basé sur l'univers Océan Voyages contient les objets Année de réservation et Revenu, le message d'erreur #CONTEXTE apparaît parce qu'il n'est pas possible de regrouper le revenu par année de réservation.
218 Utilisation de fonctions, formules et calculs dans Web Intelligence
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
5
#SYNCDONNEES
L'erreur #SYNCDONNEES se produit lorsque vous placez une dimension d'un fournisseur de données différent dans un bloc qui contient des dimensions provenant d'un autre fournisseur de données, les deux fournisseurs de données n'étant pas synchronisés via une dimension fusionnée. #SYNCDONNEES apparaît dans toutes les dimensions du bloc et #CONTEXTE apparaît dans les indicateurs.
Exemple : Dimensions provenant de fournisseurs de données différents dans un bloc
Si un rapport basé sur l'univers Océan Voyages contient des fournisseurs de données comportant les objets (Année, Revenu) et (Trimestre), un bloc contenant Année, Trimestre et Revenu affiche l'erreur #SYNCDONNEES dans les colonnes Années et Trimestre, car les deux fournisseurs de données ne sont pas synchronisés via une dimension fusionnée.
#DIV/0
L'erreur #DIV/0 se produit lorsqu'une formule tente de diviser un nombre par zéro, ce qui est mathématiquement impossible. Zéro ne peut jamais apparaître comme diviseur.
Exemple : Détermination du revenu par article
Vous disposez d'un rapport qui présente les revenus des ventes, le nombre d'articles vendus et le revenu par article (qui est calculé en divisant le revenu des ventes par le nombre d'articles vendus).
Vous avez connu un très mauvais trimestre au cours duquel vous n'avez généré aucun revenu ; la colonne Revenu par article renvoie #DIV/0 pour ce trimestre, parce que la formule essaie d'effectuer une division par zéro, c'est-à-dire de diviser par zéro le nombre d'articles vendus.
Utilisation de fonctions, formules et calculs dans Web Intelligence 219
Dépannage des formules Web Intelligence
5
Messages d'erreur de formule et d'information
#INCOMPATIBLE
L'erreur #INCOMPATIBLE se produit lorsqu'un bloc contient des objets incompatibles.
Exemple : Objets incompatibles dans une requête
Si un bloc basé sur l'univers Océan Voyages contient les dimensions Année et Année de réservation, les colonnes contenant ces dimensions affichent l'erreur #INCOMPATIBLE parce que ces objets sont incompatibles.
#VALEURMULTI
L'erreur #VALEURMULTI se produit lorsque vous placez une formule qui renvoie plusieurs valeurs dans une cellule n'en générant qu'une seule.
Exemple : Valeurs multiples dans une cellule
Vous disposez d'un rapport présentant les objets Pays, Lieux de séjour et
Revenu, et vous ajoutez une cellule contenant la formule [Revenu]
PourChaque ([Pays]). Cette cellule renvoie l'erreur #VALEURMULTI car
Pays contient deux valeurs dans le rapport : "Etats-Unis" et "France".
Une cellule ne peut pas afficher simultanément le revenu pour les Etats-Unis et la France. Placée en dehors du tableau, une cellule contenant des revenus peut uniquement agréger les revenus du tableau (par exemple, en les totalisant ou en effectuant leur moyenne).
Si le rapport est divisé en sections au niveau de Pays, la formule est correcte lorsqu'elle est placée dans une section car il n'existe qu'une valeur de Pays par section. Sinon, en dehors d'une section, la formule renvoie systématiquement l'erreur #VALEURMULTI.
220 Utilisation de fonctions, formules et calculs dans Web Intelligence
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
5
#DEBORDEMENT
L'erreur #DEBORDEMENT se produit lorsqu'un calcul renvoie une valeur trop élevée pour que Web Intelligence puisse la traiter. Cette valeur, sous sa forme exponentielle, est 1,7E308 (1,7 suivi de 307 zéros).
#RESULTATPARTIEL
L'erreur #RESULTATPARTIEL se produit lorsque Web Intelligence ne peut pas extraire toutes les lignes associées à un objet de rapport.
Si l'erreur #RESULTATPARTIEL se produit 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 à Web
Intelligence d'extraire davantage de données. Si vous ne disposez pas des droits nécessaires pour modifier la requête, contactez votre administrateur
Business Objects.
Si votre rapport contient des indicateurs intelligents, il est plus susceptible d'afficher l'erreur #RESULTATPARTIEL car les indicateurs intelligents impliquent que Web Intelligence extraie de plus grandes quantités de données qu'avec les indicateurs classiques.
#CLASSEMENT
L'erreur #CLASSEMENT se produit lorsque vous essayez d'établir un classement des données en fonction d'un objet qui dépend de l'ordre des valeurs. (Les objets qui utilisent la fonction Précédent() ou toute fonction d'agrégation cumulative dépendent de l'ordre des valeurs.) L'établissant d'un classement engendre un nouveau calcul des valeurs de ces objets, ce qui modifie le classement et provoque ainsi une dépendance circulaire. Une telle dépendance peut se produire lorsque vous utilisez la boîte de dialogue
Classement pour créer un classement, ou lorsque vous utilisez la fonction
Classement().
Utilisation de fonctions, formules et calculs dans Web Intelligence 221
Dépannage des formules Web Intelligence
5
Messages d'erreur de formule et d'information
Exemple : Etablissement d'un classement de la moyenne cumulative ou des valeurs précédentes
Si vous essayez d'établir un classement d'un bloc sur une colonne qui contient la fonction Précédent() ou toute fonction d'agrégation cumulative, la totalité du bloc renvoie l'erreur #CLASSEMENT.
#RECURSIF
L'erreur #RECURSIF se produit lorsque Web Intelligence ne peut pas effectuer un calcul en raison d'une dépendance circulaire.
Exemple : Utilisation de la fonction NombreDePages()
Si vous placez la fonction NombreDePages() dans une cellule dont les propriétés Ajuster la hauteur automatiquement ou Ajuster la largeur automatiquement sont définies, Web Intelligence renvoie l'erreur
#RECURSIF, car le placement de cette formule dans une cellule ajustée automatiquement crée une dépendance circulaire. Web Intelligence doit connaître la taille exacte du rapport avant de pouvoir renvoyer une valeur de la fonction, mais la taille de la cellule (laquelle affecte la taille du rapport) est déterminée par le contenu de la cellule.
#SECURITE
L'erreur #SECURITE se produit lorsque vous essayez d'utiliser une fonction pour laquelle vous ne disposez pas des droits de sécurité.
Exemple : Utilisation de la fonction SQLDuFournisseur()
Si un utilisateur ne disposant pas du droit de visualiser le SQL du fournisseur de données place la fonction SQLDuFournisseur() dans une cellule, le message #SECURITE apparaît dans la cellule.
222 Utilisation de fonctions, formules et calculs dans Web Intelligence
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
5
#SYNTAXE
L'erreur #SYNTAXE se produit lorsqu'une formule fait référence à un objet qui n'existe plus dans le rapport.
Exemple : Référence à un objet non existant
Vous disposez d'un rapport qui affichait initialement les objets Année,
Trimestre et Revenu des ventes, avec une colonne supplémentaire pour montrer la différence entre le revenu et le revenu moyen annuel. Ce chiffre est généré par la variable Différence de moyenne annuelle.
Si la variable Différence de moyenne annuelle est supprimée du rapport, la colonne qui la contient renvoie l'erreur #SYNTAXE.
#TOREFRESH
L'erreur #TOREFRESH apparaît dans les cellules basées sur des indicateurs intelligents lorsque la valeur renvoyée par l'indicateur intelligent n'est pas disponible. Cette situation se produit lorsque le "regroupement" contenant la valeur n'est pas disponible dans le fournisseur de données.
Vous pouvez supprimer l'erreur #TOREFRESH en actualisant les données.
#INDISPONIBLE
L'erreur #INDISPONIBLE se produit lorsque Web Intelligence ne peut pas calculer la valeur d'un indicateur intelligent.
Cette situation se produit lorsque Web Intelligence ne peut pas afficher les valeurs d'un indicateur intelligent filtré sans appliquer un filtre à la requête.
Etant donné que cela risquerait d'avoir un impact sur les autres rapports basés sur la même requête, Web Intelligence n'applique pas le filtre de requête.
Utilisation de fonctions, formules et calculs dans Web Intelligence 223
Dépannage des formules Web Intelligence
5
Messages d'erreur de formule et d'information
#ERREUR
#ERREUR est le message d'erreur par défaut qui couvre toutes les erreurs non couvertes par les autres messages d'erreur.
224 Utilisation de fonctions, formules et calculs dans Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
6
Calcul de valeurs à l'aide d'indicateurs intelligents
6
Indicateurs intelligents définis
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é un univers Web Intelligence, plutôt que par Web Intelligence lui-même.
Un indicateur est défini comme un indicateur intelligent dans l'univers lorsque ses données sont agrégées d'une manière qui n'est pas prise en charge par
Web Intelligence.
Pour renvoyer les valeurs d'un indicateur intelligent, Web Intelligence génère une requête pour calculer l'indicateur dans tous les contextes de calcul requis dans un rapport. Ces contextes peuvent changer lorsque le rapport est modifié. En conséquence, Web Intelligence modifie la requête à chaque actualisation des données suivant un changement des contextes requis.
Les indicateurs intelligents se comportent différemment des indicateurs classiques, qui prennent en charge un ensemble basique de fonctions d'agrégation (Max, Min, Nombre, Somme, Moyenne) que Web Intelligence peut calculer dans tous les contextes sans l'aide de la base de données.
Par exemple, si vous créez une requête contenant les dimensions [Pays] et
[Région], et l'indicateur [Revenu] (qui calcule la somme des revenus), Web
Intelligence affiche initialement Pays, Région et Revenu dans un bloc. Si vous supprimez Région du bloc, Web Intelligence est toujours en mesure de calculer le revenu total de chaque pays en calculant la somme des revenus de toutes les régions du pays.
Les contextes de calcul sont représentés par des "regroupements" dans la requête générée par Web Intelligence.
Regroupements et indicateurs intelligents
Un "regroupement" est un ensemble de dimensions qui génère un résultat pour un indicateur. Lorsque Web Intelligence renvoie des données pour un indicateur intelligent, le SQL généré inclut les regroupements pour toutes les agrégations de cet indicateur qui sont incluses dans le rapport.
226 Utilisation de fonctions, formules et calculs dans Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Regroupements et indicateurs intelligents
6
Exemple : Regroupements dans une requête
Une requête contient les dimensions [Pays], [Région], [Ville] et l'indicateur intelligent [Revenu]. Ces objets impliquent que les regroupements suivants calculent le revenu dans tous les contextes possibles :
• Valeur d'indicateur intelligent totale
• Valeur d'indicateur intelligent par (Pays, Région, Ville)
• Valeur d'indicateur intelligent par (Pays, Ville)
• Valeur d'indicateur intelligent par (Ville)
• Valeur d'indicateur intelligent par (Région, Ville)
• Valeur d'indicateur intelligent par (Région)
• Valeur d'indicateur intelligent par (Pays, Région)
• Valeur d'indicateur intelligent par (Pays)
Web Intelligence extrait les regroupements en utilisant l'opérateur
UNION dans la requête. Si la base de données ne prend pas en charge l'opérateur
UNION
, Web Intelligence effectue lui-même les unions.
Web Intelligence met à jour les regroupements en fonction des contextes de calcul requis par le rapport, lesquels peuvent changer suite aux modifications apportées à la structure du rapport.
Gestion des regroupements par Web Intelligence
Lorsque vous créez et exécutez initialement une requête incluant des indicateurs intelligents, Web Intelligence inclut les regroupements nécessaires pour calculer les indicateurs intelligents au niveau le plus détaillé impliqué par les objets de la requête. Web Intelligence inclut toujours ce regroupement dans le SQL de la requête.
Par exemple, si vous créez une requête contenant les dimensions [Pays],
[Région], [Ville] et l'indicateur intelligent [Revenu], Web Intelligence inclut le regroupement (Pays, Région, Ville) dans le SQL généré. Ce regroupement apparaît toujours dans le SQL. Web Intelligence ajoute et supprime d'autres regroupements en réponse aux modifications apportées au rapport.
Si vous supprimez la dimension [Ville] du bloc, Web Intelligence a besoin du regroupement (Pays, Région) pour renvoyer les valeurs de revenu. Ce regroupement n'est pas encore disponible dans le SQL de la requête, par conséquent, Web Intelligence affiche #TOREFRESH dans les cellules
Utilisation de fonctions, formules et calculs dans Web Intelligence 227
Calcul de valeurs à l'aide d'indicateurs intelligents
6
Indicateurs intelligents et périmètre d'analyse
[Revenu]. Lorsque vous actualisez les données, Web Intelligence est en mesure de remplacer #TOREFRESH par les valeurs de revenu.
Si vous replacez ensuite la dimension [Ville] dans le bloc, le regroupement
(Pays, Région) n'est plus nécessaire. Web Intelligence le supprime donc du
SQL de la requête et ignore ses valeurs la prochaine fois que vous actualisez les données.
Chaque fois que vous actualisez les données du rapport, Web Intelligence met à jour le SQL de la requête pour inclure ou ignorer les regroupements en fonction des contextes de calcul requis par le rapport.
Dans certains cas, Web Intelligence ne peut pas afficher la valeur d'un indicateur intelligent. Dans ce cas, Web Intelligence affiche l'erreur
#INDISPONIBLE dans les cellules de l'indicateur.
Indicateurs intelligents et périmètre d'analyse
Lorsque vous créez une requête avec un périmètre d'analyse, Web
Intelligence génère un regroupement initial qui contient les objets du résultat, mais pas les objets du périmètre. Web intelligence ne génère pas tous les regroupements possibles résultant de la combinaison des objets du résultat et des objets du périmètre.
Exemple : Requête avec un périmètre d'analyse et un indicateur intelligent
Une requête a les objets du résultat [Pays] et [Revenu]. Le périmètre d'analyse contient les dimensions [Région] et [Ville]. Lorsque vous exécutez la requête, Web Intelligence extrait le regroupement (Pays) et affiche [Pays] et [Revenu] dans un bloc.
Indicateurs intelligents et SQL
Regroupements et opérateur UNION
Certaines bases de données prennent en charge les regroupements d'ensembles de façon explicite avec l'opérateur
GROUPING SETS
.
228 Utilisation de fonctions, formules et calculs dans Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et SQL
6
Web Intelligence utilise plusieurs jeux de résultats et l'opérateur
UNION pour simuler l'effet de
GROUPING SETS
.
Exemple : Regroupements extraits avec l'opérateur UNION
Cet exemple décrit une requête contenant les dimensions [Pays], [Région],
[Ville] et l'indicateur intelligent [Revenu].
Remarque :
Pour plus de simplicité, l'indicateur intelligent calcule une somme. Dans la pratique, aucun indicateur intelligent n'est nécessaire pour cette agrégation car les univers Web Intelligence prennent en charge la fonction
Somme
.
Lorsque la requête est exécutée pour la première fois, le regroupement est
(Pays, Région, Ville). La requête SQL complète renvoie ce regroupement et l'opérateur
UNION n'est absolument pas nécessaire dans le SQL.
Si vous supprimez la dimension [Ville] de la table, Web Intelligence a besoin du regroupement (Pays, Région) pour afficher le revenu (qui apparaît en tant qu'erreur #TOREFRESH). Après l'actualisation des données, le SQL se présente comme suit :
SELECT
SELECT
0 AS GID, country.country_name, region.region_name,
NULL, sum(city.revenue)
FROM country, region, city
WHERE
( country.country_id=region.country_id
)
AND ( region.region_id=city.region_id
)
GROUP BY country.country_name, region.region_name
UNION
SELECT
1 AS GID, country.country_name, region.region_name, city.city_name, sum(city.revenue)
FROM country, region,
Utilisation de fonctions, formules et calculs dans Web Intelligence 229
Calcul de valeurs à l'aide d'indicateurs intelligents
6
Indicateurs intelligents et SQL
city
WHERE
( country.country_id=region.country_id
)
AND ( region.region_id=city.region_id
)
GROUP BY country.country_name, region.region_name, city.city_name
Chaque regroupement est représenté par une instruction
SELECT et a son propre ID (dans la colonne GID). Les regroupements qui ne contiennent pas l'ensemble de dimensions intégral incluent des colonnes vides (
SELECT
''
) car chaque instruction
SELECT d'une requête incluant l'opérateur
UNION doit avoir le même nombre de colonnes.
Si vous ajoutez au rapport un nouveau bloc contenant [Pays] et [Revenu],
Web Intelligence a besoin du regroupement (Pays). Le SQL généré inclut maintenant les trois regroupements suivants :
SELECT
0 AS GID, country.country_name, region.region_name,
NULL, sum(city.revenue)
FROM country, region, city
WHERE
( country.country_id=region.country_id
)
AND ( region.region_id=city.region_id
)
GROUP BY country.country_name, region.region_name
UNION
SELECT
1 AS GID, country.country_name,
NULL,
NULL, sum(city.revenue)
FROM country, city, region
WHERE
( country.country_id=region.country_id
)
AND ( region.region_id=city.region_id
)
GROUP BY
230 Utilisation de fonctions, formules et calculs dans Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et formules
6 country.country_name
UNION
SELECT
2 AS GID, country.country_name, region.region_name, city.city_name, sum(city.revenue)
FROM country, region, city
WHERE
( country.country_id=region.country_id
)
AND ( region.region_id=city.region_id
)
GROUP BY country.country_name, region.region_name, city.city_name
Indicateurs intelligents et formules
Indicateurs intelligents et dimensions contenant des formules
Si une formule ou une variable apparaît en tant que dimension dans le contexte de calcul d'un indicateur intelligent et que cette formule détermine le regroupement requis par l'indicateur, Web Intelligence ne peut pas afficher les valeurs de l'indicateur intelligent. Web Intelligence ne peut pas déduire le regroupement à partir d'une formule dans cette situation.
Par exemple, un rapport contient une variable,
Semestre
, avec la formule suivante :
If [Quarter] = "Q1" or [Quarter] = "Q2" Then "H1" Else "H2"
Placée dans un bloc, la variable
Semestre renvoie le résultat suivant :
Semestre
H1
Revenu
#INDISPONIBLE
Utilisation de fonctions, formules et calculs dans Web Intelligence 231
Calcul de valeurs à l'aide d'indicateurs intelligents
6
Indicateurs intelligents et formules
Semestre
H2
Revenu
#INDISPONIBLE
Indicateurs intelligents dans les formules
Web Intelligence peut renvoyer une valeur pour un indicateur intelligent lorsque cet indicateur intelligent est inclus dans une formule, même lorsque la formule nécessite un contexte de calcul différent de celui impliqué par la position de la formule.
Par exemple, un rapport contient un bloc défini comme suit :
Pays
Etats-Unis
Etats-Unis
Etats-Unis
Etats-Unis
Région
Nord
Sud
Est
Ouest
Revenu
10 000
15 000
14 000
12 000
Si vous incluez une colonne supplémentaire dans la table avec la formule suivante :
[Revenue] ForAll ([Region])
Web Intelligence renvoie initialement l'erreur #TOREFRESH car la formule nécessite le regroupement (Pays). (La formule exclut les régions du calcul.)
Lorsque vous actualisez les données, Web Intelligence ajoute le regroupement (Pays) à la requête et affiche les valeurs d'indicateur.
232 Utilisation de fonctions, formules et calculs dans Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et filtres
6
Indicateurs intelligents et filtres
Indicateurs intelligents et filtres sur les dimensions
Si un filtre est appliqué à une dimension dont dépend la valeur d'un indicateur intelligent, mais que cette dimension n'apparaît pas explicitement dans le contexte de calcul de l'indicateur, Web Intelligence ne peut renvoyer aucune valeur pour l'indicateur intelligent et affiche donc l'erreur #INDISPONIBLE.
Cette situation se produit car Web Intelligence ne peut pas calculer l'effet du filtre sur les valeurs de l'indicateur. La seule manière de connaître son effet est d'appliquer le filtre à la requête. Mais cela présente un risque, car cela peut avoir un impact sur les autres rapports basés sur la même requête.
En conséquence, Web Intelligence n'applique pas le filtre au niveau de la requête.
Exemple : Un indicateur intelligent et un filtre sur une dimension
Une requête contient les dimensions [Pays] et [Région], et l'indicateur intelligent [Revenu]. [Pays] et [Revenu] sont affichés dans un bloc. Si vous appliquez un filtre de rapport limitant les valeurs de [Région] à "Sud-est" ou "Sud-ouest", Web Intelligence affiche l'erreur #INDISPONIBLE dans les cellules [Revenu].
Indicateurs intelligents et filtres d'exploration
En général, Web Intelligence ne peut pas renvoyer les valeurs des indicateurs intelligents lorsqu'un filtre est appliqué à une dimension qui a un impact sur le calcul de l'indicateur. Les dimensions filtrées par des filtres d'exploration sont l'exception à cette règle.
Exemple : Filtre d'exploration affectant un indicateur intelligent
Un bloc contient les objets [Pays] et [Revenu]. Vous explorez l'objet [Pays] et Web Intelligence affiche [Région], [Revenu] dans le bloc et place le filtre sur [Pays] dans la barre d'outils d'exploration.
Utilisation de fonctions, formules et calculs dans Web Intelligence 233
Calcul de valeurs à l'aide d'indicateurs intelligents
6
Indicateurs intelligents et filtres
Pour ce faire, Web Intelligence ajoute le regroupement (Pays, Région) à la requête et extrait toutes ses données, puis il filtre ces données pour afficher uniquement les régions contenues dans le pays exploré.
Web Intelligence n'a pas besoin d'ajouter un filtre au niveau de la requête pour filtrer les régions en fonction du pays auquel elles appartiennent.
234 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de
Web Intelligence
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction Précédent
Comparaison de valeurs à l'aide de la fonction Précédent
La fonction
Précédent renvoie une valeur précédente comparative d'une expression. La valeur renvoyée dépend de la présentation du rapport.
Si vous voulez utiliser une fonctionnalité de comparaison plus puissante, utilisez la fonction
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
•
page 183
•
page 188
•
Comparaison de valeurs à l'aide de la fonction ValeurRelative
page 236
Comparaison de valeurs à l'aide de la fonction ValeurRelative
La fonction
ValeurRelative renvoie les valeurs comparatives d'une expression. La fonction renvoie ces valeurs quelle que soit la présentation du rapport.
Lorsque vous utilisez la fonction
ValeurRelative
, vous spécifiez les
éléments suivants :
• L'expression dont vous voulez trouver la valeur comparative (l'expression doit être un indicateur ou un détail d'une dimension disponible dans le bloc).
• La liste des "dimensions de découpage"
• L'offset.
La fonction utilise les dimensions de découpage, l'offset et les "dimensions de sous-axe" (impliquées par les dimensions de découpage) pour renvoyer une valeur comparative. Les dimensions de sous-axe correspondent à toutes les dimensions du contexte de calcul, sauf les dimensions de découpage.
Exprimée en termes généraux,
ValeurRelative renvoie la valeur de l'expression de la ligne qui, dans la liste de valeurs des dimensions de
236 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
7 découpage, correspond aux lignes situées à offset lignes de la ligne actuelle, et où les valeurs des dimensions de sous-axe sont identiques à celles de la ligne actuelle.
Remarque :
Toutes les dimensions de découpage se trouvent obligatoirement dans le contexte de calcul du bloc dans lequel se trouve la fonction. Si une dimension de découpage est ensuite supprimée, la fonction renvoie l'erreur #CALCUL.
2007
2007
2007
2007
2008
2008
2008
2008
Exemple :
Dans cet exemple, la colonne ValeurRelative contient la formule suivante :
RelativeValue([Revenue];([Year]);-1)
• L'expression est [Chiffre d'affaires];
• La dimension de découpage est [Année];
• L'offset est -1 (la fonction renvoie la valeur située immédiatement avant dans la liste).
Année Trimestre Vendeur
T1
T2
T3
T4
T1
T2
T3
T4
Durand
Dupont
Martin
Dubois
Durand
Dupont
Martin
Dubois
Chiffre d'affaires
1 000
2 000
1 500
3 000
4 000
3 400
2 000
1 700
Valeur-
Relative
1 000
2 000
1 500
3 000
Exprimée en tant que question sur l'activité, la formule invite
Web Intelligence à renvoyer le chiffre d'affaires généré par le même vendeur au même trimestre de l'année précédente.
Exprimée en tant que calcul formulé par des mots, la formule invite
Web Intelligence à renvoyer la valeur de [Chiffre d'affaires] (l'expression) dans la ligne où la valeur de [Année] (la dimension de découpage) est la
Utilisation de fonctions, formules et calculs dans Web Intelligence 237
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction ValeurRelative
valeur précédente de la liste de valeurs de l'objet [Année] et où les valeurs de [Trimestre] et de [Vendeur] (les dimensions de sous-axe) sont identiques
à celles de la ligne active.
Rubriques associées
•
page 188
Dimensions de découpage et fonction ValeurRelative
La fonction
ValeurRelative utilise la liste de valeurs des dimensions de découpage pour trouver la ligne comparative. La fonction renvoie la valeur comparative de l'expression spécifiée dans la fonction qui se trouve à offset lignes dans la liste des dimensions de découpage.
En conséquence, l'ordre de tri des dimensions de découpage est essentiel pour déterminer le résultat de la fonction.
2007
2007
2007
2007
2007
2007
Exemple : Dimensions de découpage multiples
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
• L'expression est [Chiffre d'affaires];
• Les dimensions de découpage sont ([Année];[Trimestre]);
• L'offset est -1 (la fonction renvoie la valeur située immédiatement avant dans la liste).
Année Trimestre Vendeur
T1
T2
T3
T4
T1
T2
Durand
Durand
Durand
Durand
Dupont
Dupont
Chiffre d'affaires
1 000
2 000
1 500
3 000*
4 000
3 400
Valeur-
Relative
238 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
7
Année
2007
2007
2008
2008
2008
2008
Trimestre
T3
T4
T1
T2
T3
T4
Vendeur
Dupont
Dupont
Durand
Durand
Durand
Durand
Chiffre d'affaires
2 000
1 700
5 000**
3 000***
2 700****
6 800
Valeur-
Relative
3 000*
5 000**
3 000***
2 700****
Exprimée en tant que question sur l'activité, la formule invite
Web Intelligence à renvoyer le chiffre d'affaires généré par le même vendeur au trimestre précédent.
Exprimée en tant que calcul formulé par des mots, la formule invite
Web Intelligence à renvoyer la valeur de [Chiffre d'affaires] dans la ligne où les valeurs de [Année] et de [Trimestre] représentent la valeur précédente de la liste de valeurs ([Année];[Trimestre]) et où la valeur de [Vendeur] est identique à celle de la ligne actuelle.
Pour trouver la valeur comparative du chiffre d'affaires, Web Intelligence utilise la liste de valeurs des dimensions de découpage :
Année
2007
2007
2007
2007
2008
Trimestre
T1
T2
T3
T4
T1
*
**
Utilisation de fonctions, formules et calculs dans Web Intelligence 239
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
2008
2008
2008
Trimestre
T2
T3
T4
***
****
L'ordre de tri des dimensions de découpage détermine le résultat de la fonction. Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées
•
page 188
Dimensions de découpage et sections
Une dimension de découpage peut être dans la cellule maître d'une section de rapport.
Exemple :
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
2007
Trimestre
T1
T2
T3
T4
T1
Vendeur
Durand
Durand
Durand
Durand
Dupont
Chiffre d'affaires ValeurRelative
1 000
2 000
1 500
3 000*
4 000
240 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
7
Trimestre
T2
T3
T4
2008
Trimestre
T1
T2
T3
T4
Vendeur
Dupont
Dupont
Dupont
Chiffre d'affaires ValeurRelative
3 400
2 000
1 700
Vendeur
Durand
Durand
Durand
Durand
Chiffre d'affaires ValeurRelative
5 000** 3 000*
3 000***
2 700 ****
6 800
5 000**
3 000***
2 700****
Année
2007
2007
2007
2007
2008
2008
2008
2008
Pour trouver la valeur comparative du chiffre d'affaires, Web Intelligence utilise la liste de valeurs des dimensions de découpage :
T4
T1
T2
T3
T4
Trimestre
T1
T2
T3
*
**
***
****
L'ordre de tri des dimensions de découpage détermine le résultat de la fonction. Dans les tableaux, l'ordre de tri est signalé par le signe *.
Utilisation de fonctions, formules et calculs dans Web Intelligence 241
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Rubriques associées
•
page 188
Ordre des dimensions de découpage
Etant donné que l'ordre de tri de la liste de valeurs des dimensions de découpage détermine le résultat de
ValeurRelative
, l'ordre dans lequel les dimensions de découpage sont spécifiées a une incidence sur le résultat de la fonction.
Exemple : Ordre des dimensions de découpage
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
Année
2007
2007
2007
2007
2007
2007
2007
2007
2008
Trimestre
T1
T2
T3
T4
T1
T2
T3
T4
T1
Vendeur
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Dupont
Durand
Chiffre d'affaires
1 000
2 000
1 500
3 000*
4 000
3 400
2 000
1 700
5 000**
Valeur-
Relative
3 000*
242 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
7
Année
2008
2008
2008
Trimestre
T2
T3
T4
Vendeur
Durand
Durand
Durand
Chiffre d'affaires
3 000***
2 700****
6 800
Valeur-
Relative
5 000**
3 000***
2 700****
Exprimée en tant que question sur l'activité, la formule invite
Web Intelligence à afficher le chiffre d'affaires généré par le même vendeur au trimestre précédent.
L'ordre de tri des dimensions de découpage est le suivant :
Année
2007
2007
2007
2007
2008
2008
2008
2008
T3
T4
T1
T2
Trimestre
T1
T2
T3
T4
*
**
***
****
L'appel de fonction devient :
RelativeValue([Revenue];([Quarter];[Year]);-1)
L'ordre de tri des dimensions de découpage devient :
Utilisation de fonctions, formules et calculs dans Web Intelligence 243
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction ValeurRelative
T3
T4
T4
Trimestre
T1
T1
T2
T2
T3
Année
2007
2008
2007
2008
2007
2008
2007
2008
*
**
***
****
*****
******
*******
********
2007
2007
2007
2007
2007
2007
2007
2007
2008
L'impact de l'ordre de tri sur le résultat de la fonction est le suivant :
Année Trimestre Vendeur
T1
T2
T3
T4
T1
T2
T3
T4
T1
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Dupont
Durand
Chiffre d'affaires
1 000*
2 000***
1 500*****
3 000*******
4 000
3 400
2 000
1 700
5 000**
Valeur-
Relative
1 000*
244 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
7
Année
2008
2008
2008
Trimestre
T2
T3
T4
Vendeur
Durand
Durand
Durand
Chiffre d'affaires
3 000****
2 700******
6 800********
Valeur-
Relative
2 000***
1 500*****
3 000*******
Exprimée en tant que question sur l'activité, la formule invite maintenant
Web Intelligence à afficher le chiffre d'affaires généré par le même vendeur au même trimestre de l'année précédente.
La modification de l'ordre de tri de la dimension de découpage modifie la signification de la formule. Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées
•
page 188
Dimensions de découpage et tris
Etant donné que l'ordre de tri de la liste de valeurs des dimensions de découpage détermine le résultat de la fonction, le tri appliqué à toutes les dimensions de découpage a une incidence sur le résultat de la fonction.
Exemple : Tri personnalisé appliqué à une dimension de découpage
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
Un tri personnalisé (T1, T2, T4, T3) est appliqué à [Trimestre] et le résultat de la fonction est le suivant :
Utilisation de fonctions, formules et calculs dans Web Intelligence 245
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
2007
2007
2007
2008
2008
2008
2008
2007
2007
2007
2007
2007
Trimestre
T2
T4
T3
T2
T4
T3
T1
T1
T2
T4
T3
T1
Vendeur
Durand
Durand
Durand
Durand
Dupont
Dupont
Dupont
Dupont
Durand
Durand
Durand
Durand
Chiffre d'affaires
1 000
2 000
3 000
1 500*
4 000
3 400
1 700
2 000
5 000**
3 000***
6 800****
2 700
Valeur-
Relative
1 500*
5 000**
3 000***
6 800****
Année
2007
2007
2007
2007
2008
2008
2008
2008
La liste triée des dimensions de découpage est la suivante :
T2
T4
T3
Trimestre
T1
T2
T4
T3
T1
*
**
***
****
Dans les tableaux, l'ordre de tri est signalé par le signe *.
246 Utilisation de fonctions, formules et calculs dans Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
7
Rubriques associées
•
page 188
Utilisation de ValeurRelative dans les tableaux croisés
La fonction ValeurRelative fonctionne exactement de la même façon dans les tableaux croisés et dans les tableaux verticaux. La présentation des données dans un tableau croisé n'a pas d'incidence sur le résultat de la fonction.
Rubriques associées
•
page 188
Utilisation de fonctions, formules et calculs dans Web Intelligence 247
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
7
Comparaison de valeurs à l'aide de la fonction ValeurRelative
248 Utilisation de fonctions, formules et calculs dans Web Intelligence
Aide supplémentaire
A
A
Aide supplémentaire
Bibliothèque de documentation en ligne
Business Objects vous propose une documentation complète couvrant l'ensemble de ses produits, ainsi que leur déploiement. La bibliothèque de documentation en ligne contient la dernière version de la documentation sur les produits Business Objects. Vous pouvez parcourir le contenu de la bibliothèque, effectuer des recherches de texte, lire les guides en ligne et télécharger les versions PDF. La bibliothèque est mise à jour régulièrement et enrichie des nouveaux documents disponibles.
Pour accéder à la bibliothèque de documentation en ligne, rendez-vous à
http://help.sap.com/
et cliquez sur Business Objects en haut de la page.
Autres ressources destinées aux développeurs
https://boc.sdn.sap.com/developer/library/
Support client en ligne
Le site Web de support client de Business Objects contient des informations sur les programmes et les services de support client. Il contient également des liens vers toute une gamme d'informations techniques, notamment vers des articles de la base de connaissances, des téléchargements et des forums de support.
http://www.businessobjects.com/support/
Comment trouver la meilleure solution de déploiement pour votre entreprise ?
Les consultants de Business Objects peuvent vous accompagner depuis l'analyse initiale d'un projet jusqu'à son déploiement effectif. Ils font notamment preuve d'expertise en matière de bases de données relationnelles et multi-dimensionnelles, en connectivités, en outils de conception de base de données, en technologie intégrée personnalisée, etc.
Pour en savoir plus, adressez-vous à votre agence commerciale locale, ou contactez-nous à l'adresse suivante :
http://www.businessobjects.com/services/consulting/
250 Utilisation de fonctions, formules et calculs dans Web Intelligence
Aide supplémentaire
A
Quels sont les types de formation proposés ?
Nous pouvons vous fournir un module de formation qui réponde à vos besoins et convienne à votre style d'apprentissage préféré, sous forme de stage traditionnel ou de séminaires plus ciblés. Pour plus d'informations sur le site
Web de formation de Business Objects :
http://www.businessobjects.com/services/training
Vos commentaires sont les bienvenus
Avez-vous des suggestions à faire pour améliorer notre documentation ? Y a-t-il quelque chose que vous avez particulièrement apprécié ou trouvé utile ?
Envoyez-nous un commentaire et nous ferons le maximum pour garantir que votre suggestion trouve sa place dans la prochaine version de notre documentation.
mailto:[email protected]
Remarque :
Si votre question porte sur un produit Business Objects et non sur la documentation, veuillez contacter les experts de notre support client. Pour plus d'informations sur le support client, visitez le site suivant :
http://www.businessobjects.com/support/
.
Informations sur les produits Business Objects
Pour en savoir plus sur la gamme complète des produits Business Objects, visitez la page :
http://www.businessobjects.com
Utilisation de fonctions, formules et calculs dans Web Intelligence 251
A
Aide supplémentaire
252 Utilisation de fonctions, formules et calculs dans Web Intelligence
Index
Symboles
#CALCUL, message d'erreur
#CLASSEMENT, message d'erreur
#CONTEXTE, message d'erreur
#DEBORDEMENT, message d'erreur
#DIV/0, message d'erreur
#ERREUR, message d'erreur
#INCOMPATIBLE, message d'erreur
#INDISPONIBLE, message d'erreur
#RECURSIF, message d'erreur
#RESULTATPARTIEL, message d'erreur
#SECURITE, message d'erreur
#SYNCDONNEES, message d'erreur
#SYNTAXE, message d'erreur
#TOREFRESH, message d'erreur
#VALEURMULTI, message d'erreur
A
Abs, fonction
Année, fonction
Arrondi, fonction
Asc, fonction
AucunFiltre, fonction
AuteurDuDocument, fonction
Auto, opérateur
B
Bas, opérateur
Bloc, mot clé
,
C
calcul, contexte définition
valeur par défaut
calculs personnalisés
calculs personnalisés
utiliser des formules pour créer
calculs standard
Capitale, fonction
CapitaleMot, fonction
Car, fonction
cellules inclure du texte dans
Centile, fonction
Classement, fonction
Col, opérateur
Comparer, fonction
Concaténation, fonction
conditionnels, opérateurs
Connexion, fonction
contexte d'entrée définition
contexte de calcul par défaut dans les ruptures
dans un tableau horizontal
dans un tableau vertical
dans une section
modifier à l'aide d'une syntaxe étendue
tableaux croisés
contexte de sortie définition
contexte, opérateurs
Utilisation de fonctions, formules et calculs dans Web Intelligence 253
Index
ConvertirDepuisEuro, fonction
ConvertirEnEuro, fonction
Corps, mot clé
,
Cos, fonction
Count, fonction
D
Dans, opérateur
DansListe, opérateur
DateActuelle, fonction
,
DateCléFournisseurDonnées, fonction
DateDeLaDernièreExécution, fonction
DateDeLaDernièreImpression, fonction
DateDeLaValeurDeRéférence, fonction
DateDuDocument, fonction
DateRelative, fonction
découpage, dimensions
,
impact de l'ordre de tri
,
ordre
Dernier, fonction
DernierJourDeLaSemaine, fonction
DernierJourDuMois, fonction
DISTINCT, opérateur
DocumentPartiellementActualisé, fonction
Droite, fonction
DuréeDernièreExécution, fonction
E
EcartTypeP, fonction
EnDate, fonction
EnNombre, fonction
Entre, opérateur
ErreurEuroParArrondi, fonction
ErreurEuroVersArrondi, fonction
EstChaîne, fonction
EstDate, fonction
EstErreur
EstErreur, fonction
EstHeure, fonction
EstLogique, fonction
EstNombre, fonction
EstNul
EstNul, fonction
Et, opérateur
Exp, fonction
Exploration, opérateur
,
F
Fact, fonction
FiltreRapport, fonction
filtres d'exploration et indicateurs intelligents
filtres sur les dimensions impact sur les indicateurs intelligents
FiltresExploration, fonction
Floor, fonction
fonction, catégories
fonctions
,
Abs
Année
Arrondi
Asc
AucunFiltre
AucunFiltreExploration
AuteurDuDocument
Average
Capitale
CapitaleMot
Car
Centile
Classement
Comparer
Concaténation
Connexion
ConvertirDepuisEuro
ConvertirEnEuro
Cos
DateActuelle
DateCléFournisseurDonnées
DateDeCréationDuDocument
DateDeLaDernièreExécution
254 Utilisation de fonctions, formules et calculs dans Web Intelligence
Index fonctions (suite)
DateDeLaDernièreImpression
DateDeLaValeurDeRéférence
DateDuDocument
DateRelative
Dernier
DernierJourDeLaSemaine
DernierJourDuMois
DocumentPartiellementActualisé
Droite
DuréeDernièreExécution
EcartTypeP
EnDate
EnNombre
ErreurEuroParArrondi
ErreurEuroVersArrondi
EstChaîne
EstHeure
EstLogique
exemples
Exp
Fact
FiltreRapport
FiltresExploration
Floor
fonction AucunFiltreExploration
fonction DateDeCréationDuDocument
fonction HeureDeCréationDuDocument
fonction HeureDeLaDernièreExécution
fonction MinCumulatif
ForcerFusion
FormatDeDate
FormatDeNombre
FournisseurDeDonnées
Gauche
HeureDeCréationDuDocument
HeureDuDocument
HTMLEncode
Impair
IndexationDesLignes
Interpolation
IsDate
fonctions (suite)
JoursEntre
LégendeDateCléFournisseurDonnées
Ln
Log
Longueur
Majuscule
Max
MaxCumulatif
Médiane
Min
MinCumulatif
Minuscule
Mode
Modulo
Mois
MoisEntre
MoyenneCumulative
Nombre
NombreCumulatif
NombreDeFournisseurs
NombreDeLignes
NombreDePages
NomDe
NomDeUnivers
NomDuBloc
NomDuDocument
NomDuJour
NomRapport
NomUniqueDe
NuméroDeColonne
NuméroDeLigne
NuméroDuJourDeAnnée
NuméroDuJourDeLaSemaine
NuméroDuJourDuMois
NuméroDuMoisDeAnnée
ObtenirVariablesRégionalesDeContenu
ObtenirVarRég
Page
Pair
Plafond
Pos
Utilisation de fonctions, formules et calculs dans Web Intelligence 255
Index fonctions (suite)
Pourcentage
Précédent
,
Premier
ProduitCumulatif
prototypes de fonction
Puissance
Racine
Remplacer
RemplissageDroite
RemplissageGauche
Répéter
RéponseInvite
RéponseUtilisateur
RéponseUtilisateurValeurRéf
RésuméFiltreRapport
RésuméInvite
RésuméRequête
Semaine
Si
Signe
Sin
SommeCumulative
SousChaîne
SQLDuFournisseur
StdDev
SupprEspace
SupprEspDroite
SupprEspGauche
Tan
Trimestre
Truncate
TypeDuFournisseur
URLEncode
UtilisateurCourant
ValeurRéf
ValeurRelative
,
,
Var
VarP
ForcerFusion, fonction
FormatDeNombre, fonction
I
formules et indicateurs intelligents
indicateurs intelligents dans
messages d'erreur et d'information
simplifier avec des variables
FournisseurDeDonnées, fonction
G
Gauche, fonction
H
HeureDeLaDernièreExécution, fonction
HeureDuDocument, fonction
HTMLEncode, fonction
Impair, fonction
InclureVide, opérateur
Index, opérateur
IndexationDesLignes, fonction
indicateurs définition des indicateurs intelligents
indicateurs intelligents dans des formules
définition
et filtres d'exploration
et formules
et périmètre d'analyse
et regroupements
et variables
impact des filtres sur
Interpolation, fonction
J
JoursEntre, fonction
256 Utilisation de fonctions, formules et calculs dans Web Intelligence
Index
L
LégendeDateCléFournisseurDonnées, fonction
Ligne, opérateur
LigneEtape, opérateur opérateurs
LigneEtape
Linéaire, opérateur
Ln, fonction
Log, fonction
Log10, fonction fonctions
Log10
Longueur, fonction
Modulo, fonction
Mois, fonction
MoisEntre, fonction
mot clé
Corps
,
mots clés
Bloc
rapport
,
rendre les rapports génériques avec
Rupture
,
Section
,
Moyenne, fonction
MoyenneCumulative, fonction
M
Majuscule, fonction
mathématiques, opérateurs
,
Max, fonction
MaxCumulatif, fonction
Médiane, fonction
messages d'erreur
#CALCUL
#CLASSEMENT
#CONTEXTE
#DEBORDEMENT
#DIV/0
#ERREUR
#INCOMPATIBLE
#INDISPONIBLE
#RECURSIF
#RESULTATPARTIEL
#SECURITE
#SYNCDONNEES
#SYNTAXE
#TOREFRESH
#VALEURMULTI
Min, fonction
Minuscule, fonction
Mode, fonction
N
NombreCumulatif, fonction
NombreDeFournisseurs, fonction
NombreDeLignes, fonction
NombreDePages, fonction
NomDe, fonction
NomDeUnivers, fonction
NomDuBloc, fonction
NomDuDocument, fonction
NomDuJour, fonction
NomRapport, fonction
NomUniqueDe, fonction
Non, opérateur
NonNul, opérateur
NuméroDeColonne, fonction
NuméroDeLigne, fonction
NuméroDuJourDeAnnée, fonction
NuméroDuJourDeLaSemaine, fonction
NuméroDuJourDuMois, fonction
NuméroDuMoisDeAnnée, fonction
O
ObtenirVariablesRégionalesDeContenu, fonction
ObtenirVarRég, fonction
Utilisation de fonctions, formules et calculs dans Web Intelligence 257
Index opérateurs
Auto
Bas
conditionnels
,
contexte
Dans
DansListe
DISTINCT
Entre
Et
Exploration
,
InclureVide
Index
Linéaire
mathématiques
Non
NonNul
opérateur Col
opérateur Ligne
Ou
Où
PourChaque
,
PourTout
,
Tout
,
TOUT
opérateurs définis
,
Ou, opérateur
Où, opérateur
P
Page, fonction
Pair, fonction
périmètre d'analyse et indicateurs intelligents
Plafond, fonction
PointAPoint, opérateur opérateurs
PointAPoint
Pos, fonction
Pourcentage, fonction
PourChaque, opérateur
,
PourTout, opérateur
,
Précédent, fonction
comparer des valeurs
Premier, fonction
ProduitCumulatif, fonction
Puissance, fonction
R
Racine, fonction
Rapport, mot clé
RégMoindresCarrés, opérateur opérateurs
RégMoindresCarrés
regroupements
et opérateur UNION
gestion dans Web Intelligence
Remplacer, fonction
RemplissageDroite, fonction
RemplissageGauche, fonction
Répéter, fonction
RéponseInvite, fonction
RéponseUtilisateur, fonction
,
RéponseUtilisateurValeurRéf, fonction
RésuméFiltreRapport, fonction
RésuméInvite, fonction
RésuméRequête, fonction
Rupture, mot clé
ruptures contexte de calcul par défaut
S
section contexte de calcul par défaut
Section, mot clé
sections et dimensions de découpage
et la fonction ValeurRelative
Semaine, fonction
Si, fonction
Signe, fonction
258 Utilisation de fonctions, formules et calculs dans Web Intelligence
Sin, fonction
Somme
SommeCumulative, fonction
SousChaîne, fonction
SQL
UNION, opérateur
SQLDuFournisseur, fonction
StdDev, fonction
SupprEspace, fonction
SupprEspDroite, fonction
SupprEspGauche, fonction
syntaxe avancée, mots clés
T
tableau horizontal contexte de calcul par défaut
tableau vertical contexte de calcul par défaut
tableaux croisés contexte de calcul par défaut
et la fonction ValeurRelative
Tan, fonction
Tout, opérateur
,
TOUT, opérateur
Trimestre, fonction
Truncate, fonction
Index
TypeDuFournisseur, fonction
U
UNION, opérateur
et regroupements
URLEncode
UtilisateurCourant, fonction
V
ValeurRéf, fonction
ValeurRelative, fonction
,
,
,
comparer des valeurs
et dimensions de découpage
,
et les sections
et tableaux croisés
valeurs, comparer
Var, fonction
variables et indicateurs intelligents
simplifier les formules avec
utiliser pour simplifier des formules
VarP, fonction
Utilisation de fonctions, formules et calculs dans Web Intelligence 259
Index
260 Utilisation de fonctions, formules et calculs dans Web Intelligence
Lien public mis à jour
Le lien public vers votre chat a été mis à jour.
Caractéristiques clés
- Utilisation de calculs standard et personnalisés
- Comprendre et manipuler les contextes de calcul
- Utiliser les fonctions, opérateurs et mots-clés de Web Intelligence
- Dépannage de formules
- Calcul de valeurs à l'aide d'indicateurs intelligents
- Comparaison de valeurs
