# GetFieldSelections - fonction de graphique
La fonction GetFieldSelections() renvoie une chaîne (string) avec les sélections actives dans un champ.
Si toutes les valeurs sauf deux, ou sauf une, sont sélectionnées, le format 'NOT x,y' ou 'NOT y' sera utilisé. Si vous sélectionnez toutes les valeurs et que le nombre total de valeurs est supérieur à l'argument max\_values, le texte ALL est renvoyé.
Syntaxe :
GetFieldSelections ( field\_name [, value\_sep [, max\_values [, state\_name]]])
Type de données renvoyé : string
Formats de chaîne renvoyés
| Format | Description |
| --- | --- |
| 'a, b, c' | Si le nombre de valeurs sélectionnées est max\_values ou moins, la chaîne renvoyée est une liste des valeurs sélectionnées.
Les valeurs sont séparées par value\_sep comme délimiteur. |
| 'NOT a, b, c' | Si le nombre de valeurs non sélectionnées est max\_values ou moins, la chaîne renvoyée est une liste des valeurs non sélectionnées avec NOT comme préfixe.
Les valeurs sont séparées par value\_sep comme délimiteur. |
| 'x of y' | x = nombre de valeurs sélectionnées
y = nombre total de valeurs
Cela est renvoyé lorsque max\_values < x < ( y - max\_values). |
| 'ALL' | Renvoyé si toutes les valeurs sont sélectionnées. |
| '-' | Renvoyé si aucune valeur n'est sélectionnée. |
| <search string> | Si vous avez effectué votre sélection via la recherche, la chaîne de recherche est renvoyée. |
Arguments
| Arguments | Description |
| --- | --- |
| field\_name | Champ contenant la plage de données à mesurer. |
| value\_sep | Séparateur à placer entre les valeurs de champ. La valeur par défaut est la virgule (,). |
| max\_values | Nombre maximum de valeurs de champ pouvant être listées individuellement. Lorsqu'un plus grand nombre de valeurs est sélectionné, le format « x valeurs sur y » le remplace. La valeur par défaut est 6. |
| state\_name | Nom d'un état alternatif ayant été choisi pour cette visualisation en particulier. Si l'argument state\_name est utilisé, seules les sélections associées au nom d'état spécifié sont prises en compte.
Pour plus d'informations, voir [Utilisation d'états alternatifs à des fins d'analyse comparative](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm). |
Exemple : Expressions de graphique
| Exemple | Résultat |
| --- | --- |
| `GetFieldSelections( FirstName )` | Renvoie « `-` » (NULL) si aucune sélection n'a été effectuée dans le champ `FirstName`. Sinon, renvoie la valeur des sélections, par exemple `John`. |
## Exemple - Les bases de GetFieldSelections
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getfieldselections.htm)
#### Expression de graphique
Vue d'ensemble
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
* Jeu de données chargé dans une table de données appelée `Example`.
* Champs suivants dans la table de données :
* `FirstName`
* `LastName`
* `Initials`
* `HasCellphone`
Script de chargement
```
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
```
Résultats
1. Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ce champ comme dimension :
* `FirstName`
2. Créez un objet ICP et ajoutez la mesure suivante :
* `=GetFieldSelections(FirstName)`, pour renvoyer les valeurs de la sélection effectuée dans le champ `FirstName`.
Note ConseilDans cet exemple, le style de l'ICP a été ajusté de sorte à utiliser un comportement de disposition réactif afin de faciliter l'affichage de la sortie. Pour plus d'informations sur la modification du comportement de disposition des graphiques, consultez [Définition du style de l'indicateur ICP](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/create-kpis.htm#Styling).
3. Cliquez sur Modifier la feuille pour passer en mode d'analyse, puis effectuez les actions suivantes dans l'ordre dans lequel elles apparaissent dans le tableau :
Actions et résultats en mode d'analyse
| Action | Résultats des indicateurs KPI |
| --- | --- |
| Sélectionnez `John` dans le filtre `FirstName`. | La mesure renvoie la valeur : `John`. |
| Sélectionnez `John` et `Peter` dans le filtre `FirstName`. | La mesure renvoie les valeurs : `John, Peter`. |
| Cliquez sur Modifier la feuille pour passer en mode d'édition, puis modifiez l'expression de la mesure ICP comme suit : `=GetFieldSelections(FirstName,'; ')` | La mesure renvoie les valeurs avec le nouveau format `value_sep` : `John; Peter`. |
| Modifiez l'expression de la mesure ICP comme suit : `=GetFieldSelections(FirstName,';', 2)` | La mesure renvoie les valeurs avec le nouvel espacement au format `value_sep` : `John;Peter`. |
| Cliquez sur Modifier la feuille pour revenir en mode d'analyse. Effacez les sélections du filtre `FirstName`, puis sélectionnez `John`, `Sue` et `Mark`. | La mesure renvoie `NOT Jane;Peter`, car le nombre de sélections dépasse l'argument `max_value` `2`. Si aucune valeur `max_value` n'est définie, tous les noms sélectionnés apparaîtront : `John; Sue; Mark`. |
L'image suivante montre les résultats de la dernière action du tableau lorsque le nombre de sélections dépasse l'argument `max_values`.
Résultats de l'ICP lors de la sélection des prénoms John, Sue, et Mark
Résultats de l'ICP lors de la sélection des prénoms John, Sue, et Mark
Résultats de l'ICP lors de la sélection des prénoms John, Sue,John, Sue, et MarkMark 
Dans cet exemple, vous pouvez voir comment les valeurs renvoyées par la fonction `GetFieldSelections` changent à mesure que des sélections sont effectuées.
## Exemple - Scénario GetFieldSelections
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getfieldselections.htm)
#### Expression de graphique
Vue d'ensemble
La fonction `GetFieldSelections` est utilisée pour mettre en évidence les noms des clients à mesure de leur sélection.
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
* Jeu de données chargé dans une table de données appelée `Example`.
* Champs suivants dans la table de données :
* `OrderID`
* `CustomerName`
* `Product`
* `Quantity`
Script de chargement
```
Example:
LOAD * INLINE [
OrderID, CustomerName, Product, Quantity
1, John Doe, Laptop, 2
2, Jane Smith, Smartphone, 1
3, Ahmed Khan, Desk, 3
4, Maria Garcia, Chair, 1
5, Li Wei, Blender, 2
];
```
Résultats
1. Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ces champs comme dimensions :
* `CustomerName`
* `Product`
2. Créez un objet ICP et ajoutez la mesure suivante :
* `=GetFieldSelections(CustomerName)`.
Note ConseilDans cet exemple, le style de l'ICP a été ajusté de sorte à utiliser un comportement de disposition réactif afin de faciliter l'affichage de la sortie. Pour plus d'informations sur la modification du comportement de disposition des graphiques, consultez [Définition du style de l'indicateur ICP](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/create-kpis.htm#Styling).
3. Cliquez sur Modifier la feuille pour passer en mode d'analyse, puis sélectionnez `Jane Smith` et `John Doe` dans le filtre `CustomerName`.
La fonction `GetFieldSelections` renvoie les valeurs : `Jane Smith, John Doe`.
Vous pouvez voir les clients sélectionnés dans le volet de filtre de l'ICP.