# GetFieldSelections

Функция GetFieldSelections() возвращает string для текущих выборок в поле.

Если выбраны все значения, кроме двух или одного значения, будет использован формат «NOT x,y» или «NOT y» соответственно. Если выбраны все значения, и число всех значений больше, чем max\_values, будет возвращен текст ALL.

Синтаксис:

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

Возвращаемые типы данных: строка

Форматы возвращаемой строки

| Формат | Описание |
| --- | --- |
| 'a, b, c' | Если число выбранных значений — max\_values или меньше, возвращаемая строка представляет собой список выбранных значений.<br><br>Для разделения значений используется value\_sep. |
| 'NOT a, b, c' | Если число невыбранных значений — max\_values или меньше, возвращаемая строка представляет собой список невыбранных значений с префиксом NOT.<br><br>Для разделения значений используется value\_sep. |
| 'x of y' | x = количество выбранных строк<br><br>y = общее количество значений<br><br>Это возвращается, когда max\_values &lt; x &lt; ( y - max\_values). |
| 'ALL' | Возвращается, если выбраны все значения. |
| '-' | Возвращается, если ни одно значение не выбрано. |
| &lt;search string&gt; | Если выборка осуществлялась посредством поиска, возвращается строка поиска. |

Аргументы:

* field\_name: Поле, содержащее диапазон данных для измерения.
* value\_sep: Разделитель значений в поле. По умолчанию используется «, ».
* max\_values: Максимальное число отдельно отображаемых значений, введенных в поле. При вводе большого числа значений используется формат «x из y значений». По умолчанию установлено 6.
* state\_name: название альтернативного состояния, которое было выбрано для конкретной визуализации. Если используется аргумент state\_name, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. раздел [Альтернативные состояния](https://help.qlik.com/ru-RU/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Alternate%20States.htm).

## Примеры

В следующем примере используется поле First name, загруженное в список.

Пример 1: John выбран в First name

`GetFieldSelections ([First name])`

Возвращает «John»

Пример 2: John и Peter выбраны в First name

`GetFieldSelections ([First name])`

Возвращает «John,Peter»

Пример 3: John и Peter выбраны в First name

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

Возвращает «John; Peter»

Пример 4: John, Sue, Mark выбраны в First name

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

возвращает «NOT Jane;Peter», поскольку значение 2 указано как значение аргумента max\_values. В противном случае результат был бы John; Sue; Mark.

Данные, используемые в примере:

`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 '|');`