Error Handling

Web services faults are classified into the following four groups:

  • Validation fault
  • System fault
  • Service unavailable fault
  • Security fault

MDS Global web serviceClosed XML- or JSON-based information exchange systems that use the Internet for direct application-to-application interaction. These systems can include programs, objects, messages, or documents. fault types are defined in the WSDL and declared as faults in the operation binding. From this, JavaClosed A widely used object-oriented programming language that is designed for use in the distributed environment of the internet. It is the most popular programming language for Android smartphone applications exceptions are derived (when using the Axis toolkit). All MDS Global web services can throw any of the fault types.

Validation Fault

Validation faults are passed back to the client through the SOAP fault mechanism and indicate to the client that there is a problem with the request data. This typically covers the following:

Validation faults accumulated during request processing are grouped together into a single message as much as possible, containing sub-faults detailing the named field and an explanation. This provides the best chance of a userClosed A person with the capability to log in to the CMP GUI software, such as a customer service advisor or agent., having modified the submitted data, to have the request processed successfully. However, this is not always possible in cases where a CMPClosed Converged Monetisation Platform. The MDS Global product that supports customer care and billing for digital service providers. process fails during execution due to some setup rule being broken.

System Fault

A system fault usually indicates that either the program has exited abnormally, or a runtime exception has occurred in the Services layer.

Service Unavailable Fault

A service unavailable fault is a type of system fault but specifically relates to unavailable resource, such as an inability to contact the CMP services layer.

Security Fault

Security faults can occur for three reasons:

  • The supplied credentials are rejected by the authentication mechanism – a security fault detailing that there is a problem with the credentials, or a missing username or password is returned.
  • An authenticated user attempts to access an unlicensed web service or web service groupClosed In the Customer Manager Platform hierarchy, the highest level of the structure. The group level can be used to group corporates. Groups can hold financial information. - individual Web Service operations are placed into licensed groups, and a license grants access to a selection of groups. Any problems encountered, including tamper detection, results in a security fault being returned with a descriptive error text.
  • An authenticated user accessing a licensed operation may encounter an error if the CMP account does not have sufficient privileges to complete the operation. Most consumers of MDS Global web services operate under a special account set up specifically for access to web services. This does not have to be the case however, and there is no restriction for the security credentials to be the same as the CMP access credentials.