• Article

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()