# GetFieldSelections — функция диаграммы

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

Если выбраны все значения, кроме двух или одного значения, будет использован формат «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, учитываются только выборки, связанные с указанным именем состояния.<br><br>Для получения дополнительной информации см. [Использование альтернативных состояний для сравнительного анализа](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm). |

Примеры и результаты:

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

Примеры и результаты

| Примеры | Результаты |
| --- | --- |
| При условии, что элемент John выбран в элементе First name.<br><br>`GetFieldSelections ([First name])` | «John» |
| При условии выбора элементов John и Peter.<br><br>`GetFieldSelections ([First name])` | «John,Peter» |
| При условии выбора элементов John и Peter.<br><br>`GetFieldSelections ([First name],'; ')` | «John; Peter» |
| При условии выбора элементов John, Sue, Mark в элементе First name.<br><br>`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 '|');
```