Функция GetFieldSelections() возвращает string для текущих выборок в поле.
Если выбраны все значения, кроме двух или одного значения, будет использован формат «NOT x,y» или «NOT y» соответственно. Если выбраны все значения, и число всех значений больше, чем max_values, будет возвращен текст ALL.
Синтаксис:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Возвращаемые типы данных: строка
| Формат | Описание |
|---|---|
| 'a, b, c' |
Если число выбранных значений — max_values или меньше, возвращаемая строка представляет собой список выбранных значений. Для разделения значений используется value_sep. |
| 'NOT a, b, c' |
Если число невыбранных значений — max_values или меньше, возвращаемая строка представляет собой список невыбранных значений с префиксом NOT. Для разделения значений используется value_sep. |
| 'x of y' |
x = количество выбранных строк y = общее количество значений Это возвращается, когда max_values < x < ( y - max_values). |
| 'ALL' | Возвращается, если выбраны все значения. |
| '-' | Возвращается, если ни одно значение не выбрано. |
| <search string> | Если выборка осуществлялась посредством поиска, возвращается строка поиска. |
Аргументы:
- field_name: Поле, содержащее диапазон данных для измерения.
- value_sep: Разделитель значений в поле. По умолчанию используется «, ».
- max_values: Максимальное число отдельно отображаемых значений, введенных в поле. При вводе большого числа значений используется формат «x из y значений». По умолчанию установлено 6.
- state_name: название альтернативного состояния, которое было выбрано для конкретной визуализации. Если используется аргумент state_name, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. раздел Альтернативные состояния.
Примеры
В следующем примере используется поле 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 '|');
