Boîte de dialogue Définir la formule [Générateur de modèles]

Article
12/15/2008

Utilisez cette boîte de dialogue pour créer un nouveau champ qui contient une formule. Pour obtenir des exemples de formules valides, consultez Utilisation des fonctions (Générateur de rapports).

Options

Champs
Utilisez cet onglet pour rechercher les champs du modèle de rapport à 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 votre expression. Double-cliquez sur la fonction pour l'ajouter à l'expression. Pour obtenir une description de chaque fonction, consultez la section suivante.

Nom du champ
Entrez le nom de l'expression que vous créez.

Formule
Utilisez cette option pour écrire et modifier la formule.

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

Effectuer l'agrégation ici
Si vous double-cliquez sur le nom d'un champ affiché dans la zone Formule, la relation entre l'entité primaire et l'entité du champ est affichée. Cliquez sur cette option pour appliquer une agrégation à l'expression à un endroit quelconque le long du chemin d'accès au modèle.

Aucun filtre appliqué
Si vous double-cliquez sur le nom d'un champ affiché dans la zone Formule, la relation entre l'entité primaire et l'entité du champ est affichée. Vous pouvez appliquer un filtre à l'expression en un emplacement quelconque le long du chemin d'accès au 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.

Raccourcis des fonction
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 contient des raccourcis des fonctions les plus couramment utilisées ; toutefois, vous pouvez également sélectionner ces opérateurs à partir de l'onglet Fonctions. L'explication de chaque raccourci est donnée ci-dessous.

+ Permet d'ajouter deux valeurs.

- Permet de soustraire une valeur à une autre.

* Permet de multiplier deux valeurs.

/ Permet de diviser deux valeurs.

& Permet de concaténer deux valeurs.

( Permet de commencer un calcul.

) Permet de terminer un calcul.

Fonctions

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

Agrégation

Pour synthétiser une plage de valeurs numériques, utilisez les fonctions ci-dessous.

SUM
Retourne la somme de toutes les valeurs de l'expression.

Syntaxe

SUM(agrégat)

SUM peut être utilisé avec des champs contenant des valeurs numériques uniquement. Les valeurs Null sont ignorées.

AVERAGE
Renvoie la moyenne (arithmétique) de toutes les valeurs non Null de l'expression.

Syntaxe

AVERAGE(agrégat)

AVERAGE peut être utilisé avec des champs contenant des valeurs numériques uniquement. Les valeurs Null sont ignorées.

MAX
Retourne la valeur maximale de l'expression.

Syntaxe

MAX(agrégat)

Pour les colonnes de type caractère, 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 l'expression.

Syntaxe

MIN(agrégat)

Pour les colonnes de type caractère, MIN recherche la valeur la plus petite dans l'ordre de classement des caractères. Les valeurs Null sont ignorées.

COUNT
Retourne le nombre d'éléments non Null figurant dans un groupe.

Syntaxe

COUNT(agrégat)

COUNT retourne toujours une valeur dont le type de données est Int.

COUNTDISTINCT
Retourne le nombre d'instances non Null d'un élément figurant dans un groupe.

Syntaxe

COUNTDISTINCT(agrégat)

STDev
Retourne l'écart type des valeurs non Null d'un élément.

Syntaxe

STDEV(agrégat)

STDevP
Retourne l'écart type de la population des valeurs non Null d'un élément.

Syntaxe

STDEVP(agrégat)

VAR
Retourne la variance des valeurs non Null d'un élément.

Syntaxe

VAR(agrégat)

VARP
Retourne la variance de la population des valeurs non Null d'un élément.

Syntaxe

VARP(agrégat)

Conditions

Pour tester une condition, utilisez les fonctions ci-dessous.

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

Syntaxe

IF(condition, valeur_si_true, valeur_si_false)

La condition doit être une valeur ou une expression qui peut prendre la valeur TRUE ou FALSE. Valeur_si_true représente la valeur retournée si la condition est vraie. Valeur_si_false représente la valeur retournée si la condition est fausse.

IN
Détermine si un élément est membre d'un ensemble.

Syntaxe

IN(élément, ensemble)

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 conditions/valeur.

Syntaxe

Switch(condition1, valeur1)

Conversion

Pour convertir une valeur d'un type de données à un autre type de données, utilisez les fonctions ci-dessous.

INT
Convertit une valeur en entier.

Syntaxe

INT(valeur)

DECIMAL
Convertit une valeur en nombre décimal.

Syntaxe

DECIMAL(valeur)

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

Syntaxe

FLOAT(valeur)

TEXT
Convertit une valeur numérique en texte.

Syntaxe

TEXT(valeur)

Date et heure

Pour afficher la date ou l'heure, utilisez les fonctions ci-dessous

DATE
Retourne une valeur datetime à partir d'une année, d'un mois et d'un jour à 12:00:00.

Syntaxe

DATE(année, mois, jour)

DATEONLY
Retourne l'année, le mois et le jour à partir d'une valeur datetime.

Syntaxe

DATEONLY(datetime)

DATETIME
Retourne une valeur datetime d'après l'année, le mois, le jour, l'heure, la minute et la seconde.

Syntaxe

DATETIME(année, mois, jour, heure, minute, seconde)

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

Syntaxe

YEAR(datetime)

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

Syntaxe

QUARTER(datetime)

MONTH
Retourne le mois à partir d'une valeur datetime.

Syntaxe

MONTH(datetime)

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

Syntaxe

DAY(datetime)

HOUR
Extrait l'heure à 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. 1er janvier = 1 jusqu'au 31 décembre = 366, en supposant une année bissextile.

Syntaxe

DAYOFYEAR(datetime)

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

Syntaxe

WEEK(datetime)

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

Syntaxe

DAYOFWEEK(datetime)

NOW
Retourne la date et l'heure courante.

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(intervalle, valeur datetime, valeur datetime)

DATEADD
Retourne une valeur datetime résultant de l'addition du nombre spécifié d'unités d'intervalles de temps à la valeur datetime d'origine.

Syntaxe

DATEADD(intervalle, unités, valeur datetime)

Opérateurs logiques

Pour tester la logique d'une condition, utilisez les fonctions ci-dessous.

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

Syntaxe

AND(valeur logique, valeur logique)

Les arguments doivent prendre des valeurs logiques telles que TRUE ou FALSE ou être des tableaux ou des références qui contiennent les valeurs logiques. Si un argument d'un tableau ou d'une référence contient du texte ou des cellules vides, ces valeurs sont ignorées.

OR
Retourne la valeur TRUE si un argument prend la valeur TRUE ; renvoie FALSE si tous les arguments prennent la valeur FALSE.

Syntaxe

OR(valeur logique, valeur logique)

Les arguments doivent prendre des valeurs logiques telles que TRUE ou FALSE ou être des tableaux ou des références qui contiennent les 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 pour confirmer qu'une clause n'est pas égale à une valeur particulière.

Syntaxe

NOT(valeur logique)

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

Mathématiques

Pour manipuler des valeurs numériques, utilisez les fonctions ci-dessous.

MOD
Retourne le reste d'une division d'un nombre par un diviseur. Le diviseur ne peut pas être 0.

Syntaxe

MOD(nombre, diviseur)

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

Syntaxe

TRUNC(nombre, nombre_de_chiffres)

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

Syntaxe

ROUND(nombre, nombre_de_chiffres)

Si le nombre de chiffres est supérieur à 0 (zéro), le nombre est arrondi au nombre spécifié de chiffres après le séparateur décimal. 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 du séparateur décimal.

Opérateurs

Opérateurs arithmétiques

Pour effectuer des opérations mathématiques de base telle que l'addition, la soustraction ou la multiplication, pour combiner des nombres et pour produire des résultats numériques, utilisez les opérateurs ci-dessous.

+ Addition
Utilisez cet opérateur pour ajouter plusieurs éléments entre eux.

Syntaxe

valeur + valeur

- Soustraction
Utilisez cet opérateur pour soustraire un élément d'un autre élément.

