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

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

Options

• Fields
  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 positions est égal à 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

Concepts

Aide sur le Générateur de rapports version 1.0 via la touche F1

Utilisation des formules (Générateur de rapports version 1.0)

Utilisation des fonctions (Générateur de rapports version 1.0)