# GetStateCounts

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 |
| --- | --- | --- | --- |
| Elementi selezionati | Include i valori selezionati nel calcolo. Per la funzione equivalente, vedere [GetSelectedCount](https://help.qlik.com/it-IT/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Opzionale | Include nel calcolo valori opzionali (non selezionati, ma selezionabili). Per la funzione equivalente, vedere [GetPossibleCount](https://help.qlik.com/it-IT/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/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.<br><br>Questo tipo di stato restituisce lo stesso calcolo che restituisce la funzione GetNotSelectedCount(), assumendo che l'argomento include\_excluded di tale funzione sia impostato come predefinito su Falso. Per ulteriori informazioni su GetNotSelectedCount(), vedere [GetNotSelectedCount](https://help.qlik.com/it-IT/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/GetNotSelectedCount.htm). | 3 | D |
| Alternativo | Include valori alternativi nel calcolo. Per la funzione equivalente, vedere [GetAlternativeCount](https://help.qlik.com/it-IT/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Escluso | Include nel calcolo i valori esclusi (non selezionati). Per la funzione equivalente, vedere [GetExcludedCount](https://help.qlik.com/it-IT/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/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 e risultati

| Esempi | Risultati |
| --- | --- |
| `=GetStateCounts(ProductName, Null(), 'S')` | Restituisce il conteggio selezionato per ProductName, nello stato alternato ereditato. |
| `=GetStateCounts(ProductName, '', 'A', 'XS')` | Restituisce il conteggio totale dei valori alternativi e dei valori esclusi selezionati 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. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Restituisce il conteggio totale dei valori esclusi, esclusi selezionati e alternativi per ProductName. Viene utilizzato lo stato alternato 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, '$', '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/qlikview/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Espressioni dei grafici

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.

Per iniziare, aggiungere lo script di caricamento qui sotto nel documento.

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 creare due caselle di riepilogo nel foglio.

2. Aggiungere First name come dimensione nella prima casella di riepilogo. Aggiungere Last name come una dimensione nella seconda casella di riepilogo.

3. Quindi, creare una tabella lineare con questa misura:

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

4. Nella casella di riepilogo First name, selezionare i valori Mark e Peter. Nella casella di riepilogo Last name, selezionare il valore Carr.

5. Osservare che il la tabella lineare mostra il valore 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/qlikview/Subsystems/Client/Content/QV_QlikView/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.

Per iniziare, aggiungere lo script di caricamento qui sotto nel documento.

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 creare due caselle di riepilogo nel foglio.

2. Aggiungere First name come dimensione nella prima casella di riepilogo. Aggiungere Last name come una dimensione nella seconda casella di riepilogo.

3. Quindi, creare una tabella lineare con questa espressione:

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

4. Nella casella di riepilogo First name, selezionare i valori John e Peter. Nella casella di riepilogo Last name, selezionare il valore Franc.

5. Osservare che la tabella lineare mostra il valore 4. Ciò riflette il fatto che il valore escluso selezionato John è incluso nel conteggio, oltre al conteggio dei valori esclusi.

6. Modificare la tabella lineare e sostituire l'espressione esistente con la seguente:

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

7. Mantenendo le selezioni esistenti, selezionare il valore Anderson nell'espressione Last name.

8. Osservare che la tabella lineare mostra il valore 4. Ciò riflette il fatto che il valore alternativo Devonshire è incluso nel conteggio, oltre al conteggio dei valori esclusi.