Protokollierungs- und Fehlerfunktionen im Jitterbit Integration 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>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);
RaiseError
Erklärung
void RaiseError(string message)
Syntax
RaiseError(<message>)
Erforderliche Parameter
message: Eine String-Nachricht
Beschreibung
Bewirkt, 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
message = "The source field "
+ "'Price' has an invalid value. Exiting.";
RaiseError(message);
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();
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
message = "Invalid value: source field 'Price'";
SetLastError(message);
WriteToOperationLog
Erklärung
string WriteToOperationLog(string message)
Syntax
WriteToOperationLog(<message>)
Erforderliche Parameter
message: Eine String-Nachricht
Beschreibung
Schreibt eine Meldung in das Operation.
Beispiele
// Write a message to the Operation Log
WriteToOperationLog("The source field 'Price' has an invalid value.");