# GetExcludedCount - função de gráfico

GetExcludedCount() encontra o número de valores (cinza-escuro) excluídos na área identificada. Somente os campos excluídos (cinza escuro) são contados. Valores alternativos (cinza claro) e selecionados excluídos (cinza escuro com marca de seleção) não são contados.

Sintaxe:

GetExcludedCount (field\_name)

Tipo de dados de retorno: inteiro

Nota informativa

As cores usadas na barra de seleção e para cada estado de seleção podem ser modificadas com um tema personalizado. Se você estiver trabalhando com um aplicativo que usa um tema personalizado, poderá notar que suas seleções não são exibidas com as mesmas cores descritas neste tópico de ajuda.

Argumentos

| Argumentos | Descrição |
| --- | --- |
| field\_name | O campo que contém o intervalo de dados que será medido. |

A tabela a seguir lista outras funções relacionadas a essa função.

Funções relacionadas

| Função | Interação |
| --- | --- |
| [GetStateCounts - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm) | Usando GetStateCounts(), você pode combinar o cálculo das contagens a seguir usando uma única chamada de função:<br><br><ul><li><p>Contagem de valores selecionados incluídos.</p></li><li><p>Contagem de valores possíveis.</p></li><li><p>Contagem de valores alternativos.</p></li><li><p>Contagem de valores excluídos, não incluindo valores excluídos alternativos e selecionados.</p></li><li><p>Contagem de valores excluídos selecionados.</p></li></ul> |
| [GetSelectedCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) | Retorna a contagem de valores incluídos selecionados. |
| [GetPossibleCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) | Retorna a contagem de valores possíveis. |
| [GetAlternativeCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm) | Retorna a contagem de valores alternativos. |

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `GetExcludedCount( Initials )` | Retorna `0` se nenhuma seleção tiver sido feita. Se uma seleção tiver sido feita, o valor retornado será o número de valores excluídos em `Initials` com cor cinza escuro. |

## Exemplo - Fundamentos de GetExcludedCount

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

#### Expressão de gráfico

Visão geral

Este exemplo mostra como os valores retornados pela função `GetExcludedCount` mudam conforme seleções adicionais são feitas.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `FirstName`

  * `LastName`

  * `Initials`

  * `HasCellphone`

Script de carregamento

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

Resultados

1. Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões:

   * `FirstName`

   * `LastName`

   * `Initials`

2. Crie três objetos KPI e adicione as expressões a seguir como medidas, uma por objeto de KPI:

   1. `=GetExcludedCount(FirstName)`, para contar o número de valores excluídos no campo `FirstName`.

   2. `=GetExcludedCount(Initials)`, para contar o número de valores excluídos no campo `Initials`.

   3. `=GetExcludedCount(LastName)`, para contar o número de valores excluídos no campo `LastName`.

   Sua pasta terá a aparência da imagem a seguir, pois nenhum valor foi selecionado. A função `GetExcludedCount` retorna `0` para cada KPI.

   ![Uma pasta com painéis de filtro para First Name, Initials e Last Name, bem como três objetos de KPI que retornam, cada um, uma contagem de valores excluídos nesses campos.](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example.png)

