Protokollierungs- und Fehlerfunktionen im Jitterbit Design Studio

Um auf Script entsprechend reagieren zu können, können und sollten Logging- und Fehlerfunktionen genutzt werden.

`GetLastError`

Erklärung

string GetLastError()

Syntax

GetLastError()

Beschreibung

Gibt den letzten in einem Script oder einer Transformation gemeldeten Fehler zurück. Dies kann mit dem ResetError Und Eval Funktionen zur Fehlerbehandlung.

Beachten Sie, dass die GetLastError() Funktion überträgt die Fehlermeldung nicht in eine andere Operation. Dafür 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 RaiseError Funktion.

Beispiele

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

// On failure, put the last error into a variable
Eval(orderType = DBLookup("<TAG>MyProject/Targets/myDbTarget</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`

Erklärung

void RaiseError(string message)

Syntax

RaiseError(<message>)

Erforderliche Parameter

message: Eine String-Nachricht

Beschreibung

Führt dazu, dass ein Script oder eine Transformation fehlschlägt und der Inhalt des Parameters message im Fehlerprotokoll angezeigt werden.

Der gesamte Text, der in das Fehlerprotokoll geschrieben wird, lautet:

Fatal Error <message> This error was raised by a call to the RaiseError function.

Warnung

Die RaiseError() Die Funktion sollte nur als letztes Mittel verwendet werden, da sie einen schwerwiegenden Fehler auslöst. Wenn ein Script ihn auslöst, hat das aufrufende Programm keine Kontrolle darüber, was für den Client ausgegeben wird. Jitterbit verfügt nicht über einen Ausnahmemechanismus zum „Erhöhen und Erfassen“, und das Auslösen dieses Fehlers führt zu einem Serverfehler mit dem Status 500. Stattdessen sollten Programme auf Ein- und Ausgaben testen und Bedingungen defensiv behandeln.

Beispiele

RaiseError("The source field 'Price' has an invalid value. Exiting.");

[Zurück nach oben]

`ResetLastError`

Erklärung

void ResetLastError()

Syntax

ResetLastError()

Beschreibung

Setzt den letzten Fehler auf eine leere Zeichenfolge. Dies ist identisch mit dem Aufruf SetLastError("") Siehe auch die Funktion SetLastError.

Beispiele

// Reset the last error
ResetLastError();

[Zurück nach oben]

`SetLastError`

Erklärung

void SetLastError(string message)

Syntax

SetLastError(<message>)

Erforderliche Parameter

errorMessage: Eine String-Nachricht

Beschreibung

Legt einen benutzerdefinierten letzten Fehler fest. Die Meldung wird als Warnung protokolliert und die GetLastError Funktion gibt die Meldung zurück, sofern kein weiterer Fehler auftritt. Siehe auch die Funktion ResetLastError, das dieselbe Aktion ausführt wie das Setzen des letzten Fehlers, jedoch ohne eine Meldung zu protokollieren.

Beispiele

// Sets the last error to a message
SetLastError("The source field 'Price' has an invalid value.");

[Zurück nach oben]

`WriteToOperationLog`

Erklärung

string WriteToOperationLog(string message)

Syntax

WriteToOperationLog(<message>)

Erforderliche Parameter

message: Eine String-Nachricht

Beschreibung

Schreibt eine Nachricht in das Operationsprotokoll.

Beispiele

// Write a message to the Operation Log
WriteToOperationLog("The source field 'Price' has an invalid value.");

[Zurück nach oben]