COUNT-Befehl

Zählt die Gesamtanzahl der Datensätze in der aktuellen Ansicht oder nur der Datensätze, die bestimmte Bedingungen erfüllen.

Syntax

COUNT <IF Test> <WHILE Test> <FIRST Bereich|NEXT Bereich>

Parameter

Name Beschreibung
IF Test

Optional

Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird nur für Datensätze ausgeführt, welche die Bedingung erfüllen.

Hinweis

Der IF-Parameter wird nur für Datensätze ausgewertet, die nach Anwendung von Bereichsparametern (WHILE, FIRST, NEXT) in einer Tabelle übrig sind.
WHILE Test

Optional

Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird ausgeführt, bis die Bedingung falsch ist oder das Tabellenende erreicht wurde.

Hinweis

Wenn Sie WHILE zusammen mit FIRST oder NEXT verwenden, endet die Datensatzverarbeitung, sobald eine Grenze erreicht wird.
FIRST Bereich | NEXT Bereich

Optional

Die Anzahl der zu verarbeitenden Datensätze:

  • FIRST Verarbeitung beim ersten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird
  • NEXT Verarbeitung beim aktuell ausgewählten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird

Verwenden Sie Bereich, um die Anzahl der zu verarbeitenden Datensätze anzugeben.

Wenn Sie FIRST und NEXT nicht angeben, werden standardmäßig alle Datensätze verarbeitet.

Analytics-Ausgabevariablen

Name Enthält
COUNTn

Die durch den Befehl berechnete Datensatzanzahl.

  • Wenn der Variablenname COUNT1 ist, wird die Datensatzanzahl für den zuletzt ausgeführten Befehl gespeichert.
  • Wenn der Variablenname COUNTn ist, wobei n größer als 1 ist, speichert die Variable die Datensatzanzahl für einen Befehl, der innerhalb eines GROUP-Befehls ausgeführt wird.

    Der Wert von n wird basierend auf der Zeilennummer des Befehls in GROUP zugewiesen. Wenn sich der Befehl beispielsweise eine Zeile unter dem GROUP-Befehl befindet, wird der Wert COUNT2 zugewiesen. Wenn sich der Befehl vier Zeilen unter dem GROUP-Befehl befindet, wird der Wert COUNT5 zugewiesen.

Beispiele

COUNT1 speichern

Das Ergebnis des COUNT-Befehls wird in der Ausgabevariablen COUNT1 gespeichert. Sie können diesen Wert in einer benutzerdefinierten Variable abrufen und speichern.

Der Befehl COUNT überschreibt die Variable „COUNT1“ bei jeder Ausführung. Daher muss der Wert in einer benutzerdefinierten Variable gespeichert werden, bevor der Befehl nach dem Anwenden des Filters auf die Tabelle ein zweites Mal ausgeführt wird:

OPEN KundenAdresse 
COUNT 
GesamtanzahlDaten = COUNT1 
SET FILTER TO ÄnderungsDatum > '20100101' 
COUNT 
GesamtanzahlFilterdatensätze = COUNT1

Bemerkungen

Wann Sie COUNT verwenden sollen

Verwenden Sie den Befehl COUNT, um die Anzahl der Datensätze in einer Analytics-Tabelle oder der Datensätze, die eine bestimmte Testbedingung erfüllen, zu ermitteln. Wenn kein Prüfkriterium angegeben ist, wird die Gesamtzahl der Datensätze in der Analytics-Tabelle angezeigt.

Wie COUNT durch Filter beeinflusst wird

Wenn ein Filter auf eine Ansicht angewendet wurde, ermittelt der Befehl die Anzahl der Datensätze, die nach dem Anwenden der Filterbedingung in der Tabelle verbleiben.