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. 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. 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 - funzione per grafici.	1	S
Opzionale	Include nel calcolo valori opzionali (non selezionati, ma selezionabili). Per la funzione equivalente, vedere GetPossibleCount - funzione per grafici.	2	O
Deselezionato	Include nel calcolo i valori non selezionati. Questo tipo di stato è disponibile solo quando il campo è in modalità and. 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 - funzione per grafici.	3	D
Alternativo	Include valori alternativi nel calcolo. Per la funzione equivalente, vedere GetAlternativeCount - funzione per grafici.	4	A
Escluso	Include nel calcolo i valori esclusi (non selezionati). Per la funzione equivalente, vedere GetExcludedCount - funzione per grafici.	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, '', '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. =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)

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 scheda.

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:

Caricare i dati e aprire un foglio.
Creare due caselle di filtro.
Aggiungere First name come dimensione nella prima casella di filtro. Aggiungere Last name come dimensione nella seconda casella di filtro.
Quindi, creare un KPI con questa misura:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
Nella casella di filtro First name, selezionare i valori Mark e Peter. Nella casella di filtro Last name, selezionare i valori Carr.
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

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 scheda.

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:

Caricare i dati e aprire un foglio.
Creare due caselle di filtro.
Aggiungere First name come dimensione nella prima casella di filtro. Aggiungere Last name come dimensione nella seconda casella di filtro.
Quindi, creare un KPI con questa misura:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
Nella casella di filtro First name, selezionare i valori John e Peter. Nella casella di filtro Last name, selezionare i valori Franc.
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.
Modificare il KPI e sostituire la misura esistente con la seguente:

=GetStateCounts([Last name], '', 'X', 'A', 'XS')
Mantenendo le selezioni esistenti, selezionare il valore Anderson nella casella di filtro Last name.
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.

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!

Lascia qui il tuo feedback