Boîte de dialogue Définir la formule (Générateur de rapports)

Article
12/15/2008

Cette boîte de dialogue permet de créer un nouveau champ qui contient une formule.

Options

Champs
Utilisez cet onglet pour rechercher dans le modèle de rapport des champs à inclure dans l'expression. Double-cliquez sur le champ pour l'ajouter à l'expression.

Fonctions
Utilisez cet onglet pour sélectionner la fonction à utiliser dans l'expression. Double-cliquez sur la fonction pour l'ajouter à l'expression. Pour une description de chaque fonction, consultez la section suivante.

Nom du champ
Entrez un nom pour l'expression que vous êtes en train de créer.

Formule
Permet d'écrire et de modifier la formule.

Rechercher
Cliquez sur cette option pour afficher la boîte de dialogue Rechercher.

Raccourcis des fonctions
Cliquez sur cette option pour ajouter un opérateur à la formule affichée dans la zone Formule. La boîte de dialogue Définir la formule met à votre disposition des raccourcis qui permettent d'exécuter les fonctions les plus couramment utilisées ; toutefois, vous pouvez également sélectionner ces opérateurs dans l'onglet Fonctions. Les informations suivantes expliquent chaque raccourci.

+ Permet d'ajouter deux valeurs ensemble.

- Permet de soustraire une valeur d'une autre.

* Permet de multiplier deux valeurs texte.

/ Permet de diviser deux valeurs.

& Permet de concaténer deux valeurs.

( Permet de commencer un calcul.

) Permet de terminer un calcul.

Options accessibles à l'aide du bouton droit de la souris

Pour voir ces options de menu, cliquez avec le bouton droit sur les formules dans la zone Formule ou dans la zone de formule développée.

Développer
Cliquez sur cette option pour afficher la formule et sa relation avec l'entité de contexte. Vous devez procéder ainsi lorsque vous souhaitez filtrer ou indiquer le niveau d'agrégation.

Renommer
Cliquez sur cette option pour renommer la formule affichée dans la boîte de dialogue Formule.

Effectuer l'agrégation ici
Cliquez sur le nom du champ pour modifier le niveau d'agrégation. Cette option n'est disponible qu'une fois que vous avez développé la formule.

Aucun filtre appliqué
Si vous double-cliquez sur un nom de champ affiché dans la zone Formule, la relation entre l'entité sur laquelle la formule est définie et le champ proprement dit apparaît. Vous pouvez appliquer un filtre à l'expression en un point quelconque du chemin du modèle. Cliquez sur cette option pour appliquer un filtre à l'expression, puis cliquez sur Créer un nouveau filtre. La boîte de dialogue Filtrer les données s'ouvre.

Fonctions

Les informations suivantes décrivent chacune des fonctions de l'onglet Fonctions de la boîte de dialogue Définir la formule.

Agrégation

Pour résumer une plage de valeurs numériques, utilisez les fonctions suivantes.

SUM
Retourne la somme de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

SUM(aggregate)

La fonction SUM ne peut être utilisée qu'avec des champs qui contiennent des valeurs numériques. Les valeurs NULL sont ignorées.

AVERAGE
Retourne la moyenne (arithmétique) de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

AVERAGE(aggregate)

La fonction AVERAGE ne peut être utilisée qu'avec des champs contenant des valeurs numériques. Les valeurs NULL sont ignorées.

MAX
Retourne la valeur maximale de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

MAX(aggregate)

Pour les colonnes de type caractère, la fonction MAX recherche la valeur la plus élevée dans l'ordre de classement des caractères. Les valeurs NULL sont ignorées.

MIN
Retourne la valeur minimale de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

MIN(aggregate)

Pour les colonnes de type caractère, la fonction MIN recherche la valeur la moins élevée dans l'ordre de classement des caractères. Les valeurs NULL sont ignorées.

COUNT
Retourne le nombre de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

COUNT(aggregate)

La fonction COUNT retourne toujours une valeur de données de type Int.

COUNTDISTINCT
Retourne le nombre de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

COUNTDISTINCT(aggregate)

STDev
Retourne l'écart-type de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

STDEV(aggregate)

STDevP
Retourne l'écart-type de la population de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

STDEVP(aggregate)

VAR
Retourne la variation de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

VAR(aggregate)

VARP
Retourne la variation du remplissage de toutes les valeurs non NULL d'un ensemble de valeurs.

Syntaxe

VARP(aggregate)

Opérateurs conditionnels

Pour tester une condition, utilisez les fonctions suivantes.

IF
Retourne une valeur si vous spécifiez une condition qui donne TRUE et une autre valeur si la condition donne FALSE.

Syntaxe

IF(condition, value_if_true, value_if_false)

La condition doit donner TRUE ou FALSE. Value_if_true représente la valeur retournée si la condition est vérifiée. Value_if_false représente la valeur retournée si la condition n'est pas vérifiée.

