Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemple
Tronquer(3.423;2) renvoie 3,42
Fonctions diverses
NomDuBloc
Description
Renvoie le nom d'un bloc
Groupe de fonctions
Divers
Syntaxe
chaîne NomDuBloc()
Entrée
Aucune
Sortie
Le nom du bloc où la fonction est placée.
Exemple
Si
NomDuBloc est placé dans un bloc appelé "Bloc1", "Bloc1" est renvoyé.
NuméroDeColonne
Description
Renvoie le numéro de la colonne d'un tableau
172 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeColonne()
Entrée
Aucune
Sortie
Le numéro de la colonne
Exemples
NuméroDeColonne() renvoie 2 si la formule est placée dans la deuxième colonne d'un tableau
UtilisateurCourant
Description
Renvoie l'identification InfoView de l'utilisateur actuel
Groupe de fonctions
Divers
Syntaxe
chaîne UtilisateurCourant()
Entrée
Aucune
Sortie
L'utilisateur courant
Utilisation de fonctions, formules et calculs dans Web Intelligence 173
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemple
UtilisateurActuel() renvoie "gkn" si la connexion InfoView de l'utilisateur actuel est "gkn"
ForcerFusion
Description
Force Web Intelligence à tenir compte des dimensions synchronisées pour les calculs d'indicateur lorsque les dimensions synchronisées n'apparaissent pas dans le contexte du calcul.
Groupe de fonctions
Divers
Syntaxe
numérique ForcerFusion([indicateur])
Entrée
indicateur Tout indicateur
Sortie
Résultat du calcul tenant compte des dimensions synchronisées
Exemple
ForcerFusion([Chiffre d'affaires]) renvoie la valeur de Chiffre d'affaires en tenant compte des dimensions synchronisées qui n'apparaissent pas dans le même bloc que l'indicateur [Chiffre d'affaires].
Remarques
• Appliqué à un indicateur intelligent,
ForcerFusion renvoie
#VALEURMULTI car le groupe nécessaire pour calculer l'indicateur intelligent n'existe pas.
174 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
• La fonction
ForcerFusion de Web Intelligence est l'équivalent de la fonction
MultiCube de BusinessObjects/Desktop Intelligence.
ObtenirVariablesRégionalesDeContenu
Description
Renvoie les paramètres régionaux du document
Groupe de fonctions
Divers
Syntaxe
chaîne ObtenirVariablesRégionalesDeContenu()
Entrée
Aucune
Sortie
Les variables régionales de contenu du document
Exemple
ObtenirVariablesRégionalesDeContenu() renvoie "fr_FR" si les variables régionales de contenu correspondent à "Français (France)"
ObtenirVarRég
Description
Renvoie les variables régionales actuelles
Groupe de fonctions
Divers
Utilisation de fonctions, formules et calculs dans Web Intelligence 175
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Syntaxe
chaîne ObtenirVarRég()
Entrée
Aucune
Sortie
Les variables régionales actuelles
Exemple
ObtenirVarRég() renvoie "en_US" si les variables régionales actuelles correspondent à "en_US"
Si
Description
Renvoie une valeur basée sur le fait qu'une expression est vraie ou fausse
Groupe de fonctions
Divers
Syntaxe
Si expression_booléenne Alors expression_vraie {Sinon expres sion_fausse | SinonSi expression_booléenne Alors expres sion_vraie Sinon expression_fausse}
Entrée
expression_booléenne expression_vraie
Une expression qui renvoie vrai ou faux
L'expression dont la valeur est renvoyée si expression_booléenne est vraie
176 Utilisation de fonctions, formules et calculs dans Web Intelligence
expression_fausse
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
L'expression dont la valeur est renvoyée si expression_booléenne est fausse
Sortie
La valeur de expression_vraie ou expression_fausse
Exemples
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" renvoie "CA
élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et aucune valeur pour les autres lignes.
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" Sinon
[Chiffre d'affaires] renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et la valeur du chiffre d'affaires pour les autres lignes.
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" Sinon "CA faible" renvoie "CA élevé" pour toutes les lignes dont le chiffre d'affaires dépasse 1 000 000 et "CA faible" pour toutes les lignes dont le chiffre d'affaires est inférieur à 1 000 000.
Si [Chiffre d'affaires] >1 000 000 Alors "CA élevé" SinonSi
[Chiffre d'affaires] > 800 000 Alors "CA moyen" Sinon "CA faible" renvoie "CA élevé" pour toutes les lignes dont le revenu dépasse
1 000 000, "CA moyen" pour toutes les lignes dont le chiffre d'affaires est compris entre 800 000 et 1 000 000 et "CA faible" pour toutes les autres lignes.
Remarques
• expression_vraie et expression_fausse peuvent combiner des types de données (voir deuxième exemple ci-dessus) sauf lorsqu'il s'agit de données numériques ou de type date/heure. Si la formule combine des données numériques et de type date/heure, elle renvoie #TYPEDON
NEES.
• Vous pouvez mettre expression_booléenne
, expression_vraie et ex pression_fausse entre parenthèses.
Utilisation de fonctions, formules et calculs dans Web Intelligence 177
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
• Vous pouvez utiliser les opérateurs booléens (ET, Entre, DansListe, OU et PAS) avec la fonction Si.
• Web Intelligence prend toujours en charge la syntaxe d'origine de la fonction Si. Voir le lien ci-dessous pour en savoir plus.
Rubriques associées
•
page 193
•
page 194
•
page 195
•
page 193
•
page 194
NuméroDeLigne
Description
Renvoie le numéro de ligne dans un tableau
Groupe de fonctions
Divers
Syntaxe
entier NuméroDeLigne()
Entrée
Aucune
Sortie
Le numéro de ligne
Exemple
NuméroDeLigne() renvoie 2 lorsque la fonction apparaît au niveau de la deuxième ligne d'un tableau
178 Utilisation de fonctions, formules et calculs dans Web Intelligence
NomDe
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Remarque
La numérotation des lignes d'un tableau commence par l'en-tête, qui est la ligne 1.
Description
Renvoie le nom d'un objet
Groupe de fonctions
Divers
Syntaxe
chaîne NomDe([objet])
Entrée
[objet] Tout objet
Sortie
Le nom de l'objet
Exemple
NomDe([Date de réservation]) renvoie "Date de réservation"
Remarque :
Web Intelligence utilise la fonction NomDe() dans les en-têtes de colonne et de ligne des rapports
Utilisation de fonctions, formules et calculs dans Web Intelligence 179
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
AucunFiltreExploration
Description
Ignore les filtres d'exploration lors d'un calcul.
Groupe de fonctions
Divers
Syntaxe
type_sortie_expression AucunFiltreExploration(expression)
Entrée
expression Toute expression
Sortie
Le résultat de l'expression, sans tenir compte des filtres d'exploration.
AucunFiltre
Description
Indique à Web Intelligence d'ignorer les filtres lors du calcul d'une expression
Groupe de fonctions
Divers
Syntaxe
type_sortie_expression AucunFiltre(expression;[Tout|Ex ploration])
180 Utilisation de fonctions, formules et calculs dans Web Intelligence
Entrée
expression
Tout/Exploration (facultatif)
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Toute expression
• Non spécifié : ignorer les filtres de rapport et de bloc
• Tout : ignorer tous les filtres
• Exploration : ignorer les filtres de rapport et les filtres d'exploration
Sortie
Le résultat de l'expression, sans tenir compte des filtres
Exemples
Lorsque
AucunFiltre(Somme([Chiffre d'affaires])) est placé dans un pied de bloc, le chiffre d'affaires total de toutes les lignes du bloc est renvoyé, même si certaines lignes sont exclues du bloc.
AucunFiltre(Somme([Chiffre d'affaires]);Tout) renvoie la somme du chiffre d'affaires de tous les pays, y compris la France, même si un filtre exclut la France du rapport.
AucunFiltre(Somme([Chiffre d'affaires]);Exploration) renvoie la somme du chiffre d'affaires de tous les pays, même si un filtre d'exploration filtre la dimension [Pays].
Remarques
•
AucunFiltre (expression;Exploration) ne fonctionne pas en mode d'exploration de requête car les filtres d'exploration sont ajoutés à la requête, et non appliqués aux données de rapport.
• Si vous quittez le mode d'exploration lorsque des filtres d'exploration sont activés, ces derniers deviennent des filtres de rapport et peuvent modifier la valeur des expressions auxquelles
AucunFiltre(expression;Ex ploration) est appliqué.
Utilisation de fonctions, formules et calculs dans Web Intelligence 181
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
NombreDePages
Description
Renvoie le nombre de pages dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier NombreDePages()
Sortie
Le nombre de pages dans le rapport
Exemple
NombreDePages() renvoie 2 si le rapport contient deux pages.
Page
Description
Renvoie le numéro de la page actuelle dans un rapport
Groupe de fonctions
Divers
Syntaxe
entier Page()
Sortie
Numéro de la page actuelle.
182 Utilisation de fonctions, formules et calculs dans Web Intelligence
Précédent
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Exemple
Page() renvoie 2 s'il apparaît dans la deuxième page du rapport
Description
Renvoie une valeur précédente d'un objet
Groupe de fonctions
Divers
Syntaxe
tout_type Précédent(objet|Auto;{dimensions_redéfinies}; {off set};{NonNul})
Entrée
objet
| Auto dimensions_redéfinies offset
NonNul
Un objet quelconque, ou le mot clé
Auto
La liste des dimensions utilisées pour réinitialiser le calcul (facultatif)
Le nombre de lignes précédant la ligne actuelle (facultatif)
Demande à la fonction de renvoyer la première valeur non nulle à partir de l'offset (facultatif)
Sortie
La valeur des lignes offset de l'objet avant la ligne actuelle
Utilisation de fonctions, formules et calculs dans Web Intelligence 183
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemples
Précédent([Pays)];1) renvoie les valeurs suivantes dans le tableau qui suit :
Précédent Pays
Etats-Unis
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
Etats-Unis
Royaume-Uni
Précédent([Chiffre d'affaires)]) renvoie les valeurs suivantes dans le tableau qui suit :
Précédent Pays
Etats-Unis
Royaume-Uni
France
Chiffre d'affaires
5 000 000
2 000 000
2 100 000
5 000 000
2 000 000
Précédent([Chiffre d'affaires];([Pays]) renvoie les valeurs suivantes dans le tableau qui suit :
Pays
Etats-Unis
Royaume-Uni
Région
Nord
Sud
Nord
Sud
Chiffre d'affaires Précédent
5 000 000
7 000 000 5 000 000
3 000 000
4 000 000 3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau croisé qui suit :
184 Utilisation de fonctions, formules et calculs dans Web Intelligence
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
France
2004
Etats-Unis 5 000 000
Royaume-Uni 2 000 000
3 000 000
Précédent 2005
6 000 000
2 500 000
2 000 000
Précédent
5 000 000
2 000 000
3 000 000
Précédent([Chiffre d'affaires]) renvoie les valeurs suivantes dans le tableau qui suit avec une rupture sur [Pays] :
Pays
Etats-Unis
Etats-Unis
Région
Nord
Sud
Chiffre d'affaires Précédent
5 000 000
7 000 000
12 000 000
5 000 000
Pays
Royaume-Uni
Région
Nord
Sud
Royaume-Uni
Chiffre d'affaires Précédent
3 000 000 7 000 000
4 000 000
7 000 000
3 000 000
12 000 000
Précédent([Chiffre d'affaires]);2;NonNul) renvoie les valeurs suivantes dans le tableau qui suit :
Année
2008
2008
Trimestre
T1
T2
Chiffre d'affaires Précédent
500
2008 T3 400 500
Utilisation de fonctions, formules et calculs dans Web Intelligence 185
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
2008
2008
2008
2008
2008
T4
T1
T2
T3
T4
700
300
200
500
400
700
300
300
2*Précédent(Auto) renvoie la séquence 2, 4, 6, 8, 10...
Remarques
• La valeur par défaut d' offset est 1.
Précédent([Chiffre d'af faires];1) et
Précédent ([Chiffre d'affaires]) sont identiques du point de vue fonctionnel.
• Lorsque l'argument
NonNul est inclus, Web Intelligence renvoie la première valeur non nulle de l'objet en remontant à partir des lignes offset de la cellule situées avant la ligne actuelle.
• Vous pouvez utiliser la syntaxe étendue des opérateurs contextuels avec
Précédent
.
• L'opérateur
Auto permet de faire référence à la valeur précédente d'une cellule lorsque son contenu n'est pas un objet rapport.
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions redéfinies ne contient qu'une entrée.
• Lorsque vous spécifiez un ensemble de dimensions redéfinies, vous devez les séparer par des points-virgules.
• Web Intelligence applique
Précédent après avoir appliqué tous les filtres de rapport, de section et de bloc.
• Vous ne pouvez pas appliquer de filtre à une formule qui utilise
Précédent
.
• Web Intelligence applique
Précédent() après avoir appliqué tous les tris.
• Vous ne pouvez pas appliquer de tri à une formule qui utilise
Précédent
.
• Si
Précédent est appliqué à un indicateur et que l'indicateur renvoie une valeur non définie,
Précédent renvoie une valeur non définie même si la ligne précédente a renvoyé une valeur.
186 Utilisation de fonctions, formules et calculs dans Web Intelligence
ValeurRéf
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
•
Précédent ignore les ruptures en cas de placement à l'extérieur d'un en-tête ou d'un pied de page de rupture.
•
Précédent renvoie la valeur de l'instance précédente du pied de page en cas de placement dans un pied de page de rupture.
• Web Intelligence réinitialise
Précédent dans chaque section de rapport.
• Lorqu'elle est utilisée dans un tableau croisé, l'option
Précédent ne traite pas la dernière valeur d'une ligne comme la première valeur de la ligne suivante.
Rubriques associées
•
Comparaison de valeurs à l'aide de la fonction Précédent
page 236
•
page 204
Description
Renvoie la valeur de référence d'un objet rapport lorsque le suivi de données est activé
Groupe de fonctions
Divers
Syntaxe
objet_type_données ValeurRéf([objet])
Entrée
Aucune
Sortie
La valeur de l'objet rapport
Utilisation de fonctions, formules et calculs dans Web Intelligence 187
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
Exemples
ValeurRéf([Région ayant les meilleurs résultats]) renvoie
"Sud-ouest" si la valeur de la variable [Région ayant les meilleurs résultats] est "Sud-ouest" dans les données de référence.
ValeurRéf([Chiffre d'affaires]) renvoie 1 000 si la valeur de l'indicateur
[Chiffre d'affaires] est 1 000 dans les données de référence.
ValeurRelative
Description
Renvoie les valeurs précédentes ou suivantes d'une expression calculée à l'aide d'un ensemble de dimensions
Groupe de fonctions
Divers
Syntaxe
expr_type RelativeValue(expr;slicing_dimensions;offset)
Entrée
expr dimensions_découpage offset
Toute expression
Les dimensions qui donnent le contexte du calcul
Le nombre de lignes situées avant ou après la ligne actuelle
Exemple
La colonne ValeurRelative du tableau ci-dessous contient le formule suivante :
RelativeValue([Revenue];([Year]);-1)
188 Utilisation de fonctions, formules et calculs dans Web Intelligence
Année
2007
2007
2007
2007
2008
2008
2008
2008
Trimestre
T1
T2
T3
T4
T1
T2
T3
T4
Vendeur
Durand
Dupont
Martin
Dubois
Durand
Dupont
Martin
Dubois
Fonctions, opérateurs et mots clés de Web Intelligence
Fonctions Web Intelligence
4
Chiffre d'affaires
1 000
2 000
1 500
3 000
4 000
3 400
2 000
1 700
Valeur-
Relative
1 000
2 000
1 500
3 000
Pour en savoir plus sur la fonction
ValeurRelative
, voir le chapitre sur la comparaison de valeurs à l'aide des fonctions Web Intelligence du guide
Utilisation de fonctions, formules et calculs dans Web Intelligence ou suivez le lien au bas de cette rubrique (le cas échéant).
Remarques
• expr doit être un indicateur ou un détail d'une dimension disponible dans le bloc.
• L'ordre de tri de la liste de valeurs des dimensions de découpage permet de déterminer le résultat de la fonction.
Deux facteurs définissent l'ordre de tri : les tris appliqués aux dimensions de découpage et l'ordre dans lequel les dimensions de découpage sont répertoriées dans la fonction.
• Une dimension utilisée comme maître de section peut être spécifiée en tant que dimension de découpage.
• Toutes les dimensions de découpage doivent être présentes dans le bloc ou dans l'en-tête de section du bloc dans lequel se trouve la fonction. Si une dimension de découpage est supprimée ultérieurement du bloc, la fonction renvoie l'erreur #CALCUL.
• Si l'offset dépasse le nombre de lignes de la liste de valeurs de la dimension de découpage, le résultat de la fonction est nul.
•
ValeurRelative ne peut être utilisé de façon récursive.
Utilisation de fonctions, formules et calculs dans Web Intelligence 189
Fonctions, opérateurs et mots clés de Web Intelligence
4
Fonctions Web Intelligence
• Vous devez toujours mettre les dimensions entre parenthèses, même si la liste des dimensions de découpage ne contient qu'une entrée.
Rubriques associées
•
page 218
•
Comparaison de valeurs à l'aide de la fonction ValeurRelative
page 236
IndexationDesLignes
Description
Renvoie le numéro d'une ligne
Groupe de fonctions
Divers
Syntaxe
entier IndexationDesLignes()
Entrée
Aucune
Sortie
Le numéro de la ligne
Exemple
IndexationDesLignes() renvoie 0 lorsqu'elle apparaît sur la première ligne d'un tableau
Remarques
• La numérotation des lignes commence à 0
• IndexationDesLignes() renvoie #VALEURMULTI lorsqu'elle est placée dans l'en-tête ou le pied de page d'un tableau
190 Utilisation de fonctions, formules et calculs dans Web Intelligence
Link pubblico aggiornato
Il link pubblico alla tua chat è stato aggiornato.
