PeopleSoft Adapter 6.0 | webMethods PeopleSoft Adapter Documentation | webMethods PeopleSoft Adapter Installation and User’s Documentation | About the PeopleSoft Adapter | Adapter Services | Update Services | Update Service Run-Time Processing
 
Update Service Run-Time Processing
The following diagram illustrates the run-time data processing for the PeopleSoft Adapter's Update service.
Step
Description
1
A flow or Java service, typically invoked by an Integration Server client, initiates the Update service on the Integration Server.
You configure the Update service, and the wrapping flow or Java service, using Designer.
2
The Update service retrieves a connection from the service's associated connection pool.
You configure and enable the adapter connection using the Integration Server Administrator. For more information about connection pooling, including the run-time behavior of connection pools, see Connection Pooling.
3
The Update service uses the PeopleSoft component interface Java APIs along with PeopleSoft libraries (which you installed in the Integration Server in Setting Up Your Adapter's Environment) to connect to the PeopleSoft system and then identify and update the specified record.
The service allows you to update records at scroll levels 1 and up. Depending on the key values specified in the input signature, the child record is updated as follows:
*If the record already exists in PeopleSoft, the adapter updates it with the new data.
*If the record does not exist in PeopleSoft, the adapter adds that row, plus all of its child-level rows.
If the service is successful, it executes the standard PeopleSoft Save method. The Save method commits any changes to the PeopleSoft database.
If the PeopleSoft server throws exceptions while creating or saving records, the adapter will throw those same exceptions. For more information about how the adapter handles PeopleSoft errors, see Handling PeopleSoft Exceptions.
You define the Update service's input signature when you create the service. Fields that you select on the Key Fields tab in the adapter service template become the service's input signature.
4
The Update service returns a status document (called STATUS) indicating whether or not the service was successful. You can optionally include this status document in the service's output signature. This status is added to the pipeline of the Update service.
You define the Insert service's output signature when you create the service. Select the STATUS option on the Output Fields tab in the adapter service template to include the STATUS message in the service's output signature.