Authentication and error handling – GE Industrial Solutions WattStation Connect Web Services Guide User Manual

Page 16

Advertising
background image


WattStation™ Connect Web Services Guide

GE Energy

©2012 GE Company All Rights Reserved

16

Authentication and Error Handling
If an error occurs during the processing of a service, a generic exception of type
EVSEWebServiceException

is thrown. The EVSEWebServiceException exception

represents all exceptions that can occur during a web service call.

To understand why the exception was thrown, you must look at attributes within the

EVSEWebServiceException

. The attributes “message” and “EVSEError” provide relevant information

regarding the cause of the exception.

The attribute „message‟ is the string description of the exception.

The attribute „errorCode‟ within the „EVSEError‟ object is the unique integer value
representing the reason for this exception.

Listed below are the types of errors that can occur during the processing of a service, along with
the error message and error code values.

Table 7: Error codes and corresponding error messages

Code

Error message

Description

100

Invalid username or password

Bad login credentials

101

Insufficient privileges to perform
this operation

The user does not have permissions to access
this web service.

103

Service Exception

General exception thrown when the backend
service cannot perform the operation because of
an internal error.

104

Station not found

The station serial number was not found.

105

Invalid parameter

A parameter that was passed to the service is
invalid.


If your client does not support exceptions, then exceptions are returned to the client as part of the
SOAP envelope response. In the SOAP envelope, there will be an element <soap:fault>. The
<soap:fault> element will hold the reason for the exception and the error code.

Advertising