Ir para o conteúdo

Funções de Registro e Erro

As funções de registro e 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. Ele pode ser usado com o ResetError e Eval funções para tratamento de erros.

Observe que o GetLastError() 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>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);

[De volta ao topo]

RaiseError

Declaração

void RaiseError(string message)

Sintaxe

RaiseError(<message>)

Parâmetros Necessá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 para ser exibido no log de erros.

Todo o texto gravado 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 acionar, não haverá controle pelo programa de chamada sobre o que é produzido para o cliente. O Jitterbit não tem um mecanismo de exceção "raise-and-capture", e gerar esse erro resultará em um erro de servidor com status 500. Em vez disso, os programas devem testar as entradas e saídas e lidar com as condições defensivamente.

Exemplos

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

[De volta ao topo]

ResetLastError

Declaração

void ResetLastError()

Sintaxe

ResetLastError()

Descrição

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

Exemplos

// Reset the last error
ResetLastError();

[De volta ao topo]

SetLastError

Declaração

void SetLastError(string message)

Sintaxe

SetLastError(<message>)

Parâmetros Necessá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 a 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
SetLastError("The source field 'Price' has an invalid value.");

[De volta ao topo]

WriteToOperationLog

Declaração

string WriteToOperationLog(string message)

Sintaxe

WriteToOperationLog(<message>)

Parâmetros Necessários

  • message: Uma mensagem de string

Descrição

Grava uma mensagem no log de operações.

Exemplos

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

[De volta ao topo]