Accéder au contenu principal Passer au contenu complémentaire

Aggr - fonction de graphique

Aggr() renvoie un tableau de valeurs pour l'expression calculée au moyen de la ou des dimensions définies. Par exemple, la valeur maximale de ventes, par client et par région.

La fonction Aggr est utilisée pour les agrégations imbriquées dans lesquelles le première paramètre (l'agrégation interne) est calculé une fois par valeur dimensionnelle. Les dimensions sont spécifiées dans le deuxième paramètre (et les paramètres suivants).

De plus, la fonction Aggr doit être imbriquée dans une fonction d'agrégation externe en utilisant le tableau de résultats provenant de la fonction Aggr comme entrée de l'agrégation dans laquelle elle est imbriquée.

 

Aggr({SetExpression}[DISTINCT] [NODISTINCT ] expr, StructuredParameter{, StructuredParameter})

double

 

Arguments
Argument Description
expr

Expression composée d'une fonction d'agrégation. Par défaut, la fonction d'agrégation couvre l'ensemble des enregistrements possibles définis par la sélection.

StructuredParameter

StructuredParameter se compose d'une dimension et éventuellement de critères de tri au format suivant : (Dimension(Sort-type, Ordering))

La dimension est un champ unique et ne peut pas être une expression. La dimension permet de déterminer le tableau de valeurs pour lequel l'expression Aggr est calculée.

Si des critères de tri sont inclus, le tableau de valeurs créé par la fonction Aggr, calculé pour la dimension, est trié. Ceci est important lorsque l'ordre de tri affecte le résultat de l'expression dans laquelle la fonction Aggr est incluse.

Pour en savoir plus sur l'utilisation des critères de tri, reportez-vous à la rubrique Ajout de critères de tri à la dimension dans le paramètre structuré.

SetExpression Par défaut, la fonction d'agrégation couvre l'ensemble des enregistrements possibles définis par la sélection. Il est possible de définir un ensemble d'enregistrements alternatif à l'aide d'une expression d'analyse d'ensembles.
DISTINCT

Si l'argument expression est précédé du qualificateur distinct ou si aucun qualificateur n'est utilisé, chaque combinaison de valeurs de dimension génère une seule valeur de retour. Il s'agit du mode de création standard des agrégations ; chaque combinaison distincte de valeurs de dimension correspond à une ligne dans le graphique.

NODISTINCT

Si l'argument expression est précédé du qualificateur nodistinct, chaque combinaison de valeurs de dimension peut, suivant la structure de données sous-jacente, générer plusieurs valeurs de retour. En présence d'une seule dimension, la fonction aggr renvoie un tableau comprenant autant d'éléments que les données de la source comportent de lignes.

Les fonctions d'agrégation de base (telles que Sum, Min et Avg) renvoient une valeur numérique unique, tandis que la fonction Aggr() est comparable à la création d'un ensemble de résultats graduel temporaire (table virtuelle), sur lequel une autre agrégation peut être effectuée. Par exemple, lorsque vous calculez une valeur de vente moyenne en additionnant les ventes par client dans une instruction Aggr(), puis en calculant la moyenne des résultats additionnés : Avg(TOTAL Aggr(Sum(Sales),Customer)).

Note ConseilSi vous souhaitez créer des agrégations de graphiques imbriqués à plusieurs niveaux, utilisez la fonction Aggr() dans des dimensions calculées.

 

Dans une fonction Aggr(), chaque dimension doit consister en un seul champ et être différente d'une expression (dimension calculée).

Dans sa forme de base, l'argument StructuredParameter dans la syntaxe de la fonction Aggr est une dimension unique. L'expression Aggr(Sum(Sales, Month)) détermine la valeur totale des ventes pour chaque mois. Toutefois, lorsqu'elle est incluse dans une autre fonction d'agrégation, des résultats inattendus peuvent survenir si aucun critère de tri n'est utilisé. En effet, certaines dimensions peuvent être triées par ordre numérique ou alphabétique, et ainsi de suite.

Dans l'argument StructuredParameter de la fonction Aggr, vous pouvez indiquer des critères de tri sur la dimension dans votre expression. De cette manière, vous imposez un ordre de tri sur la table virtuelle qui est créée par la fonction Aggr.

L'argument StructuredParameter présente la syntaxe suivante :

(FieldName, (Sort-type, Ordering))

Les paramètres structurés peuvent être imbriqués :

(FieldName, (FieldName2, (Sort-type, Ordering)))

Les types de tri possibles sont les suivants : NUMERIC, TEXT, FREQUENCY ou LOAD_ORDER.

Les types de classement associés à chaque type de tri sont les suivants :

Types de classement autorisés
Type de tri Types de classement autorisés
NUMERIC ASCENDING, DESCENDING ou REVERSE
TEXT ASCENDING, A2Z, DESCENDING, REVERSE ou Z2A
FREQUENCY DESCENDING, REVERSE ou ASCENDING
LOAD_ORDER ASCENDING, ORIGINAL, DESCENDING ou REVERSE

Les types de classement REVERSE et DESCENDING sont équivalents.

Pour le type de tri TEXT, les types de classement ASCENDING et A2Z sont équivalents, et DESCENDING, REVERSE et Z2A sont équivalents.

Pour le type de tri LOAD_ORDER, les types de classement ASCENDING et ORIGINAL sont équivalents.

Exemples : Expressions de graphique via Aggr

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !