Funções de registro e erro no Jitterbit Studio

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 relatado em um script ou transformação. Pode ser usado com as funções ResetError e Eval para tratamento de erros.

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

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

Veja também a função RaiseError.

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

[Voltar ao topo]

`RaiseError`

Declaração

void RaiseError(string message)

Sintaxe

RaiseError(<message>)

Parâmetros obrigatórios

message: Uma mensagem em string

Descrição

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

Todo o texto escrito no log de erros será:

Erro Fatal <message> Este erro foi gerado por uma chamada à função RaiseError.

Aviso

A função RaiseError deve ser usada como último recurso, pois gera um erro fatal. Se um script a gerar, não há controle por parte do programa chamador sobre o que é produzido para o cliente. O Jitterbit não possui um mecanismo de exceção "levantar-e-capturar", e gerar esse erro resultará em um Erro de Servidor com um Status de 500. Em vez disso, os programas devem testar entradas e saídas e tratar condições de forma defensiva.

Exemplos

message = "O campo de origem "
  + "'Preço' tem um valor inválido. Saindo.";
RaiseError(message);

[Voltar 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

// Redefine o último erro
ResetLastError();

[Voltar ao topo]

`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 a função GetLastError retornará a mensagem, a menos que outro erro ocorra. Veja também a função ResetLastError, que realiza a mesma ação de definir o último erro, mas sem registrar uma mensagem.

Exemplos

// Define o último erro como uma mensagem
message = "Valor inválido: campo de origem 'Preço'";
SetLastError(message);

[Voltar ao topo]

`WriteToOperationLog`

Declaração

string WriteToOperationLog(string message)

Sintaxe

WriteToOperationLog(<message>)

Parâmetros obrigatórios

message: Uma mensagem de string

Descrição

Escreve uma mensagem no log de operações.

Exemplos

// Escreve uma mensagem no Log de Operações
WriteToOperationLog("O campo de origem 'Preço' tem um valor inválido.");

[Voltar ao topo]