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, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. Использование альтернативных состояний для сравнительного анализа. |
| Пример | Результат |
|---|---|
GetCurrentSelections () | Возвращает-, если в полях ничего не выбрано. Если задана выборка, возвращается имя поля и значение, например, First Name : John. |
Пример. Основы использования функции GetCurrentSelections
Обзор
Этот пример демонстрирует, как меняются значения, возвращаемые функцией 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 '|');Результаты
Загрузите данные и откройте лист. Создайте новый фильтр и добавьте эти поля в качестве измерения:
FirstName
Initials
Добавьте объект "Ключевой показатель эффективности", затем создайте следующую меру:
=GetCurrentSelections (), чтобы найти текущие выборки.
Ключевой показатель эффективности возвращает (-), потому что нет выбранных значений.
Нажмите Изменить лист, чтобы перейти в режим анализа, затем в поле FirstName выберите John. Ключевой показатель эффективности возвращает следующее: FirstName: John.
Теперь выберите Peter, чтобы были выбраны и John, и Peter. Ключевой показатель эффективности возвращает следующее: FirstName: John, Peter.
Добавьте к выборке JA из поля Initials. Ключевой показатель эффективности возвращает следующее: First name: John, Peter Initials: JA.
Очистите выборку и выполните следующее:
Выберите John в поле FirstName и JA в поле Initials.
Измените выражение Ключевого показателя эффективности следующим образом: =GetCurrentSelections ( chr(13)&chr(10) , ' = ' ), чтобы заменить разделитель тегов на знак равенства (=).
Примечание к информацииКлючевой показатель эффективности не поддерживает перевод строки и добавляет пробел в качестве разделителя записей.
Очистите выбор и выполните следующее:
Выберите все имена, за исключением Sue, в поле FirstName.
Измените выражение Ключевого показателя эффективности следующим образом: =GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3), чтобы добавить разделитель тегов (=), разделитель значений (,) и максимальное число значений в списке (3).
Ключевой показатель эффективности возвращает значение : FirstName=NOT Sue, потому что выбрано четыре имени, но аргументом max_values разрешено только три. Если изменить аргумент max_values на 4, по той же выборке будут по отдельности перечислены все четыре значения.
Пример - Настройка заголовка диаграммы для отображения разных выборок
Обзор
В этом примере показано, как использовать функцию 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
];Результаты
Загрузите данные и откройте лист. Создайте новый фильтр и добавьте эти поля в качестве измерения:
Region
Year
Создайте линейный график и добавьте следующие измерения:
Year
Region
Создайте следующую меру:
=Sum(SalesAmount), чтобы отобразить общую сумму продаж.
На панели свойств меры, в разделе Вид > Общее > Название, введите следующее выражение: ='Sales Analysis for: ' & GetCurrentSelections().
Результат показывает сумму продаж по всем регионам и за все годы. Название диаграммы отображается как Sales Analysis for:.
Нажмите Изменить лист , чтобы перейти в режим анализа, затем выберите следующее:
В поле Регион выберите East и North.
В поле Год выберите 2022 и 2023.
Заголовок диаграммы меняется в зависимости от выборки Region и Year.