# FirstSortedValue - fonction de graphique
FirstSortedValue() renvoie la valeur de l'expression spécifiée dans value qui correspond au résultat du tri de l'argument sort\_weight, par exemple, le nom du produit ayant le prix unitaire le plus bas. Il est possible de spécifier la nième valeur dans l'ordre de tri dans l'argument rank. Si plusieurs valeurs résultantes partagent le même champ sort\_weight pour la fonction rank spécifiée, la fonction renvoie la valeur NULL.
FirstSortedValue([{SetExpression}] [DISTINCT] [TOTAL [<fld {,fld}>]] value, sort\_weight [,rank])
double
Arguments
| Argument | Description |
| --- | --- |
| value | Champ de sortie. La fonction détermine la valeur de l'expression value correspondant au résultat du tri du champ sort\_weight. |
| sort\_weight | Champ de saisie. Expression contenant les données à trier. La première valeur (la plus faible) de sort\_weight est identifiée, ce qui permet de déterminer la valeur correspondante de l'expression value. Si vous placez un signe moins devant sort\_weight, la fonction renvoie alors la dernière valeur triée (la plus élevée). |
| rank | Si vous spécifiez une valeur rank "n" supérieure à 1, vous obtenez la nième valeur triée. |
| 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 le terme DISTINCT précède les arguments de la fonction, les doublons résultant de l'évaluation des arguments de la fonction sont ignorés. |
| TOTAL | Si le terme TOTAL précède les arguments de la fonction, le calcul est effectué à partir de toutes les valeurs possibles au vu des sélections actives, et pas seulement à partir de celles qui sont associées à la valeur dimensionnelle active. Autrement dit, les dimensions du graphique ne sont pas prises en compte.
En utilisant TOTAL [<fld {.fld}>], où le qualificateur TOTAL est suivi d'un ou de plusieurs noms constituant un sous-ensemble des variables de dimension du graphique, vous créez un sous-ensemble du nombre total de valeurs possibles.
[Définition de l'étendue d'une agrégation](https://help.qlik.com/fr-FR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) |
Données
| Customer | Product | UnitSales | UnitPrice |
| --- | --- | --- | --- |
| Astrida | AA | 4 | 16 |
| Astrida | AA | 10 | 15 |
| Astrida | BB | 9 | 9 |
| Betacab | BB | 5 | 10 |
| Betacab | CC | 2 | 20 |
| Betacab | DD | - | 25 |
| Canutility | AA | 8 | 15 |
| Canutility | CC | - | 19 |
Exemples et résultats
| Exemple | Résultat |
| --- | --- |
| `firstsortedvalue (Product, UnitPrice)` | BB, qui est le produit `Product` avec le prix unitaire `UnitPrice` le plus bas (9). |
| `firstsortedvalue (Product, UnitPrice, 2)` | BB, qui est le produit `Product` avec le deuxième prix unitaire `UnitPrice` le plus bas (10). |
| `firstsortedvalue (Customer, -UnitPrice, 2)` | Betacab, qui est le client `Customer` avec le produit `Product` qui a le deuxième prix unitaire `UnitPrice` le plus élevé (20). |
| `firstsortedvalue (Customer, UnitPrice, 3)` | NULL, car il existe deux valeurs de client `Customer` (Astrida et Canutility) avec le prix unitaire `UnitPrice` au même niveau/classement rank (le troisième prix unitaire le plus bas) (15).
Utilisez le qualificateur distinct pour garantir l'absence de résultats NULL imprévus. |
| `firstsortedvalue (Customer, -UnitPrice*UnitSales, 2)` | Canutility, qui est le client `Customer` avec le deuxième prix unitaire `UnitPrice` de commande le plus élevé multiplié par les ventes unitaires `UnitSales` (120). |
Données utilisées dans les exemples :
`ProductData:``LOAD * inline [``Customer|Product|UnitSales|UnitPrice``Astrida|AA|4|16``Astrida|AA|10|15``Astrida|BB|9|9``Betacab|BB|5|10``Betacab|CC|2|20``Betacab|DD||25``Canutility|AA|8|15``Canutility|CC||19``] (delimiter is '|');`
## En savoir plus
* [Analyse d'ensembles](https://help.qlik.com/fr-FR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/SetAnalysis/set-analysis-expressions.htm)
* [Définition de l'étendue d'une agrégation](https://help.qlik.com/fr-FR/sense/May2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm)