A falha de SOAP (o elemento <Fault>) é um subelemento do
corpo SOAP, que é utilizado para relatar erros.
Se presente, o elemento de falha de SOAP deve aparecer como uma entrada de corpo e não deve aparecer mais que uma vez em um elemento de corpo. Os subelementos do elemento
de falha de SOAP são diferentes no SOAP 1.1 e SOAP 1.2.
SOAP 1.1
No SOAP 1.1, a falha de SOAP contém os
seguintes subelementos:
- <faultcode>
- O elemento <faultcode> é um elemento obrigatório no elemento
<Fault>. Ele fornece informações sobre a falha em um formato que pode ser processado pelo software. SOAP define um pequeno conjunto
de códigos de falhas do SOAP que cobrem as falhas básicas do SOAP e este conjunto pode ser
estendido por aplicativos.
- <faultstring>
- o elemento <faultstring> é um elemento obrigatório no elemento
<Fault>. Ele fornece informações sobre a falha
em um formato destinado a um leitor humano.
- <faultactor>
- O elemento <faultactor> contém a URI do nó SOAP
que gerou a falha. Um nó SOAP que não é o receptor SOAP final deve incluir
o elemento <faultactor> quando criar uma falha;
um receptor SOAP final não precisa incluir este elemento, mas pode incluí-lo.
- <detail>
- O elemento <detail> transporta informações de erro específicas do aplicativo
relacionadas ao elemento <Body>.
Ele deve estar presente
se o conteúdo do elemento <Body> não tiver sido
processado com êxito. O elemento <detail> não deve ser utilizado
para transportar informações sobre o erro pertencentes a entradas do cabeçalho. Informações de erro detalhadas pertencentes às entradas do cabeçalho devem ser transportadas para as entradas do cabeçalho.
SOAP 1.2
No SOAP 1.2, a falha de SOAP contém os
seguintes subelementos:
- <Code>
- O elemento <Code> é um elemento obrigatório no elemento <Fault>. Ele fornece informações sobre a falha em um formato que pode ser processado pelo software. Ele contém um elemento <Value> e um elemento opcional <Subcode>.
- <Reason>
- O elemento <Reason> é um elemento obrigatório no elemento
<Fault>. Ele fornece informações sobre a falha
em um formato destinado a um leitor humano. O elemento <Reason> contém
um ou mais elementos <Text>, cada um contendo informações
sobre a falha em uma linguagem diferente.
- <Node>
- O elemento <Node> contém a URI do nó SOAP
que gerou a falha. Um nó SOAP que não é o receptor SOAP final
deve incluir o elemento <Node> quando cria uma falha;
um receptor SOAP final não precisa incluir este elemento; mas pode incluí-lo.
- <Role>
- O elemento <Role> contém um URI que identifica
a função na qual o nó estava operando no ponto em que a falha ocorreu.
- <Detail>
- O elemento <Detail> é um elemento opcional, que contém
informações de erro específicas do aplicativo relacionadas aos códigos de falha SOAP
que descrevem a falha. A presença do elemento <Detail>
não tem importância em relação a quais partes da mensagem SOAP com falha foram processadas.