# GetStateCounts - diagramfunctie

De GetStateCounts() diagramfunctie wordt gebruikt om het totale aantal unieke waarden te berekenen dat overeenkomt met de opgegeven selectiestatussen.

Met GetStateCounts() kunt u de berekeningen van de volgende functies combineren in één enkele functieaanroep: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() en GetExcludedCount(). Het aantal geselecteerde uitgesloten waarden kan ook aan de berekening worden toegevoegd. U kunt opgeven of elke functieberekening een waarde optelt of aftrekt van het geretourneerde totaal.

Syntaxis:

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

Retourgegevenstypen: geheel getal

Argumenten

| Argument | Beschrijving |
| --- | --- |
| field\_name | Het veld waarvoor u de selectiestatus berekent. Een niet-bestaande veldnaam leidt tot het resultaat null. |
| state\_name | De naam van de alternatieve states. Als het argument leeg (`''`) of null is, wordt de overgenomen alternatieve state gebruikt. Gebruik `$` om expliciet de standaardstate te gebruiken. Een benoemde (niet-lege) statenaam die niet overeenkomt met een bestaande state resulteert in de uitkomst null. |
| state\_type | Een lijst van één of meer statetypen voor de veldwaarde. Deze statetypen worden samengevoegd tot een telling. Een statetype wordt gespecificeerd met behulp van een sleutel. Voer elke sleutel in tussen enkele aanhalingstekens.<br><br>Als dit argument wordt weggelaten, retourneert de functie een tekenreeks met alle beschikbare statetellingen voor het veld, in dezelfde volgorde als de opsomming.<br><br>Zie onderstaande tabel voor een lijst van states die u kunt gebruiken. |

Er wordt naar statetypen verwezen met behulp van specifieke sleutels. U kunt de numerieke of tekstuele versie van de sleutel gebruiken. Combineer meer dan één sleutel in dezelfde uitdrukking om het resultaat verder aan te passen. U kunt het aantal states aftrekken van het totaal, in plaats van het toe te voegen. Gebruik hiervoor de tekstsleutel en zet een minteken (`-`) voor het statetype.

Het statetype en, indien van toepassing, het minteken moeten tussen enkele aanhalingstekens staan.

Sleutels voor elk veld statetype

| Statetype Veld | Beschrijving | Numerieke sleutel | Tekstuele sleutel |
| --- | --- | --- | --- |
| Geselecteerd | Bevat geselecteerde waarden in de berekening. Zie [GetSelectedCount - diagramfunctie](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) voor de soortgelijke functie. | 1 | S |
| Optioneel | Bevat optionele (niet geselecteerde, maar wel te selecteren) waarden in de berekening. Zie [GetPossibleCount - diagramfunctie](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) voor de soortgelijke functie. | 2 | O |
| Selectie opgeheven | Bevat niet-geselecteerde waarden in de berekening. Dit statetype is alleen beschikbaar als het veld in de AND-modus staat. | 3 | D |
| Alternatief | Bevat alternatieve waarden in de berekening. Zie [GetAlternativeCount - diagramfunctie](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm) voor de soortgelijke functie. | 4 | A |
| Uitgesloten | Bevat uitgesloten (niet-geselecteerde) waarden in de berekening. Zie [GetExcludedCount - diagramfunctie](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm) voor de soortgelijke functie. | 5 | X |
| Geselecteerde uitgesloten | Bevat geselecteerde uitgesloten waarden in de berekening. | 6 | XS |

## Wanneer gebruikt u GetStateCounts

Door GetStateCounts() kunt u een aangepaste selectiestatus berekenen. Met deze functie kunt u meerdere functieaanroepen consolideren in één functieaanroep, waardoor het proces van het schrijven van uw uitdrukking wordt vereenvoudigd.

U moet bijvoorbeeld het totale aantal uitgesloten, alternatieve en geselecteerde waarden berekenen voor een veld. U kunt GetStateCounts() gebruiken om dit totaal te berekenen.

Voorbeelden: diagramuitdrukkingen

