Web Services Guide

Anterior Siguiente

Control de fallos

Cuando se produce un error en un servicio web, el servicio de integración de datos genera un mensaje de error y devuelve el mensaje en un fallo al cliente del servicio web.

Si una solicitud SOAP 1.1 se envía a una operación con enlace SOAP 1.2, el servicio web genera un fallo mediante SOAP 1.1. Si una solicitud SOAP 1.2 se envía a una operación con un enlace SOAP 1.1, el servicio web genera un fallo mediante SOAP 1.2. Un servicio web puede generar fallos definidos por el sistema y fallos definidos por el usuario.

El servicio de integración de datos devuelve un mensaje de error a un cliente del servicio web cuando se produce un error definido por el usuario. Un fallo definido por el usuario puede ser uno de los siguientes tipos:

Predefinido

Genérico

Cuando una asignación de operación contiene una transformación de salida, el servicio web devuelve datos de la transformación de salida o un fallo. Si se produce un fallo después de que la asignación de operación haya confirmado los datos para transformaciones de destino o aplicaciones externas, el servicio de integración de datos no puede revertir los datos. La asignación se detiene y el servicio de integración de datos descarta los datos recibidos por la transformación de salida del servicio web.

Error de SOAP 1.1

Para SOAP 1.1, un fallo es un mensaje SOAP con la siguiente estructura:


   Fault (FaultName)         
   Key_Fault (FaultName)
   faultcode            xs:QName
   faultstring          xs:string
   faultactor           xs:anyURI
   detail

El fallo contiene los siguientes elementos:

Código de fallo: Un código de identificación de fallo como un número de mensaje de error.
Cadena de fallo: Un explicación del error.
Actor del fallo: Información opcional sobre el objeto que ha provocado que se produzca el fallo.

Detalle: Información opcional que varía según el fallo.

Error de SOAP 1.2

Para SOAP 1.2, un fallo es un mensaje SOAP con la siguiente estructura:


   Fault (FaultName)         
   Key_Fault (FaultName)
   Code                tns:faultcodeEnum
   Reason              tns:reasontext
   Node                xs:anyURI
   Role                xs:anyURI
   detail

El fallo contiene los siguientes elementos:

Código: Identificación de un fallo.
El elemento Valor de Código de debe ser uno de los siguientes valores:
infasoapns:DataEncodingUnknown
infasoapns:MustUnderstand
infasoapns:Receiver
infasoapns:Sender
infasoapns:VersionMismatch
Puede expandir el elemento de fallo Código para extraer el elemento de fallo Subcódigo hasta un nivel. El tipo de esquema para Subcódigo de es xsd:QName. Puede usar el elemento de fallo Subcódigo para definir un número de mensaje de error.
Motivo: Un explicación del error.
Nodo: Contiene el URI del nodo de SOAP que ha generado el fallo.
Función: Información opcional sobre el objeto que ha provocado que se produzca el fallo.