IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > JDBC > Reference
Fault business objects
The adapter supports business faults, which are exceptions that are anticipated and declared in the outbound service description, or import. Business faults occur at predictable points in a business process, and are caused by a business rule violation or a constraint violation.
IBM WebSphere Adapter for JDBC enables faults for you. Manual configuration of faults is not required. The WBIFault business object contains information that is required to handle the fault.
The adapter provides the following fault business objects that the wizard creates:
- IntegrityConstraintFault
When processing a Create, Update, UpdateAll, DeleteAll, Execute, and Merge operation, the adapter returns this fault if the database returns the SQLException exception for an integrity constraint violation.
For example, if a foreign key is not found, the adapter returns this fault.
- MatchesExceededLimitFault
When processing a RetrieveAll operation, the adapter returns this fault if the number of records returned from the database query exceeds the value for the MaxRecords property in the interaction specification.
To increase the number of records that are returned, increase the value of the MaxRecords property in the interaction specification properties for the RetrieveAll operation.
The business object for this fault has only one property, matchCount, which is a string that contains the number of matches.
- MissingDataFault
If the business object that is passed to the outbound operation does not have all the required attributes, the adapter returns this fault. This fault can occur for the Create, Delete, Update, Retrieve, ApplyChanges, Merge and Exists operations.
- MultipleMatchingRecordsFault
When processing a Retrieve, Merge, ApplyChanges, or Update operation, the adapter returns this fault if the query returns more than one record for the keys specified. The business object for this fault has one property, matchCount, which is a string that contains the number of matches.
- ObjectNotFoundFault
When processing the Create, Update, ApplyChanges, and Merge operations, the adapter retrieves the single-cardinality child object if the ownership of the child object is set to false.
If there are no objects found during the retrieval process, then the adapter returns this fault.
- RecordNotFoundFault
When retrieving data, the adapter returns this fault if the record is not found in the database for the keys specified. This fault can occur for the Retrieve, RetrieveAll, Delete,Merge, ApplyChanges, Execute, and Update operations.
- UniqueConstraintFault
When processing a Create, Merge, ApplyChanges, Execute, UpdateAll, or Update operation, the adapter returns this fault if it receives a SQLException exception from the database because of a unique constraint violation.
Related concepts:
Related tasks:
Setting global properties for operations and creating wrapper business objects