Exceptions and error handling with the Oracle Database adapter
This section lists the exceptions that the Microsoft BizTalk Adapter for Oracle Database throws. These can contain:
An inner exception, which is a system exception that the .NET Framework throws.
An LOB exception that the LOB client library throws.
For more information about the inner exception, see the respective .NET Framework or Oracle documentation. Exceptions also contain a detailed error message that helps in resolving the problem.
| Exception | Possible Cause/Description |
|---|---|
| XmlReaderParsingException | The adapter throws this exception if it does not support the specified type, or if an incorrect value is specified for the type. Also, the input XML might be incorrect. An incorrect value includes cases where the maximum amount of text or maximum digits is exceeded. The input XML might be incorrect if the operation name or namespace is incorrect. |
| UnsupportedOperationException | The adapter throws this exception when the adapter client specifies an invalid action. |
| ArgumentException | The adapter throws this exception if an incorrect value is specified for an argument. |
| NotImplementedException | The adapter throws this exception if some method in the XMLReader reader is not implemented. |
| ArgumentNullException | The adapter throws this exception if a required argument is not specified. |
| ArgumentOutOfRangeException | The adapter throws this exception if it tries to access a non-existent entity or out-of-range entity. |
| XmlReaderGenerationException | The adapter throws this exception when it is unable to generate an XmlReader from the output message. |
| MetadataException | The adapter throws this exception if there is an error during metadata retrieval, browse, or search. |
| CredentialsException | The adapter throws this exception if there is a problem retrieving or using security tokens or if the required credentials are not specified. |
| InvalidUriException | The adapter throws this exception if the connection URI does not have the required components for the connection string. |
| ConnectionException | The adapter throws this exception if there is a problem connecting to the Oracle database using ODP.NET. The inner exception contains the Oracle exception. |
| TimeoutException | The adapter throws this exception if the timeout specified for an operation is lapsed. The inner exception contains the specifics of why the specified timeout was not sufficient. |
| ListenerException | The adapter throws this exception if there is a problem in receiving a message from the target system. This message denotes a problem related to the Oracle listener. The inner exception has the specifics of the issue. |
| TargetSystemException | The adapter throws this exception if Oracle returns an error or invalid response. The inner exception contains the Oracle runtime exception. |
| InvalidOperationException | The adapter throws this exception if adapter tries to perform an invalid operation on the target system. The inner exception contains the specifics of the invalid operation being performed. |
| OverflowException | The adapter throws this exception if while performing operation containing Oracle numeric data types inside DataSets or weakly-typed REF CURSORS, a large value is specified for these Oracle numeric data types that cannot fit into the respective .NET type. |