Fonctions de partition

La partition est un moyen de regrouper une série de valeurs plus ou moins continues en un petit nombre de "partitions".


Fonction	Description
`AutoBinNumeric`	Tente de regrouper les valeurs d'une colonne spécifiée dans le nombre de partitions défini. Cependant, il peut y avoir un nombre de partitions plus grand ou plus petit que le nombre défini, car la méthode renverra toujours des partitions avec des limites faciles à lire (avec autant de nombres égaux que possible). Le premier argument est la colonne à partitionner et le second argument le nombre de partitions souhaitées. Exemple : `AutoBinNumeric([Column], 10)`
`BinByDateTime`	Regroupe les valeurs dans les partitions à partir d'une hiérarchie naturelle de dates, de dates et heures ou d'heures. Le premier argument correspond à la colonne `Date`, `Time` ou `DateTime` à partitionner. Le deuxième argument définit les niveaux de la hiérarchie. Les niveaux de hiérarchie doivent être rédigés sous la forme d’une chaîne contenant les périodes de date désirées, séparées par des points, par exemple « `Year.Quarter.Month` ». Le troisième argument est le niveau d'élagage spécifiant le niveau de la hiérarchie à afficher. Si vous rédigez une expression personnalisée basée sur une expression `BinByDateTime`, un sélecteur de colonne s'affiche avec tous les niveaux de la hiérarchie disponible spécifiée, mais avec le curseur de hiérarchie positionné au niveau d'élagage défini. Les arguments valides pour Arg2 sont des combinaisons de : '`year`' ou '`yy`' - L’année. '`quarter`' ou '`qq`' - Le trimestre. '`month`' ou '`mm`' - Le mois. '`day of year`' ou '`dy`' - Le jour de l’année. '`day`' ou '`dd`' - Le jour. '`week`' ou '`wk`' - La semaine. '`day of week`' ou '`dw`' - Le jour de la semaine. '`hour`' ou '`hh`' - L’heure. '`minute`' ou '`mi`' - La minute. '`second`' ou '`ss`' - La seconde. '`millisecond`' ou '`ms`' - La milliseconde. Arg2 peut également être une combinaison de : ' `isoyear` ' - Année avec numérotation des semaines selon la norme ISO 8601. ' `isoweek` ' - Numéro de la semaine selon la norme ISO 8601. Exemples : `BinByDateTime([Column],"Year.Quarter.Month.Day",2)` Pour une colonne de date intitulée Date de commande, l'expression ci-dessus entraîne l'affichage du sélecteur de colonne et du curseur de hiérarchie suivants lorsqu'ils sont utilisés dans une expression personnalisée : Pour le niveau d'élagage 0, le curseur est placé à la position « Année », pour le niveau 1, à la position Trimestre ; pour le niveau 2, à la position Mois et pour le niveau 3, la position Jour. `BinByDateTime([ Column ],"ISOYear.ISOWeek", 1 )` Pour utiliser la partition selon la norme ISO 8601 pour une colonne de date, utilisez les parties de date `isoyear` et `isoweek` plutôt que les parties de date habituelles `year` et `week`.
`BinByEvenDistance`	Regroupe les valeurs dans la colonne spécifiée afin d'obtenir une distance égale entre toutes les partitions. Le premier argument est la colonne à partitionner et le second est la longueur des intervalles. Le troisième argument (facultatif) spécifie l'emplacement de départ du décompte. Si aucun argument de départ n'est spécifié, la première partition débute à zéro. Exemples : `BinByEvenDistance([Column], 10)` `BinByEvenDistance([Column], 10, 5)`
`BinByEvenDistribution`	Regroupe les valeurs dans la colonne spécifiée afin que chaque partition (groupe) ait le même nombre de valeurs uniques que les autres. La dernière partition peut comporter davantage de valeurs uniques que les autres. Le premier argument est la colonne à partitionner et le deuxième argument le nombre de partitions. Les valeurs non valides génèrent un résultat non valide. Exemple : `BinByEvenDistribution([Column], 5)` `BinByEvenDistribution(Rank([Column])*Count() + RowId(), 3)`
`BinByEvenIntervals`	Regroupe les valeurs dans la colonne spécifiée afin que la plage de valeurs soit divisée en intervalles égales. Le premier argument est la colonne à partitionner et le deuxième argument le nombre de partitions. Exemple : `BinByEvenIntervals([Column], 5)`
`BinBySpecificLimits`	Regroupe les valeurs dans la colonne spécifiées par limites définies pour les partitions (groupes). Le premier argument est la colonne à partitionner et les arguments suivants représentent les limites des partitions. Toutes les lignes dont les valeurs sont supérieures à la plus grande limite auront la même valeur partitionnée. Les valeurs non valides génèrent un résultat non valide. Exemple : `BinBySpecificLimits([Column], 1, 2, 3, 10)`
`BinByStdDev`	Regroupe les valeurs dans différentes partitions selon leur distance de la valeur moyenne, mesurée en écart type. Le premier argument est la colonne à partitionner et les arguments suivants sont le nombre d'écarts type à afficher par rapport à la moyenne. Les arguments d'écart type devront être fournis dans l'ordre croissant et toutes les valeurs doivent être positives. Exemple : `BinByStdDev([Column], 0.5, 1)` Cela créera une partition pour : écart type ≤ -1 écart type de -1 écart type de -0,5 écart type de 0,5 écart type de 1 écart type > 1
`BinBySubstring`	Regroupe les valeurs en partitions selon le caractère de début ou de fin de la valeur. Cela signifie que vous pouvez utiliser cette méthode pour regrouper toutes les valeurs commençant par « A » dans une partition, par « B » dans un autre, etc. Le premier argument est la colonne `Chaîne` à partitionner et le suivant est le nombre de caractères dans la sous-chaîne. Si l'argument suivant est négatif, la sous-chaîne démarre à la fin de la valeur. Exemples : `BinBySubstring([Column], 1)` `BinBySubstring([Column], -4)` `BinBySubstring(String([Integer Column]), 1)`
`BinByTimeSpan`	Regroupe les valeurs en partitions selon une période. Le premier argument est la colonne `TimeSpan` à partitionner. Le deuxième argument est la définition du niveau de hiérarchie écrite sous la forme d’une chaîne contenant les périodes désirées, séparées par des points («`Heures.Minutes`», par exemple). Le troisième argument est le niveau d'élagage de base zéro spécifiant le niveau de la hiérarchie à afficher. Les arguments valides pour `Arg2` sont une combinaison de : '`Days`' - Les jours. '`Hours`' - Les heures. '`Minutes`' - Les minutes. '`Seconds`' - Les secondes. '`Milliseconds`' - Les millisecondes. Exemple : `BinByTimeSpan([Column],"Days.Hours.Minutes.Seconds",2)` Pour une colonne de `période` intitulée Différence de temps, l'expression ci-dessus entraîne l'affichage du sélecteur de colonne et du curseur de hiérarchie suivants lorsqu'ils sont utilisés dans une expression personnalisée :
`FiscalBinByDateTime`	Regroupe les valeurs en partitions selon une hiérarchie naturelle de dates ou de dates et heures, avec un décalage des niveaux correspondant au nombre de mois indiqué. Le premier argument correspond à la colonne `Date` ou `DateTime` à partitionner. Le second argument est la définition du niveau de la hiérarchie écrite sous la forme d’une chaîne contenant les périodes de date désirées, séparées par des points («`Année.Trimestre.Mois`», par exemple). Seuls `Année`, `Trimestre` et `Mois` sont pris en charge. Le troisième argument est le niveau d'élagage spécifiant le niveau de la hiérarchie à afficher. Le quatrième argument (facultatif) correspond au nombre de mois à décaler. Si cet argument n'a pas été défini, la valeur `FiscalYearOffset` de la propriété de document est utilisée. Exemples : `FiscalBinByDateTime([Date Column], "Year.Quarter.Month", 1, 2)` `FiscalBinByDateTime([Date Column], "Year.Quarter.Month", 2)`

Remarque : Si un axe qui utilise une expression personnalisée avec partition a été configuré sur Évaluer l'expression d'axe sur : Filtrage actuel uniquement (applicable uniquement avec le client Windows), la partition sera recalculée à chaque filtrage.

Voir aussi Fonctions.

Exemple

Prenons l'exemple d'une colonne avec les valeurs suivantes :

Si la colonne est partitionnée à l'aide des méthodes de partition ci-dessous, les limites obtenues s'affichent comme suit :


Méthode de partitionnement	Résultat
`AutoBinNumeric([Column],5)`
`BinByEvenDistance([Column],5)`
`BinByEvenDistribution([Column],5)`
`BinByEvenIntervals([Column],5)`
`BinBySpecificLimits([Column],-2,4,10,16,22)`

Conseil : Vous pouvez modifier le formatage de la colonne pour afficher moins de décimales (ou aucune) sur l'axe.