SEQUENCE-Befehl

Konzept-Informationen

Testen der sequentiellen Reihenfolge

Bestimmt, ob ein oder mehrere Felder in einer Analytics-Tabelle in sequenzieller Folge vorliegen und identifiziert nicht sortierte Elemente.

Syntax

SEQUENCE <ON> {<FIELDS> Schlüsselfeld <D> <...n>|<FIELDS> ALL <EXCLUDE Feldname <...n>>} <UNFORMATTED> <ERRORLIMIT n> <IF Test> <WHILE Test> <FIRST Bereich|NEXT Bereich> <TO {SCREEN|Dateiname|PRINT}> <APPEND> <HEADER Kopfzeilentext> <FOOTER Fußzeilentext> <PRESORT> <ISOLOCALE Gebietsschemacode>

Parameter

Name Beschreibung
ON FIELDS Schlüsselfeld D <...n> | FIELDS ALL

Ein oder mehrere Zeichen-, Datumzeit-Felder oder numerische Felder, deren sequenzielle Reihenfolge getestet werden soll.

  • FIELDS SchlüsselfeldTestet die angegebenen Felder

    Mehrere Felder müssen durch Leerzeichen getrennt werden und können unterschiedliche Datentypen aufweisen.

    Wenn Sie mehr als ein Feld testen, werden Felder in derselben Reihenfolge getestet, in der Sie sie auflisten.

    Geben Sie D an, damit die Schlüsselfeldwerte in absteigender Reihenfolge getestet werden. Die Standardreihenfolge für den Test ist aufsteigend.

  • FIELDS ALLTestet alle Felder in der Tabelle

    Wenn Sie alle Felder testen, werden die Felder in der Reihenfolge getestet, in der sie im Tabellenlayout angezeigt werden.

    Bei FIELDS ALL können Schlüsselfeldwerte nur in aufsteigender Reihenfolge getestet werden.

Hinweis

Falls Sie für mehr als ein Feld testen, testen Sie eine verschachtelte sequenzielle Reihenfolge in der Quelltabelle. Eine gültige Verwendung von SEQUENCE setzt voraus, dass Sie die Testfelder in derselben Reihenfolge angeben wie die bestehende verschachtelte sequenzielle Reihenfolge der Quelltabelle. Mehrere Testfelder werden als verschachtelte Gruppe getestet. Es erfolgt kein unabhängiger Test dieser Felder.
EXCLUDE Feldname

optional

Nur beim Test der sequenziellen Reihenfolge mit FIELDS ALL gültig.

Die Felder, die von dem Befehl ausgeschlossen werden sollen. Durch EXCLUDE können Sie eine Feinanpassung des Schlüsselworts ALL vornehmen, indem Sie die angegebenen Felder ausschließen.

EXCLUDE muss unmittelbar auf FIELDS ALL folgen, oder auf das letzte Vorkommen des Schlüsselworts ALL, wenn Sie Felder aus einer oder mehreren verbundenen Tabellen einschließen. Beispiel:

FIELDS ALL EXCLUDE field_1 field_2
FIELDS ALL related_table_name.ALL EXCLUDE field_1 field_2

UNFORMATTED

optional

Unterdrückt Seitentitel und Seitenumbrüche, wenn die Ausgabe in eine Datei erfolgt.

ERRORLIMIT n

optional

Die Zahl der zulässigen Fehler bis zum Abbruch des Befehls. Der Standardwert 10.

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:

  • FIRSTBeginnen Sie mit der Verarbeitung beim ersten Datensatz, bis die angegebene Datensatzanzahl erreicht ist.
  • NEXTBeginnen Sie die Verarbeitung beim aktuell ausgewählten Datensatz, bis die angegebene Datensatzanzahl erreicht ist.

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.

TO SCREEN | Dateiname | PRINT

optional

