GetFieldSelections — функция диаграммы
Функция GetFieldSelections() возвращает строку с текущими выборками в поле.
Если выбраны все значения, кроме двух или одного значения, будет использован формат «NOT x,y» или «NOT y» соответственно. Если выбраны все значения и число всех значений больше, чем max_values, будет возвращен текст ALL.
Syntax:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Return data type: строка
Arguments:
Аргументы | Описание |
---|---|
field_name | Поле, содержащее диапазон данных для измерения. |
value_sep | Разделитель значений в поле. По умолчанию используется «, ». |
max_values |
Максимальное число отдельно отображаемых значений, введенных в поле. При вводе большого числа значений используется формат «x из y значений». По умолчанию установлено 6. |
state_name |
Имя альтернативного состояния, выбранное для определенной визуализации. Если используется аргумент state_name, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. Использование альтернативных состояний для сравнительного анализа. |
Examples and results:
В следующем примере используется значение поля First name, загруженное в фильтр.
Примеры | Результаты |
---|---|
При условии, что элемент John выбран в элементе First name. GetFieldSelections ([First name]) |
«John» |
При условии выбора элементов John и Peter. GetFieldSelections ([First name]) |
«John,Peter» |
При условии выбора элементов John и Peter. GetFieldSelections ([First name],'; ') |
«John; Peter» |
При условии выбора элементов 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 '|');