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
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.
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. | 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. | 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 — funkcja wykresu. |
3 | D |
Alternatywne | Uwzględnia alternatywne wartości w obliczeniach. Funkcję równoważną opisano w temacie GetAlternativeCount — funkcja wykresu. | 4 | A |
Wykluczone | Uwzględnia wykluczone (niewybrane) wartości w obliczeniach. Funkcję równoważną opisano w temacie GetExcludedCount — funkcja wykresu. | 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 | 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. =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. |