| Voorbeelden | Resultaten |
| --- | --- |
| `=GetStateCounts( ProductName, Null(), 'S' )` | Retourneert het geselecteerde aantal voor `ProductName`, in de overgenomen alternatieve state. |
| `=GetStateCounts( ProductName, '', 'X', 'A', 'XS' )` | Geeft het totale aantal uitgesloten, geselecteerde waarden en alternatieve waarden voor `ProductName`. De overgenomen alternatieve state wordt gebruikt. |
| `=GetStateCounts( ProductName, '', 'S', 'XS' )` | Retourneert het totale aantal gebruikersselecties voor `ProductName`, in de overgenomen alternatieve state. |
| Gegeven dat het veld ProductName in and-modus staat.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Retourneert het aantal niet-geselecteerde waarden, afgetrokken van het aantal mogelijke waarden, voor `ProductName`. De overgenomen alternatieve state wordt gebruikt. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Geeft het totale aantal uitgesloten, geselecteerde waarden en alternatieve waarden voor `ProductName`. De overgenomen alternatieve state wordt gebruikt. |
| `=GetStateCounts(ProductName, '$', 'O')` | Retourneert het mogelijke aantal voor `ProductName`, in de standaard alternatieve state. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Retourneert het geselecteerde aantal van `ProductName`, in de alternatieve state met de naam `StateA`. |

## Voorbeeld 1 - Het totale aantal gebruikersselecties tellen (inclusief geselecteerde uitgesloten waarden)

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

#### Diagramuitdrukking

Overzicht

De functie GetSelectedCount() retourneert het totale aantal geselecteerde waarden, exclusief het totale aantal geselecteerde uitgesloten waarden. Met GetExcludedCount() kunt u het aantal geselecteerde uitgesloten waarden opnemen in de berekening van het diagram.

Open de Editor voor laden van gegevens en voeg het volgende load-script toe aan een nieuwe sectie.

Load-script

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

Resultaten

Doe het volgende:

1. Laad de gegevens en open een werkblad.

2. Maak twee filtervakken.

3. Voeg First name toe als dimensie in het eerste filtervak. Voeg Last name toe als dimensie in het tweede filtervak.

4. Maak vervolgens een KPI met deze meting:

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

5. Selecteer in het filtervak First name de waarden Mark en Peter. Selecteer in het filtervak Last name de waarden Carr.

6. Merk op dat de KPI een waarde laat zien van 2. Dit geeft aan dat alle waarden die u hebt geselecteerd, inclusief de geselecteerde uitgesloten waarde Peter, worden geteld.

## Voorbeeld 2 - Combinatie van uitgesloten, geselecteerde uitgesloten en alternatieve tellingen

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

#### Diagramuitdrukkingen

Overzicht

De functie GetExcludedCount() retourneert het totale aantal unieke waarden die niet zijn geselecteerd en uitgesloten. Als u geselecteerde uitgesloten waarden en alternatieve waarden wilt opnemen in uw visualisatie, kunt u de functie GetStateCounts() als volgt gebruiken.

Open de Editor voor laden van gegevens en voeg het volgende load-script toe aan een nieuwe sectie.

Load-script

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

Resultaten

Doe het volgende:

1. Laad de gegevens en open een werkblad.

2. Maak twee filtervakken.

3. Voeg First name toe als dimensie in het eerste filtervak. Voeg Last name toe als dimensie in het tweede filtervak.

4. Maak vervolgens een KPI met deze meting:

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

5. Selecteer in het filtervak First name de waarden John en Peter. Selecteer in het filtervak Last name de waarden Franc.

6. U ziet dat de KPI een waarde van 4 laat zien. Dit geeft aan dat de geselecteerde uitgesloten waarde John is opgenomen in de telling, naast de telling van de uitgesloten waarden.

7. Bewerk de KPI en vervang de bestaande meting door het volgende:

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

8. Behoud de bestaande selecties en selecteer de waarde Anderson in het filtervak Last name.

9. U ziet dat de KPI nog steeds een waarde van 4 laat zien. Dit geeft aan dat de alternatieve waarde Devonshire is opgenomen in de telling, naast de telling van de uitgesloten waarden.