GetFieldSelections() は、項目内の現在の選択の string を返します。
すべての値の中で一部を除外して選択する場合、除外する値が 2 つの場合は「NOT x,y」、1 つの場合は「NOT y」形式を使用します。すべての値を選択し、その値のカウントが max_values よりも大きい場合、ALL のテキストが返されます。
Syntax:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Return data type: string
Arguments:
| 引数 | 説明 |
|---|---|
| field_name | メジャー対象となるデータ範囲が含まれている項目です。 |
| value_sep | 項目値の間に配置される区切り記号。デフォルトは「,」です。 |
| max_values |
個々にリストされる項目値の最大数です。この数が大きくなると、「x of ｙ value」(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 (max_values 引数の値に 2 が指定されているため) それ以外の場合は、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 '|');