3. Clique em Editar pasta para alternar para o modo de análise e faça as seguintes seleções na ordem:

   Filtrar seleções e resultados no modo de análise

   | Seleção do painel de filtro | Resultados do KPI |
   | --- | --- |
   | Selecione `John` no filtro `FirstName`. | <ul><li><code>GetExcludedCount (Initials)</code> retorna um valor de <code>5</code> porque há <code>5</code> valores excluídos em <code>Initials</code> com cor cinza escuro. O valor de <code>JA</code> permanece em branco, porque está associado com a seleção de <code>John</code> em <code>FirstName</code>. </li><li><code>GetExcludedCount (LastName)</code> retorna um valor de <code>5</code> porque há <code>5</code> valores excluídos em <code>LastName</code> com cor cinza escuro. O valor de <code>Anderson</code> permanece em branco, porque está associado com a seleção de <code>John</code> em <code>FirstName</code>. </li></ul> |
   | Selecione `John` e `Peter` no filtro `FirstName`. | <ul><li><code>GetExcludedCount (Initials)</code> retorna um valor de <code>3</code> porque há <code>3</code> valores excluídos em <code>Initials</code> com cor cinza escuro. </li><li><code>GetExcludedCount (LastName)</code> retorna um valor de <code>3</code> porque há <code>3</code> valores excluídos em <code>LastName</code> com cor cinza escuro. </li></ul> |
   | Com `John` e `Peter` selecionados, selecione `Franc` no filtro `LastName`. | <ul><li><code>GetExcludedCount (FirstName)</code> retorna um valor de <code>3</code> porque há <code>3</code> valores excluídos em <code>FirstName</code> com cor cinza escuro e sem marca de seleção. A função <code>The GetExcludedCount</code> conta apenas os valores excluídos. Valores alternativos e excluídos selecionados não são incluídos na contagem. <code>John</code> é um valor excluído selecionado. </li><li><code>GetExcludedCount (Initials)</code> retorna um valor de <code>5</code> porque há <code>5</code> valores excluídos em <code>Initials</code> com cor cinza escuro. </li><li><code>GetExcludedCount (LastName)</code> retorna um valor de <code>3</code> porque há <code>3</code> valores excluídos em <code>LastName</code> com cor cinza escuro. Os 2 valores de cor cinza claro, <code>Anderson</code> e <code>Devonshire</code>, são valores alternativos. </li></ul> |
   | Mantenha as seleções anteriores e, no filtro `LastName`, selecione `Anderson`. | <ul><li><code>GetExcludedCount (FirstName)</code> retorna um valor de <code>3</code> porque há <code>3</code> valores excluídos em <code>FirstName</code> com cor cinza escuro. </li><li><code>GetExcludedCount (Initials)</code> retorna um valor de <code>4</code> porque há <code>4</code> valores excluídos em <code>Initials</code> com cor cinza escuro. </li><li><code>GetExcludedCount (LastName)</code> retorna um valor de <code>3</code> porque há <code>3</code> valores excluídos em <code>LastName</code> com cor cinza escuro. </li></ul> |

Você pode ver os resultados finais das seleções do painel de filtro na imagem a seguir.

Resultados de KPI da seleção de nomes, John e Peter, e sobrenomes, Franc e Anderson

Resultados de KPI da seleção de nomes, John e Peter, e sobrenomes, Franc e Anderson

Resultados de KPI da seleção de nomes, JohnJohn e PeterPeter, e sobrenomes, FrancFranc e AndersonAnderson![Uma pasta com seleções nos campos First Name e Last Name e os resultados de KPI correspondentes a essas seleções.](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example2.png)

## Exemplo - Cenário de GetExcludedCount

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

#### Expressão de gráfico

Visão geral

Um gerente de vendas usa a função `GetExcludedCount` para criar um gráfico de KPI para analisar os produtos vendidos por vendedor.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

* Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`.

* Os campos a seguir na tabela de dados:

  * `Salesperson`

  * `Product`

  * `SalesAmount`

Script de carregamento

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

Resultados

1. Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões:

   * `Salesperson`

   * `Product`

2. Crie um novo objeto de KPI e adicione a seguinte medida:

   * `=GetExcludedCount(Product)`, para encontrar o número de valores excluídos no campo `Product`.

3. Clique em Editar pasta para alternar para o modo de análise e, em seguida, selecione `Alice` no filtro `Salesperson`.

   A função `GetExcludedCount` retorna um valor de `2` porque há `2` valores exclusivos e excluídos (cinza escuro) no campo `Product`.

   ![Uma pasta com painéis de filtro para First Name, Initials e Last Name, bem como três objetos de KPI que retornam, cada um, uma contagem de valores excluídos nesses campos.](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example3.png)

Os resultados mostram como você pode usar a função `GetExcludedCount` para analisar os dados. O vendedor `Alice` não vendeu nenhum item em 2 dos 3 grupos de produtos: produtos `Laptop` e `Tablet`.