Essa função lança um erro de negócio na execução do processo, o qual possui as seguintes informações: nome, mensagem e detalhes. Sendo que o nome é utilizado para identificação e tratamento do mesmo nos demais pontos do processo.
Observação
- O label do erro lançado por esta função é definido com o mesmo conteúdo do nome.
- Esta função está disponível para os scripts BeforeExecute e AfterExecute da atividade.
Sintaxe:context.utils.throwError(name, message, details: String)
Parâmetros:
| Nome | Tipo | Descrição |
| name | String | Texto contendo o nome do erro que será lançado na execução do processo. |
| message | String | Texto contendo a mensagem do erro que será lançado na execução do processo. |
| details | String | Texto contendo os detalhes do erro que será lançado na execução do processo. |
Tipo de retorno: Sem retorno.
Exemplo de utilização:
Essa função é utilizada quando se deseja interromper a execução de um script lançando um erro de negócio no mesmo. Esse erro lançado poderá ser tratado das mesmas forma que os demais erros lançados pelo próprio Workflow. Para saber mais informações sobre o tratamento de erros, consulte o tópico Tratamento de erro.
Será utilizado como exemplo para essa função, um script em que será feita uma verificação e caso esta falhe, será lançado um erro de negócio – via função definida pelo desenvolvedor. A tarefa que será utilizada para definir o script é a Efetivar reserva do processo abaixo.
Script definido no BeforeExecute da tarefa Efetivar reserva:
// Script antes da verificação - suprimido
…
// Verifica se o treinamento continua disponível
if(context.getVars().getBoolean(“treinamentoDisponível”)){
// Estando, então continua a execução normalmente
} else {
// Caso contrário, lança erro de negócio informando que ele não está mais disponível
// Monta as informações para o erro
var vars = context.getVars();
var nome = “CursoIndisponívelException”;
var mensagem = “O curso solicitado não está disponível”;
var detalhes = “Solicitante: “ + vars.getString(“solicitante”) + “ Data: “ + vars.getDate(“dataSolicitada”);
// Lança o erro
context.utils.throwError(nome, mensagem, detalhes);
}
// Script depois da validação - suprimido
…
Nesse caso, o erro será lançado para fora do script e consequentemente para fora da tarefa e, será tratado pelo tratador de erro padrão definido na tarefa – o evento de borda – adicionado à tarefa em questão.
English
Español
