# GetExcludedCount - チャート関数

GetExcludedCount() は、特定した項目に含まれる除外された個別の値の数を検出します。除外された (濃いグレー) 項目のみがカウントされます。代替値 (薄いグレー) および選択された除外値 (チェックマーク付きの濃いグレー) はカウントされません。

構文:

GetExcludedCount (field\_name)

戻り値データ型： 整数

情報メモ

選択バーや各選択状態で使用される色は、カスタム テーマを使用して変更できます。カスタム テーマを使用しているアプリケーションで作業している場合、選択内容がこのヘルプ トピックで説明されている色と同じ色で表示されないことがあります。

引数

| 引数 | 説明 |
| --- | --- |
| field\_name | メジャー対象となるデータ範囲が含まれている項目です。 |

次の表には、この関数に関連するその他の関数が示されています。

関連する関数

| ファンクション | 相互作用 |
| --- | --- |
| [GetStateCounts - チャート関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm) | GetStateCounts() を使用すると、単一の関数呼び出しを使用して、次の個数の計算を組み合わせることができます。<br><br><ul><li><p>選択された含められた値の個数。</p></li><li><p>可能な値の個数。</p></li><li><p>代替値の個数。</p></li><li><p>代替値と選択された除外値を含まない、除外値の個数。</p></li><li><p>選択された除外値の個数。</p></li></ul> |
| [GetSelectedCount - チャート関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) | 選択された含められた値の個数を返します。 |
| [GetPossibleCount - チャート関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) | 可能な値の個数を返します。 |
| [GetAlternativeCount - チャート関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm) | 代替値の個数を返します。 |

例: チャートの数式

| 例 | 結果 |
| --- | --- |
| `GetExcludedCount( Initials )` | 選択が行われていない場合は `0` を返します。選択が行われた場合、返される値は `Initials` の除外された値の数であり、濃いグレーで表示されます。 |

## 例 - GetExcludedCount の基本

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm)

#### チャートの数式

概要

この例では、追加の選択が行われると、`GetExcludedCount` 関数によって返される値がどのように変化するかを示します。

データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。

ロード スクリプトには次が含まれています:

* 「`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 '|');
```

結果

1. データをロードしてシートを開きます。新しいフィルター パネルを作成し、次の項目を軸として追加します。

   * `FirstName`

   * `LastName`

   * `Initials`

2. 3 つの KPI オブジェクトを作成し、KPI オブジェクトごとに 1 つずつ、次の数式をメジャーとして追加します。

   1. `=GetExcludedCount(FirstName)`、`FirstName` 項目内の除外された値の数をカウントします。

   2. `=GetExcludedCount(Initials)`、`Initials` 項目内の除外された値の数をカウントします。

   3. `=GetExcludedCount(LastName)`、`LastName` 項目内の除外された値の数をカウントします。

   値が選択されていないため、シートは次の画像のようになります。`GetExcludedCount` 関数は、各 KPI に対して`0` を返します。

   ![First Name、Initials、Last Name のフィルター パネルと、これらの項目で除外された値のカウントを返す 3 つの KPI オブジェクトを含むシート。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example.png)

