# GetStateCounts

La fonction de graphique GetStateCounts() permet de calculer le nombre total de valeurs uniques correspondant aux états de sélection spécifiés.

Si vous utilisez GetStateCounts(), vous pouvez combiner les calculs des fonctions suivantes en un seul appel de fonction : GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() et GetExcludedCount(). Il est également possible d'ajouter au calcul le nombre de valeurs exclues sélectionnées. Vous pouvez spécifier si chaque calcul de fonction est ajouté au total renvoyé ou en est soustrait.

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

**Type de données renvoyé :** entier

Arguments

| Argument | Description |
| --- | --- |
| field\_name | Champ pour lequel vous calculez l'état de sélection. Un nom du champ inexistant donne un résultat nul. |
| state\_name | Nom de l'état alternatif. Si l'argument est vide (`''`) ou nul, l'état alternatif hérité est utilisé. Utilisez `$` pour employer explicitement l'état par défaut. Un nom d'état nommé (non vide) qui ne correspond pas à un état existant donne un résultat nul. |
| state\_type | Liste d'un ou de plusieurs types d'état pour la valeur de champ. Ces types d'état seront agrégés en un nombre. Un type d'état est spécifié à l'aide d'une clé. Saisissez chaque clé encadrée de guillemets simples.<br><br>Si cet argument est omis, la fonction renvoie une chaîne contenant tous les nombres d'états disponibles pour le champ, dans le même ordre que celui de l'énumération.<br><br>Pour une liste des états disponibles, consultez le tableau ci-dessous. |

Les types d'état sont référencés à l'aide de clés spécifiques. Vous pouvez utiliser la version numérique ou textuelle de la clé. Vous pouvez personnaliser davantage le résultat en combinant plusieurs clés dans la même expression. Vous pouvez soustraire le nombre d'états du total au lieu de l'ajouter au total. Pour ce faire, utilisez la clé textuelle et préfixez le type d'état d'un symbole moins (`-`).

Le type d'état et, le cas échéant, le symbole moins, doivent être encadrés de guillemets simples.

Clés de chaque type d'état de champ

