# GetStateCounts - função de gráfico

A função do gráfico GetStateCounts() é usada para calcular o número total de valores exclusivos que correspondem aos estados de seleção especificados.

Com GetStateCounts(), você pode combinar os cálculos das funções a seguir em uma única chamada de função: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() e GetExcludedCount(). A contagem dos valores excluídos selecionados também está disponível para ser adicionada ao cálculo. Você pode especificar se cada cálculo de função inclui ou subtrai do total retornado.

Sintaxe:

GetStateCounts (field\_name, state\_name [, state\_type1,...state\_typeN])

Tipo de dados de retorno: inteiro

Argumentos

| Argumento | Descrição |
| --- | --- |
| field\_name | O campo para o qual você está calculando o estado de seleção. Um nome de campo inexistente resulta em um resultado nulo. |
| state\_name | O nome do estado alternativo. Se o argumento estiver vazio (`''`) ou for nulo, o estado alternativo herdado será usado. Use `$` para usar explicitamente o estado padrão. Um nome de estado nomeado (não vazio) que não corresponda a um estado existente resulta em um resultado nulo. |
| state\_type | Uma lista de um ou mais tipos de campo para o valor do campo. Esses tipos de estado serão agregados em uma contagem. Um tipo de estado é especificado usando uma chave. Insira cada chave com aspas simples.<br><br>Quando esse argumento é omitido, a função retorna uma cadeia de caracteres com todas as contagens de campos disponíveis, na mesma ordem da enumeração.<br><br>Para obter uma lista de estados que você pode usar, consulte a tabela. |

Os tipos de estado são referenciados usando chaves específicas. Você pode usar a versão numérica ou textual da chave. Personalize mais de uma chave na mesma expressão para personalizar ainda mais o resultado. Você pode subtrair a contagem total do estado, em vez de adicioná-la. Para fazer isso, use a chave textual e prefixe o tipo de prefixo do estado com um símbolo de menos (`-`).

O tipo de estado e, se aplicável, o símbolo de menos, precisam ser colocados em um conjunto de aspas simples.

Chaves para cada tipo de campo

| Tipo de estado do campo | Descrição | Chave numérica | Chave textual |
| --- | --- | --- | --- |
| Selecionado | Inclui valores selecionados no cálculo. Para conhecer a função equivalente, consulte [GetSelectedCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Opcional | Inclui valores opcionais (não selecionados, mas possíveis de serem selecionados) no cálculo. Para conhecer a função equivalente, consulte [GetPossibleCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Desmarcado | Inclui valores não selecionados no cálculo. Esse tipo de campo só está disponível quando o campo está no modo E. | 3 | D |
| Alternativo | Inclui valores não selecionados no cálculo. Para conhecer a função equivalente, consulte [GetAlternativeCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Excluído | Inclui valores excluídos (não selecionados) no cálculo. Para conhecer a função equivalente, consulte [GetExcludedCount - função de gráfico](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Excluído selecionado | Inclui valores excluídos selecionados no cálculo. | 6 | XS |

## Quando usar GetStateCounts

Com GetStateCounts(), você pode calcular um estado de seleção personalizado. A função permite consolidar várias chamadas de função em uma única chamada de função, simplificando o processo de escrever sua expressão.

Por exemplo, talvez você precise calcular o número total de valores excluídos, alternativos e selecionados excluídos para um campo. Você pode usar GetStateCounts() para calcular esse total.

Exemplos: expressões de gráfico

| Exemplos | Resultados |
| --- | --- |
| `=GetStateCounts( ProductName, Null(), 'S' )` | Retorna a contagem selecionada para `ProductName`, no estado alternativo herdado. |
| `=GetStateCounts( ProductName, '', 'X', 'A', 'XS' )` | Contagem total de valores excluídos, selecionados excluídos e alternativos para `ProductName`. O estado alternativo herdado é usado. |
| `=GetStateCounts( ProductName, '', 'S', 'XS' )` | Retorna a contagem total de seleções de usuário para `ProductName`, no estado herdado. |
| Considerando que o campo ProductName está no modo.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Retorna o número de valores não selecionados, subtraído pelo número de valores possíveis, para `ProductName`. O estado alternativo herdado é usado. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Contagem total de valores excluídos, selecionados excluídos e alternativos para `ProductName`. O estado alternativo herdado é usado. |
| `=GetStateCounts(ProductName, '$', 'O')` | Retorna a contagem possível para `ProductName`, no estado alternativo padrão. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Retorna a contagem selecionada de `ProductName`, no estado alternativo denominado `StateA`. |

## Exemplo 1 - Contagem do número total de seleções do usuário (incluindo os valores selecionados excluídos)

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

#### Expressão de gráfico

Visão geral

A função GetSelectedCount() retorna o número total de valores selecionados, não incluindo o número total de valores excluídos selecionados. Com GetExcludedCount(), você pode incluir a contagem de valores excluídos selecionados no cálculo do gráfico.

Abra o Editor de carregamento de dados e adicione o script de carregamento a seguir a uma nova seção.

Script de carregamento

```
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
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

Faça o seguinte:

1. Carregue os dados e abra uma pasta.

2. Crie dois painéis de filtro.

3. Adicione First name como uma dimensão no primeiro painel de filtro. Adicione Last name como uma dimensão no secundo painel de filtro.

4. Em seguida, crie um KPI com essa medida:

   `=GetStateCounts([First Name],'', 'S','XS')`

5. No painel de filtro First name, selecione os valores Mark e Peter. No painel de filtro Last name, selecione o valor Carr.

6. Observe que o KPI mostra um valor de 2. Isso reflete que todos os valores que você selecionou, incluindo o valor excluído selecionado Peter, são contados.

## Exemplo 2 - Combinação de contagens de excluídos, excluídos selecionados e alternativos

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

#### Expressões de gráfico

Visão geral

A função GetExcludedCount() retorna o número total de valores exclusivos que não são selecionados e excluídos. Se quiser incluir contagens alternativas e excluídas selecionadas em sua visualização, você poderá usar a função GetStateCounts() da seguinte forma.

Abra o Editor de carregamento de dados e adicione o script de carregamento a seguir a uma nova seção.

Script de carregamento

```
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
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

Faça o seguinte:

1. Carregue os dados e abra uma pasta.

2. Crie dois painéis de filtro.

3. Adicione First name como uma dimensão no primeiro painel de filtro. Adicione Last name como uma dimensão no secundo painel de filtro.

4. Em seguida, crie um KPI com essa medida:

   `=GetStateCounts([First name], '', 'X', 'A', 'XS')`

5. No painel de filtro First name, selecione os valores John e Peter. No painel de filtro Last name, selecione o valor Franc.

6. Observe que o KPI mostra um valor de 4. Isso reflete que o valor excluído selecionado John está incluído na contagem, além da contagem dos valores excluídos.

7. Edite o KPI e substitua a medida existente pela seguinte:

   `=GetStateCounts([Last name], '', 'X', 'A', 'XS')`

8. Mantendo as seleções existentes, selecione o valor Anderson no painel de filtro Last name.

9. Observe que o KPI ainda mostra um valor de 4. Isso reflete que o valor alternativo Devonshire está incluído na contagem, além da contagem dos valores excluídos.