Inhaltsverzeichnis

Search

  1. Vorwort
  2. Umwandlungssprache
  3. Konstanten
  4. Operatoren
  5. Variablen
  6. Datumsangaben
  7. Funktionen

Referenzhandbuch für die Umwandlungssprache

Referenzhandbuch für die Umwandlungssprache

ERROR

ERROR

Zwingt
Data Integration Service
zum Überspringen einer Zeile und Ausgeben einer von Ihnen festgelegten Fehlermeldung. Die Fehlermeldung wird in der Sitzungs-Logdatei angezeigt.
Data Integration Service
trägt die übersprungenen Zeilen nicht in die Ablehnungsdatei ein.
Mit ERROR in Ausdrucksumwandlungen können Sie Daten validieren. Im Allgemeinen wird ERROR innerhalb einer IIF- oder DECODE-Funktion eingesetzt, um die Regeln für das Überspringen von Zeilen festzulegen.
Verwenden Sie ERROR für die Standardwerte sowohl der Eingabe- als auch der Ausgabeports. Sie können ERROR bei Eingabeports dazu nutzen, die Übergabe von Nullwerten in die Umwandlung zu verhindern.
Außerdem können Sie mit ERROR in Ausgabeports alle Arten von Umwandlungsfehlern behandeln, einschließlich der ERROR-Funktionsaufrufe innerhalb eines Ausdrucks. Wenn Sie die Funktion ERROR in einem Ausdruck und im Standardwert des Ausgabeports verwenden, überspringt
Data Integration Service
die Zeile und protokolliert sowohl die Fehlermeldung aus dem Ausdruck als auch jene aus dem Standardwert. Wenn Sie sichergehen möchten, dass
Data Integration Service
alle Zeilen überspringt, in denen ein Fehler auftritt, ordnen Sie ERROR als Standardwert zu.
Bei anderen Ausgabestandardwerten als ERROR überschreibt der Standardwert die Funktion ERROR in einem Ausdruck. Beispiel: Sie verwenden ERROR in einem Ausdruck, weisen dem Ausgabeport als Standardwert jedoch „1234“ zu. Jedes Mal, wenn
Data Integration Service
nun im Ausdruck auf die Funktion ERROR trifft, überschreibt es den Fehler mit dem Wert „1234“ und übergibt diesen Wert an die nächste Umwandlung. Die Zeile wird nicht übersprungen und es wird keine Fehlermeldung in das Protokoll eingetragen.

Syntax

ERROR(
string
)
In der folgenden Tabelle wird das Argument für diesen Befehl beschrieben:
Argument
Erforderlich/
Optional
Beschreibung
string
Erforderlich
Stringwert. Die Meldung, die angezeigt werden soll, wenn Integration Service infolge eines Ausdrucks mit der Funktion ERROR eine Zeile überspringt. Der String kann beliebig lang sein.

Rückgabewert

String.

Beispiel

Das folgende Beispiel zeigt, wie ein Mapping referenziert wird, das das durchschnittliche Gehalt von Mitarbeitern in allen Abteilungen des Unternehmens berechnet, negative Werte aber überspringt. Die Funktion ERROR wird in einem IIF-Ausdruck verschachtelt, sodass
Data Integration Service
bei einem negativen Wert im Port SALARY die betreffende Zeile überspringt und einen Fehler anzeigt:
IIF( SALARY < 0, ERROR ('Error. Negative salary found. Row skipped.', EMP_SALARY )
SALARY
RETURN VALUE
10000
10000
-15000
'Error. Negative salary found. Row skipped.'
NULL
NULL
150000
150000
1005
1005