| Type d'état de champ | Description | Clé numérique | Clé textuelle |
| --- | --- | --- | --- |
| Sélectionné | Inclut les valeurs sélectionnées dans le calcul. Pour la fonction équivalente, consultez [GetSelectedCount](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Optionnel | Inclut les valeurs optionnelles (non sélectionnées, mais qu'il est possible de sélectionner) dans le calcul. Pour la fonction équivalente, consultez [GetPossibleCount](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Désélectionné | Inclut les valeurs non sélectionnées dans le calcul. Ce type d'état est disponible uniquement lorsque le champ est en mode « et ».<br><br>Ce type d'état renvoie le même calcul que celui de la fonction GetNotSelectedCount(), en supposant que l'argument include\_excluded de cette fonction est défini sur la valeur False par défaut. Pour plus d'informations sur GetNotSelectedCount(), consultez [GetNotSelectedCount](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/GetNotSelectedCount.htm). | 3 | D |
| Alternatif | Inclut les valeurs alternatives dans le calcul. Pour la fonction équivalente, consultez [GetAlternativeCount](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Exclu | Inclut les valeurs exclues (non sélectionnées) dans le calcul. Pour la fonction équivalente, consultez [GetExcludedCount](https://help.qlik.com/fr-FR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Exclu sélectionné | Inclut les valeurs exclues sélectionnées dans le calcul. | 6 | XS |

## Cas d'utilisation

Si vous utilisez GetStateCounts(), vous pouvez calculer un état de sélection personnalisé. Cette fonction vous permet de consolider plusieurs appels de fonctions en un seul appel de fonction, ce qui simplifie le processus de rédaction de votre expression.

Par exemple, vous pourriez avoir besoin de calculer le nombre total de valeurs exclues, alternatives et exclues sélectionnées d'un champ. Vous pouvez utiliser GetStateCounts() pour calculer ce total.

Exemples et résultats

| Exemples | Résultats |
| --- | --- |
| `=GetStateCounts(ProductName, Null(), 'S')` | Renvoie le nombre sélectionné pour ProductName, à l'état alternatif hérité. |
| `=GetStateCounts(ProductName, '', 'A', 'XS')` | Renvoie le nombre total de valeurs exclues sélectionnées et alternatives pour ProductName. L'état alternatif hérité est utilisé. |
| `=GetStateCounts(ProductName, '', 'S', 'XS')` | Renvoie le nombre total de sélections de l'utilisateur pour ProductName, à l'état hérité. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Renvoie le nombre total de valeurs exclues, exclues sélectionnées et alternatives pour ProductName. L'état alternatif hérité est utilisé. |
| Étant donné que le champ ProductName se trouve en mode « et ».<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Renvoie le nombre de valeurs non sélectionnées, soustraites du nombre de valeurs possibles, pour ProductName. L'état alternatif hérité est utilisé. |
| `=GetStateCounts(ProductName, '$', 'O')` | Renvoie le nombre possible pour ProductName, à l'état alternatif par défaut. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Renvoie le nombre sélectionné de ProductName, à l'état alternatif nommé StateA. |

## Exemple 1 – Comptage du nombre total de sélections de l'utilisateur (y compris les valeurs exclues sélectionnées)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Expression de graphique

Vue d'ensemble

La fonction GetSelectedCount() renvoie le nombre total de valeurs sélectionnées, en excluant le nombre total de valeurs exclues sélectionnées. Si vous utilisez GetExcludedCount(), vous pouvez inclure le nombre de valeurs exclues sélectionnées dans le calcul du graphique.

Pour commencer, ajoutez le script de chargement ci-dessous à votre document.

Script de chargement

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

Résultats

Procédez comme suit :

1. Chargez les données et créez deux listes de sélection sur votre feuille.

2. Ajoutez First name comme dimension dans la première liste de sélection. Ajoutez Last name comme dimension dans la deuxième liste de sélection.

3. Créez ensuite un tableau simple avec cette mesure :

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

4. Dans la liste de sélection First name, sélectionnez les valeurs Mark et Peter. Dans la liste de sélection de filtre Last name, sélectionnez la valeur Carr.

5. Notez que le tableau simple affiche une valeur 2. Cela signifie que toutes les valeurs que vous avez sélectionnées, y compris la valeur exclue sélectionnée Peter, sont comptées.

## Exemple 2 – Combinaison des nombres de valeurs exclues, exclues sélectionnées et alternatives

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Expressions de graphique

Vue d'ensemble

La fonction GetExcludedCount() renvoie le nombre total de valeurs uniques non sélectionnées et exclues. Si vous souhaitez inclure les nombres de valeurs alternatives et exclues sélectionnées dans votre visualisation, vous pouvez utiliser la fonction GetStateCounts() comme suit.

Pour commencer, ajoutez le script de chargement ci-dessous à votre document.

Script de chargement

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

Résultats

Procédez comme suit :

1. Chargez les données et créez deux listes de sélection sur votre feuille.

2. Ajoutez First name comme dimension dans la première liste de sélection. Ajoutez Last name comme dimension dans la deuxième liste de sélection.

3. Créez ensuite un tableau simple avec cette expression :

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

4. Dans la liste de sélection First name, sélectionnez les valeurs John et Peter. Dans la liste de sélection Last name, sélectionnez la valeur Franc.

5. Notez que le tableau simple affiche une valeur 4. Cela signifie que la valeur exclue sélectionnée John est incluse dans le nombre, en plus du nombre de valeurs exclues.

6. Modifiez le tableau simple et remplacez l'expression existante par l'expression suivante :

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

7. En conservant les sélections existantes, sélectionnez la valeur Anderson dans l'expression Last name.

8. Notez que le tableau simple continue d'afficher une valeur 4. Cela signifie que la valeur alternative Devonshire est incluse dans le nombre, en plus du nombre de valeurs exclues.