# GetExcludedCount - fonction de graphique

GetExcludedCount() permet de déterminer le nombre de valeurs distinctes exclues dans le champ identifié. Seuls les champs exclus (gris foncé) sont comptés. Les valeurs exclues sélectionnées (gris foncé avec une coche) et alternatives (gris clair) ne sont pas comptées.

Syntaxe :

GetExcludedCount (field\_name)

Type de données renvoyé : integer

Note Informations

Les couleurs utilisées dans la barre de sélection et pour chaque état de sélection peuvent être remplacées par un thème personnalisé. Si vous utilisez une application qui emploie un thème personnalisé, vous remarquerez peut-être que vos sélections ne s'affichent pas avec les mêmes couleurs que celles décrites dans cette rubrique d'aide.

Arguments

| Arguments | Description |
| --- | --- |
| field\_name | Champ contenant la plage de données à mesurer. |

Le tableau suivant répertorie d'autres fonctions associées à cette fonction.

Fonctions associées

| Fonction | Interaction |
| --- | --- |
| [GetStateCounts - fonction de graphique](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm) | Si vous utilisez GetStateCounts(), vous pouvez combiner le calcul des nombres suivants à l'aide d'un seul appel de fonction :<br><br><ul><li><p>Nombre de valeurs incluses sélectionnées.</p></li><li><p>Nombre de valeurs possibles.</p></li><li><p>Nombre de valeurs alternatives.</p></li><li><p>Nombre de valeurs exclues, à l'exclusion des valeurs exclues alternatives et sélectionnées.</p></li><li><p>Nombre de valeurs exclues sélectionnées.</p></li></ul> |
| [GetSelectedCount - fonction de graphique](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) | Renvoie le nombre de valeurs incluses sélectionnées. |
| [GetPossibleCount - fonction de graphique](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) | Renvoie le nombre de valeurs possibles. |
| [GetAlternativeCount - fonction de graphique](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm) | Renvoie le nombre de valeurs alternatives. |

Exemple : Expressions de graphique

| Exemple | Résultat |
| --- | --- |
| `GetExcludedCount( Initials )` | Renvoie `0` si aucune sélection n'a été effectuée. Si une sélection a été effectuée, la valeur renvoyée est le nombre de valeurs exclues dans `Initials` avec une couleur gris foncé. |

## Exemple - Les bases de GetExcludedCount

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

#### Expression de graphique

Vue d'ensemble

Cet exemple montre comment les valeurs renvoyées par la fonction `GetExcludedCount` changent à mesure que des sélections supplémentaires sont effectuées.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée `Example`.

* Champs suivants dans la table de données :

  * `FirstName`

  * `LastName`

  * `Initials`

  * `HasCellphone`

Script de chargement

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

Résultats

1. Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ces champs comme dimensions :

   * `FirstName`

   * `LastName`

   * `Initials`

2. Créez trois objets ICP et ajoutez les expressions suivantes comme mesures, une par objet ICP :

   1. `=GetExcludedCount(FirstName)`, pour compter le nombre de valeurs exclues dans le champ `FirstName`.

   2. `=GetExcludedCount(Initials)`, pour compter le nombre de valeurs exclues dans le champ `Initials`.

   3. `=GetExcludedCount(LastName)`, pour compter le nombre de valeurs exclues dans le champ `LastName`.

   Votre feuille ressemblera à l'image suivante, car aucune valeur n'a été sélectionnée. La fonction `GetExcludedCount` renvoie `0` pour chaque ICP.

   ![Feuille avec des volets de filtre pour First Name, Initials et Last Name, ainsi que trois objets ICP qui renvoient chacun un nombre de valeurs exclues dans ces champs.](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example.png)

