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. 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. 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.	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.	2	O
Avmarkerad	Inkluderar ej valda värden i beräkningen. Denna tillståndstyp är endast tillgänglig när fältet är i och-läge. Denna tillståndstyp returnerar samma beräkning som funktionen GetNotSelectedCount() returnerar, förutsatt att argumentet include_excluded i den funktionen är inställt på standardvärdet Falskt. Mer information om GetNotSelectedCount() finns i .GetNotSelectedCount - diagramfunktion.	3	D
Alternativ	Inkluderar alternativa värden i beräkningen. För motsvarande funktion, se GetAlternativeCount - diagramfunktion.	4	A
Utesluten	Inkluderar uteslutna (ej valda) värden i beräkningen. För motsvarande funktion, se GetExcludedCount - diagramfunktion.	5	X
Valda uteslutna	Inkluderar valda uteslutna värden i beräkningen.	6	XS

Användning

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 och resultat
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. =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)

Ö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 en ny flik.

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:

Ladda data och öppna ett ark.
Skapa två filterrutor.
Lägg till First name som dimension i den första filterrutan. Lägg till Last name som dimension i den andra filterrutan.
Skapa därefter ett KPI med detta mått:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
I filterrutan First name väljer du värdena Mark och Peter. I filterrutan Last name väljer du värdena Carr.
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

Ö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 en ny flik.

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:

Ladda data och öppna ett ark.
Skapa två filterrutor.
Lägg till First name som dimension i den första filterrutan. Lägg till Last name som dimension i den andra filterrutan.
Skapa därefter ett KPI med detta mått:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
I filterrutan First name väljer du värdena John och Peter. I filterrutan Last name väljer du värdena Franc.
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.
Redigera KPI:t och ersätt det befintliga måttet med följande:

=GetStateCounts([Last name], '', 'X', 'A', 'XS')
Behåll de befintliga urvalen och välj värdet Anderson i filterrutan Last name.
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.

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!

Lämna din feedback här