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 > PeopleSoft Enterprise > Overview of WebSphere Adapter for PeopleSoft Enterprise > Technical overview

Outbound processing

WebSphere Adapter for PeopleSoft Enterprise supports synchronous outbound request processing, so that when the client application sends a request in the form of a business object to the adapter, the adapter processes the request, and returns a business object that represents the result of the operation to the client application.

When the adapter receives a WebSphere business object hierarchy, the adapter processes it as follows:

  1. The adapter extracts metadata that identifies the appropriate PeopleSoft component interface to access.

  2. The adapter extracts the outbound operation to perform.

  3. After accessing the component interface, the adapter sets the keys from values specified in the business objects. If key values are not generated, for example with a Create operation, the PeopleSoft application generates key fields.

  4. After retrieving the PeopleSoft objects, the adapter instantiates an existing component interface to delete, retrieve, update, or create a component interface.

  5. If update operations (Create, Update) are to be performed, the adapter populates the component interface with data from the WebSphere business object hierarchy. If Delete operations are required, the adapter populates the component interface only with StatusColumnName and value information.

For Create and Update operations only, the adapter processes attributes in the order defined in the business object.

For example, if a complex attribute is between two simple attributes, the adapter processes the simple attribute at the first position, then the complex attribute, and then the simple attribute. After the changes are made, the component interface is saved to commit the data to the PeopleSoft database.


Supported outbound operations

WebSphere Adapter for PeopleSoft Enterprise supports the following outbound operations:

The following table describes each of these operations.

Supported outbound operations
Operation Description
ApplyChanges Updates, creates, or deletes the business object based on the delta information contained in the change summary.
Create Creates the business object.
Delete Deletes the business object and its children. Because the adapter supports only logical deletes, objects are marked as deleted but not removed.
Exists Checks for the existence of incoming business objects.
Retrieve Retrieves the PeopleSoft component and maps component data onto the business object.
RetrieveAll Retrieves multiple instances of the PeopleSoft component and maps component data onto the business object.

The following errors can result from this operation:

RecordNotFoundFault– This fault is generated when the input object does not exist in the enterprise information system and if the managed connection factory property for the Show error on empty result set (showErrorOnEmptyResultSet) property is set to True and the Use Invalid Request Fault (useInvalidRequestFault) is set to False. To get an empty business object without the RecordNotFoundFault, you can either modify the .import file and set the Show error on empty result set (showErrorOnEmptyResultSet) property to False, or after you deploy the outbound application on IBM BPM, configure the Managed Connection Factory property Show error on empty result set (showErrorOnEmptyResultSet) to False.

MatchesExceededLimitFault – This fault is generated when the number of matching records in the database exceeds the value of the Maximum number of records for RetrieveAll operation (MaxRecords) property that is defined in the interaction specification. The MatchCount attribute of the fault contains the actual number of matches that the adapter found in the database, so that you can either increase the limit or refine the search. If the Maximum number of records for RetrieveAll operation (MaxRecords) property is set to a large number, problems can occur due to a lack of sufficient memory, depending upon the size and number of business objects returned.

Update Updates the corresponding PeopleSoft component with the incoming business object.

Technical overview of WebSphere Adapter for PeopleSoft Enterprise


Related tasks:

Configure the module for outbound processing