# 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

Argumente

| 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.<br><br>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.<br><br>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.

Schlüssel für jeden Feldzustandstyp

| 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](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Optional | Enthält optionale (nicht ausgewählte, aber wählbare) Werte in der Berechnung. Die entsprechende Funktion finden Sie unter [GetPossibleCount - Diagrammfunktion](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 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 AND-Modus befindet. | 3 | D |
| Alternativ | Schließt die alternativen Werte in die Berechnung ein. Die entsprechende Funktion finden Sie unter [GetAlternativeCount - Diagrammfunktion](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Ausgeschlossen | Schließt die ausgeschlossenen (nicht ausgewählten) Werte in die Berechnung ein. Die entsprechende Funktion finden Sie unter [GetExcludedCount - Diagrammfunktion](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Ausgeschlossen ausgewählt | Schließt die ausgewählten ausgeschlossenen Werte in die Berechnung ein. | 6 | XS |

## Verwendung von GetStateCounts

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: Diagrammformeln

| 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.<br><br><br>`=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. |

## Beispiel 1: Zählung der Gesamtzahl der Benutzerauswahlen (einschließlich der ausgewählten ausgeschlossene Werte)

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

#### Diagrammformel

Übersicht

Die Funktion GetSelectedCount() gibt die Gesamtzahl der ausgewählten Werte zurück, in der die Gesamtzahl der ausgewählten ausgeschlossenen Werte nicht enthalten ist. Mit GetExcludedCount() können Sie die Anzahl der ausgewählten ausgeschlossenen Werte in die Berechnung des Diagramms einschließen.

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript in einen neuen Abschnitt ein.

Ladeskript

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

Ergebnisse

Gehen Sie folgendermaßen vor:

1. Laden Sie die Daten und öffnen Sie ein Arbeitsblatt.

2. Erstellen Sie zwei Filterfenster.

3. Fügen Sie First name als Dimension im ersten Filterfenster hinzu. Fügen Sie Last name als Dimension im zweiten Filterfenster hinzu.

4. Erstellen Sie dann einen KPI mit dieser Kennzahl:

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

5. Wählen Sie im Filterfenster First name die Werte Mark und Peter aus. Wählen Sie im Filterfenster Last name den Wert Carr aus.

6. Beachten Sie, dass der KPI einen Wert von 2 aufweist. Dies zeigt, dass alle von Ihnen ausgewählten Werte, einschließlich des ausgewählten ausgeschlossenen Werts Peter, gezählt werden.

## Beispiel 2: Kombination von ausgeschlossenen, ausgewählten ausgeschlossenen und alternativen Anzahlen

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

#### Diagrammformeln

Übersicht

Die Funktion GetExcludedCount() gibt die Gesamtzahl der eindeutigen Werte zurück, die nicht ausgewählt und ausgeschlossen sind. Wenn Sie ausgewählte ausgeschlossene und alternative Anzahlen in Ihre Visualisierung einschließen möchten, können Sie die Funktion GetStateCounts() wie folgt verwenden.

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript in einen neuen Abschnitt ein.

Ladeskript

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

Ergebnisse

Gehen Sie folgendermaßen vor:

1. Laden Sie die Daten und öffnen Sie ein Arbeitsblatt.

2. Erstellen Sie zwei Filterfenster.

3. Fügen Sie First name als Dimension im ersten Filterfenster hinzu. Fügen Sie Last name als Dimension im zweiten Filterfenster hinzu.

4. Erstellen Sie dann einen KPI mit dieser Kennzahl:

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

5. Wählen Sie im Filterfenster First name die Werte John und Peter aus. Wählen Sie im Filterfenster Last name den Wert Franc aus.

6. Beachten Sie, dass der KPI einen Wert von 4 aufweist. Das bedeutet, dass der ausgewählte ausgeschlossene Wert John zusätzlich zur Anzahl der ausgeschlossenen Werte in die Anzahl eingeschlossen ist.

7. Bearbeiten Sie den KPI und ersetzen Sie die vorhandene Kennzahl mit der folgenden:

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

8. Wählen Sie unter Beibehaltung der bestehenden Auswahlen den Wert Anderson im Filterfenster Last name aus.

9. Beachten Sie, dass der KPI immer noch einen Wert von 4 aufweist. Das bedeutet, dass der alternative Wert Devonshire zusätzlich zur Anzahl der ausgeschlossenen Werte in die Anzahl eingeschlossen ist.