Protokollierungs- und Fehlerfunktionen in Jitterbit Studio

Protokollierungs- und Fehlerfunktionen können und sollten verwendet werden, um angemessen auf Skriptaktionen zu reagieren.

`GetLastError`

Deklaration

string GetLastError()

Syntax

GetLastError()

Beschreibung

Gibt den letzten Fehler zurück, der in einem Skript oder einer Transformation gemeldet wurde. Er kann zusammen mit den Funktionen ResetError und Eval zur Fehlerbehandlung verwendet werden.

Beachten Sie, dass die Funktion GetLastError die Fehlermeldung nicht in eine andere Operation überträgt. Um dies zu tun, stehen Jitterbit-Variablen zur Verfügung, die diese Informationen für die Verwendung zwischen Operationen enthalten:

$jitterbit.operation.error
$jitterbit.operation.previous.error
$jitterbit.operation.last_error

Siehe auch die Funktion RaiseError.

Beispiele

// Discard previous errors
ResetLastError();
error = "";

// On failure, put the last error into a variable
Eval(orderType = DBLookup("<TAG>endpoint:database/My Database</TAG>",
  "SELECT ORDER_TYPE FROM PO_HEADER WHERE PO_NUMBER = " + PO_NUM),
  error = GetLastError());

// If an error, raise it with the error in the message
If(Length(error) > 0,
  RaiseError("Failed to lookup Order Type: "
    + error), orderType);

[Zurück nach oben]

`RaiseError`

Deklaration

void RaiseError(string message)

Syntax

RaiseError(<message>)

Erforderliche Parameter

message: Eine Zeichenfolgenmeldung

Beschreibung

Verursacht, dass ein Skript oder eine Transformation fehlschlägt, und der Inhalt des Parameters message im Fehlerprotokoll angezeigt wird.

Der gesamte Text, der im Fehlerprotokoll geschrieben wird, lautet:

Fatales Fehler <message> Dieser Fehler wurde durch einen Aufruf der Funktion RaiseError ausgelöst.

Warnung

Die Funktion RaiseError sollte als letzte Möglichkeit verwendet werden, da sie einen fatalen Fehler auslöst. Wenn ein Skript dies auslöst, hat das aufrufende Programm keine Kontrolle darüber, was an den Client ausgegeben wird. Jitterbit hat keinen "raise-and-capture"-Ausnahme-Mechanismus, und das Auslösen dieses Fehlers führt zu einem Serverfehler mit einem Status von 500. Stattdessen sollten Programme Eingaben und Ausgaben testen und Bedingungen defensiv behandeln.

Beispiele

message = "Das Quellfeld "
  + "'Preis' hat einen ungültigen Wert. Beende.";
RaiseError(message);

[Zurück nach oben]

`ResetLastError`

Deklaration

void ResetLastError()

Syntax

ResetLastError()

Beschreibung

Setzt den letzten Fehler auf einen leeren String. Dies entspricht dem Aufruf von SetLastError(""). Siehe auch die Funktion SetLastError.

Beispiele

// Setzt den letzten Fehler zurück
ResetLastError();

[Zurück nach oben]

`SetLastError`

Deklaration

void SetLastError(string message)

Syntax

SetLastError(<message>)

Erforderliche Parameter

errorMessage: Eine String-Nachricht

Beschreibung

Setzt einen benutzerdefinierten letzten Fehler. Die Nachricht wird als Warnung protokolliert und die Funktion GetLastError gibt die Nachricht zurück, es sei denn, ein anderer Fehler tritt auf. Siehe auch die Funktion ResetLastError, die die gleiche Aktion zum Setzen des letzten Fehlers ausführt, jedoch ohne eine Nachricht zu protokollieren.

Beispiele

// Setzt den letzten Fehler auf eine Nachricht
message = "Ungültiger Wert: Quellfeld 'Preis'";
SetLastError(message);

[Zurück nach oben]

`WriteToOperationLog`

Deklaration

string WriteToOperationLog(string message)

Syntax

WriteToOperationLog(<message>)

Erforderliche Parameter

message: Eine String-Nachricht

Beschreibung

Schreibt eine Nachricht in das Betriebsprotokoll.

Beispiele

// Schreibe eine Nachricht in das Betriebsprotokoll
WriteToOperationLog("Das Quellfeld 'Preis' hat einen ungültigen Wert.");

[Zurück nach oben]