# GetStateCounts — funkcja wykresu

Funkcja wykresu GetStateCounts() służy do obliczania łącznej liczby unikatowych wartości pasujących do określonych stanów zaznaczenia.

Przy użyciu GetStateCounts() możesz połączyć obliczenia z następujących funkcji w jedno wywołanie funkcji: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() oraz GetExcludedCount(). Liczba wybranych wykluczonych wartości jest również dostępna do dodania do obliczenia. Możesz określić, czy każde obliczenie funkcji ma dodawać, czy odejmować od zwróconej sumy.

Składnia:

GetStateCounts (field\_name, state\_name [, state\_type1,...state\_typeN])

Typ zwracanych danych: liczba całkowita

Argumenty

| Argument | Opis |
| --- | --- |
| field\_name | Pole, dla którego obliczany jest stan zaznaczenia. Nieistniejąca nazwa pola skutkuje wynikiem null. |
| state\_name | Nazwa alternatywnego stanu. Jeśli argument jest pusty (`''`) lub null, używany jest odziedziczony stan alternatywny. Użyj `$`, aby jawnie użyć stanu domyślnego. Nazwana (niepusta) nazwa stanu, która nie pasuje do istniejącego stanu, skutkuje wynikiem null. |
| state\_type | Lista jednego lub większej liczby typów stanu dla wartości pola. Te typy stanu zostaną zagregowane w liczbę. Typ stanu jest określany za pomocą klucza. Wprowadź każdy klucz w pojedynczym cudzysłowie.<br><br>W przypadku pominięcia tego argumentu funkcja zwraca ciąg znaków z wszystkimi dostępnymi liczbami stanów dla danego pola, w tej samej kolejności co wyliczenie.<br><br>Lista stanów, których można używać, znajduje się w tabeli poniżej. |

Typy stanów są przywoływane za pomocą określonych kluczy. Możesz użyć liczbowej lub tekstowej wersji klucza. Połącz więcej niż jeden klucz w tym samym wyrażeniu, aby jeszcze bardziej dostosować wynik. Możesz odjąć liczbę stanów od sumy, zamiast ją dodawać. W tym celu należy użyć klucza tekstowego oraz poprzedzić typ stanu symbolem minusa (`-`).

Typ stanu oraz, jeśli jest stosowany, symbol minusa, muszą być ujęte w zestaw pojedynczych cudzysłowów.

Klucze dla każdego typu stanu pola

