# GetStateCounts - diagramfunktion

Diagramfunktionen GetStateCounts() används för att beräkna det totala antalet unika värden som matchar de angivna urvalstillstånden.

Med GetStateCounts() kan du kombinera beräkningarna från följande funktioner till ett enda funktionsanrop: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() och GetExcludedCount(). Antalet valda uteslutna värden är också tillgängligt för att lägga till i beräkningen. Du kan ange om varje funktionsberäkning lägger till eller subtraherar från de returnerade totalvärdena.

Syntax:

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

Returnerad datatyp: heltal

Argument

| Argument | Beskrivning |
| --- | --- |
| field\_name | Det fält för vilket du beräknar urvalstillståndet. Ett icke-existerande fältnamn resulterar i ett nullresultat. |
| state\_name | Namnet på det parallella tillståndet. Om argumentet är tomt (`''`) eller null, används det ärvda parallella tillståndet. Använd `$` för att uttryckligen använda standardtillståndet. Ett namngivet (ej tomt) namn på ett tillstånd som inte matchar ett befintligt tillstånd resulterar i ett nullresultat. |
| state\_type | En lista med en eller flera tillståndstyper för fältvärdet. Dessa tillståndstyper kommer att aggregeras till ett antal. En tillståndstyp anges med hjälp av en nyckel. Skriv in varje nyckel med enkla citattecken.<br><br>När detta argument utelämnas returnerar funktionen en sträng med alla tillgängliga tillståndsantal för fältet i samma ordning som uppräkningen.<br><br>En lista över de tillstånd som du kan använda finns i tabellen nedanför. |

Tillståndstyper refereras med hjälp av specifika nycklar. Du kan använda den numeriska eller textversionen av nyckeln. Kombinera fler än en nyckel i samma uttryck för att ytterligare anpassa resultatet. Du kan subtrahera antalet tillstånd från det totala antalet i stället för att lägga till det. För att göra det använder du textnyckeln och anger en minussymbol (`-`) som prefix för tillståndstypen.

Tillståndstypen, och i förekommande fall minussymbolen, måste omges av en uppsättning enkla citattecken.

Nycklar för varje fälttillståndstyp

| Fälttillståndstyp | Beskrivning | Numerisk nyckel | Textnyckel |
| --- | --- | --- | --- |
| Valda | Inkluderar valda värden i beräkningen. För motsvarande funktion, se [GetSelectedCount - diagramfunktion](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Valfritt | Inkluderar valfria (ej valda, men möjliga att välja) värden i beräkningen. För motsvarande funktion, se [GetPossibleCount - diagramfunktion](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Avmarkerad | Inkluderar ej valda värden i beräkningen. Denna tillståndstyp är endast tillgänglig när fältet är i AND-läge. | 3 | D |
| Alternativ | Inkluderar alternativa värden i beräkningen. För motsvarande funktion, se [GetAlternativeCount - diagramfunktion](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Utesluten | Inkluderar uteslutna (ej valda) värden i beräkningen. För motsvarande funktion, se [GetExcludedCount - diagramfunktion](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Urval uteslutet | Inkluderar valda uteslutna värden i beräkningen. | 6 | XS |

## När ska du använda GetStateCounts

Med GetStateCounts() kan du beräkna ett anpassat urvalstillstånd. Funktionen gör att du kan konsolidera flera funktionsanrop till ett enda funktionsanrop, vilket förenklar processen med att skriva ditt uttryck.

Du kan exempelvis behöva beräkna det totala antalet uteslutna, alternativa och valda uteslutna värden för ett fält. Du kan använda GetStateCounts() för att beräkna detta antal.

Exempel: diagramuttryck

| Exempel | Resultat |
| --- | --- |
| `=GetStateCounts( ProductName, Null(), 'S' )` | Returnerar det valda antalet för `ProductName`, i det ärvda alternativa tillståndet. |
| `=GetStateCounts( ProductName, '', 'X', 'A', 'XS' )` | Returnerar det totala antalet uteslutna, valda uteslutna och alternativa värden för `ProductName`. Det ärvda parallella tillståndet används. |
| `=GetStateCounts( ProductName, '', 'S', 'XS' )` | Returnerar det totala antalet användarurval `ProductName`, i det ärvda alternativa tillståndet. |
| Förutsatt att fältet ProductName är i och-läge.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Returnerar antalet värden som inte valts, subtraherat med antalet möjliga värden, för `ProductName`. Det ärvda parallella tillståndet används. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Returnerar det totala antalet uteslutna, valda uteslutna och alternativa värden för `ProductName`. Det ärvda parallella tillståndet används. |
| `=GetStateCounts(ProductName, '$', 'O')` | Returnerar det möjliga antalet för `ProductName`, i det parallella standardtillståndet. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Returnerar det valda antalet för `ProductName`, i det alternativa tillståndet benämnt `StateA`. |

## Exempel 1 – Antal totala användarurval (inklusive valda uteslutna värden)

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

#### Diagramuttryck

Översikt

Funktionen GetSelectedCount() returnerar det totala antalet valda värden, exklusive det totala antalet valda uteslutna värden. Med GetExcludedCount() kan du inkludera antalet utvalda uteslutna värden i diagrammets beräkning.

Öppna Skriptredigeraren och lägg till följande laddningsskript till ett nytt delavsnitt.

Laddningsskript

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

Resultat

Gör följande:

1. Ladda data och öppna ett ark.

2. Skapa två filterrutor.

3. Lägg till First name som dimension i den första filterrutan. Lägg till Last name som dimension i den andra filterrutan.

4. Skapa därefter ett KPI med detta mått:

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

5. I filterrutan First name väljer du värdena Mark och Peter. I filterrutan Last name väljer du värdena Carr.

6. Observera att KPI visar ett värde på 2. Detta återspeglar att alla värden som du har valt, inklusive det valda uteslutna värdet Peter, räknas.

## Exempel 2 – Kombination av uteslutna, valda uteslutna och alternativa antal

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

#### Diagramuttryck

Översikt

Funktionen GetExcludedCount() returnerar det totala antalet unika värden som inte är valda och uteslutna. Om du vill inkludera valda uteslutna och alternativa antal i din visualisering kan du använda funktionen GetStateCounts() på följande sätt.

Öppna Skriptredigeraren och lägg till följande laddningsskript till ett nytt delavsnitt.

Laddningsskript

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

Resultat

Gör följande:

1. Ladda data och öppna ett ark.

2. Skapa två filterrutor.

3. Lägg till First name som dimension i den första filterrutan. Lägg till Last name som dimension i den andra filterrutan.

4. Skapa därefter ett KPI med detta mått:

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

5. I filterrutan First name väljer du värdena John och Peter. I filterrutan Last name väljer du värdena Franc.

6. Observera att KPI visar ett värde på 4. Detta återspeglar att det valda uteslutna värdet John ingår i antalet, utöver antalet uteslutna värden.

7. Redigera KPI:t och ersätt det befintliga måttet med följande:

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

8. Behåll de befintliga urvalen och välj värdet Anderson i filterrutan Last name.

9. Observera att KPI fortfarande visar ett värde på 4. Detta återspeglar att det valda uteslutna värdet Devonshire ingår i antalet, utöver antalet uteslutna värden.