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>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
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
RaiseError("The source field 'Price' has an invalid value. Exiting.");
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
SetLastError("The source field 'Price' has an invalid value.");
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ções.
Exemplos
// Write a message to the Operation Log
WriteToOperationLog("The source field 'Price' has an invalid value.");