GetStateCounts - diagramfunctie

De GetStateCounts() diagramfunctie wordt gebruikt om het totale aantal unieke waarden te berekenen dat overeenkomt met de opgegeven selectiestatussen.

Met GetStateCounts() kunt u de berekeningen van de volgende functies combineren in één enkele functieaanroep: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount(), en GetExcludedCount(). Het aantal geselecteerde uitgesloten waarden kan ook aan de berekening worden toegevoegd. U kunt opgeven of elke functieberekening een waarde optelt of aftrekt van het geretourneerde totaal.

Syntaxis:

GetStateCounts (field_name, state_name [, state_type1,...state_typeN])

Retourgegevenstypen: geheel getal

Argumenten
Argument	Beschrijving
field_name	Het veld waarvoor u de selectiestatus berekent. Een niet-bestaande veldnaam leidt tot het resultaat null.
state_name	De naam van de alternatieve states. Als het argument leeg ('') of null is, wordt de overgenomen alternatieve state gebruikt. Gebruik $ om expliciet de standaardstate te gebruiken. Een benoemde (niet-lege) statenaam die niet overeenkomt met een bestaande state resulteert in de uitkomst null.
state_type	Een lijst van één of meer statetypen voor de veldwaarde. Deze statetypen worden samengevoegd tot een telling. Een statetype wordt gespecificeerd met behulp van een sleutel. Voer elke sleutel in tussen enkele aanhalingstekens. Als dit argument wordt weggelaten, retourneert de functie een tekenreeks met alle beschikbare statetellingen voor het veld, in dezelfde volgorde als de opsomming. Zie onderstaande tabel voor een lijst van states die u kunt gebruiken.

Er wordt naar statetypen verwezen met behulp van specifieke sleutels. U kunt de numerieke of tekstuele versie van de sleutel gebruiken. Combineer meer dan één sleutel in dezelfde uitdrukking om het resultaat verder aan te passen. U kunt het aantal states aftrekken van het totaal, in plaats van het toe te voegen. Gebruik hiervoor de tekstsleutel en zet een minteken (-) voor het statetype.

Het statetype en, indien van toepassing, het minteken moeten tussen enkele aanhalingstekens staan.

Sleutels voor elk veld statetype
Statetype Veld	Beschrijving	Numerieke sleutel	Tekstuele sleutel
Geselecteerd	Bevat geselecteerde waarden in de berekening. Zie GetSelectedCount - diagramfunctie voor de soortgelijke functie.	1	S
Optioneel	Bevat optionele (niet geselecteerde, maar wel te selecteren) waarden in de berekening. Zie GetPossibleCount - diagramfunctie voor de soortgelijke functie.	2	O
Selectie opgeheven	Bevat niet-geselecteerde waarden in de berekening. Dit statetype is alleen beschikbaar als het veld in de and-modus staat. Dit statetype retourneert dezelfde berekening die de functie GetNotSelectedCount() retourneert, ervan uitgaande dat het argument include_excluded in die functie is ingesteld op de standaardwaarde False. Zie GetNotSelectedCount - diagramfunctie voor meer informatie over GetNotSelectedCount().	3	D
Alternatief	Bevat alternatieve waarden in de berekening. Zie GetAlternativeCount - diagramfunctie voor de soortgelijke functie.	4	A
Uitgesloten	Bevat uitgesloten (niet-geselecteerde) waarden in de berekening. Zie GetExcludedCount - diagramfunctie voor de soortgelijke functie.	5	X
Selectie uitgesloten	Bevat geselecteerde uitgesloten waarden in de berekening.	6	XS

Wanneer gebruiken

Door GetStateCounts() kunt u een aangepaste selectiestatus berekenen. Met deze functie kunt u meerdere functieaanroepen consolideren in één functieaanroep, waardoor het proces van het schrijven van uw uitdrukking wordt vereenvoudigd.

U moet bijvoorbeeld het totale aantal uitgesloten, alternatieve en geselecteerde waarden berekenen voor een veld. U kunt GetStateCounts() gebruiken om dit totaal te berekenen.

