El error SOAP (el elemento <Fault>) es un subelemento del cuerpo
SOAP, que se utiliza para notificar errores.
Si está presente, el elemento fault de SOAP debe aparecer
como una entrada del elemento body y no debe aparecer más de una vez dentro del
elemento body. Los subelementos del elemento fault de SOAP
son distintos en SOAP 1.1 y SOAP 1.2.
SOAP 1.1
En SOAP 1.1, el elemento fault de SOAP
contiene los siguientes subelementos:
- <faultcode>
- El elemento <faultcode> es un elemento obligatorio dentro del elemento <Fault>. Proporciona información sobre el error en un formato que el software puede procesar. SOAP define un pequeño conjunto de códigos de error SOAP que cubren errores SOAP básicos, que las aplicaciones puede ampliar.
- <faultstring>
- El elemento <faultstring> es un elemento obligatorio dentro del elemento <Fault>. Proporciona información sobre el error en un formato que el usuario puede entender.
- <faultactor>
- El elemento <faultactor> contiene el URI del nodo SOAP que ha generado el error. Un nodo SOAP que no es el destinatario SOAP final debe incluir el elemento <faultactor> cuando crea un error, un destinatario SOAP final no está obligado a incluir este elemento, pero podría hacerlo.
- <detail>
- El elemento <detail> incluye información de error específica de la aplicación relacionada con el elemento <Body>.
Debe estar presente si el contenido del elemento <Body> no se ha procesado satisfactoriamente. El elemento <detail> no debe utilizarse para llevar información sobre la información de error que pertenece a entradas de cabecera. La información de error detallada perteneciente a entradas de cabecera debe transportarse dentro de entradas de cabecera.
SOAP 1.2
En SOAP 1.2, el elemento fault de SOAP contiene
los siguientes subelementos:
- <Code>
- El elemento <Code> es un elemento obligatorio dentro del elemento <Fault>. Proporciona información sobre el error en un formato que el software puede procesar. Contiene un elemento <Value> y un elemento <Subcode> opcional.
- <Reason>
- El elemento <Reason> es un elemento obligatorio dentro del elemento <Fault>. Proporciona información sobre el error en un formato que el usuario puede entender.
El elemento <Reason> contiene uno o varios elementos <Text>, cada uno de los cuales contiene información sobre el error en un idioma distinto.
- <Nodo>
- El elemento <Node> contiene el URI del nodo SOAP que ha generado el error. Un nodo SOAP que no es el destinatario SOAP final debe incluir el elemento <Node> cuando crea un error, un destinatario SOAP final no está obligado a incluir este elemento, pero podría hacerlo.
- <Role>
- El elemento <Role> contiene un URI que identifica el rol
que el nodo desempeñaba en el momento en que se produjo el error.
- <Detail>
- El elemento <Detail> es un elemento opcional, que contiene información de errores específica de la aplicación relacionada con los códigos de error SOAP que describen el error. La presencia del elemento <Detail>
no tiene ninguna importancia respecto a qué partes del mensaje SOAP erróneo se procesaron.