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 ello, se dispone de variables de Jitterbit que contienen esa información para su uso entre operaciones:
$jitterbit.operation.error
$jitterbit.operation.previous.error
$jitterbit.operation.last_error
Véase 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¶
Hace que una 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 llama no tiene control sobre lo que se produce para el cliente. Jitterbit no tiene un mecanismo de excepción de "elevar y capturar", y generar este error dará como resultado 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("")
. Véase 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. Véase también la función ResetLastError
, que realiza la misma acción de establecer 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.");