Voorbeelden en resultaten
Voorbeelden	Resultaten
=GetStateCounts(ProductName, Null(), 'S')	Retourneert het geselecteerde aantal voor ProductName, in de overgenomen alternatieve state.
=GetStateCounts(ProductName, '', 'X', 'A', 'XS')	Geeft het totale aantal uitgesloten, geselecteerde waarden en alternatieve waarden voor ProductName. De overgenomen alternatieve state wordt gebruikt.
=GetStateCounts(ProductName, '', 'S', 'XS')	Retourneert het totale aantal gebruikersselecties voor ProductName, in de overgenomen alternatieve state.
Gegeven dat het veld ProductName in and-modus staat. =GetStateCounts(ProductName, '', 'D', '-O')	Retourneert het aantal niet-geselecteerde waarden, afgetrokken van het aantal mogelijke waarden, voor ProductName. De overgenomen alternatieve state wordt gebruikt.
=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')	Geeft het totale aantal uitgesloten, geselecteerde waarden en alternatieve waarden voor ProductName. De overgenomen alternatieve state wordt gebruikt.
=GetStateCounts(ProductName, '$', 'O')	Retourneert het mogelijke aantal voor ProductName, in de standaard alternatieve state.
=GetStateCounts(ProductName, 'StateA', 'S')	Retourneert het geselecteerde aantal van ProductName, in de alternatieve state met de naam StateA.

Voorbeeld 1 - Het totale aantal gebruikersselecties tellen (inclusief geselecteerde uitgesloten waarden)

Overzicht

De functie GetSelectedCount() retourneert het totale aantal geselecteerde waarden, exclusief het totale aantal geselecteerde uitgesloten waarden. Met GetExcludedCount() kunt u het aantal geselecteerde uitgesloten waarden opnemen in de berekening van het diagram.

Open de Editor voor laden van gegevens en voeg het volgende load-script toe aan een nieuw tabblad.

Load-script

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

Resultaten

Doe het volgende:

Laad de gegevens en open een werkblad.
Maak twee filtervakken.
Voeg First name toe als dimensie in het eerste filtervak. Voeg Last name toe als dimensie in het tweede filtervak.
Maak vervolgens een KPI met deze meting:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
Selecteer in het filtervak First name de waarden Mark en Peter. Selecteer in het filtervak Last name de waarden Carr.
Merk op dat de KPI een waarde laat zien van 2. Dit geeft aan dat alle waarden die u hebt geselecteerd, inclusief de geselecteerde uitgesloten waarde Peter, worden geteld.

Voorbeeld 2 - Combinatie van uitgesloten, geselecteerde uitgesloten en alternatieve tellingen

Overzicht

De functie GetExcludedCount() retourneert het totale aantal unieke waarden die niet zijn geselecteerd en uitgesloten. Als u geselecteerde uitgesloten waarden en alternatieve waarden wilt opnemen in uw visualisatie, kunt u de functie GetStateCounts() als volgt gebruiken.

Open de Editor voor laden van gegevens en voeg het volgende load-script toe aan een nieuw tabblad.

Load-script

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

Resultaten

Doe het volgende:

Laad de gegevens en open een werkblad.
Maak twee filtervakken.
Voeg First name toe als dimensie in het eerste filtervak. Voeg Last name toe als dimensie in het tweede filtervak.
Maak vervolgens een KPI met deze meting:

=GetStateCounts([First name], '', 'X', 'A', 'XS')
Selecteer in het filtervak First name de waarden John en Peter. Selecteer in het filtervak Last name de waarden Franc.
U ziet dat de KPI een waarde van 4 laat zien. Dit geeft aan dat de geselecteerde uitgesloten waarde John is opgenomen in de telling, naast de telling van de uitgesloten waarden.
Bewerk de KPI en vervang de bestaande meting door het volgende:

=GetStateCounts([Last name], '', 'X', 'A', 'XS')
Behoud de bestaande selecties en selecteer de waarde Anderson in het filtervak Last name.
U ziet dat de KPI nog steeds een waarde van 4 laat zien. Dit geeft aan dat de alternatieve waarde Devonshire is opgenomen in de telling, naast de telling van de uitgesloten waarden.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback