# GetStateCounts - funzione per grafici

La funzione grafico GetStateCounts() viene utilizzata per calcolare il numero totale di valori unici corrispondenti agli stati di selezione specificati.

Con GetStateCounts(), è possibile combinare i calcoli delle seguenti Funzioni in un'unica chiamata di funzione: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() e GetExcludedCount(). È disponibile anche il conteggio dei valori esclusi selezionati da aggiungere al calcolo. È possibile specificare se ogni calcolo della funzione aggiunge oppure sottrae dal totale restituito.

Sintassi:

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

Tipo di dati restituiti: numero intero

Argomenti

| Argomento | Descrizione |
| --- | --- |
| field\_name | Il campo per il quale si sta calcolando lo stato di selezione. Un nome di campo inesistente produce un risultato nullo. |
| state\_name | Il nome dello Stato alternativo. Se l'argomento è vuoto (`''`) oppure nullo, viene utilizzato lo stato alternativo ereditato. Utilizzare `$` per impiegare esplicitamente lo stato predefinito. Un nome di stato (non vuoto) che non corrisponde a uno stato esistente dà come risultato NULL. |
| state\_type | Un elenco di uno o più tipi di campo per il valore del campo. Questi tipi di stato saranno aggregati in un conteggio. Un tipo di stato viene specificato tramite una chiave. Inserire ogni chiave con virgolette singole.<br><br>Se questo argomento viene omesso, la funzione restituisce una stringa con tutti i conteggi di stato disponibili per il campo, nello stesso ordine dell'enumerazione.<br><br>Per un elenco degli stati utilizzabili, consultare la tabella sottostante. |

I tipi di stato sono referenziati mediante chiavi specifiche. È possibile utilizzare la versione numerica oppure testuale del tasto. Combinare più di un tasto nella stessa espressione per personalizzare ulteriormente il risultato. È possibile sottrarre il conteggio dello stato dal totale, anziché aggiungerlo. A tale scopo, utilizzare la chiave testuale e anteporre al tipo di stato il simbolo meno (`-`).

Il tipo di stato ed eventualmente il simbolo meno devono essere racchiusi in una serie di virgolette singole.

Chiavi per ogni tipo di campo stato

| Tipo di stato campo | Descrizione | Chiave numerica | Chiave testuale |
| --- | --- | --- | --- |
| Selezionati | Include i valori selezionati nel calcolo. Per la funzione equivalente, vedere [GetSelectedCount - funzione per grafici](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Opzionale | Include nel calcolo valori opzionali (non selezionati, ma selezionabili). Per la funzione equivalente, vedere [GetPossibleCount - funzione per grafici](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Deselezionato | Include nel calcolo i valori non selezionati. Questo tipo di stato è disponibile solo quando il campo è in modalità AND. | 3 | D |
| Alternativo | Include valori alternativi nel calcolo. Per la funzione equivalente, vedere [GetAlternativeCount - funzione per grafici](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | Una |
| Escluso | Include nel calcolo i valori esclusi (non selezionati). Per la funzione equivalente, vedere [GetExcludedCount - funzione per grafici](https://help.qlik.com/it-IT/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Selezionato escluso | Include nel calcolo i valori esclusi selezionati. | 6 | XS |

## Casi di utilizzo

Con GetStateCounts(), è possibile calcolare uno stato di selezione personalizzato. La funzione consente di consolidare più chiamate di funzione in un'unica chiamata di funzione, semplificando il processo di scrittura dell'espressione.

Ad esempio, potrebbe essere necessario calcolare il numero totale di valori esclusi, alternativi e selezionati per un campo. Per calcolare questo totale è possibile utilizzare GetStateCounts().

Esempi: espressioni del grafico

| Esempi | Risultati |
| --- | --- |
| `=GetStateCounts( ProductName, Null(), 'S' )` | Restituisce il conteggio selezionato per `ProductName`, nello stato alternato ereditato. |
| `=GetStateCounts( ProductName, '', 'X', 'A', 'XS' )` | Restituisce il conteggio totale dei valori esclusi, esclusi selezionati e alternativi per `ProductName`. Viene utilizzato lo stato alternato ereditato. |
| `=GetStateCounts( ProductName, '', 'S', 'XS' )` | Restituisce il conteggio totale delle selezioni dell'utente per `ProductName`, nello stato ereditato. |
| Il campo ProductName è in modalità and.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Restituisce il numero di valori non selezionati, sottratti dal numero di valori possibili, per `ProductName`. Viene utilizzato lo stato alternato ereditato. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Restituisce il conteggio totale dei valori esclusi, esclusi selezionati e alternativi per `ProductName`. Viene utilizzato lo stato alternato ereditato. |
| `=GetStateCounts(ProductName, '$', 'O')` | Restituisce il conteggio possibile per `ProductName`, nello stato alternato predefinito. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Restituisce il conteggio selezionato di `ProductName`, nello stato alternato denominato `StateA`. |

## Esempio 1 - Conteggio del numero totale di selezioni dell'utente (compresi i valori selezionati esclusi)

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

#### Espressione del grafico

Panoramica

La funzione GetSelectedCount() restituisce il numero totale di valori selezionati, senza includere il numero totale di valori esclusi. Con GetExcludedCount(), è possibile includere nel calcolo del grafico il conteggio dei valori esclusi selezionati.

Aprire Editor caricamento dati, quindi aggiungere il seguente script di caricamento in una nuova sezione.

Script di caricamento

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

Risultati

Procedere come indicato di seguito:

1. Caricare i dati e aprire un foglio.

2. Creare due caselle di filtro.

3. Aggiungere First name come dimensione nella prima casella di filtro. Aggiungere Last name come dimensione nella seconda casella di filtro.

4. Quindi, creare un KPI con questa misura:

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

5. Nella casella di filtro First name, selezionare i valori Mark e Peter. Nella casella di filtro Last name, selezionare i valori Carr.

6. Osservare che il KPI mostra un valore di 2. Questo riflette il fatto che tutti i valori selezionati, incluso il valore escluso Peter, sono stati conteggiati.

## Esempio 2 - Combinazione di conteggi esclusi, esclusi selezionati e alternativi

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

#### Espressioni del grafico

Panoramica

La funzione GetExcludedCount() restituisce il numero totale di valori unici non selezionati ed esclusi. Se si desidera includere nella visualizzazione i conteggi selezionati esclusi e alternativi, è possibile utilizzare la funzione GetStateCounts() come segue.

Aprire Editor caricamento dati, quindi aggiungere il seguente script di caricamento in una nuova sezione.

Script di caricamento

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

Risultati

Procedere come indicato di seguito:

1. Caricare i dati e aprire un foglio.

2. Creare due caselle di filtro.

3. Aggiungere First name come dimensione nella prima casella di filtro. Aggiungere Last name come dimensione nella seconda casella di filtro.

4. Quindi, creare un KPI con questa misura:

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

5. Nella casella di filtro First name, selezionare i valori John e Peter. Nella casella di filtro Last name, selezionare i valori Franc.

6. Osservare che il KPI mostra un valore di 4. Ciò riflette il fatto che il valore escluso selezionato John è incluso nel conteggio, oltre al conteggio dei valori esclusi.

7. Modificare il KPI e sostituire la misura esistente con la seguente:

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

8. Mantenendo le selezioni esistenti, selezionare il valore Anderson nella casella di filtro Last name.

9. Osservare che il KPI mostra un valore di 4. Ciò riflette il fatto che il valore alternativo Devonshire è incluso nel conteggio, oltre al conteggio dei valori esclusi.