1

A flow or Java service, typically invoked by an Integration Server client, initiates the Insert service on the Integration Server.

You configure the Insert service, and the wrapping flow or Java service, using Designer.

2

The Insert 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 Insert 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, initiate create keys, and insert the record (including all associated child-level records) into the PeopleSoft system, assigning values to the fields specified in the service's input signature.

If the service is successful, it executes the standard PeopleSoft Save method. The Save method commits any changes to the database.

If the PeopleSoft server throws exceptions while creating or saving records, the adapter will throw those same exceptions. For information about how the adapter handles PeopleSoft errors, see Handling PeopleSoft Exceptions.

The service's input signature includes key fields that the component interface requires to be able to insert a record into PeopleSoft, and input fields that the contain additional fields for the record.

You define the Insert service's input signature when you create the service. All fields on the Key Fields tab in the adapter service template are included in the service's input signature, and fields that you select on the Input Fields tab, become the service's input signature.

4

The Insert service returns a status document indicating whether or not the service was successful. You can optionally include this status message in the service's output signature. This status is added to the pipeline of the Insert 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.