# GetFieldSelections

Funkcja GetFieldSelections() zwraca ciąg string zawierający bieżące selekcje w danym polu.

Jeśli wybrano wszystkie wartości oprócz jednej albo dwóch, zastosowany zostanie odpowiednio format NOT x,y albo NOT y. Jeśli wybrano wszystkie wartości i liczba tych wszystkich wartości będzie większa niż max\_values, zwrócona zostanie wartość ALL.

Składnia:

GetFieldSelections ( field\_name [, value\_sep [, max\_values [, state\_name]]])

Typ zwracanych danych: ciąg znaków

Formaty zwracanych ciągów

| Format | Opis |
| --- | --- |
| 'a, b, c' | Jeśli liczba wybranych wartości wynosi max\_values lub jest mniejsza, zwracany ciąg jest listą wybranych wartości.<br><br>Wartości rozdziela value\_sep jako ogranicznik. |
| 'NOT a, b, c' | Jeśli liczba niewybranych wartości wynosi max\_values lub jest mniejsza, zwracany ciąg jest listą niewybranych wartości z prefiksem NOT.<br><br>Wartości rozdziela value\_sep jako ogranicznik. |
| 'x of y' | x = liczba wybranych wartości<br><br>y = łączna liczba wartości<br><br>Jest to zwracane, gdy max\_values &lt; x &lt; ( y - max\_values). |
| 'ALL' | Zwracane, gdy wybrane są wszystkie wartości. |
| '-' | Zwracane, gdy nie ma żadnych wybranych wartości. |
| &lt;search string&gt; | Jeżeli wybrano, używając wyszukiwania, zostanie zwrócony ciąg wyszukiwania. |

Argumenty:

* field\_name: Pole zawierające mierzony zakres danych.
* value\_sep: Separator do umieszczenia między wartościami pola. Wartością domyślną jest ', '.
* max\_values: Maksymalna liczba wartości pola, które mogą zostać osobno podane. Jeśli zostanie wybrana większa liczba wartości, zostanie użyty format „x z y wartości”. Wartością domyślną jest 6.
* state\_name: nazwa stanu alternatywnego, który został wybrany dla danej wizualizacji. Jeśli używany jest argument state\_name, uwzględniane są tylko wybory powiązane z określoną nazwą stanu. Więcej informacji zawiera temat [Stany alternatywne](https://help.qlik.com/pl-PL/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Alternate%20States.htm).

## Przykłady

W następujących przykładach używa się pola First name załadowanego do listy wartości.

Przykład 1: John wybrano w First name

`GetFieldSelections ([First name])`

zwraca wartość „John”

Przykład 2: John i Peter wybrano w First name

`GetFieldSelections ([First name])`

zwraca wartość „John,Peter”

Przykład 3: John i Peter wybrano w First name

`GetFieldSelections ([First name],'; ')`

zwraca wartość „John; Peter”

Przykład 4: John, Sue, Mark wybrano w First name

`GetFieldSelections ([First name],';',2)`

zwraca NOT Jane;Peter, ponieważ wartość 2 jest wartością argumentu max\_values. W przeciwnym razie zwrócona zostałaby wartość John; Sue; Mark.

Dane zastosowane w przykładzie:

`Names:` `LOAD * inline [` `"First name"|"Last name"|Initials|"Has cellphone"` `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 '|');`