The driver reports errors occurring in both the driver and the Google Domain. All errors reported by the driver follow the Identity Manager Driver error reporting scheme of Status Level and Status Type.
|
Status Level |
Description |
|---|---|
|
Success |
The operation succeeded |
|
Warning |
The operation succeeded with a warning |
|
Retry |
The operation failed because of an error not related to invalid data or a memory or execution error. These are transient errors. For instance, the Google driver issues a Retry when Google reports a Server Busy error. |
|
Error |
The operation failed due to an error in xml formatting or a data error. |
|
Fatal |
The operation failed as a result of an unrecoverable condition, such as an OutOfMemoryException. |
The Status Type provides a way for a driver to indicate the category of the error. For instance, the driver can use Status Type to indicate if a Retry has been issued as a result of application connectivity error. When handling an exception or an error as a result of a transient condition the driver will disconnect from the Google domain and then send a retry request to the Identity Manager engine. The default retry interval is 30 seconds. Once 30 seconds has elapsed the IDM engine will send the event to the driver again. The driver will detect that it is no longer connected to the Google domain and establish a fresh connection.
The driver will report invalid xml conditions such as invalid class names, attribute names or values with an Error status level.
All other errors will be reported with a Java exception or a Google API exception along with the Status Level and Status Type.