GetStateCounts - Diagrammfunktion
Die Diagrammfunktion GetStateCounts() wird verwendet, um die Gesamtzahl der eindeutigen Werte zu berechnen, die mit den angegebenen Auswahlstatus übereinstimmen.
Mit GetStateCounts() können Sie die Berechnungen aus den folgenden Funktionen in einem einzigen Funktionsaufruf zusammenfassen: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() und GetExcludedCount(). Die Anzahl der ausgewählten ausgeschlossene Werte kann ebenfalls zur Berechnung hinzugefügt werden. Sie können für jede Funktionsberechnung angeben, ob sie zu der zurückgegebenen Gesamtsumme addieren oder von ihr subtrahieren soll.
Syntax:
GetStateCounts (field_name, state_name [, state_type1,...state_typeN])
Rückgabe Datentyp: ganze Zahl
Argument | Beschreibung |
---|---|
field_name | Das Feld, für das Sie den Auswahlstatus berechnen. Ein nicht vorhandener Feldname führt zu einem Null-Ergebnis. |
state_name | Der Name des alternativen Zustands. Wenn das Argument leer ('') oder null ist, wird der geerbte alternative Zustand verwendet. Verwenden Sie $, um ausdrücklich den Standardzustand zu verwenden. Ein benannter (nicht leerer) Zustandsname, der nicht mit einem vorhandenen Zustand übereinstimmt, führt zu einem Null-Ergebnis. |
state_type |
Eine Liste von einem oder mehreren Zustandstypen für den Feldwert. Diese Zustandstypen werden zu einer Anzahl aggregiert. Ein Zustandstyp wird mit einem Schlüssel angegeben. Geben Sie jeden Schlüssel mit einfachen Anführungszeichen ein. Wenn dieses Argument weggelassen wird, gibt die Funktion einen String mit allen verfügbaren Zustandsanzahlen für das Feld zurück, und zwar in der Reihenfolge der Aufzählung. Eine Liste der Zustände, die Sie verwenden können, finden Sie in der folgenden Tabelle. |
Auf die Zustandstypen wird mit spezifischen Schlüsseln verwiesen. Sie können die numerische oder die Textversion des Schlüssels verwenden. Kombinieren Sie mehr als einen Schlüssel in derselben Formel, um das Ergebnis weiter anzupassen. Sie können die Zustandsanzahl von der Gesamtzahl abziehen, anstatt sie hinzuzufügen. Verwenden Sie dazu den Textschlüssel und stellen Sie dem Zustandstyp ein Minuszeichen (-) voran.
Der Zustandstyp und ggf. das Minuszeichen müssen in einfache Anführungszeichen gesetzt werden.
Feldzustandstyp | Beschreibung | Numerischer Schlüssel | Textschlüssel |
---|---|---|---|
Ausgewählt | Schließt die ausgewählten Werte in die Berechnung ein. Die entsprechende Funktion finden Sie unter GetSelectedCount - Diagrammfunktion. | 1 | S |
Optional | Enthält optionale (nicht ausgewählte, aber wählbare) Werte in der Berechnung. Die entsprechende Funktion finden Sie unter GetPossibleCount - Diagrammfunktion. | 2 | O |
Deaktiviert |
Schließt die nicht ausgewählten Werte in die Berechnung ein. Dieser Zustandstyp ist nur verfügbar, wenn sich das Feld im Und-Modus befindet. Dieser Zustandstyp gibt dieselbe Berechnung zurück wie die Funktion GetNotSelectedCount(), vorausgesetzt, das Argument include_excluded in dieser Funktion ist auf den Standardwert „Falsch“ eingestellt. Weitere Informationen zu GetNotSelectedCount() finden Sie unter GetNotSelectedCount - Diagrammfunktion. |
3 | D |
Alternativ | Schließt die alternativen Werte in die Berechnung ein. Die entsprechende Funktion finden Sie unter GetAlternativeCount - Diagrammfunktion. | 4 | A |
Ausgeschlossen | Schließt die ausgeschlossenen (nicht ausgewählten) Werte in die Berechnung ein. Die entsprechende Funktion finden Sie unter GetExcludedCount - Diagrammfunktion. | 5 | X |
Ausgewählt ausgeschlossen | Schließt die ausgewählten ausgeschlossenen Werte in die Berechnung ein. | 6 | XS |
Verwendung
Mit GetStateCounts() können Sie einen benutzerdefinierten Auswahlstatus berechnen. Die Funktion ermöglicht es Ihnen, mehrere Funktionsaufrufe in einem einzigen Funktionsaufruf zusammenzufassen und so die Verarbeitung Ihres Ausdrucks zu vereinfachen.
Ein Beispiel: Sie müssen die Gesamtzahl der ausgeschlossenen, alternativen und ausgewählten ausgeschlossenen Werte für ein Feld berechnen. Sie können GetStateCounts() verwenden, um diese Gesamtwerte zu berechnen.
Beispiele | Ergebnisse |
---|---|
=GetStateCounts(ProductName, Null(), 'S') | Gibt die ausgewählte Anzahl für ProductName im vererbten alternativen Zustand zurück. |
=GetStateCounts(ProductName, '', 'X', 'A', 'XS') | Gibt die Gesamtzahl der ausgeschlossenen, ausgewählten ausgeschlossenen und alternativen Werte für ProductName zurück. Es wird der vererbte alternative Zustand verwendet. |
=GetStateCounts(ProductName, '', 'S', 'XS') | Gibt die Gesamtzahl der Benutzerauswahlen für ProductName im vererbten Zustand zurück. |
Voraussetzung: Das Feld ProductName befindet sich im Und-Modus. =GetStateCounts(ProductName, '', 'D', '-O') |
Gibt die Anzahl der nicht ausgewählten Werte, subtrahiert um die Anzahl der möglichen Werte, für ProductName zurück. Es wird der vererbte alternative Zustand verwendet. |
=GetStateCounts(ProductName, '', 'X', , 'A', 'XS') | Gibt die Gesamtzahl der ausgeschlossenen, ausgewählten ausgeschlossenen und alternativen Werte für ProductName zurück. Es wird der vererbte alternative Zustand verwendet. |
=GetStateCounts(ProductName, '$', 'O') | Gibt die mögliche Anzahl für ProductName im alternativen Standardzustand zurück. |
=GetStateCounts(ProductName, 'StateA', 'S') | Gibt die ausgewählte Anzahl für ProductName im alternativen Zustand mit dem Namen StateA zurück. |