3. Cliquez sur Modifier la feuille pour passer en mode d'analyse, puis effectuez les sélections suivantes dans l'ordre :

   Sélections de filtre et résultats en mode d'analyse

   | Sélection du volet filtre | Résultats des indicateurs KPI |
   | --- | --- |
   | Sélectionnez `John` dans le filtre `FirstName`. | <ul><li><code>GetExcludedCount (Initials)</code> renvoie une valeur <code>5</code>, car il existe <code>5</code> valeurs exclues dans <code>Initials</code> avec une couleur gris foncé. La valeur <code>JA</code> reste blanche, car elle est associée à la sélection <code>John</code> dans <code>FirstName</code>. </li><li><code>GetExcludedCount (LastName)</code> renvoie une valeur <code>5</code>, car il existe <code>5</code> valeurs exclues dans <code>LastName</code> avec une couleur gris foncé. La valeur <code>Anderson</code> reste blanche, car elle est associée à la sélection <code>John</code> dans <code>FirstName</code>. </li></ul> |
   | Sélectionnez `John` et `Peter` dans le filtre `FirstName`. | <ul><li><code>GetExcludedCount (Initials)</code> renvoie une valeur <code>3</code>, car il existe <code>3</code> valeurs exclues dans <code>Initials</code> avec une couleur gris foncé. </li><li><code>GetExcludedCount (LastName)</code> renvoie une valeur <code>3</code>, car il existe <code>3</code> valeurs exclues dans <code>LastName</code> avec une couleur gris foncé. </li></ul> |
   | Après avoir sélectionné `John` et `Peter`, sélectionnez `Franc` dans le filtre `LastName`. | <ul><li><code>GetExcludedCount (FirstName)</code> renvoie une valeur <code>3</code>, car il existe <code>3</code> valeurs exclues dans <code>FirstName</code> avec une couleur gris foncé et aucune coche de sélection. La fonction <code>The GetExcludedCount</code> ne compte que les valeurs exclues. Les valeurs exclues sélectionnées et alternatives ne sont pas incluses dans le comptage. <code>John</code> est une valeur exclue sélectionnée. </li><li><code>GetExcludedCount (Initials)</code> renvoie une valeur <code>5</code>, car il existe <code>5</code> valeurs exclues dans <code>Initials</code> avec une couleur gris foncé. </li><li><code>GetExcludedCount (LastName)</code> renvoie une valeur <code>3</code>, car il existe <code>3</code> valeurs exclues dans <code>LastName</code> avec une couleur gris foncé. Les deux valeurs de couleur gris clair, <code>Anderson</code> et <code>Devonshire</code>, sont des valeurs alternatives. </li></ul> |
   | Conservez les sélections précédentes, puis, dans le filtre `LastName`, sélectionnez `Anderson`. | <ul><li><code>GetExcludedCount (FirstName)</code> renvoie une valeur <code>3</code>, car il existe <code>3</code> valeurs exclues dans <code>FirstName</code> avec une couleur gris foncé. </li><li><code>GetExcludedCount (Initials)</code> renvoie une valeur <code>4</code>, car il existe <code>4</code> valeurs exclues dans <code>Initials</code> avec une couleur gris foncé. </li><li><code>GetExcludedCount (LastName)</code> renvoie une valeur <code>3</code>, car il existe <code>3</code> valeurs exclues dans <code>LastName</code> avec une couleur gris foncé. </li></ul> |

Vous pouvez voir les résultats finaux des sélections du volet de filtre sur l'image suivante.

Résultats d'ICP de la sélection des prénoms, John et Peter, et des noms de famille, Franc et Anderson

Résultats d'ICP de la sélection des prénoms, John et Peter, et des noms de famille, Franc et Anderson

Résultats d'ICP de la sélection des prénoms, JohnJohn et PeterPeter, et des noms de famille, FrancFranc et AndersonAnderson![Feuille avec des sélections sur les champs First Name et Last Name, et résultats d'ICP correspondant à ces sélections.](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example2.png)

## Exemple - Scénario GetExcludedCount

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

#### Expression de graphique

Vue d'ensemble

Un responsable commercial utilise la fonction `GetExcludedCount` pour créer un graphique ICP afin d'analyser les produits vendus par vendeur.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée `Example`.

* Champs suivants dans la table de données :

  * `Salesperson`

  * `Product`

  * `SalesAmount`

Script de chargement

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

Résultats

1. Chargez les données et ouvrez une feuille. Créez un nouveau volet de filtre et ajoutez ces champs comme dimensions :

   * `Salesperson`

   * `Product`

2. Créez un nouvel objet ICP et ajoutez la mesure suivante :

   * `=GetExcludedCount(Product)`, pour trouver le nombre de valeurs exclues dans le champ `Product`.

3. Cliquez sur Modifier la feuille pour passer en mode d'analyse, puis sélectionnez `Alice` dans le filtre `Salesperson`.

   La fonction `GetExcludedCount` renvoie une valeur `2`, car il existe `2` valeurs uniques et exclues (gris foncé) dans le champ `Product`.

   ![Feuille avec des volets de filtre pour First Name, Initials et Last Name, ainsi que trois objets ICP qui renvoient chacun un nombre de valeurs exclues dans ces champs.](https://help.qlik.com/fr-FR/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetExclCnt-example3.png)

Les résultats montrent comment utiliser la fonction `GetExcludedCount` pour analyser les données. Le vendeur `Alice` n'a vendu aucun article dans deux des trois groupes de produits, `Laptop` et `Tablet`.