# GetExcludedCount — функция диаграммы

GetExcludedCount() находит количество исключенных уникальных значений в указанном поле. Засчитываются только исключенные (темно-серые) поля. Альтернативные (светло-серые) или выбранные исключенные (темно-серые с флажком) значения не засчитываются.

Синтаксис:

GetExcludedCount (field\_name)

Возвращаемые типы данных: целое

Примечание к информации

Цвета, используемые на панели выборок и для каждого состояния выборки, можно изменить с помощью пользовательской темы. При работе с приложением, в котором применяется пользовательская тема, можно заметить, что отображаемые цвета выборок не совпадают с описанными в этом разделе справки.

Аргументы

| Аргументы | Описание |
| --- | --- |
| field\_name | Поле, содержащее диапазон данных для измерения. |

В следующей таблице перечислены другие функции, связанные с данной функцией.

Связанные функции

| Функция | Взаимодействие |
| --- | --- |
| [GetStateCounts — функция диаграммы](https://help.qlik.com/ru-RU/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/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) | Возвращает количество выбранных включенных значений. |
| [GetPossibleCount — функция диаграммы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) | Возвращает количество возможных значений. |
| [GetAlternativeCount — функция диаграммы](https://help.qlik.com/ru-RU/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. Создайте три объекта "Ключевой показатель эффективности" и добавьте следующие выражения в качестве мер, по одному на объект "Ключевой показатель эффективности":

   1. `=GetExcludedCount(FirstName)`, чтобы подсчитать количество исключенных значений в поле `FirstName`.

   2. `=GetExcludedCount(Initials)`, чтобы подсчитать количество исключенных значений в поле `Initials`.

   3. `=GetExcludedCount(LastName)`, чтобы подсчитать количество исключенных значений в поле `LastName`.

   Лист будет выглядеть так, как показано на изображении ниже, так как не было выбрано ни одного значения. Функция `GetExcludedCount` возвращает `0` для каждого Ключевого показателя эффективности.

   ![Лист с фильтрами для полей "Имя", "Инициалы" и "Фамилия", а также три объекта "Ключевой показатель эффективности", каждый из которых возвращает число всех исключенных значений в этих полях.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example.png)

3. Нажмите Изменить лист, чтобы перейти в режим анализа, затем выберите в следующем порядке:

   Фильтр для выбора и отображения результатов в режиме анализа

   | Выбор в панели фильтра | Результаты КПЭ |
   | --- | --- |
   | Выберите `John` в фильтре `FirstName`. | <ul><li><code>GetExcludedCount (Initials)</code> возвращает значение <code>5</code>, так как есть <code>5</code> исключенных значений в поле <code>Initials</code>, выделенных темно-серым цветом. Значение <code>JA</code> останется белым, так как оно связано с выборкой <code>John</code> в столбце <code>FirstName</code>. </li><li><code>GetExcludedCount (LastName)</code> возвращает значение <code>5</code>, так как есть <code>5</code> исключенных значений в поле <code>LastName</code>, выделенных темно-серым цветом. Значение <code>Anderson</code> останется белым, так как оно связано с выборкой <code>John</code> в столбце <code>FirstName</code>. </li></ul> |
   | Выберите `John` и `Peter` в фильтре `FirstName`. | <ul><li><code>GetExcludedCount (Initials)</code> возвращает значение <code>3</code>, так как есть <code>3</code> исключенных значений в поле <code>Initials</code>, выделенных темно-серым цветом. </li><li><code>GetExcludedCount (LastName)</code> возвращает значение <code>3</code>, так как есть <code>3</code> исключенных значений в поле <code>LastName</code>, выделенных темно-серым цветом. </li></ul> |
   | Выберите `John` и `Peter`, затем `Franc` в фильтре `LastName`. | <ul><li><code>GetExcludedCount (FirstName)</code> возвращает значение <code>3</code>, так как имеется <code>3</code> исключенных значений в поле <code>FirstName</code> (темно-серого цвета) и ничего не выбрано. Функция <code>The GetExcludedCount</code> подсчитывает только исключенные значения. Альтернативные и выбранные значения, не входящие в выборку, не учитываются. <code>John</code> – выбранное значение, не входящее в выборку. </li><li><code>GetExcludedCount (Initials)</code> возвращает значение <code>5</code>, так как есть <code>5</code> исключенных значений в поле <code>Initials</code>, выделенных темно-серым цветом. </li><li><code>GetExcludedCount (LastName)</code> возвращает значение <code>3</code>, так как есть <code>3</code> исключенных значений в поле <code>LastName</code>, выделенных темно-серым цветом. Два значения светло-серого цвета, <code>Anderson</code> и <code>Devonshire</code>, являются альтернативными значениями. </li></ul> |
   | Сохраните предыдущие выборки, затем в фильтре `LastName` выберите `Anderson`. | <ul><li><code>GetExcludedCount (FirstName)</code> возвращает значение <code>3</code>, так как есть <code>3</code> исключенных значений в поле <code>FirstName</code>, выделенных темно-серым цветом. </li><li><code>GetExcludedCount (Initials)</code> возвращает значение <code>4</code>, так как есть <code>4</code> исключенных значений в поле <code>Initials</code>, выделенных темно-серым цветом. </li><li><code>GetExcludedCount (LastName)</code> возвращает значение <code>3</code>, так как есть <code>3</code> исключенных значений в поле <code>LastName</code>, выделенных темно-серым цветом. </li></ul> |

Результат выбора показан на следующем изображении.

Ключевой показатель эффективности после выбора имен John и Peter и фамилий Franc и Anderson

Ключевой показатель эффективности после выбора имен John и Peter и фамилий Franc и Anderson

Ключевой показатель эффективности после выбора имен JohnJohn и PeterPeter и фамилий FrancFranc и AndersonAnderson![Лист с выбранными множествами "Имя" и "Фамилия" и соответствующими результатами Ключевого показателя эффективности на основе этих множеств.](https://help.qlik.com/ru-RU/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` для создания диаграммы Ключевых показателей эффективности и анализа продуктов, проданных продавцами.

Откройте редактор загрузки данных и добавьте приведенный ниже скрипт загрузки в новый раздел.

Скрипт загрузки содержит следующее:

* Набор данных, который загружается в таблицу данных под именем `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. Создайте объект "Ключевой показатель эффективности", затем добавьте следующую меру:

   * `=GetExcludedCount(Product)`, чтобы подсчитать количество исключенных значений в поле `Product`.

3. Нажмите Изменить лист , чтобы перейти в режим анализа, затем выберите `Alice` в поле `Salesperson`.

   Функция `GetExcludedCount` возвращает значение `2`, так как имеется `2` уникальных значений, не входящих в выборку (темно-серый цвет) поля `Product`.

   ![Лист с фильтрами для полей "Имя", "Инициалы" и "Фамилия", а также три объекта "Ключевой показатель эффективности", каждый из которых возвращает число всех исключенных значений в этих полях.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example3.png)

Результаты показывают, как можно использовать функцию `GetExcludedCount` для анализа данных. Продавец `Alice` не продал ни одного товара в 2 из 3 товарных группах, `Laptop` и `Tablet`.