3. [シートを編集] をクリックして分析モードに切り替え、次の選択を順番に実行します。

   分析モードでのフィルター選択と結果

   | フィルター パネルの選択 | KPI 結果 |
   | --- | --- |
   | `FirstName` フィルターから `John` を選択します。 | <ul><li><code>Initials</code> には濃いグレーの <code>5</code> つの除外値があるため、<code>GetExcludedCount (Initials)</code> は <code>5</code> の値を返します。<code>JA</code> 値は、<code>FirstName</code> の <code>John</code> という選択に関連付けられているため、白色のままになります。 </li><li><code>LastName</code> には濃いグレーの <code>5</code> つの除外値があるため、<code>GetExcludedCount (LastName)</code> は <code>5</code> の値を返します。<code>Anderson</code> 値は、<code>FirstName</code> の <code>John</code> という選択に関連付けられているため、白色のままになります。 </li></ul> |
   | `FirstName` フィルターから `John` および `Peter` を選択します。 | <ul><li><code>Initials</code> には濃いグレーの <code>3</code> つの除外値があるため、<code>GetExcludedCount (Initials)</code> は <code>3</code> の値を返します。 </li><li><code>LastName</code> には濃いグレーの <code>3</code> つの除外値があるため、<code>GetExcludedCount (LastName)</code> は <code>3</code> の値を返します。 </li></ul> |
   | `John` と `Peter` を選択した状態で、`LastName` フィルターで `Franc` を選択します。 | <ul><li><code>FirstName</code> には濃いグレーで選択チェックマークのない <code>3</code> つの除外値があるため、<code>GetExcludedCount (FirstName)</code> は <code>3</code> の値を返します。<code>The GetExcludedCount</code> 関数は除外値のみをカウントします。代替値および選択された除外値はカウントに含まれません。<code>John</code> は選択された除外値です。 </li><li><code>Initials</code> には濃いグレーの <code>5</code> つの除外値があるため、<code>GetExcludedCount (Initials)</code> は <code>5</code> の値を返します。 </li><li><code>LastName</code> には濃いグレーの <code>3</code> つの除外値があるため、<code>GetExcludedCount (LastName)</code> は <code>3</code> の値を返します。2 つの薄いグレーの値である、<code>Anderson</code> と <code>Devonshire</code> は代替値です。 </li></ul> |
   | 以前の選択をそのままにして、`LastName` フィルターで `Anderson` を選択します。 | <ul><li><code>FirstName</code> には濃いグレーの <code>3</code> つの除外値があるため、<code>GetExcludedCount (FirstName)</code> は <code>3</code> の値を返します。 </li><li><code>Initials</code> には濃いグレーの <code>4</code> つの除外値があるため、<code>GetExcludedCount (Initials)</code> は <code>4</code> の値を返します。 </li><li><code>LastName</code> には濃いグレーの <code>3</code> つの除外値があるため、<code>GetExcludedCount (LastName)</code> は <code>3</code> の値を返します。 </li></ul> |

フィルター パネルの選択の最終結果は、次の画像で確認できます。

ファースト ネーム John と Peter、ラスト ネーム Franc と Andersonを選択した KPI 結果

ファースト ネーム John と Peter、ラスト ネーム Franc と Andersonを選択した KPI 結果

ファースト ネーム JohnJohn と PeterPeter、ラスト ネーム FrancFranc と AndersonAndersonを選択した KPI 結果![First Name と Last Name の項目の選択と、これらの選択に対応する KPI 結果を含むシート。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example2.png)

## 例 - GetExcludedCount のシナリオ

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm)

#### チャートの数式

概要

営業マネージャーは、`GetExcludedCount` 関数を使用して KPI チャートを作成し、営業担当者が販売した製品を分析します。

データ ロード エディターを開き、以下のロード スクリプトを新しいセクションに追加します。

ロード スクリプトには次が含まれています:

* 「`Example`」というデータ テーブルにロードされるデータセット。

* データ テーブル内の次の項目:

  * `Salesperson`

  * `Product`

  * `SalesAmount`

ロード スクリプト

```
Example:
LOAD * INLINE [
Salesperson, Product, SalesAmount
John, Laptops, 1000
Alice, Smartphones, 800
Bob, Laptops, 1200
Carol, Tablets, 700
Dave, Tablets, 900
];
```

結果

1. データをロードしてシートを開きます。新しいフィルター パネルを作成し、次の項目を軸として追加します。

   * `Salesperson`

   * `Product`

2. 新しい KPI オブジェクトを作成し、次のメジャーを追加します。

   * `=GetExcludedCount(Product)`、`Product` 項目内の除外された値の数を見つけます。

3. [シートを編集] をクリックして分析モードに切り替え、`Salesperson` フィルターから `Alice` を選択します。

   `Product` 項目に `2` つの一意の値と除外された値 (濃いグレー) があるため、`GetExcludedCount` 関数は `2` の値を返します。

   ![First Name、Initials、Last Name のフィルター パネルと、これらの項目で除外された値のカウントを返す 3 つの KPI オブジェクトを含むシート。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example3.png)

結果は、`GetExcludedCount` 関数を使用してデータを分析する方法を示しています。営業担当者 `Alice` は、3 つの製品グループのうち 2 つの製品グループ (`Laptop` 製品と `Tablet` 製品) を販売していません。