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 以下の場合、返される文字列は選択値のリストになります。 値は 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 of ｙ value」(x/y 個) という表記が使用されます。デフォルトは 6 です。 |
| state_name | 特定のビジュアライゼーションのために選択された並列ステートの名前。state_name 引数が使用されると、特定のステート名に関連付けられた選択のみが対象になります。 詳細については、「並列ステートを使用した比較分析」を参照してください。 |
| 例 | 結果 |
|---|---|
GetFieldSelections( FirstName ) | FirstName 項目で選択されていない場合、「-」(NULL) を返します。それ以外の場合は、選択項目の値 (John など) を返します。 |
例 - GetFieldSelections の基本
概要
データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。
ロード スクリプトには次が含まれています:
「Example」というデータ テーブルにロードされるデータセット。
データ テーブル内の次の項目:
FirstName
LastName
Initials
HasCellphone
ロード スクリプト
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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 '|');結果
データをロードしてシートを開きます。新しいフィルター パネルを作成し、次の項目を軸として追加します。
FirstName
KPI オブジェクトを作成し、次のメジャーを追加します。
=GetFieldSelections(FirstName)、FirstName 項目で選択された値を返します。
ヒント メモこの例では、出力を見やすくするために、応答性が高いレイアウト動作を使用するように KPI のスタイルが調整されています。チャートのレイアウト動作の変更については、「KPI のスタイル指定」を参照してください[シートを編集] をクリックして分析モードに切り替え、表に表示されている順序で次のアクションを実行します。
分析モードでのアクションと結果 アクション KPI 結果 FirstName フィルターから John を選択します。 メジャーは、値 John を返します。
FirstName フィルターから John および Peter を選択します。 メジャーは、値 John, Peter を返します。
[シートを編集] をクリックして編集モードに切り替え、KPI メジャー式を =GetFieldSelections(FirstName,'; ') のように編集します。 メジャーは新しい value_sep 形式で John; Peter の値を返します。
KPI メジャー式を =GetFieldSelections(FirstName,';', 2) のように編集します。 メジャーは新しい value_sep 形式の間隔で John;Peter の値を返します。
[シートを編集] をクリックして分析モードに戻ります。FirstName フィルターの選択をクリアし、John、Sue、Mark を選択します。 選択数が 2 の引数 max_value を超えているため、メジャーは NOT Jane;Peter を返します。max_value が設定されていない場合、選択されたすべての名前である John; Sue; Mark が表示されます。
次の画像は、選択数が max_values 引数を超えるテーブル内の最後のアクションの結果を示しています。
ファースト ネーム John, Sue, と Mark を選択した KPI 結果
この例では、選択が行われると GetFieldSelections 関数によって返される値がどのように変化するかを確認できます。
例 - GetFieldSelections のシナリオ
概要
GetFieldSelections 関数は、選択された顧客名を強調表示するために使用されます。
データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。
ロード スクリプトには次が含まれています:
「Example」というデータ テーブルにロードされるデータセット。
データ テーブル内の次の項目:
OrderID
CustomerName
Product
Quantity
ロード スクリプト
Example:
LOAD * INLINE [
OrderID, CustomerName, Product, Quantity
1, John Doe, Laptop, 2
2, Jane Smith, Smartphone, 1
3, Ahmed Khan, Desk, 3
4, Maria Garcia, Chair, 1
5, Li Wei, Blender, 2
];結果
データをロードしてシートを開きます。新しいフィルター パネルを作成し、次の項目を軸として追加します。
CustomerName
Product
KPI オブジェクトを作成し、次のメジャーを追加します。
=GetFieldSelections(CustomerName).
ヒント メモこの例では、出力を見やすくするために、応答性が高いレイアウト動作を使用するように KPI のスタイルが調整されています。チャートのレイアウト動作の変更については、「KPI のスタイル指定」を参照してください。[シートを編集] をクリックして分析モードに切り替え、CustomerName フィルターから Jane Smith および John Doe を選択します。
GetFieldSelections 関数は、値 Jane Smith, John Doe を返します。
KPI のフィルター パネルで選択された顧客を確認できます。