Saltar para o conteúdo principal
Versão: Próximo

SOAP SEND FAULT

SOAP SEND FAULT ( tipoErro ; descriçao )

ParâmetroTipoDescrição
tipoErroInteger1 = Erro cliente; 2= erro Servidor
descriçaoTextDescrição do erro a enviar ao cliente SOAP

Descrição

O comando SOAP SEND FAULT permite devolver um erro a um cliente SOAP indicando a origem do erro: cliente ou servidor. Este comando permite indicar um erro a um cliente sem ter que devolver um resultado.

Por exemplo, um erro do lado do cliente pode ser detectado quando publica um serviço web “Raiz_quadrada” e um cliente envia uma petição com um número negativo; pode utilizar este comando com o objetivo de indicar ao cliente que se necessita um valor positivo.

Um erro possível do lado do servidor poderia ser por exemplo, falta de memória durante a execução do método.

Passe o origem do erro em tipoErro. Pode utilizar as seguintes constantes predefinidas, que ficam no tema Serviços Web (Servidor).

ConstanteTipoValor
SOAP client faultInteiro longo1
SOAP server faultInteiro longo2

Passe em descriçao a descrição do erro. Se a implementação do cliente for correta, o erro pode ser processado.

Exemplo

Regresando ao exemplo do serviço Web “Raiz_quadrada” da descrição do comando, a instrução abaixo pode ser utilizada para processar petições con números negativos:

 SEND SOAP FAULT(SOAP client fault;"Valores positivos exigidos")

Ver também

SOAP DECLARATION
SOAP get info