| Typ stanu pola | Opis | Klucz liczbowy | Klucz tekstowy |
| --- | --- | --- | --- |
| Wybrane | Uwzględnia wybrane wartości w obliczeniach. Funkcję równoważną opisano w temacie [GetSelectedCount — funkcja wykresu](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Opcjonalne | Uwzględnia w obliczeniu opcjonalne (niewybrane, ale możliwe do wybrania) wartości. Funkcję równoważną opisano w temacie [GetPossibleCount — funkcja wykresu](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Niewybrane | Uwzględnia niewybrane wartości w obliczeniach. Ten typ stanu jest dostępny tylko wtedy, gdy pole znajduje się w trybie AND. | 3 | D |
| Alternatywne | Uwzględnia alternatywne wartości w obliczeniach. Funkcję równoważną opisano w temacie [GetAlternativeCount — funkcja wykresu](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Wykluczone | Uwzględnia wykluczone (niewybrane) wartości w obliczeniach. Funkcję równoważną opisano w temacie [GetExcludedCount — funkcja wykresu](https://help.qlik.com/pl-PL/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Wybrane wykluczone | Uwzględnia wybrane wykluczone wartości w obliczeniach. | 6 | XS |

## Kiedy używać

Przy użyciu GetStateCounts() możesz obliczyć niestandardowy stan zaznaczenia. Funkcja ta pozwala skonsolidować wiele wywołań funkcji w jedno wywołanie funkcji, upraszczając proces pisania wyrażenia.

Na przykład może być potrzebne obliczenie całkowitej liczby wykluczonych, alternatywnych i wybranych wykluczonych wartości dla pola. Do obliczenia tej sumy możesz użyć GetStateCounts().

Przykłady: wyrażenia wykresu

| Przykłady | Wyniki |
| --- | --- |
| `=GetStateCounts( ProductName, Null(), 'S' )` | Zwraca wybraną liczbę dla `ProductName`, w odziedziczonym stanie alternatywnym. |
| `=GetStateCounts( ProductName, '', 'X', 'A', 'XS' )` | Zwraca całkowitą liczbę wykluczonych, wybranych wykluczonych i alternatywnych wartości dla `ProductName`. Używany jest odziedziczony stan alternatywny. |
| `=GetStateCounts( ProductName, '', 'S', 'XS' )` | Zwraca łączną liczbę wyborów użytkowników dla `ProductName`, w stanie odziedziczonym. |
| Zakładając, że pole ProductName jest w trybie AND.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Zwraca liczbę niewybranych wartości, odjętą od liczby możliwych wartości, dla `ProductName`. Używany jest odziedziczony stan alternatywny. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Zwraca całkowitą liczbę wykluczonych, wybranych wykluczonych i alternatywnych wartości dla `ProductName`. Używany jest odziedziczony stan alternatywny. |
| `=GetStateCounts(ProductName, '$', 'O')` | Zwraca możliwą liczbę dla `ProductName`, w domyślnym stanie alternatywnym. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Zwraca wybraną liczbę dla `ProductName`, w odziedziczonym stanie alternatywnym o nazwie `StateA`. |

## Przykład 1 — liczenie całkowitej liczby wyborów użytkownika (w tym wybranych wykluczonych wartości)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Wyrażenie wykresu

Przegląd

Funkcja GetSelectedCount() zwraca całkowitą liczbę wybranych wartości, nie uwzględniając całkowitej liczby wybranych wartości wykluczonych. Przy użyciu GetExcludedCount() można uwzględnić liczbę wybranych wykluczonych wartości w obliczeniach wykresu.

Otwórz Edytor ładowania danych i dodaj następujący skrypt ładowania do nowej sekcji.

Skrypt ładowania

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

Wyniki

Wykonaj następujące czynności:

1. Załaduj dane i otwórz arkusz.

2. Utwórz dwa panele filtrowania.

3. Dodaj First name jako wymiar w pierwszym panelu filtrowania. Dodaj Last name jako wymiar w drugim panelu filtrowania.

4. Następnie utwórz wskaźnik KPI na podstawie tej miary:

   `=GetStateCounts([First Name],'', 'S','XS')`

5. W panelu filtrowania First name wybierz wartości: Mark i Peter. W panelu filtrowania Last name wybierz wartość Carr.

6. Zauważ, że wskaźnik KPI pokazuje wartość 2. Oznacza to, że wszystkie wybrane wartości, w tym wybrana wartość wykluczona Peter, są liczone.

## Przykład 2 — łączenie liczb wykluczonych, wybranych wykluczonych i alternatywnych

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Wyrażenia wykresu

Przegląd

Funkcja GetExcludedCount() zwraca całkowitą liczbę unikatowych wartości, które są niewybrane i wykluczone. Jeśli chcesz uwzględnić w wizualizacji liczby wybrane wykluczone i alternatywne, możesz użyć funkcji GetStateCounts() następująco.

Otwórz Edytor ładowania danych i dodaj następujący skrypt ładowania do nowej sekcji.

Skrypt ładowania

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

Wyniki

Wykonaj następujące czynności:

1. Załaduj dane i otwórz arkusz.

2. Utwórz dwa panele filtrowania.

3. Dodaj First name jako wymiar w pierwszym panelu filtrowania. Dodaj Last name jako wymiar w drugim panelu filtrowania.

4. Następnie utwórz wskaźnik KPI na podstawie tej miary:

   `=GetStateCounts([First name], '', 'X', 'A', 'XS')`

5. W panelu filtrowania First name wybierz wartości: John i Peter. W panelu filtrowania Last name wybierz wartość Franc.

6. Zauważ, że wskaźnik KPI pokazuje wartość 4. Odzwierciedla to, że wybrana wykluczona wartość John jest uwzględniona w liczbie, dodatkowo do liczby wykluczonych wartości.

7. Edytuj wskaźnik KPI i zamień istniejącą miarę na następującą:

   `=GetStateCounts([Last name], '', 'X', 'A', 'XS')`

8. Zachowując istniejące wybory, wybierz wartość Anderson w panelu filtrowania Last name.

9. Zauważ, że wskaźnik KPI nadal pokazuje wartość 4. Odzwierciedla to, że wartość alternatywna Devonshire jest uwzględniona w liczbie, dodatkowo do liczby wykluczonych wartości.