Ir para o conteúdo

Funções de Registro e Erro

As funções de registro e de erro podem e devem ser usadas para fornecer reações apropriadas às ações do script.

GetLastError

Declaração

string GetLastError()

Sintaxe

GetLastError()

Descrição

Retorna o último erro reportado em um script ou transformação. Pode ser usado com o ResetError e Eval funções para tratamento de erros.

Observe que o GetLastError a função não transporta a mensagem de erro para outra operação. Para fazer isso, estão disponíveis variáveis Jitterbit que contêm essas informações para uso entre as operações:

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

Veja também o RaiseError função.

Exemplos

// 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

Declaração

void RaiseError(string message)

Sintaxe

RaiseError(<message>)

Parâmetros Obrigatórios

  • message: Uma mensagem de string

Descrição

Faz com que um script ou transformação falhe e o conteúdo do parâmetro message a ser exibido no log de erros.

Todo o texto escrito no log de erros será:

Fatal Error <message> This error was raised by a call to the RaiseError function.

Aviso

O RaiseError a função deve ser usada como último recurso, pois gera um erro fatal. Se um script o gerar, não haverá controle por parte do programa chamador sobre o que é produzido para o cliente. O Jitterbit não possui um mecanismo de exceção "aumentar e capturar", e gerar esse erro resultará em um erro de servidor com status 500. Em vez disso, os programas devem testar entradas e saídas e lidar com as condições defensivamente.

Exemplos

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

ResetLastError

Declaração

void ResetLastError()

Sintaxe

ResetLastError()

Descrição

Define o último erro como uma string vazia. Isto é idêntico a chamar SetLastError(""). Veja também a função SetLastError.

Exemplos

// Reset the last error
ResetLastError();

SetLastError

Declaração

void SetLastError(string message)

Sintaxe

SetLastError(<message>)

Parâmetros Obrigatórios

  • errorMessage: Uma mensagem de string

Descrição

Define um último erro definido pelo usuário. A mensagem será registrada como um aviso e o GetLastError função retornará a mensagem, a menos que ocorra outro erro. Veja também a função ResetLastError, que executa a mesma ação de definir o último erro, mas sem registrar uma mensagem.

Exemplos

// Sets the last error to a message
message = "Invalid value: source field 'Price'";
SetLastError(message);

WriteToOperationLog

Declaração

string WriteToOperationLog(string message)

Sintaxe

WriteToOperationLog(<message>)

Parâmetros Obrigatórios

  • message: Uma mensagem de string

Descrição

Grava uma mensagem no log de operação.

Exemplos

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