Syntaxe

valeur- valeur

* Multiplication
Utilisez cet opérateur pour multiplier des éléments.

Syntaxe

valeur* valeur

/ Division
Utilisez cet opérateur pour diviser des éléments. Le diviseur ne peut pas être 0.

Syntaxe

valeur/diviseur

- Opposé
Change le signe de la valeur.

Syntaxe

-valeur

^ Élévation à une puissance
Utilisez cet opérateur pour élever une valeur à une puissance.

Syntaxe

valeur^puissance

Opérateurs de comparaison

Pour comparer deux valeurs et retourner une valeur logique TRUE ou FALSE, utilisez les opérateurs ci-dessous.

= Égal à
Permet d'égaler deux valeurs. True lorsque valeur1 est égale à valeur2.

Syntaxe

valeur1= valeur2

<> Différent de
Utilisez cet opérateur pour indiquer que deux valeurs ne sont pas égales. True lorsque valeur1 n'est pas égale à valeur2.

Syntaxe

valeur1 <> valeur2

> Supérieur à
Utilisez cet opérateur pour indiquer qu'une valeur est supérieure à une autre valeur. True lorsque valeur1 est supérieure à valeur2.

Syntaxe

valeur1 > valeur2

>= Supérieur ou égal à
Utilisez cet opérateur pour indiquer qu'une valeur est supérieure ou égale à une autre valeur. True lorsque valeur1 est supérieure ou égale à valeur2.

Syntaxe

valeur1 >= valeur2

< Inférieur à
Utilisez cet opérateur pour indiquer qu'une valeur est inférieure à une autre valeur. True lorsque valeur1 est inférieure à valeur2.

Syntaxe

valeur1 < valeur2

<= Inférieur ou égal à
Utilisez cet opérateur pour indiquer qu'une valeur est inférieure ou égale à une autre valeur. True lorsque valeur1 est inférieure ou égale à valeur2.

Syntaxe

valeur1 <= valeur2

Texte

Pour manipuler du texte dans vos rapports, utilisez les fonctions ci-dessous.

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

Syntaxe

chaîne & chaîne

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

Syntaxe

FIND(chaîne, sous-chaîne)

Left
Retourne les caractères à l'extrême gauche d'une chaîne. Si vous spécifiez une valeur inférieure à zéro pour l'argument de longueur au sein de la fonction, le comportement est indéfini.

Syntaxe

LEFT(chaîne, longueur)

Longueur
Retourne le nombre de caractères d'une chaîne.

Syntaxe

LENGTH(chaîne)

Lower
Convertit une chaîne de caractères majuscules en une chaîne de caractères minuscules.

Syntaxe

LOWER(chaîne)

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

Syntaxe

LTRIM(chaîne)

Replace
Retourne une chaîne dont toutes les instances d'une sous-chaîne sont remplacées par une autre sous-chaîne.

Syntaxe

REPLACE(recherche, remplacement, chaîne)

Right
Retourne les caractères à l'extrême droite d'une chaîne. Si vous spécifiez une valeur inférieure à zéro pour l'argument de longueur au sein de la fonction, le comportement est indéfini.

Syntaxe

RIGHT(chaîne, longueur)

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

Syntaxe

RTRIM(chaîne)

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

Syntaxe

TEXT(valeur)

Sous-chaîne
Retourne une sous-chaîne d'une chaîne. Si vous spécifiez une valeur inférieure à zéro pour l'argument de longueur au sein de la fonction, le comportement est indéfini.

Syntaxe

SUBSTRING(chaîne, début, longueur)

Upper
Convertit une chaîne de caractères minuscules en une chaîne de caractères majuscules.

Syntaxe

UPPER(chaîne)

Informations

Pour retourner des informations globales sur les utilisateurs, utilisez les fonctions ci-dessous.

GetUserID
Retourne l'ID dont l'utilisateur s'est servi pour accéder aux données.

Syntaxe

GETUSERID()

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

Syntax

GETUSERCULTURE()

Voir aussi

Partager via