• Article

Définir la formule, boîte de dialogue (Générateur de modèles)

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 version 1.0).

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