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. 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. 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.	1	S
Opcjonalne	Uwzględnia w obliczeniu opcjonalne (niewybrane, ale możliwe do wybrania) wartości. Funkcję równoważną opisano w temacie GetPossibleCount.	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. 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.	3	D
Alternatywne	Uwzględnia alternatywne wartości w obliczeniach. Funkcję równoważną opisano w temacie GetAlternativeCount.	4	A
Wykluczone	Uwzględnia wykluczone (niewybrane) wartości w obliczeniach. Funkcję równoważną opisano w temacie GetExcludedCount.	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. =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)

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:

Załaduj dane i utwórz dwie listy wartości w arkuszu.
Dodaj First name jako wymiar na pierwszej liście wartości. Dodaj Last name jako wymiar na drugiej liście wartości.
Następnie utwórz tabelę prostą z tą miarą:

=GetStateCounts([First Name],'', 'S','XS')
Na liście wartości First name wybierz wartości Mark i Peter. Na liście wartości filtru Last name wybierz wartość Carr.
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

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.