# GetFieldSelections - diagramfunctie
GetFieldSelections() retourneert een tekenreeks met de huidige selecties in een veld.
Als alle waarden op één of twee na worden geselecteerd, wordt respectievelijk de indeling 'NOT x,y' of 'NOT y' gebruikt. Als u alle waarden selecteert en het aantal waarden is groter dan max\_values, wordt de tekst ALL geretourneerd.
Syntaxis:
GetFieldSelections ( field\_name [, value\_sep [, max\_values [, state\_name]]])
Retourgegevenstypen: tekenreeks
Retourtekenreeksindelingen
| Opmaak | Beschrijving |
| --- | --- |
| 'a, b, c' | Als het aantal geselecteerde waarden max\_values of minder is, is de tekenreeks die wordt geretourneerd, een lijst met de geselecteerde waarden.
De waarden worden gescheiden met value\_sep als scheidingsteken. |
| 'NOT a, b, c' | Als het aantal niet-geselecteerde waarden max\_values of minder is, is de tekenreeks die wordt geretourneerd, een lijst met niet-geselecteerde waarden met NOT als een voorvoegsel.
De waarden worden gescheiden met value\_sep als scheidingsteken. |
| 'x of y' | x = het aantal geselecteerde waarden
y = het totale aantal waarden
Dit wordt geretourneerd wanneer max\_values < x < ( y - max\_values). |
| 'ALL' | Geretourneerd als alle waarden zijn geselecteerd. |
| '-' | Geretourneerd als geen waarde is geselecteerd. |
| <search string> | Als u een selectie hebt gemaakt met behulp van een zoekopdracht, wordt de zoekreeks geretourneerd. |
Argumenten
| Argumenten | Beschrijving |
| --- | --- |
| field\_name | Het veld met het bereik van gegevens die moeten worden gemeten. |
| value\_sep | Het scheidingsteken dat tussen twee veldwaarden moet worden geplaatst. De standaardwaarde is ', '. |
| max\_values | Het maximale aantal veldwaarden dat afzonderlijk moet worden vermeld. Als een groter aantal waarden wordt geselecteerd, wordt de notatie 'x van y waarden' gebruikt. De standaardwaarde is 6. |
| state\_name | De naam van een alternatieve state die voor de specifieke visualisatie is gekozen. Als het argument state\_name wordt gebruikt, wordt alleen rekening gehouden met de selecties die zijn gekoppeld aan de opgegeven statenaam.
Ga voor meer informatie naar [Alternatieve states gebruiken voor vergelijkende analyse](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm). |
Voorbeeld: diagramuitdrukkingen
| Voorbeeld | Resultaat |
| --- | --- |
| `GetFieldSelections( FirstName )` | Retourneert '`-`' (NULL) als er geen selectie is gemaakt in het veld `FirstName`. Anders wordt de waarde van de selecties geretourneerd, bijvoorbeeld `John`. |
## Voorbeeld - Basisprincipes voor GetFieldSelections
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getfieldselections.htm)
#### Diagramuitdrukking
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
* Een gegevensverzameling die wordt geladen in een tabel met de naam `Example`.
* De volgende velden in de gegevenstabel:
* `FirstName`
* `LastName`
* `Initials`
* `HasCellphone`
Load-script
```
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 '|');
```
Resultaten
1. Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg dit veld toe als dimensie:
* `FirstName`
2. Voeg een KPI-object toe en maak dan de volgende meting:
* `=GetFieldSelections(FirstName)`, om de waarden van de selectie in het veld `FirstName` te retourneren.
TipIn dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram [De stijl van de KPI aanpassen](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/create-kpis.htm#Styling)
3. Klik op Werkblad bewerken om over te schakelen naar de analysemodus en voer de volgende acties uit in de volgorde zoals ze verschijnen in de tabel:
Acties en resultaten in de analysemodus
| Actie | KPI-resultaten |
| --- | --- |
| Selecteer `John` in het filter `FirstName`. | De meting retourneert de waarde: `John`. |
| Selecteer `John` en `Peter` in het filter `FirstName`. | De meting retourneert de waarden: `John, Peter`. |
| Klik op Werkblad bewerken om over te schakelen naar de bewerkingsmodus en bewerk vervolgens de KPI-metinguitdrukking als volgt: `=GetFieldSelections(FirstName,'; ')` | De meting retourneert de waarden met de nieuwe `value_sep` indeling: `John; Peter`. |
| Bewerk de KPI-metinguitdrukking als volgt: `=GetFieldSelections(FirstName,';', 2)` | De meting retourneert de waarden met de nieuwe `value_sep` indeling: `John;Peter`. |
| Klik op Werkblad bewerken om terug te schakelen naar de analysemodus. Wis de selecties van het filter `FirstName` en selecteer vervolgens `John`, `Sue` en `Mark`. | De meting retourneert `NOT Jane;Peter`, omdat het aantal selecties groter is dan het argument `max_value` van `2`. Als er geen `max_value` is ingesteld, worden alle geselecteerde namen weergegeven: `John; Sue; Mark`. |
De volgende afbeelding toont de resultaten van de laatste actie in de tabel waarbij het aantal selecties groter is dan het argument `max_values`.
KPI-resultaten van de selectie van de voornamen John, Sue, en Mark
KPI-resultaten van de selectie van de voornamen John, Sue, en Mark
KPI-resultaten van de selectie van de voornamen John, Sue,John, Sue, en MarkMark 
In dit voorbeeld kunt u zien hoe de waarden die door de functie `GetFieldSelections` worden geretourneerd, veranderen naarmate er selecties worden gemaakt.
## Voorbeeld - Scenario met GetFieldSelections
[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getfieldselections.htm)
#### Diagramuitdrukking
Overzicht
De functie `GetFieldSelections` wordt gebruikt om namen van klanten te markeren wanneer ze worden geselecteerd.
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
* Een gegevensverzameling die wordt geladen in een tabel met de naam `Example`.
* De volgende velden in de gegevenstabel:
* `OrderID`
* `CustomerName`
* `Product`
* `Quantity`
Load-script
```
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
];
```
Resultaten
1. Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg deze velden toe als dimensies:
* `CustomerName`
* `Product`
2. Voeg een KPI-object toe en maak dan de volgende meting:
* `=GetFieldSelections(CustomerName)`.
TipIn dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram [De stijl van de KPI aanpassen](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/create-kpis.htm#Styling).
3. Klik op Werkblad bewerken om over te schakelen naar de analysemodus en selecteer vervolgens `Jane Smith` en `John Doe` in het filter `CustomerName`.
De functie `GetFieldSelections` retourneert de waarden: `Jane Smith, John Doe`.
U kunt de geselecteerde klanten zien in het filtervak in de KPI.