GetSelectedCount() retourneert het aantal geselecteerde (groene) waarden in een veld.
Syntaxis:
GetSelectedCount (field_name [, include_excluded [, state_name]])
Retourgegevenstypen: geheel getal
De kleuren die worden gebruikt in de selectiebalk en voor elke selectiestatus kunnen worden aangepast met een aangepast thema. Als u werkt met een app die een aangepast thema gebruikt, merkt u mogelijk dat uw selecties niet worden weergegeven met dezelfde kleuren die worden beschreven in dit Help-onderwerp.
| Argumenten | Beschrijving |
|---|---|
| field_name | Het veld met het bereik van gegevens die moeten worden gemeten. |
| include_excluded | Als de parameter is ingesteld op True(), worden ook geselecteerde waarden meegeteld die momenteel worden uitgesloten door selecties in andere velden. Als de parameter is ingesteld op False of wordt weggelaten, worden deze waarden niet opgenomen. |
| state_name | De naam van een alternatieve state die voor de specifieke visualisatie is gekozen. Als het argument state_name wordt gebruikt, wordt alleen rekening gehouden met de selecties die zijn gekoppeld aan de opgegeven statenaam. Ga voor meer informatie naar Alternatieve states gebruiken voor vergelijkende analyse. |
In de volgende tabel staan andere functies die aan deze functie gerelateerd zijn.
| Functie | Interactie |
|---|---|
| GetStateCounts - diagramfunctie | Met GetStateCounts() kunt u de berekening van de volgende aantallen combineren met één enkele functieaanroep:
|
| GetPossibleCount - diagramfunctie | Retourneert het aantal mogelijke waarden. |
| GetAlternativeCount - diagramfunctie | Retourneert het aantal alternatieve waarden. |
| GetSelectedCount - diagramfunctie | Retourneert het aantal uitgesloten waarden, exclusief alternatieve en geselecteerde opgenomen waarden. |
| Voorbeeld | Resultaat |
|---|---|
| GetSelectedCount (FirstName) | Als er geen selecties worden gemaakt, wordt 0 geretourneerd. Als er selecties zijn gemaakt in het veld FirstName, dan wordt het aantal geselecteerde items geretourneerd. |
| GetSelectedCount (FirstName, True()) | Als er geen selecties worden gemaakt, wordt 0 geretourneerd. Als er selecties zijn gemaakt in het veld FirstName, dan wordt het aantal geselecteerde items geretourneerd, ongeacht eventuele latere selecties in andere velden die de beschikbare waarden in het veld FirstName zouden kunnen verkleinen. |
Voorbeeld - Basisprincipes voor GetSelectedCount
Overzicht
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
FirstName
LastName
Initials
HasCellphone
Load-script
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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
Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg deze velden toe als dimensies:
FirstName
Initials
Maak twee KPI-objecten, één voor elk van de volgende metinguitdrukkingen:
KPI 1: =GetSelectedCount(FirstName) om het aantal geselecteerde items in het veld FirstName te retourneren.
KPI 2: =GetSelectedCount(Initials) om het aantal geselecteerde items in het veld Initials te retourneren.
Elke KPI retourneert het aantal geselecteerde items in elk veld. Zonder selecties in de filters retourneren beide KPI's de waarde 0.
TipIn dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram De stijl van de KPI aanpassenKlik op Werkblad bewerken om over te schakelen naar de analysemodus en selecteer vervolgens John in het filter FirstName.
KPI 1 retourneert de waarde 1 omdat er één item geselecteerd is in het filter FirstName. KPI 2 retourneert nog steeds 0 omdat het filter Initials geen geselecteerde items heeft.
Voorbeeld - GetSelectedCount met include_excluded parameter
Overzicht
Dit voorbeeld gebruikt dezelfde gegevensverzameling als het vorige voorbeeld, maar toont het verschil in resultaten wanneer de parameter include_excluded is ingesteld op True().
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.
Het load-script bevat:
Een gegevensverzameling die wordt geladen in een tabel met de naam Example.
De volgende velden in de gegevenstabel:
FirstName
LastName
Initials
HasCellphone
Load-script
Example:
LOAD * inline [
FirstName|LastName|Initials|HasCellphone
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
Laad de gegevens en open een werkblad. Maak een nieuw filtervak en voeg deze velden toe als dimensies:
Initials
HasCellPhone
Maak twee KPI-objecten, één voor elk van de volgende metinguitdrukkingen:
KPI 1: =GetselectedCount(Initials) om het aantal geselecteerde waarden in het veld Initials te bepalen.
KPI 2: =GetSelectedCount([Initials], True()) om ook geselecteerde waarden op te nemen die momenteel worden uitgesloten door selecties in andere velden.
Zonder selecties in het filtervak, retourneert elke KPI de waarde 0.
TipIn dit voorbeeld is de opmaak van de KPI aangepast om een responsief lay-outgedrag te gebruiken, zodat de uitvoer gemakkelijker te bekijken is. Zie voor meer informatie over het wijzigen van het lay-outgedrag van het diagram De stijl van de KPI aanpassenKlik op Werkblad bewerken om over te schakelen naar de analysemodus. Selecteer alle waarden in het filter Initials en selecteer vervolgens Yes in het filter HasCellphone.
Wanneer u de resultaten van elke KPI vergelijkt, kunt u zien dat elke KPI een andere waarde oplevert, afhankelijk van of de parameter include_excluded is ingesteld op True() of niet. KPI 2 retourneert de waarde 6 omdat het alle geselecteerde waarden in het filter Initials omvat, ook al heeft de selectie in het filter HasCellphone de beschikbare items gereduceerd tot 4. KPI 1 retourneert 4 omdat de geselecteerde uitgesloten waarden niet worden geteld in Initials.