# GetCurrentSelections — функция диаграммы
GetCurrentSelections() возвращает список текущих выборок в приложении. Если выборки были выполнены при помощи строки поиска в окне поиска, GetCurrentSelections() возвращает строку поиска.
Если параметры используются, необходимо указать record\_sep. Чтобы указать новый размер строки, установите для параметра record\_sep значение chr(13)&chr(10).
Если выбраны все значения, кроме двух или одного значения, будет использован формат «NOT x,y» или «NOT y» соответственно. Если выбраны все значения, и число всех значений больше, чем max\_values, будет возвращен текст ALL.
Синтаксис:
GetCurrentSelections ([record\_sep [, tag\_sep [, value\_sep [, max\_values [, state\_name]]]]])
Возвращаемые типы данных: string
Аргументы
| Аргументы | Описание |
| --- | --- |
| record\_sep | Разделитель должен стоять между записями в поле. Значение по умолчанию <CR><LF> означает новую строку. |
| tag\_sep | Разделитель должен стоять между тегом имени поля и значениями поля. По умолчанию используется '` : `'. |
| value\_sep | Разделитель значений в поле. По умолчанию используется «, ». |
| max\_values | Максимальное число отдельно отображаемых значений, введенных в поле. При вводе большого числа значений используется формат «x из y значений». По умолчанию установлено 6. |
| state\_name | Имя альтернативного состояния, выбранное для определенной визуализации. Если используется аргумент state\_name, учитываются только выборки, связанные с указанным именем состояния.
Для получения дополнительной информации см. [Использование альтернативных состояний для сравнительного анализа](https://help.qlik.com/ru-RU/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm). |
Пример: выражения диаграммы
| Пример | Результат |
| --- | --- |
| `GetCurrentSelections ()` | Возвращает`-`, если в полях ничего не выбрано. Если задана выборка, возвращается имя поля и значение, например, `First Name : John`. |
## Пример. Основы использования функции GetCurrentSelections
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getcurrentselections.htm)
#### Выражение диаграммы
Обзор
Этот пример демонстрирует, как меняются значения, возвращаемые функцией `GetCurrentSelections`, в зависимости от выбора.
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.
Скрипт загрузки содержит следующее:
* Набор данных, который загружается в таблицу данных под именем `Example`.
* Следующие поля в таблице данных:
* `FirstName`
* `LastName`
* `Initials`
* `HasCellphone`
Скрипт загрузки
```
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 '|');
```
Результаты
1. Загрузите данные и откройте лист. Создайте новый фильтр и добавьте эти поля в качестве измерения:
* `FirstName`
* `Initials`
2. Добавьте объект "Ключевой показатель эффективности", затем создайте следующую меру:
* `=GetCurrentSelections ()`, чтобы найти текущие выборки.
Ключевой показатель эффективности возвращает (`-`), потому что нет выбранных значений.
Примечание к подсказкеВ этом примере стиль ключевого показателя эффективности изменен для использования адаптивного поведения макета, чтобы было удобнее просматривать результаты. [Настройка стиля КПЭ](https://help.qlik.com/ru-RU/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/KPI.htm#Styling).
3. Нажмите Изменить лист, чтобы перейти в режим анализа, затем в поле `FirstName` выберите `John`. Ключевой показатель эффективности возвращает следующее: `FirstName: John`.
* Теперь выберите `Peter`, чтобы были выбраны и `John`, и `Peter`. Ключевой показатель эффективности возвращает следующее: `FirstName: John, Peter`.
* Добавьте к выборке `JA` из поля `Initials`. Ключевой показатель эффективности возвращает следующее: `First name: John, Peter Initials: JA`.
4. Очистите выборку и выполните следующее:
* Выберите `John` в поле `FirstName` и `JA` в поле `Initials`.
* Измените выражение Ключевого показателя эффективности следующим образом: `=GetCurrentSelections ( chr(13)&chr(10) , ' = ' )`, чтобы заменить разделитель тегов на знак равенства (`=`).
Примечание к информацииКлючевой показатель эффективности не поддерживает перевод строки и добавляет пробел в качестве разделителя записей.
5. Очистите выбор и выполните следующее:
* Выберите все имена, за исключением `Sue`, в поле `FirstName`.
* Измените выражение Ключевого показателя эффективности следующим образом: `=GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3)`, чтобы добавить разделитель тегов (`=`), разделитель значений (`,`) и максимальное число значений в списке (`3`).
Ключевой показатель эффективности возвращает значение : `FirstName=NOT Sue`, потому что выбрано четыре имени, но аргументом `max_values` разрешено только три. Если изменить аргумент `max_values` на `4`, по той же выборке будут по отдельности перечислены все четыре значения.
## Пример - Настройка заголовка диаграммы для отображения разных выборок
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getcurrentselections.htm)
#### Выражение диаграммы
Обзор
В этом примере показано, как использовать функцию `GetCurrentSelections` для создания динамических заголовков диаграмм на основе выбора пользователя.
Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.
Скрипт загрузки содержит следующее:
* Набор данных, который загружается в таблицу данных под именем `Example`.
* Следующие поля в таблице данных:
* `SalesID`
* `Product`
* `Year`
* `Region`
* `SalesAmount`
Скрипт загрузки
```
Example:
LOAD * INLINE [
SalesID, Product, Year, Region, SalesAmount
1, WidgetA, 2021, North, 500
2, WidgetB, 2021, South, 600
3, WidgetC, 2021, East, 450
4, WidgetA, 2021, West, 700
5, WidgetB, 2022, North, 550
6, WidgetC, 2022, South, 425
7, WidgetB, 2022, East, 650
8, WidgetC, 2022, West, 250
9, WidgetB, 2023, North, 650
10, WidgetC, 2023, South, 325
11, WidgetB, 2023, East, 550
12, WidgetC, 2023, West, 450
13, WidgetB, 2024, North, 550
14, WidgetC, 2024, South, 525
15, WidgetB, 2024, East, 350
16, WidgetC, 2024, West, 650
];
```
Результаты
1. Загрузите данные и откройте лист. Создайте новый фильтр и добавьте эти поля в качестве измерения:
* `Region`
* `Year`
2. Создайте линейный график и добавьте следующие измерения:
* `Year`
* `Region`
3. Создайте следующую меру:
* `=Sum(SalesAmount)`, чтобы отобразить общую сумму продаж.
4. На панели свойств меры, в разделе Вид > Общее > Название, введите следующее выражение: `='Sales Analysis for: ' & GetCurrentSelections()`.
Результат показывает сумму продаж по всем регионам и за все годы. Название диаграммы отображается как `Sales Analysis for:`.
5. Нажмите Изменить лист , чтобы перейти в режим анализа, затем выберите следующее:
* В поле Регион выберите `East` и `North`.
* В поле Год выберите `2022` и `2023`.
Заголовок диаграммы меняется в зависимости от выборки `Region` и `Year`.