Funciones de registro y error en Jitterbit Studio

Las funciones de registro y error pueden y deben ser utilizadas para proporcionar reacciones apropiadas a las acciones del script.

`GetLastError`

Declaración

string GetLastError()

Sintaxis

GetLastError()

Descripción

Devuelve el último error reportado en un script o transformación. Se puede utilizar con las funciones ResetError y Eval para el manejo de errores.

Tenga en cuenta que la función GetLastError no lleva el mensaje de error a otra operación. Para hacerlo, están disponibles las variables de Jitterbit que contienen esa información para su uso entre operaciones:

$jitterbit.operation.error
$jitterbit.operation.previous.error
$jitterbit.operation.last_error

Consulte también la función RaiseError.

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 al inicio]

`RaiseError`

Declaración

void RaiseError(string message)

Sintaxis

RaiseError(<message>)

Parámetros requeridos

message: Un mensaje de tipo cadena

Descripción

Provoca que un script o transformación falle, y que el contenido del parámetro message se muestre en el registro de errores.

El texto completo escrito en el registro de errores será:

Error Fatal <message> Este error fue generado por una llamada a la función RaiseError.

Advertencia

La función RaiseError debe ser utilizada como último recurso, ya que genera un error fatal. Si un script lo genera, no hay control por parte del programa que llama sobre lo que se produce al 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 su lugar, los programas deben probar las entradas y salidas y manejar las condiciones de manera defensiva.

Ejemplos

message = "El campo de origen "
  + "'Precio' tiene un valor inválido. Saliendo.";
RaiseError(message);

[Volver al inicio]

`ResetLastError`

Declaración

void ResetLastError()

Sintaxis

ResetLastError()

Descripción

Establece el último error como una cadena vacía. Esto es idéntico a llamar a SetLastError(""). Ver también la función SetLastError.

Ejemplos

// Restablece el último error
ResetLastError();

[Volver al inicio]

`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 la función GetLastError devolverá el mensaje a menos que ocurra otro error. Ver también la función ResetLastError, que realiza la misma acción de establecer el último error pero sin registrar un mensaje.

Ejemplos

// Establece el último error a un mensaje
message = "Valor inválido: campo de origen 'Precio'";
SetLastError(message);

[Volver al inicio]

`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

// Escribir un mensaje en el Registro de Operaciones
WriteToOperationLog("El campo de origen 'Precio' tiene un valor inválido.");

[Volver al inicio]