IN
Détermine si une valeur est présente dans un ensemble de valeurs.

Syntaxe

IN(item, set)

Switch
Évalue une liste d'expressions et retourne une valeur d'une expression associée à la première expression de la liste qui a pour valeur TRUE. Switch peut avoir une ou plusieurs paires condition/valeur.

Syntaxe

Switch(condition1, value1, …)

Conversion

Pour convertir une valeur d'un type de données en un autre, utilisez les fonctions suivantes.

INT
Convertit une valeur en un entier.

Syntaxe

INT(value)

DECIMAL
Convertit une valeur en un décimal.

Syntaxe

DECIMAL(value)

FLOAT
Convertit une valeur en un type de données float.

Syntaxe

FLOAT(value)

TEXT
Convertit une valeur numérique en texte.

Syntaxe

TEXT(value)

Date et heure

Pour afficher la date ou l'heure, utilisez les fonctions suivantes.

DATE
Retourne une valeur date/time représentant les année, mois et jour spécifiés à 12 heures.

Syntaxe

DATE(year, month, day)

DATEONLY
Retourne une valeur date/time représentant les année, mois et jour spécifiés.

Syntaxe

DATEONLY(datetime)

DATETIME
Retourne une valeur date/time représentant les année, mois, jour, heure, minute et seconde spécifiés.

Syntaxe

DATETIME(year, month, day, hour, minute, second)

YEAR
Retourne une année à partir d'une valeur datetime.

Syntaxe

YEAR(datetime)

QUARTER
Retourne le trimestre de calendrier (1-4) de la valeur datetime.

Syntaxe

QUARTER(datetime)

MONTH
Retourne le mois (1-12) à partir d'une valeur datetime.

Syntaxe

MONTH(datetime)

DAY
Extrait le jour à partir d'une valeur datetime.

Syntaxe

DAY(datetime)

HOUR
Extrait l'heure (0-23) à partir d'une valeur datetime.

Syntaxe

HOUR(datetime)

MINUTE
Extrait la minute à partir d'une valeur datetime.

Syntaxe

MINUTE(datetime)

SECOND
Extrait la seconde à partir d'une valeur datetime.

Syntaxe

SECOND(datetime)

DAYOFYEAR
Retourne le jour de l'année de la valeur datetime. Le 1er janvier est égal à 1, le 31 décembre à 366 si l'année est bissextile.

Syntaxe

DAYOFYEAR(datetime)

WEEK
Retourne la valeur numérique de la semaine dans l'année civile.

Syntaxe

WEEK(datetime)

DAYOFWEEK
Retourne le jour de la semaine, en commençant par lundi. Lundi = 1 et dimanche = 7.

Syntaxe

DAYOFWEEK(datetime)

NOW
Retourne la date et l'heure actuelles.

Syntaxe

NOW( )

TODAY
Retourne la date actuelle.

Syntaxe

TODAY( )

DATEDIFF
Retourne la différence entre la valeur datetime de début et la valeur datetime de fin.

Syntaxe

DATEDIFF(interval, datetime, datetime)

DATEADD
Retourne une valeur datetime qui est le résultat de l'ajout du nombre d'unités d'intervalles de temps spécifié à la valeur datetime d'origine.

Syntaxe

DATEADD(interval, units, datetime)

Opérateurs logiques

Pour tester la logique d'une condition, utilisez les fonctions suivantes.

AND
Retourne TRUE si tous les arguments ont la valeur TRUE ; retourne FALSE si un ou plusieurs arguments ont la valeur FALSE.

Syntaxe

AND(logical, logical)

Les arguments doivent donner des valeurs logiques telles que TRUE ou FALSE, ou appartenir à des tableaux ou références contenant des valeurs logiques. Si un argument de tableau ou de référence contient du texte ou des cellules vides, ces valeurs sont ignorées.

OR
Retourne TRUE si un argument quelconque a la valeur TRUE ; retourne FALSE si tous les arguments ont la valeur FALSE.

Syntaxe

OR(logical, logical)

Les arguments doivent donner des valeurs logiques telles que TRUE ou FALSE, ou appartenir à des tableaux ou références contenant des valeurs logiques. Si un tableau ou une référence contient du texte ou des cellules vides, ces valeurs sont ignorées.

NOT
Inverse la valeur de son argument. Utilisez NOT lorsque vous souhaitez vous assurer qu'une clause n'est pas égale à une valeur particulière.

Syntaxe

NOT(logical)

Si la valeur est FALSE, NOT retourne TRUE ; si la valeur est TRUE, NOT retourne FALSE.

Opérateurs mathématiques

Pour manipuler des valeurs numériques, utilisez les fonctions suivantes.

MOD
Retourne le reste une fois le nombre divisé par un diviseur. Le diviseur ne peut pas être 0.

Syntaxe

MOD(number, divisor)

