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>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);

[Volver arriba]

`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

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

[Volver arriba]

`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();

[Volver arriba]

`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
message = "Invalid value: source field 'Price'";
SetLastError(message);

[Volver arriba]

`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 operación.

Ejemplos

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

[Volver arriba]