# GetStateCounts

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](https://help.qlik.com/pl-PL/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/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](https://help.qlik.com/pl-PL/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/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.<br><br>Ten typ stanu zwraca to samo obliczenie, które zwraca funkcja GetNotSelectedCount(), zakładając, że argument include\_excluded w tej funkcji jest ustawiony na wartość domyślną Fałsz. Więcej informacji o GetNotSelectedCount() zawiera temat [GetNotSelectedCount](https://help.qlik.com/pl-PL/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/GetNotSelectedCount.htm). | 3 | D |
| Alternatywne | Uwzględnia alternatywne wartości w obliczeniach. Funkcję równoważną opisano w temacie [GetAlternativeCount](https://help.qlik.com/pl-PL/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Wykluczone | Uwzględnia wykluczone (niewybrane) wartości w obliczeniach. Funkcję równoważną opisano w temacie [GetExcludedCount](https://help.qlik.com/pl-PL/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/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 i wyniki

| Przykłady | Wyniki |
| --- | --- |
| `=GetStateCounts(ProductName, Null(), 'S')` | Zwraca wybraną liczbę dla ProductName, w odziedziczonym stanie alternatywnym. |
| `=GetStateCounts(ProductName, '', 'A', 'XS')` | Zwraca całkowitą liczbę alternatywnych i wybranych wykluczonych 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. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Zwraca całkowitą liczbę wykluczonych, wybranych wykluczonych i alternatywnych wartości dla ProductName. Używany jest odziedziczony stan alternatywny. |
| 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, '$', '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/qlikview/Subsystems/Client/Content/QV_QlikView/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.

Na początek dodaj poniższy skrypt ładowania do dokumentu.

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 utwórz dwie listy wartości w arkuszu.

2. Dodaj First name jako wymiar na pierwszej liście wartości. Dodaj Last name jako wymiar na drugiej liście wartości.

3. Następnie utwórz tabelę prostą z tą miarą:

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

4. Na liście wartości First name wybierz wartości Mark i Peter. Na liście wartości filtru Last name wybierz wartość Carr.

5. Zauważ, że tabela prosta 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/qlikview/Subsystems/Client/Content/QV_QlikView/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.

Na początek dodaj poniższy skrypt ładowania do dokumentu.

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 utwórz dwie listy wartości w arkuszu.

2. Dodaj First name jako wymiar na pierwszej liście wartości. Dodaj Last name jako wymiar na drugiej liście wartości.

3. Następnie utwórz tabelę prostą z tym wyrażeniem:

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

4. Na liście wartości First name wybierz wartości John i Peter. Na liście wartości Last name wybierz wartość Franc.

5. Zauważ, że tabela prosta pokazuje wartość 4. Odzwierciedla to, że wybrana wykluczona wartość John jest uwzględniona w liczbie, dodatkowo do liczby wykluczonych wartości.

6. Edytuj tabelę prostą i zamień istniejące wyrażenie na następujące:

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

7. Zachowując istniejące wybory, wybierz wartość Anderson w wyrażeniu Last name.

8. Zauważ, że tabela prosta nadal pokazuje wartość 4. Odzwierciedla to, że wartość alternatywna Devonshire jest uwzględniona w liczbie, dodatkowo do liczby wykluczonych wartości.