TRUNC
Tronque un nombre du nombre de chiffres spécifié. Si le nombre est positif, il est tronqué à droite de la décimale. Si le nombre est négatif, il est tronqué à gauche de la décimale.

Syntaxe

TRUNC(number, digits)

ROUND
Arrondit un nombre à un nombre de chiffres spécifié.

Syntaxe

ROUND(number, digits)

Si le nombre de chiffres est supérieur à 0 (zéro), le nombre est arrondi au nombre spécifié de décimales. Si le nombre de chiffres est 0, le nombre est arrondi à l'entier le plus proche. Si le nombre de chiffres est inférieur à 0, le nombre est arrondi à gauche de la virgule décimale.

Opérateurs

Opérateurs arithmétiques

Pour réaliser des opérations mathématiques de base, telles que l'addition, la soustraction ou la multiplication, combiner des nombres et générer des résultats numériques, utilisez les opérateurs suivants.

+ Ajouter
Permet d'ajouter au moins deux éléments ensemble.

Syntaxe

value + value

- Soustraire
Permet de déduire un élément d'un autre élément.

Syntaxe

value - value

* Multiplier
Permet de multiplier des éléments.

Syntaxe

value * value

/ Diviser
Permet de diviser des éléments. Le diviseur ne peut pas être 0.

Syntaxe

value/divisor

- Inverser
Permet de changer le signe de la valeur.

Syntaxe

-value

^ Élévation à la puissance
Permet d'élever une valeur à une puissance.

Syntaxe

value^power

Opérateurs de comparaison

Pour comparer deux valeurs et retourner la valeur logique TRUE ou FALSE, utilisez les opérateurs suivants.

= Égal à
Utilisez cette fonction pour indiquer que deux valeurs sont égales. La valeur est TRUE lorsque value1 est égale à value2.

Syntaxe

value1= value2

<> Différent de
Utilisez cette fonction pour indiquer que deux valeurs ne sont pas égales. La valeur est TRUE lorsque value1 n'est pas égale à value2.

Syntaxe

value1 <> value2

> Supérieur à
Utilisez cette fonction pour indiquer qu'une valeur est supérieure à une autre valeur. La valeur est TRUE lorsque value1 est supérieure à value2.

Syntaxe

value1 > value2

>= Supérieur ou égal à
Utilisez cette fonction pour indiquer qu'une valeur est supérieure ou égale à une autre valeur. La valeur est TRUE lorsque value1 est supérieure ou égale à value2.

Syntaxe

value1 >= value2

< Inférieur à
Utilisez cette fonction pour indiquer qu'une valeur est inférieure à une autre valeur. La valeur est TRUE lorsque value1 est inférieure à value2.

Syntaxe

value1 < value2

<= Inférieur ou égal à
Utilisez cette fonction pour indiquer qu'une valeur est inférieure ou égale à une autre valeur. La valeur est TRUE lorsque value1 est inférieure ou égale à value2.

Syntaxe

value1 <= value2

Texte

Pour manipuler du texte dans le rapport, utilisez les fonctions suivantes.

Concat (&)
Combine deux chaînes en une seule. La deuxième chaîne est ajoutée à la première.

Syntaxe

string & string

Find
Position de la première instance d'une chaîne.

Syntaxe

FIND(string, substring)

Left
Retourne les caractères situés les plus à gauche d'une chaîne.

Syntaxe

LEFT(string, length)

Length
Retourne le nombre de caractères dans une chaîne.

Syntaxe

LENGTH(string)

Lower
Convertit les caractères majuscules d'une chaîne en minuscules.

Syntaxe

LOWER(string)

LTrim
Retourne une chaîne avec les espaces de début supprimés.

Syntaxe

LTRIM(string)

Replace
Retourne une chaîne dans laquelle toutes les instances d'une sous-chaîne ont été remplacées par une autre sous-chaîne.

Syntaxe

REPLACE(find, replace, string)

Right
Retourne les caractères situés les plus à droite d'une chaîne.

Syntaxe

RIGHT(string, length)

RTrim
Retourne une chaîne avec les espaces de fin supprimés.

Syntaxe

RTRIM(string)

Text
Convertit une valeur numérique en chaîne.

Syntaxe

TEXT(value)

Substring
Retourne une sous-chaîne à partir d'une chaîne.

Syntaxe

SUBSTRING(string, start, length)

Upper
Convertit tous les caractères minuscules d'une chaîne en majuscules.

Syntaxe

UPPER(string)

Informations

Pour retourner des informations globales sur les utilisateurs, recourez aux fonctions suivantes.

GetUserID
Retourne l'ID que l'utilisateur a utilisé pour accéder aux données.

Syntaxe

GETUSERID()

GetUserCulture
Retourne les paramètres régionaux ou linguistiques de l'utilisateur.

Syntax

GETUSERCULTURE()

Voir aussi

Partager via