Funciones de Registro y Error
Las funciones de registro y error pueden y deben usarse para proporcionar reacciones apropiadas a las acciones del secuencia de comandos.
GetLastError
Declaración
string GetLastError()
Sintaxis
GetLastError()
Descripción
Devuelve el último error informado en un secuencia de comandos o transformación. Se puede utilizar con el ResetError
y Eval
funciones para el manejo de errores.
Tenga en cuenta que el GetLastError()
La función no transfiere el mensaje de error a otra operación. Para hacer eso, hay variables Jitterbit disponibles que contienen esa información para usar entre operaciones:
$jitterbit.operation.error
$jitterbit.operation.previous.error
$jitterbit.operation.last_error
Ver también el RaiseError
función.
Ejemplos
// 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);
RaiseError
Declaración
void RaiseError(string message)
Sintaxis
RaiseError(<message>)
Parámetros Requeridos
message
: Un mensaje de cadena
Descripción
Provoca que un secuencia de comandos o transformación falle y el contenido del parámetro message
que se mostrará en el registro de errores.
El texto completo escrito en el registro de errores será:
Fatal Error
<message>
This error was raised by a call to the RaiseError function.
Advertencia
El RaiseError()
La función debe usarse como último recurso, ya que genera un error fatal. Si un secuencia de comandos lo genera, el programa que realiza la llamada no tiene control sobre lo que se produce para el cliente. Jitterbit no tiene un mecanismo de excepción de "generar y capturar", y generar este error resultará en un error de servidor con un estado de 500. En cambio, los programas deben probar las entradas y salidas y manejar las condiciones de manera defensiva.
Ejemplos
RaiseError("The source field 'Price' has an invalid value. Exiting.");
ResetLastError
Declaración
void ResetLastError()
Sintaxis
ResetLastError()
Descripción
Establece el último error en una cadena vacía. Esto es idéntico a llamar SetLastError("")
. Ver también la función SetLastError
.
Ejemplos
// Reset the last error
ResetLastError();
SetLastError
Declaración
void SetLastError(string message)
Sintaxis
SetLastError(<message>)
Parámetros Requeridos
errorMessage
: Un mensaje de cadena
Descripción
Establece un último error definido por el usuario. El mensaje se registrará como una advertencia y el GetLastError
la función devolverá el mensaje a menos que ocurra otro error. Ver también la función ResetLastError
, que realiza la misma acción de configurar el último error pero sin registrar un mensaje.
Ejemplos
// Sets the last error to a message
SetLastError("The source field 'Price' has an invalid value.");
WriteToOperationLog
Declaración
string WriteToOperationLog(string message)
Sintaxis
WriteToOperationLog(<message>)
Parámetros Requeridos
message
: Un mensaje de cadena
Descripción
Escribe un mensaje en el registro de operaciones.
Ejemplos
// Write a message to the Operation Log
WriteToOperationLog("The source field 'Price' has an invalid value.");