Der Ort, an den die Ergebnisse des Befehls gesendet werden sollen:

  • SCREENZeigt die Ergebnisse im Analytics-Anzeigebereich an.

    Tipp

    Sie können auf jeden verknüpften Ergebniswert im Anzeigebereich klicken, um einen Drill-Down auf die zugeordneten Datensätze innerhalb der Quelltabelle durchzuführen.

  • DateinameSpeichert die Ergebnisse in einer Datei.

    Geben Sie Tabellenname als in Anführungszeichen gesetzte Zeichenfolge mit der entsprechenden Dateierweiterung an. Beispiel: TO "Output.TXT"

    Standardmäßig wird die Datei im Ordner mit dem Analytics-Projekt gespeichert.

    Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datei in einen anderen bestehenden Ordner zu speichern:

    • TO "C:\Output.TXT"
    • TO "Results\Output.TXT"
  • PRINTSendet die Ausgabe an den Standarddrucker.

APPEND

optional

Hängt die Befehlsausgabe an das Ende einer vorhandenen Datei an, statt die Datei zu überschreiben.

Hinweis

Vergewissern Sie sich, dass die Struktur der Befehlsausgabe und der bestehenden Datei identisch sind:

  • dieselben Felder
  • dieselbe Feldanordnung
  • abzugleichende Felder mit derselben Länge
  • abzugleichende Felder mit demselben Datentyp

Analytics hängt eine Ausgabe an eine bestehende Datei beliebiger Struktur an. Falls die Struktur der Ausgabe und der bestehenden Datei nicht übereinstimmen, kann die Datenintegrität verletzt sein, es können Daten fehlen oder falsch sein.

HEADER Kopfzeilentext

optional

Der Text, der am Anfang jeder Seite eines Berichts eingefügt wird.

Kopfzeilentext muss als eine in Anführungszeichen gesetzte Zeichenfolge angegeben werden. Der Wert überschreibt die Analytics-Systemvariable HEADER.

FOOTER Fußzeilentext

optional

Der Text, der am Ende jeder Seite eines Berichts eingefügt wird.

Fußzeilentext muss als eine in Anführungszeichen gesetzte Zeichenfolge angegeben werden. Der Wert überschreibt die Analytics-Systemvariable FOOTER.

PRESORT

optional

Sortiert die Tabelle auf Basis des Schlüsselfelds vor der Ausführung des Befehls.

Hinweis

PRESORT kann nicht innerhalb des GROUP-Befehls verwendet werden.
ISOLOCALE Gebietsschema_Code

optional

Hinweis

Gilt nur für die Unicode-Edition von Analytics.

Das Systemgebietsschema im Format Sprache_Land. Für kanadisches Französisch geben Sie beispielsweise fr_ca ein.

Verwenden Sie die folgenden Codes:

  • SpracheSprachcode nach ISO-Norm 639
  • LandLändercode nach ISO-Norm 3166

    Wenn Sie keinen Ländercode angeben, wird das standardmäßige Land für die Sprache verwendet.

Wenn Sie ISOLOCALE verwenden, wird das Standard-Systemgebietsschema nicht verwendet.

Analytics-Ausgabevariablen

Name Beinhaltet
WRITEn

Speichert die Gesamtanzahl der Sortierfolgefehler, die von dem Befehl ermittelt wurden.

Beispiele

Test auf nicht sequenzielle Mitarbeiternummern

Sie schreiben alle in den Feldern Mitarbeiternummer ermittelten Sortierfolgefehler in eine Textdatei:

SEQUENCE ON Mitarbeiternummer ERRORLIMIT 10 TO "Sequenzfehler.txt"

Bemerkungen

Weitere Informationen über die Funktion dieses Befehls finden Sie in Testen der sequentiellen Reihenfolge.

SEQUENCE in GROUP verwenden

Wenn Sie SEQUENCE innerhalb eines GROUP-Befehls verwenden, wird der Befehl ausgeführt, um eine Beeinträchtigung der Gruppenverarbeitung zu vermeiden. Es werden jedoch keine weiteren Sortierfolgefehler für die Daten gemeldet.