PeopleSoft Adapter 6.0 | webMethods PeopleSoft Adapter Documentation | webMethods PeopleSoft Adapter Installation and User’s Documentation | Adapter Services | Configuring Update Services
 
Configuring Update Services
Update services enable the adapter to update an existing level 0 or higher CI record in a PeopleSoft database. For more information about Update services, see Update Services. You configure PeopleSoft Adapter services using Designer.
*To configure an Update service
1. Review the steps in Before Configuring or Managing Adapter Services.
2. Start Designer.
3. Perform the following:
a. Right-click the package in which the service should be contained and select New > Adapter Service.
b. Select the parent namespace and type a name for the adapter service.
c. Click Next.
4. Select PeopleSoft Adapter as the adapter type and click Next.
5. Select the appropriate Adapter Connection Name and click Next.
6. From the list of available templates, select the Update template.
7. Click Finish.
The adapter service editor for the Update service appears. You can select the Adapter Settings tab at any time to confirm adapter service properties such as the Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
8. Select the Component Interface tab, if it is not already selected, to specify the PeopleSoft component interface to use with the Update service. Specify values for the following fields:
Parameter
Description/Action
Component Interface
Specify the name of the CI with which the adapter service will interface, as follows:
*If the Enable List Of All Available CIs parameter for this service's associated adapter connection is set to TRUE, you can select the CI from a list of all available CIs on the PeopleSoft system.
The list of CIs reflects all CIs on the PeopleSoft system. However, the adapter service will only work if the CI's .class files are copied to the Integration Server directory. See Setting Up Your Adapter's Environment for details.
*If the Enable List Of All Available CIs parameter for this service's associated adapter connection is set to FALSE, you must type the name of the CI. This field is case sensitive.
For more information about the Enable List Of All Available CIsoption, see Configuring Adapter Connections.
If you want Designer to display an error if you select an invalid CI name, you can turn on automatic validation of adapter services as described in Validating Adapter Service Values.
Interactive Mode
Select this option if you want the service to emulate an online component. That is, select this option if you want the service to apply values and run PeopleSoft business rules immediately. If you do not select this option, PeopleSoft queues the items and runs the business rules later, as a single step.
Get History Items
Select this option if you want the service to access records that have effective dates that are set to a past date.
Edit History Items
Select this option if you want the service to be able to update records with effective dates that are set to a past date.
To use this option, you must also select the Get History Items option.
Note:
For PeopleTools versions 8.18 and 8.19, the Edit History Items feature is not supported. If you are using PeopleTools versions 8.18 or 8.19, you only need to select the Get History Items option if you want the service to update records with effective dates that are set to a past date.
Effective Date Processing
Select this option if you want the update service to access and update effective-dated level 1 or higher records according to date. See Effective Date Processing for a description of how the Update service uses effective date processing.
To use this option, you must also select the Get History Items and Edit History Items options.
9. Select the Key Fields tab and specify the CI key fields that the service will use to identify the record to update.
The tab contains the following information:
Parameter
Description/Action
CI Field Name
This column lists all Get key fields for the CI.
CI Field Type
This column lists the PeopleSoft data type for the Get field.
Use Field
Select this option for each field you want to use as an input for locating the record to update, or click the icon to select all of the fields.
Fields that you select on this tab will appear in the adapter service's input signature (see the Input/Output tab) within a document called ServiceNameInput.LookupFields, where ServiceName is the name you specify for the service.
Input Field Name
When you choose a field on this tab, this column lists the webMethods field name.
Input Field Type
This column lists the webMethods data type for each input field.
10. Select the Update Fields tab and specify the CI key fields that the service will use to update the record.
The tab contains the following information:
Parameter
Description/Action
CI Field Name
This column lists all available fields for the CI.
CI Field Type
This column lists the PeopleSoft data type for the field.
Use Field
Select this option for each field you want to use as an input for updating the record, or click the icon to select all of the fields.
Fields that you select on this tab will appear in the adapter service's input signature (see the Input/Output) within a document called ServiceNameInput.UpdateFields, where ServiceName is the name you specify for the service.
Input Field Name
When you choose a field on this tab, this column lists the webMethods field name.
Input Field Type
This column lists the webMethods data types for the service's CI input fields.
11. Select the Output Fields tab and specify whether the service will return a status.
The tab contains the following information:
Parameter
Description/Action
Status Field
This column shows the STATUS output field.
Use Field
Select this option if you want the service to return a status.
If you choose to use the STATUS field, the field will appear as an output field on the service's Input/Output tab.
Output Field Name
If you choose to use the STATUS field, this column lists the webMethods field name.
Output Field Type
This column lists the webMethods data type for the STATUS output field.
12. When using Designer, the Designer contains only the Adapter Settings and Input/Output tabs. The information from the Audit and Permissions tabs appears in the Properties panel, and the information from the Results tab appears in the Service Results panel (in Designer). For more information see the webMethods Service Development Help for your release.
13. From the File menu, select Save.