GAPS-Befehl

Ermittelt, ob ein numerisches Feld oder ein Datumzeit-Feld in einer Analytics-Tabelle ein oder mehrere Lücken in sequenziellen Daten enthält.

Syntax

GAPS <ON> Schlüsselfeld <D> <UNFORMATTED> <PRESORT> <MISSING Limit> <HEADER Kopfzeilentext> <FOOTER Fußzeilentext> <IF Test> <WHILE Test> <FIRST Bereich|NEXT Bereich> <TO {SCREEN|Tabellenname|Dateiname|PRINT}> <LOCAL> <APPEND> <OPEN>

Parameter

Name Beschreibung
ON Schlüsselfeld D

Die Felder oder Ausdrücke, die auf Lücken geprüft werden sollen.

Geben Sie D an, damit das Schlüsselfeld in absteigender Reihenfolge sortiert wird. Die Standard-Sortierfolge ist aufsteigend.

UNFORMATTED

Optional

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

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.

MISSING Grenze

Optional

Die Ausgabeergebnisse beinhalten einzelne fehlende Elemente, nicht jedoch Lückenbereiche.

Der Wert Grenze gibt die maximale Anzahl fehlender Elemente an, die für die einzelnen ermittelten Lücken gemeldet werden sollen. Der Standardwert ist 5. Wenn der Grenzwert für eine bestimmte Lücke überschritten wird, werden die fehlenden Elemente für diese Lücke als Bereich gemeldet.

Der Wert Grenze ist kein Grenzwert für die Gesamtzahl fehlender Elemente, sondern bezieht sich nur auf die gemeldeten fehlenden Elemente innerhalb einer bestimmten Lücke.

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.

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.

TO SCREEN | Tabellenname | Dateiname | PRINT

Optional

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

  • SCREEN Zeigt 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.

  • Tabellenname Speichert die Ergebnisse in einer Analytics-Tabelle.

    Geben Sie Tabellenname als in Anführungszeichen gesetzte Zeichenfolge mit der Dateierweiterung „.FIL“ an. Beispiel: TO "Ausgabe.FIL"

    Standardmäßig wird die Tabellendatendatei (.FIL) im Ordner mit dem Analytics-Projekt gespeichert.

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

    • TO "C:\Ausgabe.FIL"
    • TO "Ergebnisse\Ausgabe.FIL"

    Hinweis

    Tabellennamen sind auf 64 alphanumerische Zeichen beschränkt, was die .FIL-Dateierweiterung nicht einbezieht. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

  • Dateiname Speichert die Ergebnisse in einer Datei.

    Geben Sie Dateiname als Zeichenfolge in Anführungszeichen mit einer geeigneten Dateierweiterung an. Beispiel: TO "Ausgabe.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:\Ausgabe.TXT"
    • .
    • TO "Ergebnisse\Ausgabe.TXT"
  • PRINT Sendet die Ergebnisse an den Standarddrucker.

LOCAL

Optional

Speichert die Ausgabedatei am selben Speicherort wie das Analytics-Projekt.

Hinweis

Nur anwendbar, wenn der Befehl für eine Servertabelle ausgeführt wird und die Ausgabedatei eine Analytics-Tabelle ist.

Der LOCAL-Parameter muss unmittelbar auf den TO-Parameter folgen.

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.

OPEN

Optional

Öffnet die durch den Befehl erstellte Tabelle, nachdem der Befehl ausgeführt wird. Nur gültig, wenn der Befehl eine Ausgabetabelle erstellt.

Analytics-Ausgabevariablen

Name Enthält
GAPDUPn

Die Gesamtanzahl an Lücken, Duplikaten oder Gruppen von Fuzzy-Duplikaten, die durch den Befehl identifiziert werden.

Beispiele

Auf fehlende Rechnungsnummern testen.

Sie verwenden GAPS, um sicherzustellen, dass in einer Tabelle Rechnungen keine Rechnungsnummern fehlen:

OPEN Rechnungen
GAPS ON Rec_Nr PRESORT TO "Rechnungslücken.fil"

Bemerkungen

Hinweis

Weitere Informationen über die Funktion dieses Befehls finden Sie in Hilfe für Analytics.

GAPS in Zeichenfeldern verwenden

Neben einem Test von numerischen Feldern oder Datumzeit-Feldern können Sie auch numerische Daten in einem Zeichenfeld auf Lücken untersuchen. Beispielsweise können Sie Schecknummern testen, die typischerweise als Zeichendaten formatiert sind.

Wenn Buchstaben und Zahlen zusammen in einem Zeichenfeld erscheinen, werden nur die Zahlen untersucht und die Buchstaben werden ignoriert.