GetSelectedCount() finner antalet valda (gröna) värden i ett fält.
Syntax:
GetSelectedCount (field_name [, include_excluded [, state_name]])
Returnerad datatyp: heltal
Färgerna som används i urvalsfältet och för varje urvaltillstånd kan ändras med ett anpassat tema. Om du arbetar med en app som använder ett anpassat tema kanske du märker att dina val inte visas med de färger som beskrivs i det här hjälpämnet.
| Argument | Beskrivning |
|---|---|
| field_name | Fältet som innehåller dataintervallet som ska mätas. |
| include_excluded | Om det anges som True(), inkluderar räkningen valda värden som just nu är exkluderade av urval i andra fält. Om de är False eller utelämnade inkluderas dessa värden inte. |
| state_name | Namnet på ett alternativt tillstånd som har valts till den specifika visualiseringen. Om argumentet state_name används tas endast hänsyn till de urval som är förknippade med det angivna tillståndsnamnet. Mer information finns i Använda parallella tillstånd för jämförande analys. |
I följande tabell listas andra funktioner som är relaterade till denna funktion.
| Funktion | Interaktion |
|---|---|
| GetStateCounts - diagramfunktion | Med hjälp av GetStateCounts() kan du kombinera beräkningen av följande antal med ett enda funktionsanrop:
|
| GetPossibleCount - diagramfunktion | Returnerar antalet möjliga värden. |
| GetAlternativeCount - diagramfunktion | Returnerar antalet alternativa värden. |
| GetSelectedCount - diagramfunktion | Returnerar antalet uteslutna värden, exklusive alternativa och valda uteslutna värden. |
| Exempel | Resultat |
|---|---|
| GetSelectedCount (FirstName) | Om inga val görs returneras 0. Om något val har gjorts i fältet FirstName returneras antalet valda artiklar. |
| GetSelectedCount (FirstName, True()) | Om inga val görs returneras 0. Om några val har gjorts i fältet FirstName returneras det antal artiklar som valts, oberoende av eventuella efterföljande val i andra fält som kan minska de tillgängliga värdena i fältet FirstName. |
Exempel – grunderna i GetSelectedCount
Översikt
Öppna dataladdningsredigeraren och lägg till laddningsskriptet nedan i ett nytt delavsnitt.
Laddningsskriptet innehåller:
En datauppsättning som läses in i en datatabell som heter Example.
Följande fält i datatabellen:
FirstName
LastName
Initials
HasCellphone
Laddningsskript
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 '|');Resultat
Ladda data och öppna ett ark. Skapa en ny filterruta och lägg till dessa fält som dimensioner:
FirstName
Initials
Skapa två KPI-objekt, ett för vart och ett av följande mätuttryck:
KPI 1: =GetSelectedCount(FirstName) för att returnera antalet artiklar som valts i FirstName-fältet.
KPI 2: =GetSelectedCount(Initials) för att returnera antalet artiklar som valts i Initials-fältet.
Varje KPI returnerar antalet valda objekt i respektive fält. Utan några val i filtren returnerar båda KPI:erna värdet 0.
Anteckning om tipsI det här exemplet har utformningen av KPI:n justerats för att använda ett responsiv layoutbeteende som underlättar visning av resultatet. Mer information om hur du ändrar layouten för diagrammet finns i Formatera KPIKlicka på Redigera ark för att växla till analysläge och välj John i FirstName-filtret.
KPI 1 returnerar värdet 1 eftersom det finns ett objekt som valts i FirstName-filtret. KPI 2 returnerar fortfarande 0 eftersom filtret Initials inte har några valda objekt.
Exempel – GetSelectedCount med parametern include_excluded
Översikt
I det här exemplet används samma datauppsättning som i det föregående exemplet, men här visas skillnaden i resultat när parametern include_excluded ställs in på True().
Öppna dataladdningsredigeraren och lägg till laddningsskriptet nedan i ett nytt delavsnitt.
Laddningsskriptet innehåller:
En datauppsättning som läses in i en datatabell som heter Example.
Följande fält i datatabellen:
FirstName
LastName
Initials
HasCellphone
Laddningsskript
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 '|');Resultat
Ladda data och öppna ett ark. Skapa en ny filterruta och lägg till dessa fält som dimensioner:
Initials
HasCellPhone
Skapa två KPI-objekt, ett för vart och ett av följande mätuttryck:
KPI 1: =GetselectedCount(Initials) för att fastställa antalet värden som har valts i fältet Initials.
KPI 2: =GetSelectedCount([Initials], True()) för att inkludera valda värden som just nu exkluderas av urval i andra fält.
Utan några val i filterrutan returnerar båda KPI:erna värdet 0.
Anteckning om tipsI det här exemplet har utformningen av KPI:n justerats för att använda ett responsiv layoutbeteende som underlättar visning av resultatet. Mer information om hur du ändrar layouten för diagrammet finns i Formatera KPIKlicka på Redigera ark för att växla till analysläge. Välj alla värden i Initials-filtret och välj sedan Yes i HasCellphone-filtret.
När du jämför resultaten för varje KPI kan du se hur var och en returnerar ett annat värde beroende på om parametern include_excluded är inställd på True() eller inte. KPI 2 returnerar värdet 6 eftersom det inkluderar alla valda värden i Initials-filtret, även om valet i HasCellphone-filtret har reducerat de tillgängliga objekten till 4. KPI 1 returnerar 4 eftersom den inte räknar de utvalda uteslutna värdena i Initials.