GetFieldSelections - 图表函数
GetFieldSelections() 用于返回包含字段内当前选择项的字符串。
如果选择除两个值以外的所有值,或除一个值以外的所有值,则分别使用格式“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 字段。
示例 | 结果 |
---|---|
假定选择 John(在 First name 中)。 GetFieldSelections ([First name]) |
“John” |
假定已选择 John 和 Peter。 GetFieldSelections ([First name]) |
“John,Peter” |
假定已选择 John 和 Peter。 GetFieldSelections ([First name],'; ') |
“John; Peter” |
假定已在 First name 中选择 John、Sue、Mark。 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 '|');