SAP Web Intelligence Mode d'emploi

Utilisation de fonctions, formules et
calculs dans SAP BusinessObjects
Web Intelligence
SAP BusinessObjects XI 3.1 Service Pack 4
Copyright
© 2011 SAP AG. Tous droits réservés.SAP, R/3, SAP NetWeaver, Duet,
PartnerEdge, ByDesign, SAP Business ByDesign, et les autres produits et services
SAP mentionnés dans ce document, ainsi que leurs logos respectifs, sont des
marques commerciales ou des marques déposées de SAP AG en Allemagne et
dans d’autres pays. Business Objects et le logo Business Objects, BusinessObjects,
Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius et les autres produits
et services Business Objects mentionnés dans ce document, ainsi que leurs logos
respectifs, sont des marques commerciales ou des marques déposées de Business
Objects S.A. aux Etats-Unis et dans de nombreux autres pays. Business Objects
est une entreprise SAP. Tous les autres noms de produits et de services
mentionnés sont des marques commerciales de leurs entreprises respectives. Les
données contenues dans ce document sont uniquement mentionnées à titre
informatif. Les spécifications des produits peuvent varier d’un pays à l’autre. Ces
informations sont susceptibles d’être modifiées sans préavis. Elles sont fournies
par SAP AG et ses filiales («Groupe SAP») uniquement à titre informatif, sans
engagement ni garantie d’aucune sorte. SAP Group ne pourra en aucun cas être
tenu responsable d’erreurs ou d'omissions relatives à ces informations. Les seules
garanties fournies pour les produits et les services SAP Group sont celles énoncées
expressément dans les déclarations de garantie accompagnant, le cas échéant,
lesdits produits et services. Aucune des informations contenues dans ce document
ne saurait constituer une garantie supplémentaire.
2011-05-06
Table des matières
Chapitre 1
A propos de ce guide
7
Chapitre 2
Utilisation de calculs standards et personnalisés
9
Calculs standard........................................................................................10
Utilisation de formules pour créer des calculs personnalisés....................11
Utilisation de variables pour simplifier des formules............................12
Utilisation des fonctions.............................................................................13
Insertion de fonctions dans des cellules..............................................14
Syntaxe de la fonction..........................................................................14
Exemples de fonctions.........................................................................15
Opérateurs de fonction et de formule Web Intelligence.......................21
Chapitre 3
Notions de contextes de calcul
25
Définition des contextes de calcul.............................................................26
Contexte d'entrée.................................................................................27
Contexte de sortie................................................................................28
Contextes de calcul par défaut..................................................................30
Contextes par défaut dans un tableau vertical.....................................31
Contextes par défaut dans un tableau horizontal.................................32
Contextes par défaut dans un tableau croisé.......................................33
Contextes par défaut dans une section................................................34
Contextes par défaut dans une rupture................................................35
Modification du contexte de calcul par défaut à l'aide de la syntaxe
avancée.....................................................................................................36
Opérateurs de syntaxe avancée..........................................................37
Mots clés de la syntaxe avancée Web Intelligence..............................41
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
3
Table des matières
Chapitre 4
Calcul de valeurs à l'aide d'indicateurs intelligents
51
Indicateurs intelligents définis....................................................................52
Regroupements et indicateurs intelligents.................................................52
Gestion des regroupements par Web Intelligence...............................53
Indicateurs intelligents et périmètre d'analyse...........................................54
Indicateurs intelligents et SQL...................................................................54
Regroupements et opérateur UNION...................................................54
Indicateurs intelligents et formules............................................................57
Indicateurs intelligents et dimensions contenant des formules............57
Indicateurs intelligents dans les formules............................................58
Indicateurs intelligents et filtres..................................................................59
Indicateurs intelligents et filtres sur les dimensions.............................59
Indicateurs intelligents et filtres d'exploration.......................................59
Indicateurs intelligents et filtres OR imbriqués.....................................60
Chapitre 5
Fonctions, opérateurs et mots clés Web Intelligence
61
Fonctions Web Intelligence........................................................................62
Fonction Agrégat..................................................................................62
Fonctions du groupe Caractère............................................................93
Fonctions Date et heure.....................................................................114
Fonctions du groupe Fournisseur de données...................................129
Fonctions Document..........................................................................144
Fonctions du groupe Logique.............................................................153
Fonctions du groupe Numérique........................................................163
Fonctions diverses.............................................................................187
Opérateurs de fonction et de formule Web Intelligence..........................211
Opérateurs mathématiques................................................................211
Opérateurs conditionnels...................................................................212
Opérateurs logiques...........................................................................212
4
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Table des matières
Opérateurs spécifiques à la fonction..................................................216
Opérateurs de syntaxe avancée........................................................225
Mots clés de la syntaxe avancée Web Intelligence.................................229
Mot clé Bloc........................................................................................229
Mot clé Corps.....................................................................................230
Mot clé Saut.......................................................................................232
Mot clé Rapport..................................................................................233
Mot clé Section...................................................................................234
Comment Web Intelligence arrondit et tronque les nombres ?...............235
Chapitre 6
Dépannage des formules Web Intelligence
237
Messages d'erreur de formule et d'information.......................................238
#CALCUL...........................................................................................238
#CONTEXTE......................................................................................238
#SYNCDONNEES..............................................................................239
#DIV/0................................................................................................239
#EXTERNE........................................................................................240
#INCOMPATIBLE...............................................................................240
#VALEURMULTI.................................................................................240
#DEBORDEMENT.............................................................................241
#RESULTATPARTIEL.........................................................................241
#CLASSEMENT.................................................................................241
#RECURSIF.......................................................................................242
#SECURITE.......................................................................................242
#SYNTAXE.........................................................................................243
#TOREFRESH...................................................................................243
#INDISPONIBLE................................................................................243
#ERREUR..........................................................................................244
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
5
Table des matières
Chapitre 7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence245
Comparaison de valeurs à l'aide de la fonction Précédent.....................246
Comparaison de valeurs à l'aide de la fonction ValeurRelative...............246
Dimensions de découpage et fonction ValeurRelative.......................248
Dimensions de découpage et sections..............................................250
Ordre des dimensions de découpage................................................252
Dimensions de découpage et tris.......................................................255
Utilisation de ValeurRelative dans les tableaux croisés.....................257
Annexe A
Informations supplémentaires
Index
6
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
259
263
A propos de ce guide
1
1
A propos de ce guide
Le guide Utilisation de fonctions, formules et calculs dans
SAP BusinessObjects 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 l'aide en ligne ou les guides suivants :
Analyse en direct avec SAP BusinessObjects Web Intelligence, Création de
rapports à l'aide de l'Editeur de rapport Java de SAP BusinessObjects Web
Intelligence et Création de rapports avec SAP BusinessObjects
Web Intelligence Rich Client.
Pour en savoir plus sur la création de fonctions personnalisées dans
Web Intelligence, voir le guide Points d'extension SAP BusinessObjects Web
Intelligence : création de fonctions personnalisées.
8
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs
standards et personnalisés
2
2
Utilisation de calculs standards et 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. 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 :
10
Calcul
Description
Somme
Calcule la somme des données sélectionnées.
Nombre
Compte toutes les lignes d'un objet de
type indicateur ou compte les différentes lignes d'un objet de type dimension ou information.
Moyenne
Calcule la moyenne des données.
Minimum
Affiche la valeur minimale des données
sélectionnées.
Maximum
Affiche la valeur maximale des données sélectionnées.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation de formules pour créer des calculs personnalisés
Calcul
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.
Pourcentage
Par défaut
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égation par
défaut à un indicateur standard, ou la
fonction d'agrégation 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 SAP BusinessObjects Web Intelligence
11
2
2
Utilisation de calculs standards et personnalisés
Utilisation de formules pour créer des calculs personnalisés
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
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 :
•
12
calculer le nombre moyen d'articles vendus,
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
•
•
•
calculer la différence entre chaque nombre d'articles vendus et la moyenne,
puis élever cette valeur au carré,
additionner toutes ces différences élevées au carré,
diviser ce total par le nombre de valeurs – 1.
Vous disposez d'un rapport présentant les nombres d'articles vendus par
trimestre et vous voulez inclure la variance. Sans variables pour la simplifier,
la formule se présente comme suit :
Sum((([Quantity sold] - Average([Quantity sold] ForEach
[Quarter]) In Report)*([Quantity sold] - Average([Qua
ntity sold] ForEach [Quarter]) In Report)) In [Quar
ter])/(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étail 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 So
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
13
2
2
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
mme([Revenu des ventes]) génère le total des revenus des ventes.
Dans ce cas, l'entrée de la fonction est l'indicateur Revenu des ventes et la
sortie est le total de tous les indicateurs des ventes.
Rubriques associées
• Opérateurs de fonction et de formule Web Intelligence
• Fonctions Web Intelligence
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.
Syntaxe de la fonction
Pour utiliser une fonction, vous devez connaître son nom, le nombre de
valeurs en entrée dont elle a besoin et les types de données de ces valeurs.
Vous devez également connaître le type de données que génère la fonction.
Par exemple, la fonction Somme utilise un objet numérique comme entrée
(par exemple, un indicateur présentant un revenu des ventes) et génère des
données numériques (la somme de toutes les valeurs de l'objet indicateur).
Voici la syntaxe de la fonction Abs :
num Abs(number)
14
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
Cette syntaxe vous montre que la fonction Abs prend un seul nombre en
entrée et renvoie un nombre en sortie.
L'Editeur de formule affiche la syntaxe de la fonction lorsque vous
sélectionnez cette dernière.
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( "eFa
shion";"Choose a State")
Le rapport est le suivant :
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
15
2
2
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
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]).
16
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
Dans ce cas, la fonction calcule chaque revenu en tant que pourcentage
du revenu total. Le contexte environnant est le revenu total ; il s'agit du seul
chiffre de revenu qui est intéressant, en dehors de la répartition en année
et en trimestre dans le tableau.
Si le rapport est divisé en sections par année, le contexte environnant à
l'extérieur du tableau devient le revenu total de la section.
Si la cellule Pourcentage est placée à l'extérieur du tableau, mais toujours
au sein de la section, le contexte environnant devient le revenu total. Dans
ce cas, la fonction Pourcentage calcule le revenu total pour la section en
tant que pourcentage du revenu global total.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
17
2
2
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
Exemple : Calcul d'un pourcentage à l'aide de la fonction Somme
Vous pouvez contrôler davantage le contexte de calcul d'un pourcentage
en utilisant la fonction Somme plutôt que la fonction Pourcentage. Si vous
divisez un chiffre faisant partie d'un ensemble de chiffres par le total de ces
chiffres, vous obtenez son pourcentage par rapport au total ; par exemple,
la formule [Revenu des ventes]/Somme([Revenu des ventes]) donne le
revenu des ventes en tant que pourcentage du revenu total.
Dans le tableau suivant, la colonne Pourcentage du total contient la formule
[Sales revenue]/(Sum([Sales revenue] In Report))
et la colonne Pourcentage de Année contient la formule
[Sales revenue]/(Sum([Sales revenue] In Section))
18
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
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
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.
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([Quan
tity sold] ForEach [Quarter]) In Report)) In [Quar
ter])/(Count ([Quantity sold] ForEach [Quarter]) - 1)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
19
2
2
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
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
Moyenne([Quantité vendue] Dans
([Trimestre])) Dans Rapport
Nombre d'observations
Nombre([Quantité vendue] Dans ([Trimestre])) Dans Rapport
Différence élevée au carré
Puissance(([Quantité vendue] [Moyenne ventes]);2)
Variance
Somme([Différence élevée au carré]
Dans ([Trimestre]))/([Nombre d'observations] - 1)
La formule s'affiche désormais sous la forme suivante :
Sum ([Difference Squared])/[Number of Observations] - 1)
qui est beaucoup plus facile à comprendre. La version simplifiée de la formule
donne une vue de niveau élevé de l'action de la formule, au lieu de vous
plonger dans des détails confus. Vous pouvez ensuite examiner les formules
des variables référencées dans la formule de niveau élevé pour comprendre
ses parties constitutives.
20
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
Par exemple, la formule fait référence à la variable Différence élevée au
carré, qui fait elle-même référence à la variable Moyenne vendue. En
examinant les formules de Différence élevée au carré et de Moyenne vendue,
vous pouvez effectuer une exploration avant de la formule afin de comprendre
en détail ce qu'elle effectue.
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.
Opérateur
Description
=
Egal à
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
21
2
2
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
Opérateur
Description
>
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 Dan
sListe. 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.
22
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
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 SAP BusinessObjects Web Intelligence
23
2
2
Utilisation de calculs standards et personnalisés
Utilisation des fonctions
24
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de
calcul
3
3
Notions de contextes de calcul
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
• Contexte d'entrée
• Contexte de sortie
26
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Définition des contextes de calcul
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 SAP BusinessObjects Web Intelligence
27
3
3
Notions de contextes de calcul
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 un saut.
Exemple : Spécification d'un contexte de sortie
Le rapport suivant présente le revenu par année et par trimestre, avec une
rupture au niveau de l'année, et le revenu minimal calculé par année :
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.
28
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Définition des contextes de calcul
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 SAP BusinessObjects Web Intelligence
29
3
3
Notions de contextes de calcul
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
Revenu
Harris
1 000
Dupont
3 000
Walsh
4 000
Total :
8000
Total du rapport : 8000
30
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Contextes de calcul par défaut
Le tableau suivant présente le contexte de calcul des indicateurs dans ce
rapport :
Indicateur
Valeur
Contexte
Total du rapport
20 000
Total de tous les revenus
du rapport
Total de l'en-tête de sec8000
tion
Année
Total du client
Année;Client
1000, 3000, 4000
Total du pied de page de
8000
bloc
Année
Rubriques associées
• Définition des contextes de calcul
• Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
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 inagrégées, puis la foncdicateurs utilisés pour
tion de calcul renvoie
générer le corps du bloc.
Toutes les données sont
une valeur unique.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
31
3
3
Notions de contextes de calcul
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
Les dimensions et les
indicateurs utilisés pour Le même que le contexte
d'entrée.
générer la ligne en
cours.
Pied de page
Toutes les données sont
Les dimensions et les inagrégées, puis la fonction
dicateurs utilisés pour
de calcul renvoie une vagénérer le corps du bloc.
leur 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
32
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Contextes de calcul par défaut
à 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 da- Le contexte d'entrée
ns...
est…
Le contexte de sortie
est…
En-tête
Toutes les données sont
Les dimensions et les inagrégées, puis la fonction
dicateurs utilisés pour
de calcul renvoie une vagénérer le corps du bloc.
leur unique.
Corps du bloc
Les dimensions et les inLe même que le contexte
dicateurs utilisés pour
d'entrée.
générer le corps du bloc.
Pied de page
Toutes les données sont
Les dimensions et les inagrégées, puis la fonction
dicateurs utilisés pour
de calcul renvoie une vagénérer le corps du bloc.
leur unique.
Pied de page VBody
Les dimensions et les indicateurs utilisés pour
générer la colonne courante.
Pied de page HBody
Toutes les données sont
Les dimensions et les inagrégées, puis la fonction
dicateurs utilisés pour
de calcul renvoie une vagénérer la ligne courante.
leur unique.
Pied de page VFooter
Identique au pied de
page.
Toutes les données sont
agrégées, puis la fonction
de calcul renvoie une valeur unique.
Toutes les données sont
agrégées, puis la fonction
de calcul renvoie une valeur unique.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
33
3
3
Notions de contextes de calcul
Contextes de calcul par défaut
Le calcul se trouve da- Le contexte d'entrée
ns...
est…
Pied de page HFooter
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 da- Le contexte d'entrée
ns...
est…
Corps
Les dimensions et les indicateurs du rapport, filtrés pour limiter les données à celles de la section.
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 une section
Le rapport suivant présente les contextes par défaut dans un tableau croisé :
34
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Contextes de calcul par défaut
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 da- Le contexte d'entrée
ns...
est…
En-tête
Instance en cours de la
rupture.
Le contexte de sortie
est…
Toutes les données sont
agrégées, puis la fonction
de calcul renvoie une valeur unique.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
35
3
3
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Le calcul se trouve da- Le contexte d'entrée
ns...
est…
Pied de page
Instance en cours de la
rupture.
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 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.
36
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Opérateurs de syntaxe avancée
Vous spécifiez explicitement les contextes d'entrée et de sortie avec les
opérateurs contextuels. Le tableau suivant répertorie les opérateurs
contextuels :
Opérateur
Description
Dans
Spécifie une liste explicite de dimensions à utiliser dans le contexte
PourChaque
Ajoute des dimensions au contexte par
défaut
PourTout
Supprime des dimensions du contexte
par défaut
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte
par défaut contient de nombreuses dimensions. Il est souvent plus facile
d'effectuer un ajout ou un retrait du contexte avec les opérateurs PourTout
et PourChaque que de spécifier explicitement la liste avec Dans.
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 SAP BusinessObjects Web Intelligence
37
3
3
Notions de contextes de calcul
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])
38
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
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
Revenu des ventes
Revenu trimestriel max.
2001
8 096 123,60
2 660 699,50
2002
13 232 246,00
4 186 120,00
2003
15 059 142,80
4 006 717,50
Il est possible de créer une formule pour la colonne Revenu trimestriel
maximum n'incluant pas l'opérateur PourChaque :
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Si vous optez pour l'opérateur contextuel PourChaque, vous pouvez obtenir
le même résultat avec la formule suivante :
Max ([Sales Revenue] ForEach ([Quarter])) In ([Year])
Pourquoi ? Parce que la dimension Année est le contexte d'entrée par défaut
du bloc. En vous servant de l'opérateur PourChaque, vous ajoutez la
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
39
3
3
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
dimension Trimestre au contexte, en donnant le contexte d'entrée
([Année];[Trimestre]).
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.
40
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
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…
Fait référence à…
Un bloc
Toutes les données du rapport
Une rupture de bloc (en-tête ou pied)
Toutes les données du rapport
Une section (en-tête, pied ou à l'extéToutes les données du rapport
rieur d'un bloc)
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
41
3
3
Notions de contextes de calcul
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…
Fait référence à…
Un bloc
Toutes les données de la section
Une rupture de bloc (en-tête ou pied)
Toutes les données de la section
Une section (en-tête, pied ou à l'extéToutes les données de la section
rieur d'un bloc)
A l'extérieur des blocs ou sections
42
Non applicable
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
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é Saut
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot
clé Saut, selon son emplacement dans un rapport :
Placé dans…
Fait référence à…
Un bloc
Toutes les données dans la partie du
bloc délimité par un saut
Un saut de bloc (en-tête ou pied)
Toutes les données dans la partie du
bloc délimité par un saut
Une section (en-tête, pied ou à l'extéNon applicable
rieur d'un bloc)
A l'extérieur des blocs ou sections
Non applicable
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
43
3
3
Notions de contextes de calcul
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
saut contient la formule :
Sum ([Sales Revenue]) In Break
Sans le mot clé Saut, cette colonne dupliquerait les chiffres de la colonne
Revenu des ventes, car le contexte de sortie par défaut ([Année];[Trimestre])
serait utilisé.
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éNon applicable
rieur d'un bloc)
44
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Placé dans…
Fait référence à…
A l'extérieur des blocs ou sections
Non applicable
Exemple : Mot clé Bloc
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes. Le rapport contient une section basée sur Année. Le
bloc est filtré de façon à exclure les troisième et quatrième trimestres.
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 SAP BusinessObjects Web Intelligence
45
3
3
Notions de contextes de calcul
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éToutes les données de la section
rieur d'un bloc)
A l'extérieur des blocs ou sections
Toutes les données du rapport
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes, avec une rupture sur Année. Le rapport contient une
section basée sur Année et une rupture au niveau de Trimestre.
Année
Trimestre
Revenu des ventes
Corps
2001
T1
2 660 700
2 660 699,5
T2
2 279 003
2 279 003
T3
1 367 841
1 367 840,7
T4
1 788 580
1 788 580,4
2001
8 096 123,6
La colonne Corps contient la formule
Sum ([Sales Revenue]) In Body
Les totaux de la colonne Corps sont égaux à ceux de la colonne Revenu
des ventes, car le mot clé Corps fait référence aux données du bloc. Si
46
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
vous deviez supprimer l'objet Mois, les chiffres de la colonne Bloc
changeraient pour correspondre aux chiffres modifiés de la colonne Revenu
des ventes. Si vous deviez placer la formule dans le pied de page du
rapport, elle renverrait le revenu total pour le bloc.
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 SAP BusinessObjects Web Intelligence
47
3
3
Notions de contextes de calcul
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];[Quarter]))) * 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 :
48
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Notions de contextes de calcul
Modification du contexte de calcul par défaut à l'aide de la syntaxe avancée
Pour quelle raison ? Le problème vient de :
Sum ([Sales Revenue] ForAll ([Year];[Quarter))
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
49
3
3
Notions de contextes de calcul
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, dans toutes les lignes où le Mois est 1, cette expression signifie à
présent "le total des revenus de tous les mois 1". Dans toutes les lignes
où le Mois est 2, elle signifie "le total des revenus de tous les mois 2". Par
conséquent, les pourcentages ne sont pas ceux que vous attendez.
50
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Calcul de valeurs à l'aide
d'indicateurs intelligents
4
4
Calcul de valeurs à l'aide d'indicateurs intelligents
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.
52
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Regroupements et indicateurs intelligents
Exemple : Regroupements dans une requête
Une requête contient les dimensions [Pays], [Région], [Ville] et l'indicateur
intelligent [Revenu]. Ces objets impliquent que les regroupements suivants
calculent le revenu dans tous les contextes possibles :
• Valeur d'indicateur intelligent totale
• Valeur d'indicateur intelligent par (Pays, Région, Ville)
• Valeur d'indicateur intelligent par (Pays, Ville)
• Valeur d'indicateur intelligent par (Ville)
• Valeur d'indicateur intelligent par (Région, Ville)
• Valeur d'indicateur intelligent par (Région)
• Valeur d'indicateur intelligent par (Pays, Région)
• Valeur d'indicateur intelligent par (Pays)
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 SAP BusinessObjects Web Intelligence
53
4
4
Calcul de valeurs à l'aide d'indicateurs intelligents
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.
54
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et SQL
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)
)
)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
55
4
4
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et SQL
FROM
country,
region,
city
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name,
region.region_name,
city.city_name
)
)
Chaque regroupement est représenté par une instruction SELECT et a son
propre ID (dans la colonne GID). Les regroupements qui ne contiennent
pas l'ensemble de dimensions intégral incluent des colonnes vides (SELECT
'') car chaque instruction SELECT d'une requête incluant l'opérateur UNION
doit avoir le même nombre de colonnes.
Si vous ajoutez au rapport un nouveau bloc contenant [Pays] et [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
56
)
)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et formules
country,
city,
region
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name
UNION
SELECT
2 AS GID,
country.country_name,
region.region_name,
city.city_name,
sum(city.revenue)
FROM
country,
region,
city
WHERE
( country.country_id=region.country_id
AND ( region.region_id=city.region_id
GROUP BY
country.country_name,
region.region_name,
city.city_name
)
)
)
)
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
57
4
4
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et formules
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
Revenu
H1
#INDISPONIBLE
H2
#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
Région
Revenu
Etats-Unis
Nord
10 000
Etats-Unis
Sud
15 000
Etats-Unis
Est
14 000
Etats-Unis
Ouest
12 000
Si vous incluez une colonne supplémentaire dans la table avec la formule
suivante :
[Revenue] ForAll ([Region])
58
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et filtres
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.
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
59
4
4
Calcul de valeurs à l'aide d'indicateurs intelligents
Indicateurs intelligents et filtres
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.
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.
Indicateurs intelligents et filtres OR imbriqués.
Les filtres OR imbriqués dans lesquels au moins une des dimensions filtrées
n'apparaît pas dans un bloc génèrent l'erreur #INDISPONIBLE pour un
indicateur intelligent du bloc.
Exemple :
•
•
60
Le filtre [Pays] = "US" OR [Pays] = "France" génère
#INDISPONIBLE pour un indicateur intelligent qui utilise la dimension
[Pays] si [Pays] n'apparaît pas dans le bloc.
Le filtre [Pays] = "US" OR [Année] = 2008 génère
#INDISPONIBLE pour un indicateur intelligent qui utilise les dimensions
[Pays] ou [Année] si ni [Pays] ni [Année] n'apparaît dans le bloc.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et
mots clés Web Intelligence
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Fonctions Web Intelligence
Web Intelligence répartit les fonctions dans les catégories suivantes :
Catégorie
Description
Agrégat
Données agrégées (par exemple, en
effectuant le total ou la moyenne d'un
ensemble de valeurs)
Caractère
Manipule des chaînes de caractères
Date et heure
Renvoie des données de date et heure
Document
Renvoie des données relatives à un
document
Fournisseur de données
Renvoie des données sur le fournisseur de données d'un document
Logique
Renvoie VRAI ou FAUX
Numérique
Renvoie des données numériques
Divers
Fonctions ne correspondant à aucune
des catégories précédentes
Fonction Agrégat
Moyen
Description
Renvoie la valeur moyenne d'un indicateur
62
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Agrégat
Syntaxe
num Moyenne(indicateur[;InclureVide])
Entrée
Paramètre Description
Type
Obligatoire
indicateur
Indicateur
Oui
Tout indicateur
InclureVide Inclut les lignes vides Mot clé
dans le calcul
Non
(les lignes vides sont exclues
par défaut)
Remarques
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels 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.
Exemples
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.
Rubriques associées
• Opérateur InclureVide
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
63
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Nombre
Description
Renvoie le nombre de valeurs d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
entier Nombre(dimension|indicateur[;InclureVide][;Disti
nct|Tout])
Entrée
Paramètre
Description
Type
Obligatoire
dimenToute dimension ou tout indicateur
sion|indicateur
DimenOui
sion ou indicateur
InclureVide
Inclut des valeurs vides dans le calcul
Mot clé
Non
Distinct|Tout
Inclut les valeurs distinctes uniquement (par Mot clé
défaut pour les dimensions) ou toutes les
valeurs (par défaut pour les indicateurs) dans
le calcul
Non
Remarques
•
•
64
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels 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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
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.
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.
Rubriques associées
• Opérateur InclureVide
• Opérateurs Distinct/Tout
Premier
Description
Renvoie la première valeur d'un ensemble de données
Groupe de fonctions
Agrégat
Syntaxe
type_entrée Premier(dimension|indicateur)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
65
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
dimension|indica- Toute dimension ou
teur
tout indicateur
Type
Obligatoire
Dimension ou in- Oui
dicateur
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.
Exemples
Lorsque Premier([Chiffre d'affaires]) est placé dans un pied de
tableau, la première valeur de [Chiffre d'affaires] est renvoyée dans le tableau.
Interpolation
Description
Calcule les valeurs d'indicateur manquantes par interpolation
Groupe de fonctions
Numérique
Syntaxe
num Interpolation(measure[;PointToPoint|Linear][;NotOn
Break][;Row|Col])
66
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
PointAMot clé
La méthode d'interpolation :
Point|Linéaire • PointAPoint : interpolation de
point à point
• Linéaire : régression linéaire
avec interpolation des moindres
carrés.
Non
(PointAPoint est
utilisé par défaut)
PasSur- Empêche la fonction de réinitialiser le Mot clé
Saut
calcul au niveau des sauts de section
et de bloc
Non
Ligne|Col Définit le sens du calcul
Non
Mot clé
Remarques
•
•
•
•
•
•
Interpolation est très utile pour créer un graphique linéaire pour un
indicateur dont certaines valeurs sont manquantes. L'utilisation de cette
fonction permet de s'assurer que le diagramme trace une ligne continue
(et non des lignes et des points discontinus).
La régression linéaire avec interpolation des moindres carrés calcule les
valeurs manquantes en calculant une équation de droite de type
f(x) = ax + b qui passe, le plus précisément possible, par toutes les valeurs
disponibles de l'indicateur.
L'interpolation de point à point calcule les valeurs manquantes en calculant
une équation de droite de type f(x) = ax + b qui passe par les deux valeurs
adjacentes à la valeur manquante.
L'ordre de tri de l'indicateur a une incidence sur les valeurs renvoyées
par Interpolation.
Vous ne pouvez pas appliquer de tri ni de classement à une formule
contenant Interpolation.
Si la liste de valeurs ne comporte qu'une seule valeur, Interpolation
l'utilise pour fournir toutes les valeurs manquantes.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
67
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
Les filtres appliqués à un indicateur interpolé peuvent modifier les valeurs
renvoyées par Interpolation en fonction des valeurs concernées par
les filtres.
Exemples
Interpolation([Valeur]) fournit les valeurs manquantes suivantes en
utilisant la méthode d'interpolation de point à point par défaut :
Jour
Valeur
Interpolation([Valeur])
Lundi
12
12
Mardi
14
14
Mercredi
Jeudi
15
16
16
Vendredi
17
Samedi
18
Dimanche
19
19
Rubriques associées
• Opérateur Linéaire
• Opérateur PointAPoint
Dernier
Description
Renvoie la dernière valeur d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
68
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
type_entrée Dernier(dimension|indicateur)
Entrée
Paramètre
Description
dimension|indica- Toute dimension ou
teur
tout indicateur
Type
Obligatoire
Dimension ou in- Oui
dicateur
Remarques
•
•
Lorsque Dernier est placé dans un pied de rupture, la dernière valeur
de la rupture est renvoyée.
Lorsque Dernier est placé dans un pied de section, la dernière valeur
de la section est renvoyée.
Exemples
Lorsque Premier([Chiffre d'affaires]) est placé dans un pied de
tableau, la première valeur de [Chiffre d'affaires] est renvoyée dans le tableau.
Max
Description
Renvoie la valeur la plus grande d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
type_entrée Max(dimension|indicateur)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
69
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
dimension|indica- Toute dimension ou
teur
tout indicateur
Type
Obligatoire
Dimension ou in- Oui
dicateur
Remarques
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la
fonction Max.
Exemples
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".
Median
Description
Renvoie la médiane (valeur centrale) d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique Médiane(indicateur)
70
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
Si l'ensemble de nombres comporte un nombre de valeurs pair, la fonction
Médiane prend la moyenne des deux valeurs centrales.
Exemples
Médiane([Chiffre d'affaires]) renvoie 971 444 si [Chiffre d'affaires]
possède les valeurs 835 420, 971 444 et 1 479 660.
Min
Description
Renvoie la plus petite valeur d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
tout_type Min(dimension|indicateur)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
71
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
dimension|indica- Toute dimension ou
teur
tout indicateur
Type
Obligatoire
Dimension ou in- Oui
dicateur
Remarques
Vous pouvez utiliser des opérateurs de contexte de syntaxe étendue avec
Min.
Exemples
Si l'indicateur Chiffre d'affaires comporte les valeurs 3 000, 60 034 et 901 234,
Min([Chiffre d'affaires]) renvoie 3 000.
Si la dimension Ville a les valeurs "Aberdeen" et "Londres", Min([Ville])
renvoie "Aberdeen".
Mode
Description
Renvoie la valeur d'un ensemble de données qui apparaît le plus souvent
Groupe de fonctions
Agrégat
Syntaxe
input_type Mode(dimension|measure)
72
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dimension|indica- Toute dimension ou Indicateur
teur
indicateur
Obligatoire
Oui
Remarques
•
Mode renvoie la valeur Nul si aucune des valeurs de l'ensemble de
données n'apparaît plus souvent que les autres.
Exemples
Mode([Chiffres d'affaires]) renvoie 200 si la variable [Chiffre
d'affaires] a les valeurs 100, 200, 300, 200.
Mode([Pays]) renvoie la valeur [Pays] qui apparaît le plus souvent.
Pourcentage
Description
Exprime une valeur d'indicateur en tant que pourcentage de son contexte
Groupe de fonctions
Agrégat
Syntaxe
num Pourcentage(indicateur[;Saut][;Ligne|Col])
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
73
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Rupture
Prend en compte les rup- Mot clé
tures de tableau
Non
Ligne|Col
Définit le sens du calcul
Non
Mot clé
Exemples
Dans le tableau suivant, la colonne Pourcentage contient la formule Pour
centage ([Revenu des ventes]).
Année
Chiffre d'affaires
Pourcentage
2001
1 000
10
2002
5 000
50
2003
4 000
40
Somme :
10 000
100
Par défaut, le contexte d'intégration est le total de l'indicateur dans le tableau.
Vous pouvez faire en sorte que la fonction prenne en compte une rupture
dans le tableau en utilisant l'argument facultatif Rupture. Dans ce cas, le
contexte d'intégration par défaut devient la section de tableau.
Dans le tableau suivant, la colonne Pourcentage contient la formule Pour
centage([Chiffre d'affaires];Rupture)
74
Année
Trimestre
Revenu des ventes
Pourcentage
2001
T1
1 000
10
T2
2 000
20
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
T3
5 000
50
T4
2 000
20
2001
Somme :
10 000
100
Année
Trimestre
Revenu des ventes
Pourcentage
2002
T1
2 000
20
T2
2 000
20
T3
5 000
50
T4
1 000
10
Somme :
10 000
100
2002
Vous pouvez utiliser la fonction Pourcentage dans plusieurs colonnes et
lignes. Cela peut être explicitement spécifié avec l'argument facultatif
Ligne|Col. Par exemple, dans le tableau croisé suivant, la colonne
Pourcentage a la formule Pourcentage ([Revenu des ve
ntes];Ligne)
T1
Pour
cen
tage
T2
Pour
cen
tage
T3
Pour
cen
tage
T4
Pource
ntage
2001
1 000
10
2 000
20
5 000
50
2 000
20
2002
2 000
20
2 000
20
5 000
50
1 000
10
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
75
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Centile
Description
Renvoie le nième centile d'un indicateur
Groupe de fonctions
Numérique
Syntaxe
numérique Centile(indicateur;centile)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
centile
Un pourcentage exprimé sous Nombre
forme décimale
Oui
Remarques
Le nième centile est un nombre supérieur ou égal à n % des nombres d'un
ensemble. Vous exprimez n % sous la forme 0.n.
Exemples
Si [indicateur] possède l'ensemble de nombres (10;20;30;40;50), Cen
tile([indicateur];0.3) renvoie 22, qui est supérieur ou égal à 30 %
des nombres de l'ensemble.
Produit
Description
Multiplie les valeurs d'un indicateur
76
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Agrégat
Syntaxe
numérique Produit(indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Exemples
Produit([Indicateur]) renvoie 30 si [Indicateur] a les valeurs 2, 3, 5.
MoyenneCumulative
Description
Renvoie la moyenne cumulative d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num MoyenneCumulative(indicateur[;Ligne|Col][;Inclure
Vide][;réinit_dims])
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
77
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Ligne|Col
Définit le sens du calcul
Mot clé
Non
InclureVide
Inclut des valeurs vides dans le Mot clé
calcul
Non
dim_redéfinies
Réinitialise le calcul selon les
dimensions spécifiées
Non
Liste Dimension
Remarques
•
•
•
•
•
•
Vous pouvez utiliser des opérateurs de contexte de syntaxe étendue
avec MoyenneCumulative.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et
Col.
Si vous appliquez un tri sur l'indicateur référencé par MoyenneCumula
tive, Web Intelligence applique d'abord le tri à l'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 un saut de bloc ou une nouvelle section.
Exemples
MoyenneCumulative([Chiffre d'affaires]) renvoie ces résultats
dans le tableau suivant :
78
Pays
Lieu de séjour
Chiffre d'affaires
Moyenne cumulative
US
Hawaiian Club
1 479 660
835 420
US
Bahamas Beach
971 444
1 225 552
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
France
Côte d'Azur
835 420
1 095 508
MoyenneCumulative([Chiffre d'affaires]);([Pays]) renvoie
ces résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Moyenne cumulative
US
Hawaiian Club
1 479 660
835 420
US
Bahamas Beach
971 444
1 225 552
France
Côte d'Azur
835 420
835 420
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
NombreCumulatif
Description
Renvoie le total cumulatif d'un ensemble de nombres
Groupe de fonctions
Agrégat
Syntaxe
num NombreCumulatif(dimension|indicateur[;Ligne|Col][;In
clureVide][;réinit_dims])
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
79
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
dimension|in- Toute dimension ou tout indica- Dimension ou Oui
dicateur
teur
indicateur
Ligne|Col
Définit le sens du calcul
Mot clé
Non
InclureVide
Inclut des valeurs vides dans le Mot clé
calcul
Non
dim_redéfinies
Réinitialise le calcul selon les
dimensions spécifiées
Non
Liste Dimension
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels 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 NombreCumulatif,
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
un saut de bloc ou une nouvelle section.
Exemples
NombreCumulatif([Chiffre d'affaires]) renvoie ces résultats dans
le tableau suivant :
80
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Pays
Lieu de séjour
Chiffre d'affaires Nombre cumulatif
US
Hawaiian Club
1 479 660
1
US
Bahamas Beach
971 444
2
France
Côte d'Azur
835 420
3
NombreCumulatif([Chiffre d'affaires]);([Pays]) renvoie ces
résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires Nombre cumulatif
US
Hawaiian Club
1 479 660
1
US
Bahamas Beach
971 444
2
France
Côte d'Azur
835 420
1
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
• Opérateur InclureVide
• Opérateur InclureVide
MaxCumulatif
Description
Renvoie le maximum cumulatif d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
81
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
input_type RunningMax(dimension|measure[;Row|Col][;re
set_dims])
Entrée
Paramètre
Description
Type
Obligatoire
dimension|in- Toute dimension ou tout indica- Dimension ou Oui
dicateur
teur
indicateur
Ligne|Col
Définit le sens du calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les
dimensions spécifiées
Liste Dimension
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec
la fonction MaxCumulatif.
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et
Col.
Si vous appliquez un tri à l'indicateur référencé par MaxCumulatif,
Web Intelligence applique d'abord le tri à l'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
un saut de bloc ou une nouvelle section.
Exemples
MinCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le
tableau suivant :
82
Pays
Lieu de séjour
Chiffre d'affaires
Minimum cumulatif
France
Côte d'Azur
835 420
835 420
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
US
Bahamas Beach
971 444
971 444
US
Hawaiian Club
1 479 660
1 479 660
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
MinCumulatif
Description
Renvoie le minimum cumulatif d'une dimension ou d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
type_entrée MinCumulatif(dimension|indica
teur;[Ligne|Col];[dimensions_redéfinies])
Entrée
Paramètre
Description
Type
Obligatoire
dimension|dé- Toute dimension ou indicateur
tail|indicateur
Dimension ou Oui
indicateur
Ligne|Col
Mot clé
Non
Liste Dimension
Non
Définit le sens du calcul
dim_redéfinies Réinitialise le calcul selon les
dimensions spécifiées
Remarques
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec
la fonction MinCumulatif.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
83
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
•
•
•
•
Vous pouvez définir le sens du calcul à l'aide des opérateurs Ligne et
Col.
Si vous appliquez un tri sur l'indicateur référencé par MinCumulatif,
Web Intelligence applique d'abord le tri à l'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.
MinCumulatif ne réinitialise pas automatiquement le minimum après
un saut de bloc ou une nouvelle section.
Exemples
MinCumulatif([Chiffre d'affaires]) renvoie ces résultats dans le
tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Minimum cumulatif
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
835 420
US
Hawaiian Club
1 479 660
835 420
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
ProduitCumulatif
Description
Renvoie le produit cumulatif d'un indicateur
Groupe de fonctions
Agrégat
84
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
num ProduitCumulatif(indicateur[;Ligne|Col][;réinit_di
ms])
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Ligne|Col
Définit le sens du calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les
dimensions spécifiées
Liste Dimension
Non
Remarques
•
•
•
•
•
•
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels 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 ProduitCumulatif,
Web Intelligence applique d'abord le tri à l'indicateur, puis calcule le
produit 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
un saut de bloc ou une nouvelle section.
Exemples
ProduitCumulatif([Nombre d'invités]) renvoie ces résultats dans
le tableau suivant :
Pays d'origine
Ville
Nombre d'invités
Produit cumulatif
Japon
Kobe
6
6
Japon
Osaka
4
24
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
85
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
US
Chicago
241
5 784
ProduitCumulatif([Nombre d'invités]);([Pays d'origine])
renvoie ces résultats dans le tableau suivant :
Pays d'origine
Ville
Nombre d'invités
Produit cumulatif
Japon
Kobe
6
6
Japon
Osaka
4
24
US
Chicago
241
5 784
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
SommeCumulative
Description
Renvoie la somme cumulative d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
num SommeCumulative(indicateur[;Ligne|Col][;réinit_dims])
86
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Ligne|Col
Définit le sens du calcul
Mot clé
Non
dim_redéfinies
Réinitialise le calcul selon les
dimensions spécifiées
Liste Dimension
Non
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 SommeCu
mulative, Web Intelligence applique d'abord le tri à l'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
un saut de bloc ou une nouvelle section.
Exemple
SommeCumulative([Chiffre d'affaires]) renvoie ces résultats dans
le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires
Total cumulé
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
1 806 864
US
Hawaiian Club
1 479 660
3 286 524
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
87
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
SommeCumulative([Chiffre d'affaires]);([Pays]) renvoie ces
résultats dans le tableau suivant :
Pays
Lieu de séjour
Chiffre d'affaires Total cumulé
France
Côte d'Azur
835 420
835 420
US
Bahamas Beach
971 444
971 444
US
Hawaiian Club
1 479 660
2 451 104
Rubriques associées
• Opérateur InclureVide
• Opérateurs Ligne/Col
Ecartype
Description
Renvoie l'écart type d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique EcartType(indicateur)
88
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
L'écart type est un indicateur de variation statistique dans un ensemble de
nombres. Elle est calculée comme suit :
• calcul de la moyenne d'un ensemble de nombres
• soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré
• addition de toutes ces différences élevées au carré
• division de cette somme par le nombre de nombres de l'ensemble
- 1)
• calcul de la racine carrée du résultat.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), EcartType([in
dicateur]) renvoie 2,58.
Rubriques associées
• Var
EcartTypeP
Description
Renvoie l'écart type de population d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique EcartTypeP(indicateur)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
89
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
L'écart type de population est un indicateur de variation statistique dans un
ensemble de nombres. Elle est calculée comme suit :
• calcul de la moyenne d'un ensemble de nombres ;
• soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré ;
• addition de toutes ces différences élevées au carré ;
• division de cette somme par le (nombre de nombres de
l'ensemble) ;
• calcul de la racine carrée du résultat.
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la
fonction EcartTypeP.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), EcartTy
peP([indicateur]) renvoie 2,24.
Sum (Somme)
Description
Renvoie la somme d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique Somme(indicateur)
90
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la
fonction Somme.
Exemples
Si l'indicateur Chiffre d'affaires comporte les valeurs 2 000, 3 000, 4 000 et
1 000, Somme([Chiffre d'affaires]) renvoie 10 000.
Var
Description
Renvoie la variance d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique Var(indicateur)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
La variance est un indicateur de variation statistique dans un ensemble de
nombres. Elle est calculée comme suit :
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
91
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
•
•
•
calcul de la moyenne d'un ensemble de nombres
soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré
addition de toutes ces différences élevées au carré
division de cette somme par le nombre de nombres de l'ensemble
- 1)
La variance est le carré de l'écart type.
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la
fonction Var.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), Var([indica
teur]) renvoie 6,67.
Rubriques associées
• Ecartype
VarP
Description
Renvoie la variance de population d'un indicateur
Groupe de fonctions
Agrégat
Syntaxe
numérique VarP(indicateur)
92
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Remarques
La variance de population est un indicateur de variation statistique dans un
ensemble de nombres. Elle est calculée comme suit :
• calcul de la moyenne d'un ensemble de nombres
• soustraction de la moyenne de chaque nombre dans l'ensemble et
élévation de la différence au carré
• addition de toutes ces différences élevées au carré
• division de cette somme par le (nombre de nombres de l'ensemble)
La variance de population est le carré de l'écart type de population.
Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec la
fonction VarP.
Exemples
Si indicateur possède l'ensemble de valeurs (2, 4, 6, 8), VarP([indi
cateur]) renvoie 5.
Rubriques associées
• EcartTypeP
Fonctions du groupe Caractère
Asc
Description
Renvoie la valeur ASCII d'un caractère
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
93
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Caractère
Syntaxe
entier Asc(chaîne)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
N'importe quelle
chaîne
Chaîne
Oui
Remarques
Si chaîne contient plusieurs caractères, la fonction renvoie la valeur ASCII
du premier caractère dans la chaîne.
Exemples
Asc("A") renvoie 65.
Asc("ab") renvoie 97.
Asc([Pays]) renvoie 85 lorsque la valeur de [Pays] est "US".
Car
Description
Renvoie le caractère associé à un code ASCII
Groupe de fonctions
Caractère
Syntaxe
chaîne Car(code_ascii)
94
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
code_ascii
Un code ASCII
Nombre
Oui
Remarques
Si nombre est un décimal, la fonction ignore la partie décimale.
Exemple
s
Car(123) renvoie "{".
Concaténation
Description
Concatène (joint) deux chaînes de caractères.
Groupe de fonctions
Caractère
Syntaxe
chaîne Concaténation(première_chaîne;seconde_chaîne)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
95
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
première_chaîne
La première
chaîne
Chaîne
Oui
deuxième_chaîne La seconde
chaîne
Chaîne
Oui
Remarques
Vous pouvez également utiliser l'opérateur "+" pour concaténer des chaînes.
"Premier " + "Second" renvoie "Premier Second".
"Premier " + "Second" + " Troisième" renvoie "Premier Second
Troisième".
Exemples
Concaténation("Premier ";"Second") renvoie "Premier Second"
Concaténation("Premier ";Concaténation("Second ";"Troi
sième")) renvoie "Premier Second Troisième".
Remplissage
Description
Construit une chaîne en répétant une chaîne n fois
Groupe de fonctions
Caractère
Syntaxe
chaîne Remplir(répétition_chaîne;nombre_répétitions)
96
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_à_répéter La chaîne à répé- Chaîne
ter
Oui
nombre_de_répéti- Le nombre de rétions
pétitions
Oui
Nombre
Exemples
Remplir("New York";2) renvoie "New York New York".
FormatDeDate
Description
Formate une date selon le format spécifié
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatDeDate(date;chaîne_format)
Entrée
Paramètre
Description
date
La date à laquelle appliquer le Date
format de date
chaîne_format Le format à appliquer
Type
Chaîne
Obligatoire
Oui
Oui
Remarques
•
Le format du résultat dépend du format de date appliqué à la cellule.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
97
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
Vous ne pouvez pas appliquer les chaînes de mise en forme des couleurs
(par exemple [Rouge], [Bleu], etc.) à la fonction FormatDeDate.
Exemples
FormatDeDate(DateActuelle();"dd/MM/yyyy") renvoie "15/12/2005"
si la date actuelle est le 15 décembre 2005.
FormatDeNombre
Description
Formate un nombre selon un format spécifié
Groupe de fonctions
Caractère
Syntaxe
chaîne FormatDeNombre(nombre;chaîne_format)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à formater
Nombre
Oui
chaîne_format
Le format à appli- Chaîne
quer
Oui
Remarques
•
•
98
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
FormatDeNombre[Revenu des ventes];"# ###,00") renvoie
835 420,00 si [Revenu des ventes] est d'une valeur de 835 420.
HTMLEncode
Description
Applique des règles d'encodage HTML à une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne HTMLEncode(html)
Entrée
Paramètre
Description
Type
html
Une chaîne HTML Chaîne
Obligatoire
Oui
Exemples
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
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
99
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
chaîne Capitale(chaîne)
Entrée
Paramètre
Description
Type
chaîne
La chaîne à mettre en Chaîne
majuscules
Obligatoire
Oui
Exemples
Capitale("ces vérités sont évidentes") renvoie "Ces vérités
sont évidentes".
Gauche
Description
Retourne les caractères les plus à gauche dans une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne Gauche(chaîne;nombre_car)
100
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne entrée.
chaîne
Oui
nombre_car
Le nombre de caractères à retour- nombre
ner à partir de la gauche
Oui
Exemples
Gauche([Pays];2) retourne "Fr" si [Pays] est "France".
RemplissageGauche
Description
Remplit une chaîne à gauche avec une autre chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne RemplissageGauche(chaîne_complétée,lon
gueur,chaîne_gauche)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
101
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_complétée
La chaîne d'origine
Chaîne
Oui
longueur
la longueur de la chaîne de
sortie
Nombre
Oui
Chaîne
Oui
chaîne_gauche La chaîne à ajouter à gauche
de la chaîne_complétée
Remarques
•
•
•
Si longueur est inférieure à la longueur combinée de chaîne_gauche
et de chaîne_complétée, chaîne_gauche est tronquée.
Si longueur est inférieure ou égale à la longueur de chaîne_complé
tée, la fonction renvoie chaîne_complétée.
Si longueur est supérieure à la longueur combinée de chaîne_com
plétée et de chaîne_gauche, chaîne_gauche est répétée
entièrement ou en partie le nombre de fois nécessaire pour remplir la
longueur.
Exemples
RemplissageGauche("York";8;"New ") renvoie "New York"
RemplissageGauche("York",6,"New") renvoie "NeYork".
RemplissageGauche("York";11;"New ") renvoie "New NewYork"
RemplissageGauche("New "; 2;"York") renvoie "New".
SupprEspGauche
Description
Supprime les espaces à gauche d'une chaîne de caractères
102
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspGauche(chaîne_à_traiter)
Entrée
Paramètre
Description
Type
chaîne_raccourcie La chaîne à traiter. Chaîne
Obligatoire
Oui
Exemples
SupprEspGauche([Pays]) renvoie "France" si [Pays] est " France".
Longueur
Description
Renvoie le nombre de caractères d'une chaîne.
Groupe de fonctions
Caractère
Syntaxe
entier Longueur(chaîne)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
103
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
chaîne
La chaîne entrée. Chaîne
Obligatoire
Oui
Exemples
Longueur([Nom]) renvoie 6 si [Nom] est "Martin".
Minuscule
Description
Convertit une chaîne en minuscules
Groupe de fonctions
Caractère
Syntaxe
chaîne Minuscule(chaîne)
Entrée
Paramètre
Description
Type
chaîne
La chaîne à convertir en Chaîne
minuscules
Obligatoire
Oui
Exemples
Minuscule("New York") renvoie "new york".
104
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Comparaison
Description
détermine si une chaîne correspond à un modèle.
Groupe de fonctions
Caractère
Syntaxe
booléen Comparer(chaîne_test;modèle)
Entrée
Paramètre
Description
Type
chaîne_test
La chaîne à comparer au chaîne
modèle de texte
Oui
modèle
La
Oui
chaîne du modèle de texte
Obligatoire
Remarques
•
Le modèle peut contenir le caractère générique "*" (remplace n'importe
quel ensemble de caractères) ou "?" (remplace n'importe quel caractère
unique).
Exemples
Comparer([Pays];"F*") renvoie Vrai si [Pays] est "France".
Comparer([Pays];"?S?") renvoie Vrai si [Pays] est "USA".
Comparer("New York";"P*") renvoie la valeur Faux.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
105
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Pos
Description
Renvoie la position de départ d'une chaîne de caractères dans une chaîne
Groupe de fonctions
Caractère
Syntaxe
entier Pos(chaîne_test;modèle)
Entrée
Paramètre
Description
Type
chaîne_test
La chaîne à vérifier dans le chaîne
modèle de texte
modèle
La
Obligatoire
Oui
chaîne du mo- Oui
dèle de texte
Remarques
•
Si le modèle apparaît plusieurs fois, Pos renvoie la position de la première
occurrence.
Exemples
Pos("New York";"Ne") renvoie 1.
Pos("New York, New York";"Ne") renvoie 1.
Pos("New York"; "York") renvoie 5.
106
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Remplacer
Description
remplace une partie d'une chaîne par une autre chaîne.
Groupe de fonctions
Caractère
Syntaxe
chaîne Remplacer(remplacer_dans;chaîne_rempla
cée;chaîne_de_remplacement)
Entrée
Paramètre
Description
Type
Obligatoire
remplacer_da- La chaîne dans laquelle le
ns
texte est remplacé
chaîne
Oui
chaîne_rempla- Le texte à remplacer
cée
chaîne
Oui
chaîne_de_re- Le texte qui remplace
mplacement
chaîne_remplacée
chaîne
Oui
Exemples
Remplacer("New YORK";"ORK";"ork") renvoie "New York"
Droit
Description
Renvoie les caractères les plus à droite dans une chaîne
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
107
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Caractère
Syntaxe
chaîne Droite(chaîne;nombre_de_caractères)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
N'importe quelle chaîne
chaîne
Oui
noLe nombre de caractères à ren- nombre
mbre_de_ca- voyer à partir de la droite
ractères
Oui
Exemples
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_complétée;lon
gueur;chaîne_droite)
108
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_complétée
La chaîne d'origine
Chaîne
Oui
longueur
la longueur de la chaîne de
sortie
Nombre
Oui
chaîne_droite La chaîne à ajouter à droite de Chaîne
la chaîne_complétée
Oui
Remarques
•
•
•
Si longueur est inférieure à la longueur combinée de chaîne_droite
et à la chaîne_complétée, chaîne_droite est tronquée.
Si longueur est inférieure ou égale à la longueur de chaîne_complé
tée, la fonction renvoie chaîne_complétée.
Si longueur est supérieure à la longueur combinée de chaîne_com
plétée et de chaîne_droite, chaîne_droite est répétée
entièrement ou en partie le nombre de fois nécessaire pour remplir la
longueur.
Exemples
RemplissageDroite("New ";8;"York") renvoie "New York"
RemplissageDroite("New "; 6;"York") renvoie "New Yo"
RemplissageDroite("New ";11;"York") renvoie "New YorkYor"
RemplissageDroite("New "; 2;"York") renvoie "New".
SupprEspDroite
Description
Supprime les espaces de fin de chaîne
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
109
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspDroite(chaîne_raccourcie)
Entrée
Paramètre
Description
Type
chaîne_raccourcie La chaîne à traiter. Chaîne
Obligatoire
Oui
Exemples
SupprEspDroite([Pays]) renvoie "France" si [Pays] est "France ".
SousChaîne
Description
Renvoie une partie d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne SousChaîne(chaîne;début;longueur)
110
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
N'importe quelle chaîne
Chaîne
Oui
début
La position de départ de la Nombre
chaîne extraite
Oui
longueur
La longueur de la chaîne
extraite
Oui
Nombre
Exemples
SousChaîne("Grande Bretagne";1;6) renvoie "Grande".
SousChaîne("Grande Bretagne";8;8) renvoie "Bretagne".
SupprEspace
Description
Supprime les espaces de début et de fin d'une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne SupprEspace(chaîne_raccourcie)
Entrée
Paramètre
Description
Type
chaîne
La chaîne à traiter. Chaîne
Obligatoire
Oui
Exemples
SupprEspace(" Grande Bretagne ") renvoie "Grande Bretagne".
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
111
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Majuscule
Description
Convertit une chaîne en majuscules
Groupe de fonctions
Caractère
Syntaxe
chaîne Majuscule(chaîne)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne à convertir
Chaîne
Oui
Exemples
Majuscule("New York") renvoie "NEW YORK".
UrlEncode
Description
Applique des règles d'encodage URL à une chaîne
Groupe de fonctions
Caractère
Syntaxe
chaîne UrlEncode(html)
112
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
html
L'URL à encoder
Chaîne
Oui
Exemples
UrlEncode("http://www.businessobjects.com") renvoie
"http%3A%2F%2Fwww%2Ebusinessobjects%2Ecom".
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)
Entrée
Paramètre
Description
Type
chaîne
La chaîne qui va être mise Chaîne
en majuscules
Obligatoire
Oui
Exemples
CapitaleMot("Chiffre d'affaires de mars") renvoie "Chiffre
D'affaires De Mars".
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
113
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Fonctions Date et heure
CurrentDate
Description
Renvoie la date actuelle au format conforme aux paramètres régionaux
Groupe de fonctions
Date et heure
Syntaxe
date DateCourante()
Exemples
DateActuelle() renvoie 10 septembre 2002 si la date est le
10 septembre 2002.
CurrentTime
Description
Renvoie l'heure actuelle au format conforme aux paramètres régionaux
Groupe de fonctions
Date et heure
Syntaxe
heure HeureCourante()
Exemples
HeureActuelle renvoie 11:15 si l'heure actuelle est 11 h 15.
114
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
NomDuJour
Description
Renvoie le nom du jour correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne NomDuJour(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
NomDuJour([Date de réservation]) renvoie "samedi' si [Date de
réservation] est 15 décembre 2001 (ce qui correspond à un samedi).
Remarque
La date saisie doit être une variable. Vous ne pouvez pas spécifier
directement la date, comme dans NomDuJour("07/15/2001").
NuméroDuJourDuMois
Description
Renvoie le numéro du jour dans un mois
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
115
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDuMois(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
NuméroDuJourDuMois([Date de réservation]) renvoie 15 si [Date
de réservation] est "15 décembre 2001".
NuméroDuJourDeLaSemaine
Description
Renvoie le numéro du jour d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDeLaSemaine(date)
116
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Remarques
Web Intelligence considère le lundi comme le premier jour de la semaine.
Exemples
NuméroDuJourDeLaSemaine([Date de réservation]) renvoie 1 si
la date figurant dans [Date de réservation] est le 2 mai 2005 (ce qui
correspond à un lundi).
NuméroDuJourDeAnnée
Description
Renvoie le numéro du jour dans une année
Groupe de fonctions
Date et heure
Syntaxe
entier NuméroDuJourDeAnnée(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
NuméroDuJourDeAnnée([Date de réservation]) renvoie 349 si
[Date de réservation] est "15 décembre 2001".
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
117
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
JoursEntre
Description
renvoie le nombre de jours compris entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier JoursEntre(première_date;dernière_date)
Entrée
Paramètre
Description
Type
Obligatoire
première_date
La première date
Date
Oui
dernière_date
La dernière date
Date
Oui
Exemples
JoursEntre([Date de la vente];[Date de facture]) renvoie 2
si [Date de la vente] correspond au 15 décembre 2001 et [Date de facture]
au 17 décembre 2001.
DernierJourDuMois
Description
Renvoie la date du dernier jour d'un mois
Groupe de fonctions
Date et heure
118
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
date DernierJourDuMois(date)
Entrée
Paramètre
Description
Type
date
N'importe quelle date Date
du mois
Obligatoire
Oui
Exemples
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 d'une semaine
Groupe de fonctions
Date et heure
Syntaxe
date DernierJourDeLaSemaine(date)
Entrée
Paramètre
Description
Type
date
N'importe quelle date de Date
la semaine
Obligatoire
Oui
Remarques
Web Intelligence considère le lundi comme le premier jour de la semaine.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
119
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
DernierJourDeLaSemaine([Date de la vente]) renvoie 15 mai 2005
(un dimanche) si [Date de la vente] correspond au 11 mai 2005.
Mois
Description
Renvoie le nom du mois correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
chaîne Mois(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
Mois([Date de réservation]) renvoie "Décembre" si la date figurant
dans [Date de réservation] correspond au 15 décembre 2005.
NuméroDuMoisDeAnnée
Description
Renvoie le numéro du mois correspondant à une date
Groupe de fonctions
Date et heure
120
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
entier NuméroDuMoisDeAnnée(date)
Entrée
Paramètre
Description
Type
date
N'importe quelle date Date
de l'année
Obligatoire
Oui
Exemple
NuméroDuMoisDeAnnée([Date de réservation]) renvoie 12 si la
date figurant dans [Date de réservation] correspond au 15 décembre 2005.
MoisEntre
Description
Renvoie le nombre de mois entre deux dates.
Groupe de fonctions
Date et heure
Syntaxe
entier MoisEntre(première_date;dernière_date)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
121
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
première_date
La première date
Date
Oui
dernière_date
La dernière date
Date
Oui
Exemples
MoisEntre([Date de la vente];[Date de facture]) renvoie 1
si [Date de la vente] correspond au 2 décembre 2005 et [Date de facture]
au 2 janvier 2006.
Trimestre
Description
Renvoie le numéro du trimestre correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
entier Trimestre(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
N'importe quelle date
du trimestre
Date
Oui
Exemples
Trimestre([Date de réservation]) renvoie 4 si la date figurant dans
[Date de réservation] correspond au 15 décembre 2005.
122
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DateRelative
Description
Renvoie une date relative à une autre date
Groupe de fonctions
Date et heure
Syntaxe
date DateRelative(date_début;nombre_de_jours)
Entrée
Paramètre
Description
Type
Obligatoire
date_début
La date de début
Date
Oui
Nombre
Oui
noLe nombre de jours à partir
mbre_de_jours de la date de début
Remarques
Le paramètre nombre_de_jours peut être négatif pour renvoyer une date
antérieure à date_début.
Exemples
DateRelative([Date de réservation];2) renvoie 17 décembre 2005
si [Date de réservation] correspond au 15 décembre 2005;
DateRelative([Date de réservation];-3) renvoie 9 janvier 2007
si [Date de réservation] correspond au 12 janvier 2007.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
123
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DimTps
Description
La dimension temporelle DimTps vous permet de construire un axe temporel
à partir d'un objet d'univers de type date. DimTps renvoie les données des
dates fournies en tant que premier paramètre pour les périodes fournies en
tant que second paramètre. Lorsque les périodes ne contiennent pas de
données, le premier jour de chaque période vide est renvoyé, ce qui permet
d'obtenir un axe complet pour la période donnée. Cela garantit :
• Que l'axe conserve l'ordre naturel du temps (les objets les plus anciens
en premier et les objets les plus récents en dernier).
• Que l'axe conserve toutes les périodes entre les dates minimales et
maximales du contexte actuel.
Groupe de fonctions
Date et heure
Syntaxe
TimeDim([Date Type]; Period Type)
124
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type de
date
L'objet de date pour le rapport, par exemple, Date
DateFacture.
Oui
Type de
période
La période concernée par les résultats, à
partir des valeurs suivantes :
Facultatif
•
•
•
•
Type
Date
Obligatoire
Jour
Mois
Trimestre
Année
Lorsqu'aucune valeur n'est sélectionnée,
Jour est utilisé par défaut.
Utilisez la fonction ci-dessus en conjonction avec les fonctions suivantes :
• NomDuJour
• NuméroDuJourDuMois
• NuméroDuJourDeLaSemaine
• NuméroDuJourDeAnnée
• Mois
• NuméroDuMoisDeAnnée
• Trimestre
• Année
• FormatDeDate
Exemple
Le premier tableau ci-dessous contient des données concernant uniquement
certaines dates. Les exemples de requête suivants montrent comment les
résultats sont interprétés.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
125
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Date de la facture
Chiffre d'affaires
1/3/00
31 607
1/8/00
31 244
7/3/00
38 154
La requête suivante NomDuJour(DimTps([Date de la facture] ;
Trimestre) renvoie les valeurs journalières du tableau ci-dessus.
Date de la facture
Chiffre d'affaires
1/3/00
31 607
1/8/00
31 244
4/1/00
7/3/00
38 154
Vous devez formater les résultats de la fonction DimTps avec la fonction
Trimestre pour renvoyer les résultats par trimestre (T1, T2, etc.) afin d'obtenir
le tableau de résultats suivant :
Date de la facture
Chiffre d'affaires
T1
62 851
T2
T3
38 154
EnDate
Description
renvoie une chaîne de caractères spécifiant la date indiquée dans le format
défini.
126
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Date et heure
Syntaxe
date EnDate(chaîne_date;format)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne_date
Date à formater
chaîne
Oui
format
Le format de date chaîne
Oui
Exemples
EnDate("15/12/2002";"dd/MM/yyyy") renvoie 15 décembre 2002.
Semaine
Description
Renvoie le numéro de la semaine de l'année
Groupe de fonctions
Date et heure
Syntaxe
entier Semaine(date)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
127
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
Semaine([Date de réservation]) renvoie 1 si la date figurant dans
[Date de réservation] est le 4 janvier 2004 (ce qui correspond à la première
semaine de l'année 2004).
Année
Description
Renvoie l'année correspondant à une date
Groupe de fonctions
Date et heure
Syntaxe
entier Année(date)
Entrée
Paramètre
Description
Type
Obligatoire
date
La date saisie
Date
Oui
Exemples
Année([Date de réservation]) renvoie 2005 si la date figurant dans
[Date de réservation] est le 15 décembre 2005.
128
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
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(dp)
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
•
•
Vous devez mettre le nom du fournisseur de données entre crochets.
Pour des raisons de sécurité, le résultat de la fonction n'inclut pas le nom
d'hôte de la base de données, le nom de l'utilisateur ni le mot de passe
de l'utilisateur.
FournisseurDeDonnées
Description
Renvoie le nom d'un fournisseur de données contenant un objet de rapport
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
129
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne FournisseurDeDonnées(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Un objet de rapport
Objet rapport
Oui
Exemples
FournisseurDeDonnées([Revenu total]) renvoie "Ventes" si
l'indicateur [Revenu total] se trouve dans un fournisseur de données appelé
"Ventes".
DateCléFournisseurDonnées
Description
Renvoie la date clé d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateCléFournisseurDonnées(dp)
130
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
•
•
Vous devez mettre le nom du fournisseur de données entre crochets.
La date clé renvoyée est dotée d'un format conforme à celui des
paramètres régionaux du document.
Exemples
DateCléFournisseurDonnées([Ventes]) renvoie le 3 août 2007 si la
date clé du fournisseur de données Ventes est le 3 août 2007.
LégendeDateCléFournisseurDonnées
Description
Renvoie la légende de la date clé d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne LégendeDateCléFournisseurDonnées(dp)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
131
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
LégendeDateCléFournisseurDonnées([Ventes]) renvoie la "Date
actuelle du calendrier" si la légende de date clé du fournisseur de données
Ventes est "Date actuelle du calendrier".
SQLDuFournisseur
Description
Renvoie le SQL généré par un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne SQLDuFournisseur(dp)
132
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
SQLDuFournisseur([Requête 1]) renvoie "SELECT pays.nom_pays
FROM pays" si le SQL du fournisseur de données est "SELECT
pays.nom_pays FROM pays".
TypeDuFournisseur
Description
Renvoie le type d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne TypeDuFournisseur(dp)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
133
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
•
•
TypeDuFournisseur renvoie "Univers" pour les fournisseurs de données
d'univers ou "Données personnelles" pour les fournisseurs de données
personnelles.
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
TypeDuFournisseur([Ventes]) renvoie "Univers" si le fournisseur de
données "Ventes" est basé sur un univers.
RéponseInvite
Description
Détermine si une réponse a été donnée à l'invite
Groupe de fonctions
Fournisseur de données
Syntaxe
bool RéponseInvite([fd;]chaîne_invite)
134
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
contenant l'invite
Fournisseur de Non
données
chaîne_invite
Texte de l'invite
Chaîne
Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
RéponseInvite("Choisir une ville") renvoie la valeur Vrai si une
réponse a été donnée à l'invite identifiée par le texte "Choisir une ville".
RéponseInvite ([Ventes];"Choisir une ville") renvoie la valeur
Vrai si une réponse a été donnée à l'invite identifiée par le texte "Choisir une
ville" dans le fournisseur de données [Ventes].
DateDeLaDernièreExécution
Description
Renvoie la date de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateDeLaDernièreExécution(dp)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
135
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
•
•
•
Si votre rapport ne comporte qu'un fournisseur de données, vous pouvez
omettre le paramètre dp
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir
une référence à un fournisseur de données.
Exemples
DateDeLaDernièreExécution([Requête ventes]) renvoie "4/3/2002"
si le fournisseur de données Requête ventes a été actualisé pour la dernière
fois le 4 mars 2002.
Rubriques associées
• FournisseurDeDonnées
DuréeDernièreExécution
Description
Renvoie la durée, exprimée en secondes, de la dernière actualisation d'un
fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
numérique DuréeDernièreExécution(dp)
136
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
DuréeDernièreExécution([Ventes]) renvoie 3 s'il a fallu 3 secondes
au fournisseur de données "Ventes" pour renvoyer ses données lors de la
dernière exécution.
HeureDeLaDernièreExécution
Description
Renvoie l'heure de la dernière actualisation d'un fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
heure HeureDeLaDernièreExécution(dp)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
137
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
Remarques
•
•
•
Si votre rapport ne comporte qu'un fournisseur de données, vous pouvez
omettre le paramètre dp.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir
une référence à un fournisseur de données.
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
HeureDeLaDernièreExécution([Requête ventes]) renvoie "2:48:00
PM" si le fournisseur de données Requête ventes a été actualisé pour la
dernière fois à 14 h 48.
Rubriques associées
• FournisseurDeDonnées
NombreDeFournisseurs
Description
Renvoie le nombre de fournisseurs de données dans un rapport
Groupe de fonctions
Fournisseur de données
Syntaxe
entier NombreDeFournisseurs()
138
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
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(dp)
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
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.
Exemples
NombreDeLignes([Requête 1]) renvoie 10 si le fournisseur de données
"Requête 1" comporte 10 lignes.
Rubriques associées
• FournisseurDeDonnées
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
139
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DateDeLaValeurDeRéférence
Description
Renvoie la date des données de référence utilisées dans le cadre du suivi
des données
Groupe de fonctions
Fournisseur de données
Syntaxe
date DateDeLaValeurDeRéférence()
Exemples
DateDeLaValeurDeRéférence() renvoie 15 décembre 2008 si la date
de référence correspond au 15 décembre 2008.
RéponseUtilisateurValeurRéf
Description
Renvoie la réponse à une invite lorsque les données de référence étaient
les données actuelles
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateurValeurDeRéférence([fd;]chaîne_in
vite[;Index])
140
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
dp
Le fournisseur de données
Fournisseur de
données
Non
Chaîne
Oui
Indique à la fonction de renvoyer les clés Mot clé
primaires de base de données des valeurs
d'invite
Non
chaîne_in- Texte de l'invite
vite
Index
Remarques
•
•
•
•
Cette fonction renvoie une chaîne vide si le suivi des données n'est pas
activé.
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir
une référence à un fournisseur de données.
Si vous avez sélectionné plusieurs valeurs en réponse à une invite, la
fonction renvoie une chaîne constituée d'une liste de valeurs (ou de clés
primaires si l'opérateur Index est spécifié) séparées par des
points-virgules.
Exemples
RéponseUtilisateurValeurRéf( "Quelle ville ?" ) renvoie
"Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle ville ?" lorsque les
données de référence étaient les données actuelles.
RéponseUtilisateurValeurRéf([Requête ventes];"Quelle
ville ?") renvoie "Madrid" si vous avez saisi "Madrid" dans l'invite "Quelle
ville ?" du fournisseur de données "Requête ventes" lorsque les données
de référence étaient les données actuelles.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
141
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
NomDeUnivers
Description
Renvoie le nom de l'univers sur lequel est basé le fournisseur de données
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne NomDeUnivers(dp)
Entrée
Paramètre
Description
Type
dp
Le fournisseur de Fournisseur de
données
données
Obligatoire
Oui
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.
Exemples
NomDeUnivers([Requête 1]) renvoie "eMode" si le fournisseur de
données [Requête 1] est basé sur l'univers eMode.
Rubriques associées
• FournisseurDeDonnées
142
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
RéponseUtilisateur
Description
Renvoie la réponse à une invite
Groupe de fonctions
Fournisseur de données
Syntaxe
chaîne RéponseUtilisateur([fd;]chaîne_invite[;Index])
Entrée
Paramètre Description
Type
Obligatoire
dp
Fournisseur de
données
Non
Chaîne
Oui
Indique à la fonction de renvoyer les clés Mot clé
primaires de base de données des valeurs
d'invite
Non
Le fournisseur de données
chaîne_in- Texte de l'invite
vite
Index
Remarques
•
•
•
Vous devez mettre le nom du fournisseur de données entre crochets.
Vous pouvez utiliser la fonction FournisseurDeDonnées pour fournir
une référence à un fournisseur de données.
Si vous sélectionnez plusieurs valeurs en réponse à une invite, la fonction
renvoie une chaîne constituée d'une liste de valeurs (ou de clés primaires
si l'opérateur Index est spécifié) séparées par des points-virgules.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
143
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
RéponseUtilisateur( "Quelle ville ?" ) renvoie "Los Angeles"
si vous avez saisi "Los Angeles" dans l'invite "Quelle ville ?".
RéponseUtilisateur ([Requête ventes];"Quelle ville ?")
renvoie "Los Angeles" si vous avez saisi "Los Angeles" dans l'invite "Quelle
ville ?" du fournisseur de données "Requête ventes".
RéponseUtilisateur ([Requête ventes];"Quelle
ville ?";Index) renvoie 23 si vous avez saisi "Los Angeles" dans l'invite
"Quelle ville ?" du fournisseur de données "Requête ventes" et que la clé
primaire de base de données de Los Angeles est 23.
Fonctions Document
AuteurDuDocument
Description
Renvoie l'identification InfoView de l'auteur du document
Groupe de fonctions
Document
Syntaxe
chaîne AuteurDuDocument()
Exemples
AuteurDuDocument() renvoie "gkn" si le nom de connexion de l'auteur
du document est "gkn".
144
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DateDeCréationDuDocument
Description
Renvoie la date à laquelle un document a été créé
Groupe de fonctions
Document
Syntaxe
date DateDeCréationDuDocument()
Exemples
DateDeCréationDuDocument renvoie 15 décembre 2008 si le document
a été créé le 15 décembre 2008.
HeureDeCréationDuDocument
Description
Renvoie l'heure à laquelle un document a été créé
Groupe de fonctions
Document
Syntaxe
heure HeureDeCréationDuDocument()
Exemples
HeureDeCréationDuDocument() renvoie 11:15 si le document a été créé
à 11 h 15.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
145
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DateDuDocument
Description
Renvoie la date à laquelle un document a été enregistré pour la dernière
fois
Groupe de fonctions
Document
Syntaxe
date DateDuDocument()
Exemples
DateDuDocument() renvoie 8 août 2005 si le document a été enregistré
pour la dernière fois le 8 août 2005.
NomDuDocument
Description
renvoie le nom du document.
Groupe de fonctions
Document
Syntaxe
chaîne NomDuDocument()
Exemples
NomDuDocument() renvoie "Rapport des ventes" si le document se nomme
"Rapport des ventes".
146
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DocumentPartiellementActualisé
Description
Détermine si un document est partiellement actualisé
Groupe de fonctions
Document
Syntaxe
booléen DocumentPartiellementActualisé()
Remarques
DocumentPartiellementActualisé renvoie une valeur booléenne que
vous pouvez utiliser dans la fonction Si.
Exemples
DocumentPartiellementActualisé() renvoie Vrai si le document est
partiellement actualisé.
HeureDuDocument
Description
Renvoie l'heure à laquelle un document a été enregistré pour la dernière
fois
Groupe de fonctions
Document
Syntaxe
heure HeureDuDocument()
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
147
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Remarques
Le format de l'heure renvoyée varie en fonction du format de cellule.
Exemple
HeureDuDocument() renvoie 15:45 si le document a été enregistré pour
la dernière fois à 15h:45.
FiltresExploration
Description
Renvoie les filtres d'exploration appliqués à un document ou à un objet en
mode Exploration
Groupe de fonctions
Document
Syntaxe
chaîne FiltresExploration(obj|séparateur)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Un objet de rapport
Objet rapport
Soit obj, soit sépa
rateur requis
séparateur
Le séparateur du filtre
d'exploration
Chaîne
Soit obj, soit sépa
rateur requis
Remarques
•
•
148
Vous pouvez insérer FiltresExploration directement sans saisir
manuellement la formule en insérant une cellule de filtres d'exploration.
Si vous ne spécifiez aucun objet, la fonction renvoie tous les filtres
d'exploration appliqués au document.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
FiltresExploration() renvoie "US" si le document possède un filtre
d'exploration restreignant l'objet [Pays] à US.
FiltresExploration() renvoie "US - 1999" si le document possède un
filtre limitant les objets [Pays] à "US" et [Année] à 1999.
FiltresExploration("/") renvoie "US / 1999" si le document possède
des filtres limitant les objets [Pays] à "US" et [Année] à 1999.
FiltresExploration ([Trimestre]) renvoie "T3" si le document
possède un filtre d'exploration limitant l'objet [Trimestre] à "T3".
RésuméInvite
Description
Renvoie le texte de l'invite et la réponse utilisateur de toutes les invites d'un
document
Groupe de fonctions
Document
Syntaxe
string PromptSummary()
Exemples
RésuméInvite() renvoie des informations sur toutes les invites d'un
document.
Exemple de sortie :
Enter Quantity Sold: 5000
Enter value(s) for State (optional): California,
Texas, Utah
Enter Customer (optional):
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
149
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
RésuméRequête
Description
Renvoie des informations sur les requêtes d'un document
Groupe de fonctions
Document
Syntaxe
chaîne RésuméRequête([dp])
Entrée
Paramètre
Description
Type
dp
Un fournisseur de Fournisseur de
données
données
Obligatoire
Non
Remarques
•
Vous devez mettre le nom du fournisseur de données entre crochets.
Exemples
RésuméRequête() renvoie des informations sur toutes les requêtes d'un
document.
RésuméRequête([Requête 1]) renvoie des informations sur toutes les
requêtes basées sur le fournisseur de données [Requête 1].
Exemple de sortie :
Query 1:
Universe: eFashion
Last execution time: 1s
NB of rows: 34500
Result objects: State, Year, Sales Revenue
Scope of analysis: State, City, Year, Quarter,
Month
150
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
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
FiltreRapport
Description
Renvoie les filtres de rapport appliqués à un objet ou un rapport
Groupe de fonctions
Document
Syntaxe
chaîne FiltreRapport(obj)
Entrée
Paramètre
Description
Type
Obligatoire
obj
Un objet de rapport
Objet rapport
Oui
Exemples
FiltreRapport([Pays]) renvoie "US" si un filtre de rapport limite l'objet
Pays à "US".
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
151
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
RésuméFiltreRapport
Description
Renvoie un résumé des filtres de rapport d'un document ou d'un rapport
Groupe de fonctions
Document
Syntaxe
string ReportFilterSummary(report_name)
Entrée
Paramètre
Description
Type
nom_rapport
Le nom du rapport Chaîne
Obligatoire
Non
Remarques
Si nom_rapport est omis, RésuméFiltreRapport renvoie un résumé
de tous les filtres de rapport du document.
Exemples
RésuméFiltreRapport() renvoie des informations sur tous les filtres de
rapport d'un document.
RésuméFiltreRapport("Rapport1") renvoie des informations sur les
filtres du rapport "Rapport1".
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:
152
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
(Top 10 & Bottom 10 [Customer] Based on [Sales
Revenue] (Count))
Fonctions du groupe Logique
Pair
Description
Détermine si un nombre est pair
Groupe de fonctions
Logique
Syntaxe
booléen Pair(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Remarques
•
•
Pair renvoie une valeur booléenne que vous pouvez utiliser dans la
fonction Si.
Si vous placez Pair directement dans une colonne, Web Intelligence
convertit la valeur renvoyée en nombre entier (1=vrai ; 0=faux). Vous
pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Exemples
Pair(4) renvoie Vrai.
Pair(3) renvoie Faux.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
153
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Pair(23,2) renvoie Faux.
Pair(-4) renvoie Vrai.
Pair(-2,2) renvoie Faux.
Estdate
Description
Détermine si une valeur est une date
Groupe de fonctions
Logique
Syntaxe
booléen EstDate(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
•
EstDate renvoie une valeur booléenne que vous pouvez utiliser dans
la fonction Si.
Si vous placez EstDate() directement dans une colonne,
Web Intelligence convertit la valeur renvoyée en nombre entier (1 = vrai ;
0 = faux). Vous pouvez appliquer un format à ce nombre en utilisant un
opérateur booléen.
Exemples
EstDate([Date de réservation]) renvoie Vrai si la variable [Date
de réservation] est une date.
154
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Si(EstDate([Date de réservation] Alors "Date" Sinon "Pas
date") renvoie "Date" si [Date de réservation] est une date.
Rubriques associées
• Si...Alors...Sinon
EstErreur
Description
Détermine si un objet renvoie une erreur
Groupe de fonctions
Logique
Syntaxe
booléen EstErreur(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
•
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.
Exemples
EstErreur([Chiffre d'affaires]) renvoie la valeur Faux si la variable
[Chiffre d'affaires] ne renvoie pas d'erreur.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
155
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
EstErreur([Nombre moyen d'invités]) renvoie Vrai si la variable
[Nombre moyen d'invités] renvoie une erreur de division par zéro (#DIV/0).
Si EstErreur([Nombre moyen d'invités]) Alors "Erreur"
Sinon "Pas d'erreur" renvoie "Erreur" si la variable [Nombre moyen
d'invités] renvoie une erreur de division par zéro (#DIV/0).
Rubriques associées
• Si...Alors...Sinon
EstLogique
Description
Détermine si une valeur est booléenne
Groupe de fonctions
Logique
Syntaxe
booléen EstLogique(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
•
156
EstLogique renvoie une valeur booléenne que vous pouvez utiliser
dans la fonction Si.
Si vous placez EstLogique directement dans une colonne,
Web Intelligence transforme la valeur renvoyée en nombre entier. Vous
pouvez appliquer un format à ce nombre en utilisant un opérateur booléen.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
EstLogique(EstChaîne([Pays])) renvoie Vrai.
EstLogique([Pays]) renvoie Faux si [Pays] renvoie tout type de données
autre que booléen.
Si EstLogique(EstDate([Pays])) Alors "Booléen" Sinon "Non
booléen" renvoie "Booléen".
Rubriques associées
• Si...Alors...Sinon
EstNul
Description
Détermine si une valeur est nulle
Groupe de fonctions
Logique
Syntaxe
booléen EstNul(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
•
EstNul renvoie une valeur booléenne que vous pouvez utiliser dans la
fonction Si.
Si vous placez EstNul directement dans une colonne, Web Intelligence
transforme la valeur renvoyée en nombre entier. Vous pouvez appliquer
un format à ce nombre en utilisant un opérateur booléen.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
157
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
EstNul([Chiffre d'affaires]) renvoie la valeur Faux si la variable
[Chiffre d'affaires] n'est pas nulle.
EstNul([Nombre moyen d'invités]) renvoie la valeur Vrai si la variable
[Nombre moyen d'invités] est nulle.
Rubriques associées
• Si...Alors...Sinon
EstNombre
Description
Détermine si une valeur est un nombre
Groupe de fonctions
Logique
Syntaxe
booléen EstNombre(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
•
158
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
EstNombre([Chiffre d'affaires]) renvoie la valeur Vrai si la variable
[Chiffre d'affaires] est un nombre.
EstNombre([Nom du client]) renvoie Faux si la variable [Nom du
client] n'est pas un nombre.
Si EstNombre([Nom du client]) Alors "Nombre" Sinon "Pas
un nombre" renvoie "Pas un nombre" si la variable [Nom du client] n'est
pas un nombre.
Rubriques associées
• Si...Alors...Sinon
EstChaîne
Description
Détermine si une valeur est une chaîne
Groupe de fonctions
Logique
Syntaxe
booléen EstChaîne(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
EstChaîne renvoie une valeur booléenne que vous pouvez utiliser dans
la fonction Si.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
159
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
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.
Exemples
EstChaîne([Chiffre d'affaires]) renvoie la valeur Faux si la variable
[Chiffre d'affaires] n'est pas une chaîne.
EstChaîne([Nom du client]) renvoie Vrai si la variable [Nom du client]
est une chaîne.
Si EstChaîne([Nom client]) Alors "Chaîne" Sinon "Pas
chaîne" renvoie "Chaîne" si la variable [Nom client] est une chaîne.
Rubriques associées
• Si...Alors...Sinon
EstHeure
Description
Détermine si une variable est une variable d'heure
Groupe de fonctions
Logique
Syntaxe
booléen EstHeure(obj)
160
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
•
•
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.
Exemples
EstHeure([Heure de réservation]) renvoie la valeur Vrai si la variable
[Heure de réservation] est une variable d'heure.
EstHeure([Nombre moyen d'invités]) renvoie la valeur Faux si la
variable [Nombre moyen d'invités] n'est pas une variable d'heure.
Si EstHeure([Nombre moyen d'invités]) Alors "Heure" Sinon
"Pas heure" renvoie "Pas heure" si la variable [Nombre moyen d'invités]
n'est pas une variable d'heure.
Rubriques associées
• Si...Alors...Sinon
Impair
Description
Détermine si un nombre est impair
Groupe de fonctions
Logique
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
161
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
booléen Impair(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
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.
Exemples
Impair(5) renvoie la valeur Vrai.
Impair(4) renvoie la valeur Faux.
Impair(23.2) renvoie la valeur Vrai.
Impair(24.2) renvoie la valeur Vrai.
Impair(-23.2) renvoie la valeur Vrai.
Impair(-24.2) renvoie la valeur Vrai.
Rubriques associées
• Si...Alors...Sinon
162
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Fonctions du groupe Numérique
Abs
Description
Renvoie la valeur absolue d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Abs(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Exemples
Abs(25) renvoie 25.
Abs(-11) renvoie 11.
Plafond
Description
Renvoie un nombre arrondi à l'entier supérieur
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
163
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Numérique
Syntaxe
numérique Plafond( nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Exemples
Plafond(2,4) renvoie 3.
Plafond(3,1) renvoie 4.
Plafond(-3,1) renvoie -3.
Cos
Description
Renvoie le cosinus d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Cos(angle)
164
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
angle
Un angle en radia- Nombre
ns
Obligatoire
Oui
Exemples
Cos(180) renvoie -0,6.
ConvertirDepuisEuro
Description
Convertit un montant en euros dans une autre devise
Groupe de fonctions
Numérique
Syntaxe
numérique ConvertirDepuisEuro(montant_euro;code_dev;ni
veau_arrondi)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
165
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
montant_eu- Le montant en euros
ro
Nombre
Oui
code_dev
Chaîne
Oui
Nombre
Oui
Le code ISO de la devise cible
niveau_arro- Le nombre de décimales selon lendi
quel le résultat doit être arrondi
Remarques
Le code de la devise doit être le code de l'une des 12 devises de
l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant
leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction renvoie
#ERROR. Les devises sont les suivantes :
BEF
Franc belge
DEM Mark allemand
GRD Drachme grecque
166
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
ConvertirDepuisEuro(1000;"FRF";2) renvoie 6559,57.
ConvertirDepuisEuro(1000;"FRF";1) renvoie 6559,60.
ConvertirDepuisEuro(1000.04;"DEM";2) renvoie 1955,83.
ConvertirDepuisEuro(1000.04;"DEM";1) renvoie 1955,80.
Rubriques associées
• Comment Web Intelligence arrondit et tronque les nombres ?
ConvertirEnEuro
Description
Convertit un montant en euros
Groupe de fonctions
Numérique
Syntaxe
numérique ConvertirEnEuro(montant_non_euro;code_dev;ni
veau_arrondi)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
167
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
montaLe montant dans la devise qui n'est
nt_non_eu- pas en euros
ro
code_dev
Type
Obligatoire
Nombre
Oui
Le code ISO de la devise qui n'est pas Chaîne
en euros
niveau_arro- Le nombre de décimales selon lequel Nombre
ndi
le résultat doit être arrondi
Oui
Oui
Exemple
ConvertirEnEuro(6559;"FRF";2) renvoie 999,91.
ConvertirEnEuro(6559;"FRF";1) renvoie 999,90.
ConvertirEnEuro(1955;"DEM";2) renvoie 999,58.
ConvertirEnEuro(1955;"DEM";1) renvoie 999,60.
Remarque
Le code de la devise doit être le code de l'une des 12 devises de
l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant
leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction renvoie
#ERROR. Les devises sont les suivantes :
168
BEF
Franc belge
DEM
Mark allemand
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Rubriques associées
• Comment Web Intelligence arrondit et tronque les nombres ?
ErreurEuroParArrondi
Description
Renvoie l'erreur d'arrondi dans une conversion à partir d'euros
Groupe de fonctions
Numérique
Syntaxe
numérique ErreurEuroParArrondi(montant_euro;code_dev;ni
veau_arrondi)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
169
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
montant_eu- Le montant en euros
ro
Nombre
Oui
code_dev
Chaîne
Oui
Le code ISO de la devise cible
niveau_arro- Le nombre de décimales selon lequel Nombre
ndi
le résultat doit être arrondi
Oui
Résultat
L'erreur d'arrondi du calcul
Exemples
ErreurEuroParArrondi(1000;"FRF";2) renvoie 0. (Il n'y a pas de
différence entre la conversion non arrondie et la conversion arrondie à
2 positions décimales.)
ErreurEuroParArrondi(1000;"FRF";1) renvoie 0,03. (La conversion
non arrondie est 6559,57. La conversion arrondie à 1 position décimale est
6559,60. L'erreur d'arrondi est 0,03.)
ErreurEuroParArrondi(1000;"DEM";2) renvoie 0. (Il n'y a pas de
différence entre la conversion non arrondie et la conversion arrondie à
2 positions décimales.)
ErreurEuroParArrondi(1000;"DEM";1) renvoie -0,01. (La conversion
non arrondie est 1955,83. La conversion arrondie à 1 position décimale est
1995,80. L'erreur d'arrondi est de -0,03.)
Remarque
Le code de la devise doit être le code de l'une des 12 devises de
l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant
leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction renvoie
#ERROR. Les devises sont les suivantes :
BEF
170
Franc belge
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
DEM
Mark allemand
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Rubriques associées
• Comment Web Intelligence arrondit et tronque les nombres ?
ErreurEuroVersArrondi
Description
Renvoie l'erreur d'arrondi dans un calcul de conversion en euros
Groupe de fonctions
Numérique
Syntaxe
numérique ErreurEuroVersArrondi(montant_non_eu
ro;code_dev;niveau_arrondi)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
171
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
montaLe montant dans la devise qui n'est
nt_non_eu- pas en euros
ro
code_dev
Type
Obligatoire
Nombre
Oui
Le code ISO de la devise qui n'est pas Chaîne
en euros
niveau_arro- Le nombre de décimales selon lequel Nombre
ndi
le résultat doit être arrondi
Oui
Oui
Exemples
ErreurArrondiConvertirEnEuro(6559;"FRF";2) renvoie 0. (Il n'y a
pas de différence entre la conversion non arrondie et la conversion arrondie
à 2 positions décimales.)
ErreurArrondiConvertirEnEuro(6559;"FRF";1) renvoie -0,01. (La
conversion non arrondie est 999,91. La conversion arrondie à 1 position
décimale est 999,90. L'erreur d'arrondi est de -0,01.)
ErreurArrondiConvertirEnEuro(1955;"DEM";2) renvoie 0. (Il n'y a
pas de différence entre la conversion non arrondie et la conversion arrondie
à 2 positions décimales.)
ErreurArrondiConvertirEnEuro(1955;"DEM";1) renvoie 0,02. (La
conversion non arrondie est 999,58. La conversion arrondie à 1 position
décimale est 999,60. L'erreur d'arrondi est de -0,02.)
Remarque
Le code de la devise doit être le code de l'une des 12 devises de
l'Union Européenne, dont les valeurs ont été fixées par rapport à l'euro avant
leur disparition en janvier 2002. Si ce n'est pas le cas, la fonction renvoie
#ERROR. Les devises sont les suivantes :
172
BEF
Franc belge
DEM
Mark allemand
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
GRD
Drachme grecque
ESP
Peseta espagnole
FRF
Franc français
IEP
Punt irlandais
ITL
Lire italienne
LUF
Franc luxembourgeois
NLG
Guilder néerlandaise
ATS
Schilling autrichien
PTS
Escudo portugais
FIM
Mark finnois
Rubriques associées
• Comment Web Intelligence arrondit et tronque les nombres ?
Exp
Description
Renvoie une valeur exponentielle (e élevée à une puissance)
Groupe de fonctions
Numérique
Syntaxe
numérique Exp(puissance)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
173
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
puissance
La puissance
Nombre
Oui
Remarques
Une valeur exponentielle est la constante e (2,718...) élevée à une puissance.
Exemples
Exp(2.2) renvoie 9,03.
Fact
Description
Renvoie le factoriel d'un nombre
Groupe de fonctions
Numérique
Syntaxe
entier Fact(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Remarques
Le factoriel de nombre est le produit de tous les nombres entiers compris
entre 1 et nombre.
174
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
Fact(4) renvoie 24.
Fact(5,9) renvoie 120.
Floor
Description
Renvoie un nombre arrondi à l'entier inférieur le plus proche
Groupe de fonctions
Numérique
Syntaxe
entier Plancher(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Exemple
Plancher(24,4) renvoie 24.
Ln
Description
renvoie le logarithme naturel d'un nombre.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
175
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Numérique
Syntaxe
numérique Ln(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Exemples
Ln(10) renvoie 2.
Journal
Description
Renvoie le logarithme d'un nombre d'une base spécifiée
Groupe de fonctions
Numérique
Syntaxe
numérique Log(nombre;base)
176
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
nombre
N'importe quel nombre
Nombre
Oui
base
La base du logarithme
Nombre
Oui
Exemples
Log(125;5) renvoie 3.
Log10
Description
Renvoie le logarithme de base 10 d'un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Log10(nombre)
Entrée
numérique_entré
Un nombre
Exemples
Log10(100) renvoie 2.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
177
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Mod
Description
Renvoie le reste d'une division de deux nombres
Groupe de fonctions
Numérique
Syntaxe
numérique Mod(dividende;diviseur)
Entrée
Paramètre
Description
Type
Obligatoire
dividende
Le dividende
Nombre
Oui
diviseur
Le diviseur.
Nombre
Oui
Exemples
Mod(10;4) renvoie 2.
Mod (10.2;4.2) renvoie 1.8.
Puissance
Description
Renvoie un nombre élevé à une puissance
Groupe de fonctions
Numérique
178
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
numérique Puissance(nombre;puissance)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à élever à
une puissance
Nombre
Oui
puissance
La puissance
Nombre
Oui
Exemple
Puissance(10;2) renvoie 100.
Classement
Description
Classe un indicateur selon des dimensions
Groupe de fonctions
Numérique
Syntaxe
entier Classement(indicateur;[dim_classement][;Pre
miers|Derniers][;dim_redéfinies])
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
179
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
L'indicateur à classer
Indicateur
Oui
dim_clas- Les dimensions utilisées pour classer Liste Di- Non
sement l'indicateur
mension
PreDéfinit l'ordre de classement.
miers/Der- • Premiers : décroissant
niers
• Bas : croissant
Mot clé
dim_redéfinies
Liste Di- Non
mension
Les dimensions qui réinitialisent le
classement
Non (Premiers
est la configuration par défaut)
Remarques
•
•
•
•
Si vous ne spécifiez pas de dimensions 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.
Lorsque vous spécifiez un ensemble de dimensions de classement ou
redéfinies, vous devez les séparer par des points-virgules.
Par défaut, le classement est réinitialisé sur une section ou une rupture
de bloc.
Exemples
Dans le tableau suivant, le rang est indiqué par Classement([Chiffre
d'affaires]);([Pays])):
180
Pays
Chiffre d'affaires
Classement
France
835 420
2
US
2 451 104
1
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Dans le tableau suivant, le classement est donné par Classeme
nt([Chiffre d'affaires];([Pays]);Derniers). L'argument Der
niers signifie que les indicateurs sont classés par ordre décroissant.
Pays
Chiffre d'affaires
Classement
France
835 420
1
US
2 451 104
2
Dans le tableau suivant, le classement est indiqué par Classeme
nt([Chiffre d'affaires];([Pays];[Lieu de séjour])):
Pays
Lieu de séjour
Chiffre d'affaires
Classement
France
Côte d'Azur
835 420
3
US
Bahamas Beach
971 444
2
US
Hawaiian Club
1 479 660
1
Dans le tableau suivant, le classement est indiqué par Classeme
nt([Chiffre d'affaires];([Pays];[Année]);([Pays])). Le rang
est réinitialisé dans la dimension Pays.
Pays
Année
Chiffre d'affaires
Classement
France
FY1998
295 940
1
France
1999
280 310
2
France
2000
259 170
3
US
FY1998
767 614
3
US
1999
826 930
2
US
2000
856 560
1
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
181
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Rubriques associées
• Opérateurs Derniers/Premiers
Arrondi
Description
Arrondit un nombre
Groupe de fonctions
Numérique
Syntaxe
numérique Arrondi (nombre;niveau_arrondi)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à arrondir
Nombre
Oui
niveau_arron- Nombre de décimales selon le- Nombre
di
quel le nombre est arrondi
Oui
Exemples
Arrondi(9.44;1) renvoie 9,4.
Arrondi(9.45;1) renvoie 9,5.
Arrondi(9.45;0) renvoie 9.
Arrondi(9.45;-1) renvoie 10.
Arrondi(4.45;-1) renvoie 0.
Rubriques associées
• Comment Web Intelligence arrondit et tronque les nombres ?
182
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Signe
Description
Renvoie le signe d'un nombre
Groupe de fonctions
Numérique
Syntaxe
entier Signe(nombre)
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Remarques
Signe renvoie -1 si nombre est négatif, 0 si nombre est zéro et 1 si nombre
est positif.
Exemples
Signe(3) renvoie 1.
Signe(-27,5) renvoie -1.
Sin
Description
Retourne le sinus d'un angle
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
183
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Numérique
Syntaxe
numérique Sin(angle)
Entrée
Paramètre
Description
Type
angle
Un angle en radia- Nombre
ns
Obligatoire
Oui
Exemple
Sin(234542) renvoie -0,116992.
RacineCarrée
Description
Calcule la racine carrée d'un nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique RacineCarrée(nombre)
184
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
nombre
N'importe quel no- Nombre
mbre
Obligatoire
Oui
Exemple
Racine(25) renvoie 5.
Tan
Description
Renvoie la tangente d'un angle
Groupe de fonctions
Numérique
Syntaxe
numérique Tan(angle)
Entrée
Paramètre
Description
Type
angle
Un angle en radia- Nombre
ns
Obligatoire
Oui
Exemples
Tan(90) renvoie -2.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
185
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
EnNombre
Description
renvoie une chaîne sous la forme de nombre.
Groupe de fonctions
Numérique
Syntaxe
numérique EnNombre(chaîne)
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
Un nombre sous forme de
chaîne de caractères
Chaîne
Oui
Remarques
Si chaîne ne correspond pas à un nombre, la fonction EnNombre renvoie
#ERREUR.
Exemples
EnNombre("45") renvoie 45.
Truncate
Description
Tronque un nombre
186
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Numérique
Syntaxe
numérique Tronquer(nombre;niveau_troncature)
Entrée
Paramètre
Description
Type
Obligatoire
nombre
Le nombre à arrondir
Nombre
Oui
niveau_tronca- Nombre de décimales selon le- Nombre
ture
quel le nombre est tronqué
Oui
Remarques
Exemple
Tronquer(3,423;2) renvoie 3,42.
Rubriques associées
• Comment Web Intelligence arrondit et tronque les nombres ?
Fonctions diverses
NomDuBloc
Description
Renvoie le nom du bloc
Groupe de fonctions
Divers
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
187
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
chaîne NomDuBloc()
Exemples
Si NomDuBloc est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
NuméroDeColonne
Description
Renvoie le numéro de la colonne
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeColonne()
Exemples
NuméroDeColonne() renvoie 2 si la formule est placée dans la deuxième
colonne d'un tableau.
CurrentUser
Description
Renvoie l'identification InfoView de l'utilisateur actuel
Groupe de fonctions
Divers
Syntaxe
chaîne UtilisateurActuel()
188
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
UtilisateurActuel() renvoie "gkn" si l'identification InfoView de
l'utilisateur actuel est "gkn".
ForcerFusion
Description
Inclut des dimensions synchronisées dans les calculs d'indicateurs lorsque
les dimensions n'apparaissent pas dans le contexte du calcul.
Groupe de fonctions
Divers
Syntaxe
num ForceMerge(measure)
Entrée
Paramètre
Description
Type
Obligatoire
indicateur
Tout indicateur
Indicateur
Oui
Résultat
Résultat du calcul tenant compte des dimensions synchronisées
Remarques
•
•
Appliqué à un indicateur intelligent, ForcerFusion renvoie
#VALEURMULTI car le groupe nécessaire pour calculer l'indicateur
intelligent n'existe pas.
La fonction ForcerFusion de Web Intelligence est l'équivalent de la
fonction MultiCube de BusinessObjects/Desktop Intelligence.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
189
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
ForcerFusion([Chiffre d'affaires]) renvoie la valeur de [Chiffre
d'affaires] en tenant compte des dimensions synchronisées qui n'apparaissent
pas dans le même bloc que l'indicateur [Chiffre d'affaires].
ObtenirVariablesRégionalesDeContenu
Description
Renvoie les paramètres régionaux des données contenues dans le document
(les paramètres régionaux du document)
Groupe de fonctions
Divers
Syntaxe
chaîne ObtenirVariablesRégionalesDeContenu()
Remarques
Les paramètres régionaux du document sont utilisés pour mettre en forme
les données dans le document Web Intelligence.
Exemples
ObtenirVariablesRégionalesDeContenu() renvoie "fr_FR" si les
paramètres régionaux du document sont "Français (France)".
ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents
Description
Renvoie les paramètres régionaux dans le groupe paramètres régionaux de
visualisation préférés de l'utilisateur
190
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Divers
Syntaxe
string GetDominantPreferredViewingLocale()
Remarques
•
•
Chaque groupe de paramètres régionaux associés possède des
paramètres régionaux de document utilisés comme base pour tous les
autres paramètres régionaux du groupe. Par exemple, Anglais US
("en_US") constitue le paramètre régional prévalent dans le groupe des
paramètres régionaux anglais. L'anglais de Nouvelle-Zélande ("en_NZ")
est également un membre de ce groupe.
Le Guide du Gestionnaire de traduction répertorie tous les paramètres
régionaux de visualisation préférés dominants.
Exemples
ObtenirParamèresRégionauxDeVisualisationPréférésPrévale
nts renvoie "en_US" lorsque le paramètre régional de visualisation préféré
est "Anglais (Nouvelle-Zélande)".
Rubriques associées
• ObtenirParamètresRégionauxDeVisualisationPréférés
ObtenirVarRég
Description
Renvoie les paramètres régionaux de l'utilisateur utilisés pour mettre en
forme l'interface Web Intelligence (les paramètres régionaux du produit)
Groupe de fonctions
Divers
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
191
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
chaîne ObtenirVarRég()
Remarques
Les paramètres régionaux du produit sont ceux utilisés par Web Intelligence
pour afficher l'interface utilisateur (par exemple, les éléments de menu et le
texte des icônes).
Exemples
ObtenirVarRég() renvoie "en_US" si le paramètre régional du produit est
"Anglais (US)".
ObtentionTraduction
Description
Renvoie une chaîne localisée conformément aux paramètres régionaux de
visualisation préférés de l'utilisateur
Syntaxe
string GetLocalized(string[;comment])
Entrée
Paramètre
Description
Type
Obligatoire
chaîne
La chaîne à traduire
chaîne
Oui
chaîne
Non
comment (com- Un commentaire pour aider
mentaire)
les traducteurs
Remarques
•
192
Les paramètres de la chaîne peuvent être une chaîne dans toute formule
Web Intelligence (par exemple dans une cellule, un message alerteur ou
une définition de variable).
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
•
Lors de la conception d'un rapport, vous pouvez utiliser le paramètreco
mmentaire afin de fournir de plus amples informations pour aider le
traducteur à traduire la chaîne. Le commentaire apparaît avec la chaîne
dans l'outil Gestionnaire de traduction que les traducteurs utilisent pour
traduire les rapports de Web Intelligence.
Chaque paire chaîne + commentaire génère une chaîne distincte à
traduire dans l'outil Gestionnaire de traduction. En conséquence, Obten
tionTraduction("Product Total";"Max 20 characters") et
ObtentionTraduction("Product Total";"Use no more than
20 characters") peuvent renvoyer des traductions différentes.
Exemples
ObtentionTraduction("Total for all products") renvoie la
traduction de "Total for all products" si le paramètre régional de visualisation
préféré est "fr_FR".
ObtentionTraduction("Total for all products";"Try not to
use more than 20 characters") renvoie la traduction allemande de
"Total for all products" si le paramètre régional de visualisation préféré est
"de_DE". La fonction prévient également le traducteur s'il ne doit pas utiliser
plus de 20 caractères, si possible, pour la traduction de la chaîne.
Rubriques associées
• ObtenirParamètresRégionauxDeVisualisationPréférés
ObtenirParamètresRégionauxDeVisualisationPréférés
Description
Renvoie les paramètres régionaux préférés de l'utilisateur pour visualiser
les données du document (les paramètres régionaux de visualisation
préférés)
Groupe de fonctions
Divers
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
193
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Syntaxe
chaîne ObtenirParamètresRégionauxDeVisualisationPréfé
rés()
Exemples
ObtenirParamètresRégionauxDeVisualisationPréférés renvoie
"en_US" si les Paramètres régionaux de visualisation préférés sont "English
(US)".
Rubriques associées
• ObtentionTraduction
• ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents
Si...Alors...Sinon
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
If bool_value Then true_value [Else false_value]
194
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
valeur_bool
Une valeur booléenne
Booléen
Oui
valeur_vrai
La valeur à renvoyer si va
leur_bool est vraie
N'importe lequel
Oui
valeur_faux
La valeur à renvoyer si va
leur_bool est fausse
N'importe lequel
Oui si Sinon
est inclus
Remarques
•
•
•
valeur_vrai et valeur_faux peuvent combiner les types de données.
Vous pouvez utiliser les opérateurs booléens Et, Entre, DansListe,
Ou et Pas avec Si.
Vous pouvez imbriquer des conditions Si en utilisant Sinon si. La
syntaxe est la suivante :
If test_value Then true_value [Else false_value|ElseIf
test_value Then true_value [Else
false_value…]]
•
Web Intelligence accepte également la syntaxe Si(valeur_bool;va
leur_vrai;valeur_faux).
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
195
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Si [Chiffre d'affaires]>1 000 000 Alors "CA élevé" Sinon
si [Chiffre d'affaires]> 800 000 Alors "CA moyen" Sinon
"CA faible" renvoie "CA élevé" pour toutes les lignes dont le revenu
dépasse 1 000 000, "CA moyen" pour toutes les lignes dont le chiffre
d'affaires est compris entre 800 000 et 1 000 000 et "CA faible" pour toutes
les autres lignes.
Rubriques associées
• Si
• And (opérateur)
• Opérateur Entre
• DansListe (opérateur)
• Ou (opérateur)
• Pas (not x)
Si
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
If(bool_value;true_value;false_value)
196
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
valeur_bool
Une valeur booléenne
Booléen
Oui
valeur_vrai
La valeur à renvoyer si va
leur_bool est vraie
N'importe lequel
Oui
valeur_faux
La valeur à renvoyer si va
leur_bool est fausse
N'importe lequel
Oui
Remarques
•
•
valeur_vrai et valeur_faux peuvent combiner les types de données.
Vous pouvez imbriquer les conditions Si en remplaçant valeur_faux
par des conditions Si supplémentaires :
If(bool_value;true_value;If(bool_value;true_va
lue;false_value|If...))
•
Web Intelligence prend également en charge la syntaxe
Si...Alors...Sinon.
Exemples
Si([Revenu des ventes]>1000000;"Revenu élevé";"Revenu
bas") renvoie "Revenu élevé" pour toutes les lignes dont le chiffre d'affaires
dépasse 1 000 000 et "Revenu bas" pour toutes les lignes dont le chiffre
d'affaires est inférieur à 1 000 000.
Si([Revenu des ventes]>1 000 000;"Revenu élevé";[Chiffre
d'affaires]) renvoie "Revenu élevé" pour toutes les lignes dont le chiffre
d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres
lignes.
Rubriques associées
• Si...Alors...Sinon
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
197
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
NuméroDeLigne
Description
Renvoie le numéro de ligne dans un tableau
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeLigne()
Remarques
La numérotation des lignes d'un tableau commence par l'en-tête, qui est la
ligne 1.
Exemples
NuméroDeLigne() renvoie 2 lorsque la fonction apparaît au niveau de la
deuxième ligne d'un tableau.
NomDe
Description
Renvoie le nom d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomDe(obj)
198
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Remarques
Web Intelligence utilise NomDe dans les en-têtes de colonne et de ligne des
rapports.
Exemples
NomDe([Date de réservation]) renvoie "Date de réservation".
AucunFiltre
Description
Ignore les filtres lors du calcul d'une valeur
Groupe de fonctions
Divers
Syntaxe
type_saisie AucunFiltre(obj[;Tous|Explorer])
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
199
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
obj
Tout objet rapport
Objet rap- Oui
port
Tout|Exploration
•
•
•
Aucun mot clé spécifié : ignorer les filtres Mot clé
de rapport et de bloc
Tout : ignorer tous les filtres
Exploration : ignorer les filtres de
rapport et d'exploration
Obligatoire
Non
Remarques
•
•
AucunFiltre(obj;Exploration) ne fonctionne pas en mode
d'exploration de requête, car les filtres d'exploration sont ajoutés à la
requête, et non appliqués aux données de rapport.
Si vous quittez le mode d'exploration lorsque des filtres d'exploration sont
activés, ces derniers deviennent des filtres de rapport et peuvent modifier
la valeur des objets auxquels AucunFiltre(objet;Exploration)
est appliqué.
Exemples
Lorsque AucunFiltre(Somme([Chiffre d'affaires])) est placé
dans un pied de bloc, le chiffre d'affaires total de toutes les lignes du bloc
est renvoyé, même si certaines lignes sont exclues du bloc.
AucunFiltre(Somme([Chiffre d'affaires]);Tout) renvoie la
somme du chiffre d'affaires de tous les pays, y compris la France, même si
un filtre exclut la France du rapport.
AucunFiltre(Somme([Chiffre d'affaires]);Exploration)
renvoie la somme du chiffre d'affaires de tous les pays, même si un filtre
d'exploration filtre la dimension [Pays].
200
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
NombreDePages
Description
Renvoie le nombre de pages dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier NombreDePages()
Exemples
NombreDePages() renvoie 2 si le rapport contient deux pages.
Page
Description
Renvoie le numéro de la page actuelle dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier Page()
Exemple
Page()renvoie 2 s'il apparaît dans la deuxième page du rapport;
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
201
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Précédent
Description
Renvoie une valeur précédente d'un objet
Groupe de fonctions
Divers
Syntaxe
type_saisie Précédent(dimension|indicateur|Auto[;ré
init_dims][;décalage][;NonNul])
202
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
Type
Obligatoire
dimenLa dimension ou l'indicateur dont la va- Dimension, Oui
sion|indi- leur précédente est renvoyée par la fonc- indicateur
cation, ou le mot clé Auto
ou mot clé
teur|Auto
dimensio- La liste des dimensions utilisées pour ré- Liste Dimen- Non
ns_redéfi- initialiser le calcul
sion
nies
offset
Indique la valeur de dimension ou
d'indicateur présentant un déca
lage de lignes avant la ligne actuelle
Entier
NonNul
Demande à la fonction de renvoyer la
Mot clé
première valeur non nulle à partir du décalage
Non (la valeur par défaut est 1)
Non
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
203
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
•
•
•
•
•
•
•
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.
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.
Lorsqu'elle est utilisée dans un tableau croisé, l'option Précédent ne
traite pas la dernière valeur d'une ligne comme la première valeur de la
ligne suivante.
Exemples
Précédent([Pays)];1) renvoie les valeurs suivantes dans le tableau
qui suit :
Pays
Chiffre d'affaires
Précédent
US
5 000 000
Royaume-Uni
2 000 000
Etats-Unis
France
2 100 000
Royaume-Uni
Précédent([Chiffre d'affaires)]) renvoie les valeurs suivantes
dans le tableau qui suit :
204
Pays
Chiffre d'affaires
Précédent
US
5 000 000
Royaume-Uni
2 000 000
5 000 000
France
2 100 000
2 000 000
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Précédent([Chiffre d'affaires];([Pays]) renvoie les valeurs
suivantes dans le tableau qui suit :
Pays
Région
Chiffre d'affaires
Etats-Unis
Nord
5 000 000
Sud
7 000 000
Nord
3 000 000
Sud
4 000 000
Royaume-Uni
Précédent
5 000 000
3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes
dans le tableau croisé qui suit :
2004
2005
Précédent
5 000 000
6 000 000
5 000 000
Royaume-Uni 2 000 000
2 500 000
2 000 000
France
2 000 000
3 000 000
US
3 000 000
Précédent
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes
dans le tableau qui suit avec une rupture sur [Pays] :
Pays
Région
Chiffre d'affaires
Etats-Unis
Nord
5 000 000
Sud
7 000 000
Etats-Unis
Précédent
5 000 000
12 000 000
Pays
Région
Chiffre d'affaires
Précédent
Royaume-Uni
Nord
3 000 000
7 000 000
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
205
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Sud
Royaume-Uni
4 000 000
3 000 000
7 000 000
12 000 000
Précédent([Chiffre d'affaires]);2;NonNul) renvoie les valeurs
suivantes dans le tableau qui suit :
Année
Trimestre
Chiffre d'affaires
2008
T1
500
2008
T2
2008
T3
400
500
2008
T4
700
500
2008
T1
300
400
2008
T2
700
2008
T3
300
2008
T4
200
Précédent
300
2*Précédent(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Rubriques associées
• Comparaison de valeurs à l'aide de la fonction Précédent
• Opérateur Auto
ValeurRéf
Description
Renvoie la valeur de référence d'un objet rapport lorsque le suivi de données
est activé
206
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Groupe de fonctions
Divers
Syntaxe
type_entrée ValeurRéf(obj)
Exemples
ValeurRéf([Région ayant les meilleurs résultats]) renvoie
"Sud-ouest" si la valeur de la variable [Région ayant les meilleurs résultats]
est "Sud-ouest" dans les données de référence.
ValeurRéf([Chiffre d'affaires]) renvoie 1 000 si la valeur de
l'indicateur [Chiffre d'affaires] est 1 000 dans les données de référence.
ValeurRelative
Description
Renvoie les valeurs antérieures ou suivantes d'un objet
Groupe de fonctions
Divers
Syntaxe
input_type RelativeValue(measure|detail;slicing_dims;off
set)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
207
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Entrée
Paramètre
Description
indicaTout indicateur ou détail d'une dimension
teur|détail dans le bloc
Type
Obligatoire
Indicateur Oui
ou détail
dim_découpage
Les dimensions qui donnent le contexte du Liste Dicalcul
mension
Oui
offset
Indique la valeur de l'indicateur ou du
détail qui est de offset lignes supprimées de la ligne actuelle
Oui
Entier
Remarques
•
•
L'objet doit être un indicateur ou un détail d'une dimension disponible
dans le bloc.
L'ordre de tri de la liste de valeurs des dimensions de découpage permet
de déterminer le résultat de la fonction.
Deux facteurs définissent l'ordre de tri : les tris appliqués aux dimensions
de découpage et l'ordre dans lequel les dimensions de découpage sont
répertoriées dans la fonction.
•
•
•
•
•
Une dimension utilisée comme maître de section peut être spécifiée en
tant que dimension de découpage.
Toutes les dimensions de découpage doivent être présentes dans le bloc
ou dans l'en-tête de section du bloc dans lequel se trouve la fonction. Si
une dimension de découpage est supprimée ultérieurement du bloc, la
fonction renvoie l'erreur #CALCUL.
Si l'offset dépasse le nombre de lignes de la liste de valeurs de la
dimension de découpage, le résultat de la fonction est nul.
ValeurRelative ne peut être utilisé de façon récursive.
Vous devez toujours mettre les dimensions entre parenthèses, même si
la liste des dimensions de découpage ne contient qu'une entrée.
Exemples
La colonne ValeurRelative du tableau ci-dessous contient le formule suivante :
RelativeValue([Revenue];([Year]);-1)
208
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Dupont
2 000
2007
T3
Martin
1 500
2007
T4
Harris
3 000
2008
T1
Durand
4 000
1 000
2008
T2
Dupont
3 400
2 000
2008
T3
Martin
2 000
1 500
2008
T4
Harris
1 700
3 000
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 SAP BusinessObjects
Web Intelligence ou suivez le lien au bas de cette rubrique.
Rubriques associées
• #CALCUL
• Comparaison de valeurs à l'aide de la fonction ValeurRelative
NomRapport
Description
Renvoie le nom d'un rapport
Groupe de fonctions
Divers
Syntaxe
Chaîne NomRapport()
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
209
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Fonctions Web Intelligence
Exemples
Si NomRapport() est placé dans un rapport appelé "Rapport des ventes",
alors "Rapport des ventes" est renvoyé.
IndexationDesLignes
Description
Renvoie le numéro d'une ligne
Groupe de fonctions
Divers
Syntaxe
entier IndexationDesLignes()
Remarques
•
•
La numérotation des lignes commence à 0.
IndexationDesLignes renvoie #VALEURMULTI lorsqu'elle est placée
dans l'en-tête ou le pied de page d'un tableau.
Exemples
IndexationDesLignes renvoie 0 lorsqu'elle apparaît sur la première ligne
d'un tableau.
NomUniqueDe
Description
Renvoie le nom unique d'un objet
Groupe de fonctions
Divers
210
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Syntaxe
chaîne NomUniqueDe(obj)
Entrée
Paramètre
Description
Type
obj
Tout objet rapport Objet rapport
Obligatoire
Oui
Exemples
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.
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".
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
211
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Opérateurs conditionnels
Les opérateurs conditionnels déterminent le type de comparaison à effectuer
entre des valeurs.
Opérateur
Description
=
Egal à
>
Supérieur à
<
Inférieur à
>=
Supérieur ou égal à
<=
Inférieur ou égal à
<>
Différent de
Vous utilisez les opérateurs conditionnels avec la fonction Si, comme dans :
If [Revenue]>10000 Then "High" Else "Low"
qui renvoie "Elevé" pour toutes les lignes où le revenu est supérieur ou égal
à 10 000 et "Bas" pour toutes les autres lignes.
Opérateurs logiques
Les opérateurs logiques Web Intelligence sont Et, Ou, Pas, Entre et Dan
sListe. Les opérateurs logiques sont utilisés dans des expressions
booléennes qui renvoient Vrai ou Faux.
212
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
And (opérateur)
Description
L'opérateur Et relie des valeurs booléennes. Si toutes les valeurs booléennes
reliées par Et renvoient Vrai, la combinaison de toutes les valeurs renvoie
également Vrai.
Syntaxe
valeur_bool Et valeur_bool [Et valeur_bool...]
Exemples
Si [Lieu de séjour] = "Bahamas Beach" Et [Chiffre d'af
faires]>100 000 Alors "CA élevé de Bahamas" renvoie "Revenu
élevé Bahamas" si [Lieu de séjour] = "Bahamas Beach" Et [Chiffres
d'affaires]>100 000.
Ou (opérateur)
Description
L'opérateur Ou relie les valeurs booléennes. Si une valeur booléenne reliée
par Ou renvoie Vrai, la combinaison de toutes les valeurs renvoie également
Vrai.
Syntaxe
valeur_bool Ou valeur_bool [Ou valeur_bool...]
Exemples
Si [Lieu de séjour] = "Bahamas Beach" Ou [Lieu de sé
jour]="Hawaiian Club" Alors "Etats-Unis" Sinon "France"
renvoie "Etats-Unis" si [Lieu de séjour]="Bahamas Beach" ou "Hawaiian
Club", et renvoie "France" dans les autres cas.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
213
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Pas (not x)
Description
L'opérateur Non renvoie l'inverse d'une valeur booléenne.
Syntaxe
booléen Non(valeur_bool)
Exemples
Si Non([Pays] = "Etats-Unis") Alors "Pas Etats-Unis"
renvoie "Pas Etats-Unis" si [Pays] a une valeur autre que "Etats-Unis".
Opérateur Entre
Description
L'opérateur Entre détermine si une variable est comprise entre deux valeurs.
Syntaxe
booléen Entre(première_valeur;seconde_valeur)
Remarques
•
•
Vous pouvez utiliser Entre avec la fonction Si et l'opérateur Où.
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.)
Exemples
Si [Chiffre d'affaires] Entre(800000;900000) Alors "Reve
nu moyen" renvoie "Revenu moyen" si [Chiffres d'affaires] est compris entre
800 000 et 900 000.
214
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
[Chiffre d'affaires] Entre (10000;20000) renvoie Vrai si le
chiffre d'affaires est compris entre 10 000 et 20 000.
Si ([Chiffre d'affaires] Entre (200000;500000);"Revenu
moyen";"Revenu bas/élevé") renvoie "Revenu moyen" si [Chiffre
d'affaires] est égal à 300 000.
Rubriques associées
• Si...Alors...Sinon
• Opérateur Où
DansListe (opérateur)
Description
L'opérateur DansListe détermine si une valeur fait partie d'une liste de
valeurs.
Syntaxe
booléen valeur_test DansListe(liste_valeurs)
Remarques
C'est la combinaison de valeur_test et de DansListe qui renvoie une
valeur booléenne, et non DansListe seul.
Exemples
Si Non ([Pays] DansListe("Angleterre";"Ecosse";"Pays de
Galles")) Alors "Pas Grande Bretagne" Sinon "Grande Bre
tagne" renvoie "Pas Grande Bretagne" si [Pays] n'est pas égal à
"Angleterre", "Ecosse" ou "Pays de Galles", et renvoie "Grande Bretagne"
dans le cas contraire.
Si [Lieu de séjour] DansListe("Bahamas Beach";"Hawaiian
Club") Alors "Lieu de séjour Etats-Unis" renvoie "Lieu de
séjour Etats-Unis" si [Lieu de séjour] est égal à "Bahamas Beach" ou
"Hawaiian Club".
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
215
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Rubriques associées
• Si...Alors...Sinon
• Opérateur Où
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
L'opérateur Tout invite la fonction AucunFiltre à ignorer tous les filtres
ou la fonction Nombre à compter toutes les valeurs, y compris les doublons.
Rubriques associées
• Nombre
• Opérateurs Distinct/Tout
• AucunFiltre
• Opérateurs Tout/Exploration
Opérateurs Tout/Exploration
Description
Les opérateurs Tout/Exploration détermine quels sont les filtres ignorés
par la fonction AucunFiltre.
•
•
•
216
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
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Opérateurs Derniers/Premiers
Description
Les opérateurs Derniers/Premiers indiquent à la fonctionClassement
de classer par ordre croissant ou décroissant.
• Premiers : établit un classement par ordre décroissant
• Derniers : établit un classement par ordre croissant
Exemples
Classement([Chiffres d'affaires];([Pays]);Premiers classe
les pays par ordre décroissant de chiffre d'affaires.
Rubriques associées
• Classement
Opérateur Rupture
Description
L'opérateur Rupture invite la fonction Pourcentage à prendre en compte
les ruptures de tableau.
Exemples
La formule Pourcentage([Chiffre d'affaires]) donne le résultat
indiqué dans le tableau suivant (les pourcentages sont calculés sur le chiffre
d'affaires total du bloc) :
Année
Trimestre
Chiffre d'affaires
Pourcentage
2005
T1
10 000
10 %
2005
T2
20 000
20 %
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
217
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
2006
T1
30 000
30 %
2006
T2
40 000
40 %
La formule Pourcentage([Chiffre d'affaires];Rupture) donne
le résultat indiqué dans le tableau suivant (les pourcentages sont calculés
sur le chiffre d'affaires total de chaque partie du bloc) :
Année
Trimestre
Chiffre d'affaires
Pourcentage
2005
T1
10 000
33,3 %
2005
T2
20 000
66,6 %
2006
T1
30 000
42,9%
2006
T2
40 000
57,1%
Rubriques associées
• Pourcentage
Opérateurs Distinct/Tout
Les opérateurs Distinct/Tout indiquent à la fonction Nombre de compter
les valeurs distinctes uniquement ou toutes les valeurs.
Exemples
Nombre([Chiffre d'affaires];Distinct) renvoie 3 si [Chiffre
d'affaires] a les valeurs (5;5;6;4).
Nombre([Chiffre d'affaires];Tout) renvoie 4 si [Chiffre d'affaires]
a les valeurs (5;5;6;4).
218
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Rubriques associées
• Nombre
Opérateur InclureVide
Description
L'opérateur InclureVide invite certaines fonctions d'agrégat à inclure des
valeurs vides dans les calculs.
Exemples
Moyenne([Chiffre d'affaires];InclureVide) renvoie 3 si [Chiffre
d'affaires] a les valeurs (5;3;<vide>;4).
Rubriques associées
• Moyen
• Nombre
• MoyenneCumulative
• NombreCumulatif
Opérateur Index
Description
L'opérateur Index indique aux fonctions RéponseUtilisateur et Répo
nseUtilisateurValeurDeRéférence de renvoyer la clé primaire de
base de données de la réponse d'invite.
Rubriques associées
• RéponseUtilisateur
• RéponseUtilisateurValeurRéf
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
219
5
5
Fonctions, opérateurs et mots clés Web Intelligence
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
• Interpolation
Opérateur NonNul
Description
L'opérateur NonNul invite la fonction Précédent à ignorer les valeurs nulles.
Lorsque Précédent est utilisé avec NonNul, il renvoie la première valeur
non nulle de l'objet, en remontant à partir des lignes offset de la cellule
située avant la ligne actuelle.
Rubriques associées
• Précédent
Opérateur PasSurSaut
Description
L'opérateur PasSurSaut invite la fonction Interpolation à ignorer les
ruptures de section et de bloc.
Rubriques associées
• Interpolation
220
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Opérateur PointAPoint
Description
L'opérateur PointAPoint stipule que la fonction Interpolation doit
utiliser l'interpolation de point à point pour donner les valeurs d'indicateur
manquantes.
L'interpolation de point à point calcule les valeurs manquantes en calculant
une équation de droite de type f(x) = ax + b qui passe par les deux valeurs
adjacentes à la valeur manquante.
Rubriques associées
• Interpolation
Opérateurs Ligne/Col
Description
Vous pouvez utiliser les opérateurs Ligne/Col pour définir le sens du calcul
des fonctions suivantes : Pourcentage, MoyenneCumulative, Nombre
Cumulatif, MaxCumulatif, MinCumulatif, ProduitCumulatif, So
mmeCumulative.
Remarques
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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
221
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Exemples
Dans un tableau croisé, Pourcentage([Indicateur]) donne le résultat
suivant :
Indicateur
Pourcentage
Indicateur
Pourcentage
100
10 %
500
50 %
200
20 %
200
20 %
Pourcentage([Indicateur];Ligne) donne le résultat suivant :
Indicateur
Pourcentage
Indicateur
Pourcentage
100
16,7 %
500
83,3 %
200
50 %
200
50 %
Pourcentage([Indicateur];Col) donne le résultat suivant :
Indicateur
Pourcentage
Indicateur
Pourcentage
100
33,3 %
500
83,3 %
200
66,6 %
200
16,7 %
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.
Dans un tableau croisé, SommeCumulative([indicateur]) ou Somme
Cumulative([indicateur];Ligne) donne le résultat suivant :
Indicateur
222
SommeCumula
tive
Indicateur
SommeCumulative
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
100
100
200
300
400
700
250
950
Dans un tableau croisé, SommeCumulative([Indicateur];Col) donne
le résultat suivant :
Indicateur
SommeCumula
tive
Indicateur
SommeCumulative
100
100
200
700
400
500
250
950
Rubriques associées
• Pourcentage
• MoyenneCumulative
• NombreCumulatif
• MaxCumulatif
• MinCumulatif
• ProduitCumulatif
• SommeCumulative
Opérateur Auto
Description
Fait référence à la fonction Précédent pour la cellule précédente si celle-ci
ne contient pas d'objet de rapport.
Exemples
5 +
Précédent(Auto) renvoie la séquence 5, 10, 15, 20, 25, 30...
1 + 0,5 * Précédent(Auto) renvoie la séquence 1, 1,5, 1,75, 1,88...
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
223
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Rubriques associées
• Précédent
Opérateur Où
Description
L'opérateur Où limite les données utilisées pour calculer un indicateur.
Exemples
La formule Moyenne ([Chiffre d'affaires]) Où ([Pays] =
"USA") calcule les ventes moyennes où le pays est "USA".
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.
Rubriques associées
• And (opérateur)
• Opérateur Entre
• DansListe (opérateur)
• Ou (opérateur)
• Pas (not x)
224
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
Opérateurs de syntaxe avancée
Vous spécifiez explicitement les contextes d'entrée et de sortie avec les
opérateurs contextuels. Le tableau suivant répertorie les opérateurs
contextuels :
Opérateur
Description
Dans
Spécifie une liste explicite de dimensions à utiliser dans le contexte
PourChaque
Ajoute des dimensions au contexte par
défaut
PourTout
Supprime des dimensions du contexte
par défaut
Les opérateurs PourTout et PourChaque sont pratiques lorsqu'un contexte
par défaut contient de nombreuses dimensions. Il est souvent plus facile
d'effectuer un ajout ou un retrait du contexte avec les opérateurs PourTout
et PourChaque que de spécifier explicitement la liste avec Dans.
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 SAP BusinessObjects Web Intelligence
225
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
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])
226
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
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
Revenu des ventes
Revenu trimestriel max.
2001
8 096 123,60
2 660 699,50
2002
13 232 246,00
4 186 120,00
2003
15 059 142,80
4 006 717,50
Il est possible de créer une formule pour la colonne Revenu trimestriel
maximum n'incluant pas l'opérateur PourChaque :
Max ([Sales Revenue] In ([Year];[Quarter])) In ([Year])
Si vous optez pour l'opérateur contextuel PourChaque, vous pouvez obtenir
le même résultat avec la formule suivante :
Max ([Sales Revenue] ForEach ([Quarter])) In ([Year])
Pourquoi ? Parce que la dimension Année est le contexte d'entrée par défaut
du bloc. En vous servant de l'opérateur PourChaque, vous ajoutez la
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
227
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Opérateurs de fonction et de formule Web Intelligence
dimension Trimestre au contexte, en donnant le contexte d'entrée
([Année];[Trimestre]).
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.
228
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
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éNon applicable
rieur d'un bloc)
A l'extérieur des blocs ou sections
Non applicable
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
229
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
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 :
230
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
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éToutes les données de la section
rieur d'un bloc)
A l'extérieur des blocs ou sections
Toutes les données du rapport
Exemple : Mot clé Corps
Vous disposez d'un rapport présentant les valeurs Année, Trimestre et
Revenu des ventes, avec une rupture sur Année. Le rapport contient une
section basée sur Année et une rupture au niveau de Trimestre.
Année
Trimestre
Revenu des ventes
Corps
2001
T1
2 660 700
2 660 699,5
T2
2 279 003
2 279 003
T3
1 367 841
1 367 840,7
T4
1 788 580
1 788 580,4
2001
8 096 123,6
La colonne Corps contient la formule
Sum ([Sales Revenue]) In Body
Les totaux de la colonne Corps sont égaux à ceux de la colonne Revenu
des ventes, car le mot clé Corps fait référence aux données du bloc. Si
vous deviez supprimer l'objet Mois, les chiffres de la colonne Bloc
changeraient pour correspondre aux chiffres modifiés de la colonne Revenu
des ventes. Si vous deviez placer la formule dans le pied de page du
rapport, elle renverrait le revenu total pour le bloc.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
231
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
Mot clé Saut
Le tableau ci-après décrit les dimensions auxquelles fait référence le mot
clé Saut, selon son emplacement dans un rapport :
Placé dans…
Fait référence à…
Un bloc
Toutes les données dans la partie du
bloc délimité par un saut
Un saut de bloc (en-tête ou pied)
Toutes les données dans la partie du
bloc délimité par un saut
Une section (en-tête, pied ou à l'extéNon applicable
rieur d'un bloc)
A l'extérieur des blocs ou sections
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
saut contient la formule :
Sum ([Sales Revenue]) In Break
Sans le mot clé Saut, cette colonne dupliquerait les chiffres de la colonne
Revenu des ventes, car le contexte de sortie par défaut ([Année];[Trimestre])
serait utilisé.
232
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
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…
Fait référence à…
Un bloc
Toutes les données du rapport
Une rupture de bloc (en-tête ou pied)
Toutes les données du rapport
Une section (en-tête, pied ou à l'extéToutes les données du rapport
rieur d'un bloc)
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
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
233
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Mots clés de la syntaxe avancée Web Intelligence
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…
Fait référence à…
Un bloc
Toutes les données de la section
Une rupture de bloc (en-tête ou pied)
Toutes les données de la section
Une section (en-tête, pied ou à l'extéToutes les données de la section
rieur d'un bloc)
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
234
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Fonctions, opérateurs et mots clés Web Intelligence
Comment Web Intelligence arrondit et tronque les nombres ?
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é.
Comment Web Intelligence arrondit et
tronque les nombres ?
Plusieurs fonctions de Web Intelligence contiennent un paramètre permettant
de déterminer le niveau auquel la fonction arrondit ou tronque la valeur qu'elle
renvoie. Ce paramètre accepte un nombre entier supérieur, égal ou inférieur
à 0.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
235
5
5
Fonctions, opérateurs et mots clés Web Intelligence
Comment Web Intelligence arrondit et tronque les nombres ?
Paramètre
>0
Description
La fonction arrondit/tronque à <paramètre> décimales.
Exemples :
Arrondi(3.13;1) renvoie 3,1
Arrondi(3.157;2) renvoie 3,16
0
La fonction arrondit/tronque à l'entier le plus proche.
Exemples :
Tronquer(3.7;0) renvoie 3
Tronquer(4.164;0) renvoie 4
<0
La fonction arrondit/tronque à la dizaine (paramètre = -1),
à la centaine (paramètre = -2), au millier (paramètre = -3),
etc., le plus proche.
Exemples :
Arrondi(123.76;-1) renvoie 120
Arrondi(459.9;-2) renvoie 500
Tronquer(1600;-3) renvoie 1000
Remarque :
Les nombres sont représentés de manière interne comme doubles et sont
précis à seize chiffres près.
Rubriques associées
• Arrondi
• Truncate
• ConvertirEnEuro
• ConvertirDepuisEuro
• ErreurEuroParArrondi
• ErreurEuroVersArrondi
236
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Dépannage des formules
Web Intelligence
6
6
Dépannage des formules Web Intelligence
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 en savoir plus, voir le guide Utilisation de
fonctions, de formules et de calculs dans SAP BusinessObjects
Web Intelligence .
Rubriques associées
• ValeurRelative
#CONTEXTE
#CONTEXTE apparaît dans un indicateur lorsque le contexte de celui-ci est
non existant.
#CONTEXTE est lié aux messages d'erreur #INCOMPATIBLE et
#SYNCDONNEES, qui apparaissent dans les dimensions lorsqu'un bloc
contient un contexte de calcul inexistant.
Dans le cas de l'erreur #INCOMPATIBLE, le contexte est inexistant car les
dimensions sont incompatibles ; dans le cas de l'erreur #SYNCDONNEES,
le contexte est inexistant car les dimensions proviennent de plusieurs
fournisseurs de données non synchronisés.
238
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
Exemple : Contexte de calcul non existant dans une requête
Si un bloc basé sur l'univers Océan Voyages contient les objets Année de
réservation et Revenu, le message d'erreur #CONTEXTE apparaît parce
qu'il n'est pas possible de regrouper le revenu par année de réservation.
(Les réservations n'ont pas encore généré de revenu.)
#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).
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
239
6
6
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
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.
#EXTERNE
#EXTERNE apparaît lorsqu'une formule fait référence à une fonction externe
non disponible dans Web Intelligence.
#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
240
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
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.
#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
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
241
6
6
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
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().
Exemple : Etablissement d'un classement de la moyenne cumulative ou
des valeurs précédentes
Si vous essayez de classer un bloc sur une colonne qui contient la fonction
Précédent() ou toute fonction d'agrégat 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é.
242
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
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.
#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.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
243
6
6
Dépannage des formules Web Intelligence
Messages d'erreur de formule et d'information
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.
#ERREUR
#ERREUR est le message d'erreur par défaut qui couvre toutes les erreurs
non couvertes par les autres messages d'erreur.
244
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à
l'aide des fonctions de
Web Intelligence
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
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
• Précédent
• ValeurRelative
• Comparaison de valeurs à l'aide de la fonction ValeurRelative
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
246
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
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.
Exemple :
Dans cet exemple, la colonne ValeurRelative contient la formule suivante :
RelativeValue([Revenue];([Year]);-1)
•
•
•
L'expression est [Chiffre d'affaires];
La dimension de découpage est [Année];
L'offset est -1 (la fonction renvoie la valeur située immédiatement avant
dans la liste).
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Dupont
2 000
2007
T3
Martin
1 500
2007
T4
Harris
3 000
2008
T1
Durand
4 000
1 000
2008
T2
Dupont
3 400
2 000
2008
T3
Martin
2 000
1 500
2008
T4
Harris
1 700
3 000
Exprimée 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)
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
247
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
dans la ligne où la valeur de [Année] (la dimension de découpage) est la
valeur précédente de la liste de valeurs de l'objet [Année] et où les valeurs
de [Trimestre] et de [Vendeur] (les dimensions de sous-axe) sont identiques
à celles de la ligne active.
Rubriques associées
• ValeurRelative
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.
Exemple : Dimensions de découpage multiples
Dans le tableau ci-dessous, la colonne ValeurRelative a la formule suivante :
RelativeValue([Revenue];([Year];[Quarter]);-1)
•
•
•
248
L'expression est [Chiffre d'affaires];
Les dimensions de découpage sont ([Année];[Trimestre]);
L'offset est -1 (la fonction renvoie la valeur située immédiatement avant
dans la liste).
Année
Trimestre
Vendeur
Chiffre d'affaires
2007
T1
Durand
1 000
2007
T2
Durand
2 000
2007
T3
Durand
1 500
2007
T4
Durand
3 000*
2007
T1
Dupont
4 000
ValeurRelative
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T2
Dupont
3 400
2007
T3
Dupont
2 000
2007
T4
Dupont
1 700
2008
T1
Durand
5 000**
3 000*
2008
T2
Durand
3 000***
5 000**
2008
T3
Durand
2 700****
3 000***
2008
T4
Durand
6 800
2 700****
Exprimée 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
Trimestre
2007
T1
2007
T2
2007
T3
2007
T4
*
2008
T1
**
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
249
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
Trimestre
2008
T2
***
2008
T3
****
2008
T4
L'ordre de tri des dimensions de découpage détermine le résultat de la
fonction. Dans les tableaux, l'ordre de tri est signalé par le signe *.
Rubriques associées
• ValeurRelative
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
250
Trimestre
Vendeur
Chiffre d'affaires ValeurRelative
T1
Durand
1 000
T2
Durand
2 000
T3
Durand
1 500
T4
Durand
3 000*
T1
Dupont
4 000
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Trimestre
Vendeur
Chiffre d'affaires ValeurRelative
T2
Dupont
3 400
T3
Dupont
2 000
T4
Dupont
1 700
Trimestre
Vendeur
Chiffre d'affaires ValeurRelative
T1
Durand
5 000**
3 000*
T2
Durand
3 000***
5 000**
T3
Durand
2 700 ****
3 000***
T4
Durand
6 800
2 700****
2008
Pour trouver la valeur comparative du chiffre d'affaires, Web Intelligence
utilise la liste de valeurs des dimensions de découpage :
Année
Trimestre
2007
T1
2007
T2
2007
T3
2007
T4
*
2008
T1
**
2008
T2
***
2008
T3
****
2008
T4
L'ordre de tri des dimensions de découpage détermine le résultat de la
fonction. Dans les tableaux, l'ordre de tri est signalé par le signe *.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
251
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Rubriques associées
• ValeurRelative
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)
252
Année
Trimestre
Vendeur
Chiffre d'affaires
2007
T1
Durand
1 000
2007
T2
Durand
2 000
2007
T3
Durand
1 500
2007
T4
Durand
3 000*
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T3
Dupont
2 000
2007
T4
Dupont
1 700
2008
T1
Durand
5 000**
ValeurRelative
3 000*
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2008
T2
Durand
3 000***
5 000**
2008
T3
Durand
2 700****
3 000***
2008
T4
Durand
6 800
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
Trimestre
2007
T1
2007
T2
2007
T3
2007
T4
*
2008
T1
**
2008
T2
***
2008
T3
****
2008
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 SAP BusinessObjects Web Intelligence
253
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Trimestre
Année
T1
2007
*
T1
2008
**
T2
2007
***
T2
2008
****
T3
2007
*****
T3
2008
******
T4
2007
*******
T4
2008
********
L'impact de l'ordre de tri sur le résultat de la fonction est le suivant :
254
Année
Trimestre
Vendeur
Chiffre d'affaires
2007
T1
Durand
1 000*
2007
T2
Durand
2 000***
2007
T3
Durand
1 500*****
2007
T4
Durand
3 000*******
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T3
Dupont
2 000
2007
T4
Dupont
1 700
2008
T1
Durand
5 000**
ValeurRelative
1 000*
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2008
T2
Durand
3 000****
2 000***
2008
T3
Durand
2 700******
1 500*****
2008
T4
Durand
6 800********
3 000*******
Exprimée 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
• ValeurRelative
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 SAP BusinessObjects Web Intelligence
255
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Année
Trimestre
Vendeur
Chiffre d'affaires
ValeurRelative
2007
T1
Durand
1 000
2007
T2
Durand
2 000
2007
T4
Durand
3 000
2007
T3
Durand
1 500*
2007
T1
Dupont
4 000
2007
T2
Dupont
3 400
2007
T4
Dupont
1 700
2007
T3
Dupont
2 000
2008
T1
Durand
5 000**
1 500*
2008
T2
Durand
3 000***
5 000**
2008
T4
Durand
6 800****
3 000***
2008
T3
Durand
2 700
6 800****
La liste triée des dimensions de découpage est la suivante :
Année
Trimestre
2007
T1
2007
T2
2007
T4
2007
T3
*
2008
T1
**
2008
T2
***
2008
T4
****
2008
T3
Dans les tableaux, l'ordre de tri est signalé par le signe *.
256
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
Rubriques associées
• ValeurRelative
Utilisation de ValeurRelative dans les tableaux
croisés
La fonction ValeurRelative fonctionne exactement de la même façon dans
les tableaux croisés et dans les tableaux verticaux. La présentation des
données dans un tableau croisé n'a pas d'incidence sur le résultat de la
fonction.
Rubriques associées
• ValeurRelative
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
257
7
7
Comparaison de valeurs à l'aide des fonctions de Web Intelligence
Comparaison de valeurs à l'aide de la fonction ValeurRelative
258
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Informations
supplémentaires
A
A
Informations supplémentaires
Ressources d'informations Emplacement
Informations sur le produit
SAP BusinessObjects
http://www.sap.com
Naviguez vers http://help.sap.com/businessobjects/ et cliquez sur Tous les produits dans le panneau latéral "Présentation de SAP BusinessObjects".
SAP Help Portal
Vous pouvez accéder à la toute dernière documentation
relative aux produits SAP BusinessObjects et à leur déploiement sur le portail SAP Help Portal. Il est également possible de télécharger des versions PDF ou des bibliothèques
HTML installables.
Certains guides résident sur SAP Service Marketplace et
ne sont, par conséquent, pas disponibles sur le portail SAP
Help Portal. Le portail d'aide répertorie ces guides et propose un lien vers SAP Service Marketplace. Les clients qui
bénéficient d'un contrat de maintenance disposent d'un ID
utilisateur pour accéder à ce site. Pour obtenir un identifiant,
contactez votre support technique.
http://service.sap.com/bosap-support > Documentation
•
•
SAP Service Marketplace
260
Guides d'installation : https://service.sap.com/bosap-inst
guides
Notes de version : http://service.sap.com/releasenotes
SAP Service Marketplace comprend certains guides d'installation, guides de migration et de mise à niveau, guides
de déploiement, notes de version et des documents concernant les plates-formes prises en charge. Les clients qui
bénéficient d'un contrat de maintenance disposent d'un ID
utilisateur pour accéder à ce site. Pour obtenir un identifiant,
contactez votre support technique. Si vous êtes redirigé
vers SAP Service Marketplace à partir du site SAP Help
Portal, utilisez le menu situé dans le panneau de navigation
à gauche pour sélectionner la catégorie contenant la documentation que vous souhaitez consulter.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Informations supplémentaires
Ressources d'informations Emplacement
https://cw.sdn.sap.com/cw/community/docupedia
Docupedia
Docupedia fournit des ressources de documentation supplémentaires, un environnement de création collaboratif et
un canal de commentaires interactif.
Ressources à l'attention des
développeurs
https://boc.sdn.sap.com/
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
https://www.sdn.sap.com/irj/boc/businessobjects-articles
Articles SAP BusinessObjects
sur SAP Community Network Ces articles étaient précédemment appelées notes tech
niques.
https://service.sap.com/notes
Remarques
Forums sur SAP Community
Network
Ces remarques étaient précédemment appelées des articles de la base de connaissances.
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Formation
Nous pouvons vous fournir un module de formation qui réponde à vos besoins et convienne à votre style d'apprentissage préféré, sous forme de stage traditionnel ou de séminaires plus ciblés.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
261
A
A
Informations supplémentaires
Ressources d'informations Emplacement
http://service.sap.com/bosap-support
Support client en ligne
Le site SAP Support Portal présente des informations sur
les programmes et services de support technique. Il propose également des liens vers de nombreuses informations
techniques ainsi que des téléchargements. Les clients qui
bénéficient d'un contrat de maintenance disposent d'un ID
utilisateur pour accéder à ce site. Pour obtenir un identifiant,
contactez votre support technique.
http://www.sap.com/services/bysubject/businessobjectsco
nsulting
Conseil
262
Les consultants peuvent vous accompagner dans votre
démarche, depuis la phase initiale d'analyse jusqu'à la
phase finale de livraison de votre projet de déploiement.
Ils peuvent vous faire bénéficier de leur expertise en ma
tière de bases de données relationnelles et multidimensio
nnelles, de connectivité, d'outils de conception de base de
données et de technologie d'intégration personnalisée.
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Index
Symboles
#CALCUL, message d'erreur 207, 238
#CLASSEMENT, message d'erreur 241
#CONTEXTE, message d'erreur 238, 239
#DEBORDEMENT, message d'erreur 241
#DIV/0, message d'erreur 239
#ERREUR, message d'erreur 165, 167, 169,
171, 186, 244
#EXTERNE, message d'erreur 240
#INCOMPATIBLE, message d'erreur 238, 239,
240
#INDISPONIBLE, message d'erreur 59, 243
et indicateurs intelligents 243
#RECURSIF, message d'erreur 242
#RESULTATPARTIEL, message d'erreur 241
et indicateurs intelligents 241
#SECURITE, message d'erreur 242
#SYNCDONNEES, message d'erreur 238, 239
#SYNTAXE, message d'erreur 243
#TOREFRESH, message d'erreur 53, 58, 243
et indicateurs intelligents 243
#VALEURMULTI, message d'erreur 210, 240
A
Abs, fonction 163
actualiser les données 53
afficher l'auteur de documents 144
afficher l'heure du dernier enregistrement d'un
document 147
afficher la date de création des documents 145
afficher la date du dernier enregistrement d'un
document 146
afficher le nombre de pages dans un rapport
201
afficher le numéro de ligne 210
afficher les noms d'univers 142
afficher les noms des diagrammes 187
afficher les noms des objets rapport 198
afficher les noms des tableaux 187
afficher les numéros de colonne 188
afficher les numéros de page 201
afficher les réponses aux invites 143
Année, fonction 128
appliquer un format aux nombres 98
Arrondi, fonction 182, 235
arrondir les nombres 163
arrondir les valeurs 235
Asc, fonction 93
ASCII, valeurs 93
renvoyer des caractères associés à 94
AucunFiltre, fonction 199, 216
AuteurDuDocument, fonction 144
Auto, opérateur 202, 223
avancée, syntaxe 22
modifier le contexte de calcul par défaut à
l'aide de 36
mot clé Bloc 44, 229
mot clé Corps 46, 230
mot clé Rapport 41, 47, 233
mot clé Saut 43, 232
mot clé Section 42, 234
opérateur Dans 37, 225
PourChaque (opérateur) 37, 39, 225, 227
PourTout (opérateur) 37, 40, 225, 228
Average, fonction
à l'aide de mots clés de syntaxe avancée
44, 229
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
263
Index
B
Bas, opérateur 179
Bloc, mot clé 44, 229
blocs
afficher les noms 187
booléennes, expressions
lier à l'opérateur Et 213
renvoyer l'opposé 214
booléennes, valeurs
identifier 156
tester 194, 196
C
calcul par défaut, contextes
dans les ruptures 35
dans les sections 34
dans les tableaux horizontaux 32
dans les tableaux verticaux 31
modifier à l'aide d'une syntaxe étendue 36
tableaux croisés 33
calcul standard par défaut 10
calculer des erreurs d'arrondi 169, 171
calculer le sinus d'un angle 183
calculer un centile 76
calculer un cosinus 164
calculer un écart type 88
calculer un écart type de population 89
calculer un factoriel 174
calculer un logarithme en base 10 177
calculer un logarithme en base n 176
calculer un logarithme naturel 175
calculer un maximum cumulatif 81
calculer un minimum cumulatif 83
calculer un mode 72
calculer un nombre cumulatif 79
calculer un pourcentage 15, 73
calculer un produit 76
calculer un produit cumulatif 84
calculer une fonction exponentielle 173
calculer une médiane 70
264
calculer une moyenne 62
calculer une moyenne cumulative 77
calculer une racine carrée 184
calculer une somme 90
calculer une somme cumulative 86
calculer une tangente 185
calculer une valeur maximum 69
calculer une valeur minimum 71
calculer une variance 91
calculer une variance de population 92
calculs
personnalisés 10
standard 10
calculs personnalisés 10
utiliser des formules pour créer 11
calculs personnalisés, créer à l'aide de formules
11
calculs standard 10
Capitale, fonction 99
CapitaleMot, fonction 113
Car, fonction 94
caractères
afficher depuis des valeurs ASCII 94
renvoyer les valeurs ASCII 93
cellules
inclure du texte dans 14
inclure les fonctions dans 14
centile 76
Centile, fonction 76
chaînes
identifier 159
chaînes de caractères
appliquer des règles d'encodage URL à 112
calculer la longueur 103
convertir en minuscules 104
extraire des sections de 110
faire correspondre à un modèle 105
joindre/concaténer 21, 95, 211
mettre en majuscules la première lettre de
99
mettre en majuscules les premières lettres
113
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Index
chaînes de caractères (suite)
mettre en majuscules toutes les premières
lettres dans 113
remplacer des parties 107
remplir avec d'autres chaînes 101, 108
renvoyer les caractères les plus à droite 107
renvoyer les caractères les plus à gauche
100
répéter 96
supprimer les espaces à droite 111
supprimer les espaces à gauche 102, 111
supprimer les espaces à la fin d'une chaîne
de caractères 109
transformer en majuscules 112
transformer en nombres 186
classement
et fonctions d'agrégat cumulatives 241
Classement, fonction 179, 217
classer les données 179
Col, opérateur 77, 81, 83, 84, 86, 221
colonnes
afficher les nombres 188
comparer les valeurs à l'aide de Précédent 246
comparer les valeurs à l'aide de RelativeValue
246, 248, 250, 252, 255, 257
Comparer, fonction 105
comptage, fonction 64
compter les lignes dans les tableaux 198
compter les valeurs 79
Concaténation, fonction 95
concaténer des chaînes de caractères 21, 95,
211
condition Si...Alors...Sinon 194
conditionnels, opérateurs 21, 212
Connexion, fonction 129
contexte d'entrée
définition 27
contexte de sortie
définition 28
contexte, opérateurs 22
contextes de calcul
contexte d'entrée 26, 27
contextes de calcul (suite)
contexte de sortie 26, 28
définition 26
et indicateurs intelligents 58
modifier à l'aide d'une syntaxe étendue 30
par défaut 30
convertir à partir d'euros 165
convertir en euros 167
ConvertirDepuisEuro, fonction 165, 235
ConvertirEnEuro, fonction 167, 235
Corps, mot clé 46, 230
Cos, fonction 164
cosinus 164
Count, fonction 218
CurrentDate, fonction 114
CurrentTime, fonction 114
D
Dans, opérateur 37, 225
DansListe, opérateur 22, 212, 215
DateCléFournisseurDonnées, fonction 130
DateDeLaDernièreExécution, fonction 135
DateDeLaValeurDeRéférence, fonction 140
DateDuDocument, fonction 146
DateRelative, fonction 123
dates
calculer les dates relatives 123
identifier 154
mettre en forme 97, 126
découpage, dimensions 246
et les sections 250
impact de l'ordre de tri 248, 252, 255
ordre 252
Dernier, fonction 68
DernierJourDeLaSemaine, fonction 119
DernierJourDuMois, fonction 118
Derniers, opérateur 217
devises
convertir entre devises européennes 165,
167
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
265
Index
devises européennes
convertir entre 165, 167
diagrammes
afficher les noms 187
dimensions
ajouter au contexte de calcul 39, 227
dimensions de découpage 246, 248
et message d'erreur #INCOMPATIBLE 240
et message d'erreur #SYNCDONNEES 239
et regroupements 57
spécifier dans le contexte de calcul 37, 225
supprimer du contexte de calcul 40, 228
DimTps 124
Distinct, opérateur 218
document, afficher les paramètres régionaux
190
document, paramètres régionaux
afficher 190
DocumentPartiellementActualisé, fonction 147
documents
afficher l'auteur 144
afficher l'heure du dernier enregistrement
147
afficher la date de création 145
afficher la date du dernier enregistrement
146
afficher le nom 146
visualiser les requêtes dans 150
données
actualiser 53
données de référence
renvoyer la date 140
Droite, fonction 107
DuréeDernièreExécution, fonction 136
E
écart type 88
écart type, population 89
EcartTypeP, fonction 89
Ecartype, fonction 88
266
Editeur de formule
afficher la syntaxe de la fonction dans 14
EnDate, fonction 126
EnNombre, fonction 186
Entre, opérateur 22, 212, 214
ErreurEuroParArrondi, fonction 169, 235
ErreurEuroVersArrondi, fonction 171, 235
erreurs
identifier 155
erreurs d'arrondi 169, 171
espaces à droite
supprimer des chaînes de caractères 109,
111
espaces à gauche
supprimer des chaînes de caractères 102,
111
EstChaîne, fonction 159
EstDate, fonction 154
EstErreur, fonction 155
EstHeure, fonction 160
EstLogique, fonction 156
EstNombre, fonction 158
EstNul, fonction 157
Et, opérateur 22, 212, 213
euros
convertir à partir de 165
convertir en 167
Exp, fonction 173
Exploration, opérateur 199, 216
F
Fact, fonction 174
factoriel 174
FiltreRapport, fonction 151
filtres
afficher les filtres d'exploration 216
afficher tout 216
bloc 152
et indicateurs intelligents 59
explorer 216
filtres d'exploration 59
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Index
filtres (suite)
rapport 151, 152, 216
section 152
sur les dimensions 59
filtres d'exploration 216
afficher 216
et indicateurs intelligents 59
ignorer 216
filtres de rapport 151, 216
ignorer 216
visualiser un résumé 152
filtres sur les dimensions
impact sur les indicateurs intelligents de 59
FiltresExploration, fonction 148
Floor, fonction 175
fonction exponentielle 173
fonction, syntaxe
affichage de Web Intelligence 14
exemple 14
fonctions
Abs 163
Année 128
Arrondi 182, 235
Asc 93
AucunFiltre 199, 216
AuteurDuDocument 144
Average 44, 62, 219, 229
Capitale 99
CapitaleMot 113
Car 94
catégories 62
Centile 76
Classement 179, 217
combiner avec du texte dans les cellules 14
Comparer 105
Concaténation 95
Connexion 129
ConvertirDepuisEuro 165, 235
ConvertirEnEuro 167, 235
Cos 164
DateActuelle 114
DateCléFournisseurDonnées 130
fonctions (suite)
DateDeCréationDuDocument 145
DateDeLaDernièreExécution 135
DateDeLaValeurDeRéférence 140
DateDuDocument 146
DateRelative 123
définition 13
Dernier 68
DernierJourDeLaSemaine 119
DernierJourDuMois 118
DocumentPartiellementActualisé 147
Droite 107
DuréeDernièreExécution 136
EcartTypeP 89
EnDate 126
EnNombre 186
ErreurEuroParArrondi 169, 235
ErreurEuroVersArrondi 171, 235
EstChaîne 159
EstErreur 155
EstHeure 160
EstLogique 156
EstNombre 158
exemples 15
Exp 173
Fact 174
FiltreRapport 151
FiltresExploration 148
Floor 175
fonction DateDeCréationDuDocument 145
fonction HeureDeCréationDuDocument 145
fonction HeureDeLaDernièreExécution 137
fonction Interpolation 220
fonction MaxCumulatif 221
fonction MinCumulatif 83, 221
fonction MoyenneCumulative 221
fonction NombreCumulatif 221
fonction Pourcentage 221
fonction ProduitCumulatif 221
fonction SommeCumulative 221
ForcerFusion 189
FormatDeDate 97
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
267
Index
fonctions (suite)
FormatDeNombre 98
FournisseurDeDonnées 129
Gauche 100
HeureDeCréationDuDocument 145
HeureDuDocument 147
HTMLEncode 99
Impair 161
IndexationDesLignes 210
insérer dans des cellules 14
Interpolation 66, 220, 221
IsDate 154
IsNull 157
JoursEntre 118
LégendeDateCléFournisseurDonnées 131
Ln 175
Log 176
Log10 177
Longueur 103
Majuscule 112
Max 39, 69, 227
MaxCumulatif 81, 221
Médiane 70
Min 71
MinCumulatif 83, 221
Minuscule 104
Mode 72
Modulo 178
Mois 120
MoisEntre 121
MoyenneCumulative 77, 219, 221
Nombre 64, 216, 218, 219
NombreCumulatif 79, 219, 221
NombreDeFournisseurs 138
NombreDeLignes 139
NombreDePages 201, 242
NomDe 198
NomDeUnivers 142
NomDuBloc 187
NomDuDocument 146
NomDuJour 115
NomRapport 209
268
fonctions (suite)
NomUniqueDe 210
NuméroDeColonne 188
NuméroDeLigne 198
NuméroDuJourDeAnnée 117
NuméroDuJourDeLaSemaine 116
NuméroDuJourDuMois 115
NuméroDuMoisDeAnnée 120
ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents
190
ObtenirParamètresRégionauxDeVisualisationPréférés 193
ObtenirParamètresRégionauxDeVisualisationPréférés,
fonction 193
ObtenirVariablesRégionalesDeContenu 190
ObtenirVarRég 191
ObtentionTraduction 192
Page 201
Pair 153
Plafond 163
Pos 106
Pourcentage 15, 73, 217, 221
Précédent 202, 220, 223, 241, 246
Premier 65
produit 76
ProduitCumulatif 84, 221
Puissance 178
Racine 184
Remplacer 107
RemplissageDroite 108
RemplissageGauche 101
Répéter 96
RéponseInvite 134
RéponseUtilisateur 15, 143, 219
RéponseUtilisateurValeurRéf 140, 219
RésuméFiltreRapport 152
RésuméInvite 149
RésuméRequête 150
Semaine 127
Si 21, 196, 212
Signe 183
Sin 183
Somme, fonction 90
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Index
FormatDeNombre, fonction 98
fonctions (suite)
formules
SommeCumulative 86, 221
créer des calculs personnalisés à l'aide de
SousChaîne 110
11
SQLDuFournisseur 132
et indicateurs intelligents 57
StdDev 88
indicateurs
Sum 15, 40, 41, 42, 43, 46, 47, 90, 228, 230, 232, 233,
234 intelligents dans 58
messages d'erreur générés par 238
SupprEspace 111
simplifier avec des variables 12, 19
SupprEspDroite 109
utiliser les opérateurs dans 21, 211
SupprEspGauche 102
FournisseurDeDonnées, fonction 129
syntaxe de la fonction 14
fournisseurs de données 138
Tan 185
afficher le nom de l'univers 142
Trimestre 122
afficher le nombre de lignes dans 139
Tronquer 235
visualiser le code SQL généré par 132
Truncate 186
TypeDuFournisseur 133
URLEncode 112
G
UtilisateurCourant 188
ValeurRéf 206
Gauche, fonction 100
ValeurRelative 207, 238, 246, 250, 252, 255, 257
guide des fonctions, formules et calculs,
Var 91
utilisation
VarP 92
à propos de 8
fonctions caractère
description 62
H
fonctions d'agrégat
description 62
heure, valeurs
fonctions d'agrégat cumulatives
identifier 160
et classement 241
HeureDeLaDernièreExécution,
fonction 137
et message d'erreur #CLASSEMENT 241
HeureDuDocument, fonction 147
fonctions de date et d'heure
HTMLEncode, fonction 99
description 62
fonctions diverses
description 62
fonctions document
description 62
fonctions du fournisseur de données
description 62
fonctions logiques
description 62
fonctions numériques
description 62
ForcerFusion, fonction 189
FormatDeDate, fonction 97
I
identifier des chaînes 159
identifier des dates 154
identifier des nombres 158
identifier les erreurs 155
identifier les nombres impairs 153, 161
identifier les nombres pairs 153, 161
identifier les valeurs booléennes 156
identifier les valeurs d'heure 160
identifier les valeurs nulles 157
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
269
Index
Impair, fonction 161
InclureVide, opérateur 219
Index, opérateur 143
IndexationDesLignes, fonction 210
indicateur, valeurs
interpoler 66, 220, 221
indicateurs
et contextes de calcul par défaut 30
indicateurs intelligents définis 52
renvoyer les valeurs précédentes 207
renvoyer les valeurs suivantes 207
indicateurs intelligents
définition 52
et calculs standards 10
et filtres d'exploration 59
et formules 57, 58
et message d'erreur #INDISPONIBLE 243
et message d'erreur #RESULTATPARTIEL
241
et message d'erreur #TOREFRESH 243
et opérateurs de contexte 58
et périmètre d'analyse 54
et regroupements 52
et variables 57
impact des filtres sur 59
impossibilité de calculer 243
individuelles, cellules
et message d'erreur #VALEURMULTI 240
InfoView
afficher les informations de connexion de
l'auteur d'un document 144
Interpolation, fonction 66, 220, 221
interpoler des valeurs d'indicateur 66, 220, 221
invites
afficher les réponses 15, 140, 143
J
joindre des chaînes de caractères 21, 95, 211
JoursEntre, fonction 118
270
L
LégendeDateCléFournisseurDonnées, fonction
131
Ligne, opérateur 77, 81, 83, 84, 86, 221
lignes
afficher le nombre de lignes dans le
fournisseur de données 139
afficher le numéro de ligne 210
compter dans les tableaux 198
compter les valeurs distinctes 216
compter toutes les valeurs 216
Linéaire, opérateur 66, 220
Ln, fonction 175
Log, fonction 176
Log10, fonction 177
logarithme naturel 175
logarithmes 175, 176, 177
logarithmes en base 10 177
logarithmes en base n 176
Longueur, fonction 103
M
Majuscule, fonction 112
mathématiques, opérateurs 21, 211
Max, fonction 69
utiliser avec les opérateurs de contexte 39,
227
MaxCumulatif, fonction 81
maximum, calcul standard 10
maximum, valeurs
calculer un maximum cumulatif 81
médian 70
Median, fonction 70
messages d'erreur
#CALCUL 207, 238
#CLASSEMENT 241
#CONTEXTE 238, 239
#DEBORDEMENT 241
#DIV/0 239
#ERREUR 165, 167, 169, 171, 186, 244
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Index
messages d'erreur (suite)
#EXTERNE 240
#INCOMPATIBLE 238, 239, 240
#INDISPONIBLE 59, 243
#RECURSIF 242
#RESULTATPARTIEL 241
#SECURITE 242
#SYNCDONNEES 238, 239
#SYNTAXE 243
#TOREFRESH 53, 58, 243
#VALEURMULTI 210, 240
messages d'erreur relatifs aux formules 238
Min, fonction 71
minimum, calcul standard 10
minimum, valeurs
calculer un minimum cumulatif 83
Minuscule, fonction 104
mode 72
Mode, fonction 72
Modulo, fonction 178
Mois, fonction 120
MoisEntre, fonction 121
mots clés
Bloc 44, 229
Corps 46, 230
mots clés de la syntaxe avancée 41, 229
rapport 41, 47, 233
rendre les rapports génériques avec 47
Saut 43, 232
Section 42, 234
moyenne
calculer une moyenne cumulative 77
moyenne, calcul standard 10
Moyenne, fonction 62, 219
MoyenneCumulative, fonction 77, 219
multiplier des nombres 76, 84
N
nombre cumulatif 79
nombre, calcul standard 10
nombre, calculer la valeur absolue 163
Nombre, fonction 216, 219
NombreCumulatif, fonction 79, 219
NombreDeFournisseurs, fonction 138
NombreDeLignes, fonction 139
NombreDePages, fonction 201
et message d'erreur #RECURSIF 242
nombres
arrondir 163, 182
arrondir à inférieur 175
arrondir les nombres 182
arrondir les nombres à inférieur 175
calculer un modulo 178
déterminer si impair ou pair 153, 161
diviser 178
élever à une puissance 178
identifier 158
mettre en forme 98
modulo 178
multiplier 76, 84
transformer des chaînes de caractères en
186
tronquer 186
tronquer des nombres 186
nombres impairs
identifier 153, 161
nombres pairs
identifier 153, 161
NomDe, fonction 198
NomDeUnivers, fonction 142
NomDuBloc, fonction 187
NomDuDocument, fonction 146
NomDuJour, fonction 115
NomRapport, fonction 209
NomUniqueDe, fonction 210
Non, opérateur 22, 212, 214
NonNul, opérateur 202, 220
nulles, valeurs
identifier 157
NuméroDeColonne, fonction 188
NuméroDeLigne, fonction 198
NuméroDuJourDeAnnée, fonction 117
NuméroDuJourDeLaSemaine, fonction 116
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
271
Index
NuméroDuJourDuMois, fonction 115
NuméroDuMoisDeAnnée, fonction 120
numéros de page
afficher dans les rapports 201
O
objets
afficher le nom 210
visualiser des filtres sur 151
ObtenirParamèresRégionauxDeVisualisationPréférésPrévalents,
Fonction 190
ObtenirVariablesRégionalesDeContenu,
fonction 190
ObtenirVarRég, fonction 191
ObtentionTraduction, fonction 192
opérateurs
Auto 202, 223
Bas 179
Col 77, 79, 81, 83, 84, 86, 221
conditionnels 21, 212
contexte 22
Dans 37, 225
DansListe 22, 212, 215
définition 21, 211
Derniers 217
Distinct 218
Entre 22, 212, 214
Et 22, 212, 213
Exploration 199, 216
InclureVide 79, 219
Index 143, 219
Ligne 77, 79, 81, 83, 84, 86, 221
Linéaire 66, 220
logiques 22, 212
mathématiques 21, 211
Non 22, 212, 214
NonNul 202, 220
opérateur Index 219
opérateurs spécifiques à la fonction 22, 216
Ou 22, 212, 213
Où 224
272
opérateurs (suite)
PasSurSaut 66, 220
PointAPoint 66, 221
PourChaque 39, 227
PourTout 40, 47, 228
Premiers 179, 217
Rupture 217
spécifiques à la fonction 22, 216
Tout 199, 216, 218
opérateurs logiques 22, 212
ordre de tri
et dimensions de découpage 248, 252, 255
Ou, opérateur 22, 212, 213
Où, opérateur 224
P
Page, fonction 201
pages
afficher le nombre de pages dans les
rapports 201
Pair, fonction 153
paramètres régionaux
afficher les paramètres régionaux de
document 190
afficher les paramètres régionaux de
visualisation préférés dominants 190
afficher les paramètres régionaux du produit
191
Paramètres régionaux de visualisation préférés
afficher 193
paramètres régionaux de visualisation préférés
dominants, afficher 190
paramètres régionaux de visualisation préférés,
afficher 193
paramètres régionaux de visualisation préférés,
dominants
afficher 190
PasSurSaut, opérateur 66, 220
périmètre d'analyse
et indicateurs intelligents 54
et regroupements 54
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
Index
Plafond, fonction 163
PointAPoint, opérateur 66, 221
Pos, fonction 106
pourcentage, calcul standard 10
Pourcentage, fonction 15, 73
PourChaque, opérateur 39, 227
PourTout, opérateur 40, 47, 228
Précédent, fonction 202, 220, 223
comparer des valeurs 246
et message d'erreur #CLASSEMENT 241
Premier, fonction 65
Premiers, opérateur 179, 217
produit, afficher les paramètres régionaux 191
Produit, fonction 76
produit, paramètres régionaux
afficher 191
ProduitCumulatif, fonction 84
produits
calculer un produit cumulatif 84
propriétés de requête
Nombre max. de lignes extraites 241
Puissance, fonction 178
R
racine carrée 184
Racine, fonction 184
Rapport, mot clé 41, 47, 233
rapports
afficher le nombre de pages dans 201
afficher les noms des objets dans 198
afficher les numéros de page dans 201
visualiser les noms 209
regroupements 52
définition 52
et opérateur UNION 54
et périmètre d'analyse 54
exemple de gestion de 54
gestion dans Web Intelligence 53
Remplacer, fonction 107
RemplissageDroite, fonction 108
RemplissageGauche, fonction 101
Répéter, fonction 96
RéponseInvite, fonction 134
RéponseUtilisateur, fonction 15, 143, 219
RéponseUtilisateurValeurRéf, fonction 140, 219
requêtes
visualiser un résumé 150
RésuméFiltreRapport, fonction 152
RésuméInvite, fonction 149
RésuméRequête, fonction 150
Rupture, opérateur 217
ruptures
contextes de calcul par défaut dans 35
S
Saut, mot clé 43, 232
Section, mot clé 42, 234
sections
contextes de calcul par défaut dans 34
et dimensions de découpage 250
et la fonction ValeurRelative 250
Semaine, fonction 127
Si, fonction 21, 196, 212
Signe, fonction 183
simplifier des formules avec des variables 12,
19
Sin, fonction 183
sinus 183
somme, calcul standard 10
Somme, fonction 15
à l'aide de mots clés de syntaxe avancée
41, 42, 43, 46, 47, 230, 232, 233, 234
utiliser avec les opérateurs de contexte 40,
228
SommeCumulative, fonction 86
SousChaîne, fonction 110
SQL 132
et actualisation des données 53
et regroupements 52, 53
opérateur GROUPING SETS 54
UNION, opérateur 52, 54
SQLDuFournisseur, fonction 132
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
273
Index
SupprEspace, fonction 111
SupprEspDroite, fonction 109
SupprEspGauche, fonction 102
syntaxe avancée, mots clés 41, 229
rendre les rapports génériques avec 47
utiliser avec la fonction Moyenne 44, 229
utiliser avec la fonction Somme 41, 42, 43,
46, 230, 232, 233, 234
syntaxe de la fonction, afficher 14
U
T
V
tableaux
afficher les noms 187
compter les lignes dans 198
horizontaux 32
verticaux 31
tableaux croisés
contextes de calcul par défaut dans 33
et la fonction ValeurRelative 257
tableaux horizontaux
contextes de calcul par défaut dans 32
Tan, fonction 185
tangentes 185
tester les valeurs booléennes 194, 196
Tout, opérateur 199, 216, 218
Trimestre, fonction 122
tris
et dimensions de découpage 248, 252, 255
tronquer les valeurs 235
Tronquer, fonction 235
Truncate, fonction 186
TypeDuFournisseur, fonction 133
ValeurRéf, fonction 206
ValeurRelative, fonction 207
comparer des valeurs 246, 248, 250, 252,
255, 257
et dimensions de découpage 248, 250, 255
et les sections 250
et message d'erreur #CALCUL 238
et tableaux croisés 257
valeurs
arrondir 235
comparer à l'aide de Précédent 246
comparer à l'aide de RelativeValue 246,
248, 250, 252, 255, 257
compter 64, 79
tronquer 235
Var, fonction 91
variables
et indicateurs intelligents 57
simplifier les formules avec 12, 19
variance 91
variance, population 92
VarP, fonction 92
vertical, tableau
contextes de calcul par défaut dans 31
274
UNION, opérateur 54
univers
afficher les noms 142
URL
appliquer des règles d'encodage à 112
URLEncode, fonction 112
UtilisateurCourant, fonction 188
Utilisation de fonctions, formules et calculs dans SAP BusinessObjects Web Intelligence
">