# GetFieldSelections - チャート関数

GetFieldSelections() は、項目内の現在の選択の string を返します。

すべての値の中で一部を除外して選択する場合、除外する値が 2 つの場合は「NOT x,y」、1 つの場合は「NOT y」形式を使用します。すべての値を選択し、その値のカウントが max\_values よりも大きい場合、ALL のテキストが返されます。

構文:

GetFieldSelections ( field\_name [, value\_sep [, max\_values [, state\_name]]])

戻り値データ型： 文字列

返される文字列の書式

| 書式 | 説明 |
| --- | --- |
| 'a, b, c' | 選択された値の数が max\_values 以下の場合、返される文字列は選択値のリストになります。<br><br>値は value\_sep を区切り記号として区切ります。 |
| 'NOT a, b, c' | 非選択値の数が max\_values 以下の場合、返される文字列は、非選択値のリストに NOT を前置したものです。<br><br>値は value\_sep を区切り記号として区切ります。 |
| 'x of y' | x = 選択値の数<br><br>y = 値の合計数<br><br><br>max\_values &lt; x &lt; ( y - max\_values) のときに返されます。 |
| 'ALL' | すべての値が選択されている場合に返されます。 |
| '-' | 値が選択されていない場合に返されます。 |
| &lt;search string&gt; | [検索] を選択した場合、検索文字列が返されます。 |

引数：

引数

| 引数 | 説明 |
| --- | --- |
| field\_name | メジャー対象となるデータ範囲が含まれている項目です。 |
| value\_sep | 項目値の間に配置される区切り記号。デフォルトは「,」です。 |
| max\_values | 個々にリストされる項目値の最大数です。この数が大きくなると、「x of ｙ value」(x/y 個) という表記が使用されます。デフォルトは 6 です。 |
| state\_name | 特定のビジュアライゼーションのために選択された並列ステートの名前。state\_name 引数が使用されると、特定のステート名に関連付けられた選択のみが対象になります。<br><br>詳細については、「[並列ステートを使用した比較分析](https://help.qlik.com/ja-JP/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm)」を参照してください。 |

例と結果:

次の例では、フィルター パネルにロードされた First name 項目を使用しています。

例と結果

| 例 | 結果 |
| --- | --- |
| John が First name に選択されている場合<br><br>`GetFieldSelections ([First name])` | 「John」 |
| John と Peter が選択されている場合<br><br>`GetFieldSelections ([First name])` | 「John,Peter」 |
| John と Peter が選択されている場合<br><br>`GetFieldSelections ([First name],'; ')` | 「John; Peter」 |
| Johnと Sue、Mark が First name に選択されている場合<br><br>`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 '|');
```