VERIFY-Befehl

Konzept-Informationen

Daten überprüfen

Prüft auf Datengültigkeitsfehler in einem oder mehreren Feldern der aktuellen Analytics-Tabelle, indem die Daten auf Konsistenz mit den Felddefinitionen im Tabellenlayout geprüft werden.

Syntax

VERIFY {<FIELDS> Feldname <...n>|<FIELDS> ALL <EXCLUDE Feldname <...n>>} <IF Test> <WHILE Test> <FIRST Bereich|NEXT Bereich> <ERRORLIMIT n> <TO {SCREEN|Dateiname|PRINT}> <APPEND>

Parameter

Name Beschreibung
FIELDS Feldname <...n> | FIELDS ALL

Die Felder oder Ausdrücke, die überprüft werden sollen. Geben Sie ALL an, um alle Felder in der-Tabelle zu überprüfen.

Hinweis

Definitionsgemäß sind Kalkulationsfelder, Ad-hoc-Ausdrücke und Binärfelder immer gültig.

EXCLUDE Feldname

optional

Nur beim Verifizieren 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 

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.

ERRORLIMIT n

optional

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

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.

Analytics-Ausgabevariablen

Name Beinhaltet
WRITEn

Die Gesamtanzahl der Datengültigkeitsfehler aller Felder, die von dem Befehl ermittelt wurde.

Beispiele

Daten überprüfen und Fehlergrenze festlegen

Sie überprüfen alle Spalten einer Tabelle und legen das Fehlerlimit auf 10 fest. Der Befehl beendet die Ausführung nachdem er zehn Gültigkeitsfehler in den Daten gefunden hat:

VERIFY ALL ERRORLIMIT 10 TO "Fehlerimport.txt"

Bemerkungen

Funktionsweise

VERIFY vergleicht die Werte in einem oder mehreren Feldern mit dem für jedes Feld im Tabellenlayout angegebenen Datentyp und meldet aufgetretene Fehler. Der Befehl stellt sicher:

  • ZeichenfelderEnthalten ausschließlich gültige Zeichen und keine nicht druckbaren Zeichen.
  • Numerische FelderEnthalten nur gültige numerische Daten. Zusätzlich zu Zahlen können numerische Felder ein vorangehendes Plus- oder Minuszeichen und ein Dezimalkomma enthalten.
  • Datumzeit-FelderEnthalten ein gültiges Datum, eine Datumzeit oder eine Uhrzeit.

Für jeden festgestellten Fehler werden die Datensatznummer und der Feldname zusammen mit dem ungültigen Wert in hexadezimaler Schreibweise ausgegeben.