# GetExcludedCount - 图表函数

GetExcludedCount() 用于查找标识字段中排除的相异值的数量。仅计算排除的（深灰色）字段。备选值（浅灰色）和选定的排除值（带复选标记的深灰色）不计算在内。

语法：

GetExcludedCount (field\_name)

返回数据类型： 整数

信息注释

选择栏中使用的颜色以及每个选择项状态都可以使用自定义主题进行修改。如果您所用的是使用自定义主题的应用程序，您可能会注意到您的选择显示的颜色与该帮助主题中描述的颜色不同。

参数

| 参数 | 描述 |
| --- | --- |
| field\_name | 包含要度量的数据范围的字段。 |

下表列出了与此函数相关的其他函数。

相关函数

| 函数 | 交互 |
| --- | --- |
| [GetStateCounts - 图表函数](https://help.qlik.com/zh-CN/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/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) | 返回所选包含值的计数。 |
| [GetPossibleCount - 图表函数](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) | 返回可能值的计数。 |
| [GetAlternativeCount - 图表函数](https://help.qlik.com/zh-CN/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. 创建三个 KPI 对象，并添加以下表达式作为度量，每个 KPI 对象一个表达式：

   1. `=GetExcludedCount(FirstName)`，用来统计 `FirstName` 字段中排除值的数量。

   2. `=GetExcludedCount(Initials)`，用来统计 `Initials` 字段中排除值的数量。

   3. `=GetExcludedCount(LastName)`，用来统计 `LastName` 字段中排除值的数量。

   您的工作表将如下图所示，因为没有选择任何值。`GetExcludedCount` 函数返回每个 KPI 的 `0`。

   ![一个包含“名字”、“姓名首字母”和“姓氏”筛选窗格的工作表，以及三个 KPI 对象，每个 KPI 对象都返回这些字段中任何排除值的计数。](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example.png)

3. 单击编辑工作表切换到分析模式，然后依序进行以下选择：

   分析模式下筛选选择项和结果

   | 筛选器窗格选择 | KPI 结果 |
   | --- | --- |
   | 在 `FirstName` 筛选器中选择 `John`。 | <ul><li><code>GetExcludedCount (Initials)</code> 返回 <code>5</code> 的一个值，因为<code>Initials</code> 中有 <code>5</code> 个排除值，颜色为深灰色。 <code>JA</code> 值将保持白色，因为它与 <code>FirstName</code> 中的选择 <code>John</code> 相关联。 </li><li><code>GetExcludedCount (LastName)</code> 返回 <code>5</code> 的一个值，因为<code>LastName</code> 中有 <code>5</code> 个排除值，颜色为深灰色。 <code>Anderson</code> 值将保持白色，因为它与 <code>FirstName</code> 中的选择 <code>John</code> 相关联。 </li></ul> |
   | 在 `FirstName` 筛选器中选择 `John` 和 `Peter`。 | <ul><li><code>GetExcludedCount (Initials)</code> 返回 <code>3</code> 的一个值，因为<code>Initials</code> 中有 <code>3</code> 个排除值，颜色为深灰色。 </li><li><code>GetExcludedCount (LastName)</code> 返回 <code>3</code> 的一个值，因为<code>LastName</code> 中有 <code>3</code> 个排除值，颜色为深灰色。 </li></ul> |
   | 选择 `John` 和 `Peter` 后，在 `LastName` 筛选器中选择 `Franc` 。 | <ul><li><code>GetExcludedCount (FirstName)</code>返回值 <code>3</code>，因为 <code>FirstName</code> 中有 <code>3</code> 个排除值，颜色为深灰色，没有选择复选标记。<code>The GetExcludedCount</code> 函数仅计算排除值。备选和选定的排除值不包括在计数中。<code>John</code> 是选定的排除值。 </li><li><code>GetExcludedCount (Initials)</code> 返回 <code>5</code> 的一个值，因为<code>Initials</code> 中有 <code>5</code> 个排除值，颜色为深灰色。 </li><li><code>GetExcludedCount (LastName)</code> 返回 <code>3</code> 的一个值，因为<code>LastName</code> 中有 <code>3</code> 个排除值，颜色为深灰色。<code>Anderson</code> 和 <code>Devonshire</code> 这两个浅灰色值是替代值。 </li></ul> |
   | 保留之前的选择，然后在 `LastName` 筛选器中选择 `Anderson` 。 | <ul><li><code>GetExcludedCount (FirstName)</code> 返回 <code>3</code> 的一个值，因为<code>FirstName</code> 中有 <code>3</code> 个排除值，颜色为深灰色。 </li><li><code>GetExcludedCount (Initials)</code> 返回 <code>4</code> 的一个值，因为<code>Initials</code> 中有 <code>4</code> 个排除值，颜色为深灰色。 </li><li><code>GetExcludedCount (LastName)</code> 返回 <code>3</code> 的一个值，因为<code>LastName</code> 中有 <code>3</code> 个排除值，颜色为深灰色。 </li></ul> |

您可以在下图中看到筛选器窗格选择的最终结果。

选择名字 John 和 Peter，以及姓氏 Franc 和 Anderson 的 KPI 结果

选择名字 John 和 Peter，以及姓氏 Franc 和 Anderson 的 KPI 结果

选择名字 JohnJohn 和 PeterPeter，以及姓氏 FrancFranc 和 AndersonAnderson 的 KPI 结果![工作表，其中包含对名字和姓氏字段的选择，以及这些选择所对应的 KPI 结果。](https://help.qlik.com/zh-CN/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`。

   `GetExcludedCount` 函数返回一个值 `2`，因为 `Product` 字段中有 `2` 个唯一和排除的（深灰色）值。

   ![一个包含“名字”、“姓名首字母”和“姓氏”筛选窗格的工作表，以及三个 KPI 对象，每个 KPI 对象都返回这些字段中任何排除值的计数。](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example3.png)

结果显示了如何使用 `GetExcludedCount` 函数来分析数据。销售人员 `Alice` 未售出 3 个产品组中 2 个组的任何产品（`Laptop` 和 `Tablet` 产品）。